automation-suite
2023.10
false
- Introdução
- Autenticação
- Escopos e permissões
- APIs de gestão de plataforma
Criar uma nova conta de robô
Importante :
A localização de um conteúdo recém-publicado pode levar de 1 a 2 semanas para ficar disponível.

Guia da API do Automation Suite
Última atualização 10 de fev de 2025
Criar uma nova conta de robô
Cria uma nova conta de Robot na ID da organização especificada e a atribui aos grupos indicados.
--header 'Authorization: Bearer {access_token}'\
--header 'Content-Type: application/json'
--header 'Authorization: Bearer {access_token}'\
--header 'Content-Type: application/json'
Observação: para obter o
{access_token}
, certifique-se de se autenticar por meio de um dos métodos descritos aqui.
O corpo da solicitação contém a ID da organização à qual você deseja adicionar o grupo e, opcionalmente, os usuários que você deseja adicionar como membros no novo grupo.
{
"partitionGlobalId": "string",
"id": "string",
"name": "string",
"groupIDsToAdd": [
"string", "string"
]
}
{
"partitionGlobalId": "string",
"id": "string",
"name": "string",
"groupIDsToAdd": [
"string", "string"
]
}
Digamos que você reuniu todas as informações necessárias para criar a chamada de API.
- Seu
{baseURL}
é:https://{yourDomain}/{organizationName}/{tenantName}/
-
Seu
{access_token}
é:1234
(para considerações de comprimento). - O
{partitionGlobalId}
é:magic-7
- Você deseja nomear o grupo:
"Gryffindors"
-
Você deseja adicionar os usuários Ron, Harry e Hermione ao grupo. Esse usuários têm as seguintes IDs de usuários:
- Identificador do usuário Ron:
ron-0103
- Identificador do usuário Luna:
har-3107
- Identificador do usuário Hermione:
her-1909
- Identificador do usuário Ron:
A chamada deve ter a seguinte aparência (cURL):
curl --location --request POST 'https://{yourDomain}/{organizationName}/{tenantName}/identity_/api/Group' \
--header 'Authorization: Bearer 1234' \
--header 'Content-Type: application/json'
--data-raw '{
"name": "Roby",
"displayName": "Roby",
"partitionGlobalId": "magic-7",
"groupIDsToAdd": [
"gryff-01"
],
"groupIDsToRemove": []
}'
curl --location --request POST 'https://{yourDomain}/{organizationName}/{tenantName}/identity_/api/Group' \
--header 'Authorization: Bearer 1234' \
--header 'Content-Type: application/json'
--data-raw '{
"name": "Roby",
"displayName": "Roby",
"partitionGlobalId": "magic-7",
"groupIDsToAdd": [
"gryff-01"
],
"groupIDsToRemove": []
}'
Aqui está a resposta de uma chamada bem-sucedida:
{
"id": "rb-12",
"name": "Roby",
"displayName": "Roby",
"creationTime": "2021-10-20T15:20:29.1302044Z",
"lastLoginTime": null,
"groupIds": ["gryff-01"]
}
{
"id": "rb-12",
"name": "Roby",
"displayName": "Roby",
"creationTime": "2021-10-20T15:20:29.1302044Z",
"lastLoginTime": null,
"groupIds": ["gryff-01"]
}