Regel erstellen

Erstellen Sie eine Autorisierungsregel innerhalb einer Organisation mithilfe des Endpunkts POST /api/Rule und geben Sie die generierte Regel-ID in der Antwort zurück.

Erstellt eine neue Autorisierungsregel innerhalb einer Organisation.

Endpoint

POST /api/Rule

Anforderungstext

Feld	Typ	Erforderlich	Beschreibung
name	String	Ja	Name der Regel
description	String	Nein	Beschreibung des Zwecks der Regel
enabled	Boolescher	Ja	Ob die Regel aktiv ist
definition	String	Nein	Die Regeldefinition, ausgedrückt als JSON-codierte Zeichenfolge.
partitionGlobalId	GUID	Ja	Der globale Bezeichner der Organisation. Schritte zum Abrufen von partitionGlobalId finden Sie unter Abrufen von partitionGlobalId für die API-Verwendung.

Anforderungsheader

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

Antworten

Hinweis:

1. Die Antwort gibt die erstellte Regel als RuleDto zurück, einschließlich des generierten id.
2. partitionGlobalId kann je nach Umgebung oder Verhalten des Regelanbieters als Null-GUID zurückgegeben werden.
3. definition wird beibehalten und als JSON-codierte Zeichenfolge zurückgegeben.
4. assignedGroups wird als leeres Array ([]) zurückgegeben, wenn zum Zeitpunkt der Erstellung keine Gruppen aufgelöst werden.

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

Beispielanforderung

{
  "name": "Test",
  "description": "Test",
  "partitionGlobalId": "47a714db-cd27-4250-9668-2054e008c448",
  "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 ist nicht vorhanden