Criar regra

Cria uma nova regra de autorização dentro de uma organização.

Endpoint

POST /api/Rule

Corpo da Solicitação

Campo	Tipo	Required	Description
name	String	Sim	Nome da regra
description	String	Não	Descrição da finalidade da regra
enabled	Booleano	Sim	Se a regra está ativa
definition	String	Não	A definição de regra, expressa como uma string codificada por JSON.
partitionGlobalId	GUID	Sim	O identificador global da organização. Para obter etapas sobre a recuperação de partitionGlobalId, consulte Recuperação do partialGlobalId para uso da API.

Cabeçalhos de solicitação.

--header 'Authorization: Bearer {access_token}'
--header 'Content-Type: application/json'

Resposta

Observação:

1. A resposta retorna a regra criada como uma RuleDto, incluindo a id gerada.
2. partitionGlobalId pode ser retornado como o GUID zero, dependendo do ambiente ou comportamento do provedor de regras.
3. definition é persistente e retornado como uma string codificada por JSON.
4. assignedGroups é retornado como uma matriz vazia ([]) quando nenhum grupo é resolvido no momento da criação.

{
  "id": 3684,
  "partitionGlobalId": "00000000-0000-0000-0000-000000000000",
  "name": "Test",
  "description": "Test",
  "enabled": true,
  "definition": "{\"GroupsToAssign\":[\"4d161738-7204-4794-b839-8f7fed28366c\"],\"Conditions\":[]}",
  "assignedGroups": []
}

Exemplo de solicitação

{
  "name": "Test",
  "description": "Test",
  "partitionGlobalId": "47a714db-cd27-4250-9668-2054e008c448",
  "enabled": true,
  "definition": "{\"GroupsToAssign\":[\"4d161738-7204-4794-b839-8f7fed28366c\"],\"Conditions\":[]}"
}

Respostas de erro

• 400 Bad Request: corpo da solicitação inválido ou erros de validação
• 401 Unauthorized: token de autenticação ausente ou inválido
• 403 Forbidden: permissões insuficientes
• 404 Not Found: a organização não existe