Obtenir une règle unique

Point de terminaison d'API qui récupère une seule règle d'enregistrement SAML par son ID, avec une résolution complète du champ contrairement au point de terminaison groupé.

Récupère une règle d'enregistrement SAML par son ID au sein d'une organisation.

Endpoint

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

En-têtes de requête.

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

Paramètres

Nom	Saisie de texte	Emplacement	Requis	Description
partitionGlobalId	GUID	Chemin d'accès	Oui (Yes)	L’identifiant global de l’organisation. Pour obtenir des étapes sur la récupération partitionGlobalId, consultez la section Récupération de l’ID partitionGlobalId pour utiliser l’API.
ruleId	Entier	Chemin d'accès	Oui (Yes)	Identificateur unique de la règle

Réponses

Remarque :

• Contrairement au point de terminaison Obtenir les règles en bloc , le point de terminaison Obtenir la règle résout assignedGroups en tant qu'objets de groupe complets.
• definition est renvoyé sous la forme d’une chaîne encodée en JSON, pas en tant qu’objet analysé.
• Les champs facultatifs, tels que description, peuvent être renvoyés sous forme de chaînes vides.
• groupType est renvoyé sous la forme d'une valeur numérique.
• Des champs supplémentaires, tels que mappedRole et scope, peuvent être présents en fonction du type de groupe et de l'environnement.

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

Exemple de requête

{
  "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": []
    }
  ]
}