Aktualisieren Sie die Regel

PUT-Endpunkt zum Aktualisieren einer vorhandenen SAML-Bereitstellungsregel mit Anforderungsheadern, Textstruktur und bekannten Antwortbeschränkungen.

Aktualisiert eine vorhandene SAML-Bereitstellungsregel.

Endpoint

PUT /api/Rule

Anforderungstext

Feld	Typ	Erforderlich	Beschreibung
ruleId	Integer	Ja	Der eindeutige Bezeichner der zu aktualisierenden Regel
partitionGlobalId	GUID	Ja	Der globale Bezeichner der Organisation. Schritte zum Abrufen von partitionGlobalId finden Sie unter Abrufen von partitionGlobalId für die API-Verwendung.
name	String	Ja	Aktualisierter Name der Regel
description	String	Nein	Beschreibung wurde aktualisiert
enabled	Boolescher	Ja	Ob die Regel aktiv ist
definition	String	Nein	Die Regeldefinition

Anforderungsheader

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

Antworten

Hinweis:

Der Endpunkt der Aktualisierungsregel gibt kein RuleDto zurück. Zugewiesene Gruppen werden nicht zurückgegeben.

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

Beispielanforderung

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

Fehlerantworten

• 400 Bad Request: Ungültiger Anforderungstext oder Validierungsfehler
• 401 Unauthorized: Fehlendes oder ungültiges Authentifizierungstoken
• 403 Forbidden: Unzureichende Berechtigungen
• 404 Not Found: Organisation oder Regel ist nicht vorhanden