Bring hosts under management
POST/api/v1/ManagedResource/Candidate/AddMultiple
Turns discovered domain hosts into managed resources that use the service account you name, and starts a host scan for each of them. A host that is already a resource is switched to the service account instead. Use the IDs from the candidate search for the host list.
Permission required: Administrator signed in with multifactor authentication, or an application account.
Caution: Each listed host is created as a resource, or switched to the service account you name if it is already one, and scanned right away. Hosts are processed in order, so if one host fails validation the hosts before it have already been added, but no scan is started for any of them.
Request
Responses
- 200
- 400
- 403
Returns the number of hosts that were added or switched to the service account.
No hosts were sent, the service account is missing or not found, a host is not found or is not a domain host with a DNS host name, or the add failed. The body is a message.
The signed-in user does not have the required role.