Get Tenant Robot Allocation

GET endpoint for retrieving the number of robot runtimes allocated to and in use by a specific tenant.

Retrieves the number of unattended robot runtimes allocated to a specific tenant and, when available, how many of them are currently in use. The in-use count is read live from Orchestrator on each call. Requires one of the following:

• An external application with the scope PM.License.Read (or PM.License). Find out how to create an external application.
• An Organization Administrator user token.
• An internal service-to-service token.

Ponto de Extremidade da API

GET {accessURL}/{organizationName}/license_/api/account/{accountId}/tenant/{tenantId}/robots

Substitua {accessURL} em todos os caminhos do ponto de extremidade pelo URL base para sua plataforma de nuvem:

Cloud Platform	URL de acesso
Automation Cloud	https://cloud.uipath.com/
Automation Cloud Setor público	https://govcloud.uipath.us/
Automation Cloud dedicado	https://{customURL}.dedicated.uipath.com/

Observação:

{organizationName} and {accountId} both identify the same organization: {organizationName} is the organization name in the URL routing prefix, while {accountId} is the organization ID (GUID) used as a path parameter. The organization ID is also accepted in the routing prefix, as in any standard URL.

Cabeçalhos de solicitação.

--header 'Authorization: Bearer {access_token}'

Observação:

To obtain the {access_token} for an external application, authenticate using the client credentials grant, as described on the Authentication Methods page.

Parâmetros do caminho

Parâmetro do caminho	Tipo de dados	Description
accountId (obrigatório)	Guid	The ID of the organization in which the tenant resides.
tenantId (obrigatório)	Guid	The ID of the tenant for which to retrieve the robot allocation.

Resposta

200 OK

Returns the robot allocation for the specified tenant.

• serviceScopeId: the tenant ID from the request.
• serviceType: always orchestrator.
• usageAvailable: true when the in-use counts were retrieved from Orchestrator. false when Orchestrator could not be reached; in that case, inUse is omitted from every entry in robots so that unavailable usage is never reported as zero.
• robots: for each unattended robot type allocated to the tenant, the allocated quantity (allocated) and, when available, the quantity currently in use (inUse). Only products allocated to the tenant are listed. See Robots for the available codes.

robots is returned as an empty array, with usageAvailable set to false, when the tenant has no Orchestrator service license or has no unattended robot licenses allocated. In that case, no call is made to Orchestrator.

Observação:

This endpoint covers unattended robot runtimes only (UNATT, NONPR, UNATT-HOSTING, TAUNATT, APPTESTR). Attended and other named-user licenses aren't included, as those are user licenses, not runtimes. It also returns allocation for one tenant per call: to retrieve robot allocation for every tenant in an organization, call the endpoint once per tenant.

Exemplo de solicitação

A solicitação deve ser semelhante ao seguinte exemplo (cURL):

curl --location --request GET 'https://cloud.uipath.com/{organizationName}/license_/api/account/11111111-1111-1111-1111-111111111111/tenant/22222222-2222-2222-2222-222222222222/robots' \
--header 'Authorization: Bearer {access_token}'

Here's the response body for a successful robot allocation retrieval:

{
  "serviceScopeId": "22222222-2222-2222-2222-222222222222",
  "serviceType": "orchestrator",
  "usageAvailable": true,
  "robots": [
    { "code": "UNATT", "allocated": 10, "inUse": 3 },
    { "code": "NONPR", "allocated": 2, "inUse": 0 }
  ]
}