Atualizar regra

Atualiza uma regra de provisionamento SAML existente.

Endpoint

PUT /api/Rule

Corpo da Solicitação

Campo	Tipo	Required	Description
ruleId	Número inteiro	Sim	O identificador exclusivo da regra que será atualizada
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.
name	String	Sim	Nome da regra atualizado
description	String	Não	Descrição atualizada
enabled	Booleano	Sim	Se a regra está ativa
definition	String	Não	A definição de regra

Cabeçalhos de solicitação.

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

Resposta

Observação:

O endpoint Atualizar regra não retorna um RuleDto. Os grupos atribuídos não são retornados.

{
  "id": 3685,
  "name": "Test",
  "description": "Test",
  "enabled": true,
  "partitionId": 28728,
  "definition": "{\"GroupsToAssign\":[\"4d161738-7204-4794-b839-8f7fed28366c\"],\"Conditions\":[]}",
  "creationTime": "2026-01-29T16:09:41.7203623",
  "lastModificationTime": "2026-01-29T16:11:18.691478Z"
}

Exemplo de solicitação

{
  "ruleId": 3685,
  "partitionGlobalId": "{{prtId}}",
  "name": "Test",
  "description": "Test",
  "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 ou regra não existe