Para saber mais sobre as relações de objetos e como usá-las na API, vá para a seção Relações de objeto .
Para obter mais informações sobre grupos de usuários do Server, acesse a página de ajuda Gerenciamento de usuários e grupos .
Para criar um novo grupo de usuários do Server, use o ponto de extremidade
POST {baseURL}/v3/usergroups
.
Para criar um novo grupo de usuários do Server, especifique o parâmetro "contract":
contract (corpo): obrigatório. Especifique os parâmetros para um grupo de usuários do Server:
name (cadeia de caracteres): obrigatório. Insira um nome de grupo de usuários do Server.
role (cadeia de caracteres): obrigatório. Insira uma função para este grupo de usuários do Server. Selecione uma destas opções: "NoAccess" (sem acesso), "Viewer" (visualizador), "Member" (membro), "Artisan" (criador), "Curator" (administrador), e "Evaluated" (avaliado). A função padrão ("Evaluated" (avaliado)) é avaliada em tempo de execução. Para obter mais informações sobre funções e permissões, visite a página Funções e permissões de usuário .
curl --location --request POST 'http://localhost/webapi/v3/usergroups' \ --header 'Content-Type: application/x-www-form-urlencoded' \ --header 'Authorization: Bearer BearerTokenGoesHere' \ --data-urlencode 'name=Accounting' \ --data-urlencode 'role=Artisan'
Para adicionar um ou mais usuários a um grupo de usuários do Server, use o ponto de extremidade
POST {baseURL}/v3/usergroups/{id}/users
.
Para adicionar usuários a um grupo de usuários do Server, especifique os seguintes parâmetros:
id (cadeia de caracteres): obrigatório. Insira o ID do grupo de usuários do Server ao qual deseja adicionar usuários.
userIds (corpo): obrigatório. Insira os IDs do usuário que deseja adicionar a esse grupo de usuários do Server.
Para adicionar um grupo do Active Directory como membro de um grupo de usuários do Server, use o ponto de extremidade
POST /v3/usergroups/{id}/activedirectorygroups
.
Nota
Este ponto de extremidade só pode ser utilizado em instâncias do Server configuradas para autenticação do Windows.
id (cadeia de caracteres): obrigatório. Insira o ID de um grupo de usuários do Server ao qual deseja adicionar um grupo do Active Directory.
sid (cadeia de caracteres): obrigatório. Insira o identificador de segurança (SID) do grupo do Active Directory. Você deve enviar o valor entre aspas, por exemplo "S-My-SID".
Para pesquisar usuários, use o ponto de extremidade
GET {baseURL}/v3/usergroups
. Use vários parâmetros como um filtro para pesquisar os usuários.
Nota
Apenas os grupos de usuários do Server serão recuperados. Grupos do Active Directory não serão retornados.
Nenhum parâmetro é necessário.
curl --location --request GET 'http://localhost/webapi/v3/usergroups' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Para recuperar informações sobre um grupo de usuários do Server específico, use o ponto de extremidade
GET {baseURL}/v3/usergroups/{id}
.
Nota
Funciona apenas para grupos de usuários do Server. Os grupos do Active Directory não podem ser recuperados desse ponto de extremidade.
"id" (cadeia de caracteres): obrigatório. Insira um ID do grupo de usuários do Server para recuperar informações sobre esse grupo de usuários.
curl --location --request GET 'http://localhost/webapi/v3/usergroups/61d58ac83c15317e1a482069' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Para atualizar o nome e a função de um grupo de usuários do Server existente, use o ponto de extremidade
PUT {baseURL}/v3/usergroups/{id}
.
id (cadeia de caracteres): obrigatório. Insira um ID do grupo de usuários do Server para que esse grupo de usuários seja atualizado.
contract (corpo): obrigatório. Para atualizar um grupo de usuários do Server, o parâmetro "contract" é obrigatório. Especifique o seguinte:
name (cadeia de caracteres): obrigatório. Insira um nome de grupo de usuários do Server.
role (cadeia de caracteres): obrigatório. Você pode selecionar entre estas opções: "NoAccess" (sem acesso), "Viewer" (visualizador), "Member" (membro), "Artisan" (criador), "Curator" (administrador), e "Evaluated" (avaliado). Para obter mais informações sobre funções e permissões, visite a página Funções e permissões de usuário .
curl --location --request PUT 'http://localhost/webapi/v3/usergroups/61d58ac83c15317e1a482069' \ --header 'Content-Type: application/x-www-form-urlencoded' \ --header 'Authorization: Bearer BearerTokenGoesHere' \ --data-urlencode 'name=Marketing' \ --data-urlencode 'role=Artisan'
Para remover um usuário específico de um grupo de usuários do Server, use o ponto de extremidade
DELETE {baseURL}/v3/usergroups/{userGroupId}/users/{userId}
.
Nota
Se o usuário não fizer parte do grupo, uma resposta "OK" será retornada.
userGroupId (cadeia de caracteres): obrigatório. Insira o ID do grupo de usuários do Server do qual deseja remover o usuário.
userId (cadeia de caracteres): obrigatório. Insira o ID do usuário que você deseja remover do grupo de usuários do Server.
curl --location --request DELETE 'http://localhost/webapi/v3/usergroups/61d58ac83c15317e1a482069/users/61d564361d6d5da7ad461a32' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Para remover um grupo do Active Directory como membro de um grupo de usuários do Server, use o ponto de extremidade
DELETE /v3/usergroups/{userGroupId}/activedirectorygroups/{adGroupSid}
.
Nota
Este ponto de extremidade só pode ser utilizado em instâncias do Server configuradas para autenticação do Windows.
userGroupId (cadeia de caracteres): obrigatório. Insira o identificador do grupo de usuários do Server do qual deseja remover o grupo do Active Directory.
adGroupSid (cadeia de caracteres): obrigatório. Insira o identificador de segurança (SID) do grupo do Active Directory que deseja remover do grupo de usuários do Server.
Para excluir um grupo de usuários do Server específico do sistema, use o ponto de extremidade
DELETE {baseURL}/v3/usergroups/{id}
.
Nota
A mensagem de erro "400 Bad Request" (400 Solicitação incorreta) será retornada se o grupo de usuários do Server não estiver vazio e o parâmetro de consulta forceDelete for "false" (falso).
id (cadeia de caracteres): obrigatório. Insira o ID do grupo de usuários do Server que deseja excluir.
forceDelete (booleano): opcional. Se definido como "true" (verdadeiro), o grupo de usuários do Server será excluído mesmo que contenha usuários.
curl --location --request DELETE 'http://localhost/webapi/v3/usergroups/61d58ac83c15317e1a482069?forceDelete=true' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Se estiver criando um grupo de usuários do Server, você poderá usar objetos criados da seguinte maneira:
Objeto criado: " id " (por exemplo, "id": "619158e57e607d0011ac3009")
Você pode usá-lo como:
userGroupId se você estiver adicionando um grupo de usuários do Server a uma coleção .
userGroupId se você estiver atualizando permissões do grupo de usuários do Server de uma coleção .
userGroupId se você estiver removendo um grupo de usuários do Server de uma coleção .
userGroupId se você desejar compartilhar uma credencial com um grupo de usuários do Server .
userGroupId se você desejar remover um grupo de usuários do Server de uma credencial .
userGroupId se você desejar adicionar um grupo de usuários do Server a uma conexão de dados .
userGroupId se você desejar remover um grupo de usuários do Server de uma conexão de dados .
POST /v3/usergroups

DELETE /v3/usergroups/{userGroupId}/users/{userId}

Para saber mais sobre solicitações Postman, visite a página de ajuda Como usar Postman .