Actualizar regla

Punto final PUT para actualizar una regla de aprovisionamiento SAML existente, con encabezados de solicitud, estructura del cuerpo y limitaciones de respuesta conocidas.

Actualiza una regla de aprovisionamiento SAML existente.

PuntoFinal

PUT /api/Rule

Solicitar cuerpo

Campo	Tipo	Obligatorio	Descripción
ruleId	Entero	Sí	El identificador único de la regla que se actualizará
partitionGlobalId	GUID	Sí	El identificador global de la organización. Para conocer los pasos para recuperar partitionGlobalId, consulta Recuperar IDGlobalDePartición para uso de la API.
name	Cadena	Sí	Nombre actualizado de la regla
description	Cadena	No	Descripción actualizada
enabled	Booleano	Sí	Si la regla está activa
definition	Cadena	No	La definición de la regla

Solicitar encabezados.

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

Respuesta

Nota:

El punto final Actualizar regla no devuelve un RuleDto. Los grupos asignados no se devuelven.

{
  "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"
}

Solicitud de ejemplo

{
  "ruleId": 3685,
  "partitionGlobalId": "{{prtId}}",
  "name": "Test",
  "description": "Test",
  "enabled": true,
  "definition": "{\"GroupsToAssign\":[\"4d161738-7204-4794-b839-8f7fed28366c\"],\"Conditions\":[]}"
}

Respuestas de error

• 400 Bad Request: Cuerpo de solicitud no válido o errores de validación
• 401 Unauthorized: Token de autenticación faltante o no válido
• 403 Forbidden: permisos insuficientes
• 404 Not Found: la organización o regla no existe