Rufen Sie eine einzelne Regel ab

API-Endpunkt, der eine einzelne SAML-Bereitstellungsregel anhand ihrer ID abruft, mit vollständiger Feldauflösung, im Gegensatz zum Massenendpunkt.

Ruft eine SAML-Bereitstellungsregel anhand ihrer ID innerhalb einer Organisation ab.

Endpoint

GET /api/Rule/{partitionGlobalId}/{ruleId}

Anforderungsheader

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

Parameter

Name	Typ	Ort	Erforderlich	Beschreibung
partitionGlobalId	GUID	Pfad	Ja	Der globale Bezeichner der Organisation. Schritte zum Abrufen von partitionGlobalId finden Sie unter Abrufen von partitionGlobalId für die API-Verwendung.
ruleId	Integer	Pfad	Ja	Der eindeutige Bezeichner der Regel

Antworten

Hinweis:

• Im Gegensatz zum Endpunkt Get Rules in Bulk löst der Endpunkt Get Rule assignedGroups als vollständige Gruppenobjekte auf.
• definition wird als JSON-codierter String zurückgegeben, nicht als geparstes Objekt.
• Optionale Felder, z. B. description, können als leere Zeichenfolgen zurückgegeben werden.
• groupType wird als numerischer Wert zurückgegeben (enum-backed).
• Zusätzliche Felder, z. B. mappedRole und scope, können je nach Gruppentyp und Umgebung vorhanden sein.

{
  "id": 2607,
  "partitionGlobalId": "00000000-0000-0000-0000-000000000000",
  "name": "Automation Users",
  "description": "",
  "enabled": true,
  "definition": "{\"GroupsToAssign\":[\"cdc34b5b-77d2-4ae1-9744-209d21ce557d\"],\"Conditions\":[{\"ClaimName\":\"http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress\",\"ConditionType\":\"Contains\",\"Value\":\"uipath.com\"}]}",
  "assignedGroups": [
    {
      "id": "cdc34b5b-77d2-4ae1-9744-209d21ce557d",
      "name": "Automation Users",
      "displayName": "Automation Users",
      "type": 0,
      "creationTime": "2021-01-22T16:29:33.7917688",
      "lastModificationTime": "2021-01-22T16:29:33.7917689",
      "members": [],
      "mappedRole": null,
      "scope": null
    }
  ]
}

Beispielanforderung

{
  "id": 2607,
  "partitionGlobalId": "00000000-0000-0000-0000-000000000000",
  "name": "Automation Users",
  "description": "",
  "enabled": true,
  "definition": "{\"GroupsToAssign\":[\"cdc34b5b-77d2-4ae1-9744-209d21ce557d\"],\"Conditions\":[{\"ClaimName\":\"http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress\",\"ConditionType\":\"Contains\",\"Value\":\"uipath.com\"}]}" ,
  "assignedGroups": [
    {
      "id": "cdc34b5b-77d2-4ae1-9744-209d21ce557d",
      "name": "Automation Users",
      "displayName": "Automation Users",
      "type": 0,
      "creationTime": "2021-01-22T16:29:33.7917688",
      "lastModificationTime": "2021-01-22T16:29:33.7917689",
      "members": []
    }
  ]
}