Look up computer ids from names
POST/computers/lookupids
Resolves computer name and domain pairs to computer ids.
cn and domain_fqdn are matched exactly (case-sensitive). Pairs with no match, including pairs whose cn is not a string, are returned in notFound. A pair sent twice is returned twice in found.
Required role: superadmin, admin or user.
The body can be JSON or urlencoded (systemInfo[0][cn]=...&systemInfo[0][domain_fqdn]=...); the nested array is practical only as JSON.
Request
Responses
- 200
- 400
- 401
- 403
Lookup result.
Request body failed validation. Body is a typed error with name ValidationError and a message, for example when systemInfo is missing, is not an array, or an entry lacks cn or domain_fqdn. A request body containing a key that starts with $ is also rejected as invalid.
No token, or the token is invalid or expired. The body is {message}: No auth token provided when no token is sent, otherwise the token check's message (jwt expired, jwt malformed, invalid signature, invalid token, jwt signature is required). Send Authorization: Bearer <token> exactly: the server drops the first seven characters of the header and reads the rest as the token, so a different scheme or an extra space fails. If Authorization is absent, the server reads a token field in the body, then a token query parameter, then x-access-token. Routes that validate query fields reject ?token= with 400 InvalidQuery.
The token's role is not allowed for this operation, or the token's scopes exclude the route
(Scope not allowed by token).