Atualizar regra

Ponto de extremidade da API Atualizar regra para modificar uma regra de provisionamento SAML existente no Test Cloud no Automation Cloud.

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