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.

API 端点

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

将所有端点路径中的{accessURL}替换为您的云平台的基本 URL：

Cloud Platform	访问 URL
Automation Cloud	https://cloud.uipath.com/
Automation Cloud 公共部门	https://govcloud.uipath.us/
Automation Cloud 专用	https://{customURL}.dedicated.uipath.com/

备注：

{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.

请求标头

--header 'Authorization: Bearer {access_token}'

备注：

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

路径参数

路径参数	数据类型	描述
accountId (必填)	Guid	The ID of the organization in which the tenant resides.
tenantId (必填)	Guid	The ID of the tenant for which to retrieve the robot allocation.

响应

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.

备注：

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.

请求示例

请求应类似于以下示例 (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 }
  ]
}