Automation Suite
2022.10
falso
- Introdução
- Autenticação
- Escopos e permissões
- APIs de gestão de plataforma
[Visualizar] Criar uma nova conta de robô
Guia da API do Automation Suite
Última atualização 19 de abr de 2024
[Visualizar] 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"]
}