automation-cloud
latest
false
- Introdução
- Autenticação
- Escopos e permissões
- APIs de gestão de plataforma
Guia de API da UiPath Automation Cloud
Última atualização 5 de mai de 2026
Recupera a alocação de licença e a configuração de cota atuais de um grupo. Requer um aplicativo externo com o escopo PM.License.Read.
Ponto de Extremidade da API
GET {accessURL}/{organizationName}/lease_/api/account/{accountId}/user-license/group/{groupId}/with-quota
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/ |
Cabeçalhos de solicitação.
--header 'Authorization: Bearer {access_token}'
--header 'Authorization: Bearer {access_token}'
Parâmetros do caminho
| Parâmetro do caminho | Tipo de dados | Description |
|---|---|---|
accountId (obrigatório) | Guid | A ID da organização na qual seu locatário reside. |
groupId (obrigatório) | String | A ID do grupo ao qual você deseja alocar licenças. Você pode recuperar esse ID seguindo estas etapas. |
Resposta
200 OK
Retorna as licenças de grupos alocadas com cotas configuradas e uso atual.
404
A organização ou grupo não existe.
Exemplo de solicitação
A solicitação deve ser semelhante ao seguinte exemplo (cURL):
curl --location --request GET 'https://https://cloud.uipath.com/{organizationName}/lease_/api/account/1234/user-license/group/group-01/with-quota' \
--header 'Authorization: Bearer {access_token}'
curl --location --request GET 'https://https://cloud.uipath.com/{organizationName}/lease_/api/account/1234/user-license/group/group-01/with-quota' \
--header 'Authorization: Bearer {access_token}'
Aqui está o corpo da resposta para uma alocação de licença bem-sucedida:
{
"groupRule": {
"groupId": "group-01",
"organizationId": "1234",
"userBundleCodes": ["RPADEVPRONU", "IDU"]
},
"quotas": [
{
"userBundleCode": "RPADEVPRONU",
"limit": 10,
"currentUsage": 3
}
]
}
{
"groupRule": {
"groupId": "group-01",
"organizationId": "1234",
"userBundleCodes": ["RPADEVPRONU", "IDU"]
},
"quotas": [
{
"userBundleCode": "RPADEVPRONU",
"limit": 10,
"currentUsage": 3
}
]
}