単一のルールを取得する

組織内の SAML プロビジョニング ルールを ID で取得します。

エンドポイント

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

要求ヘッダー

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

パラメーター

名前	入力	場所	Required	説明
partitionGlobalId	GUID	パス	はい	組織のグローバル識別子です。 partitionGlobalId を取得する手順については、「API で使用するために partitionGlobalId を取得する」をご覧ください。
ruleId	Integer	パス	はい	ルールの一意の識別子です。

応答

注:

• ルールを一括で取得のエンドポイントとは異なり、ルールを取得のエンドポイントでは、assignedGroups は完全なグループ オブジェクトとして解決されます。
• definition は、解析されたオブジェクトとしてではなく、JSON エンコード形式の文字列として返されます。
• description などの任意のフィールドは、空の文字列として返される場合があります。
• groupType は、数値 (定数値が入った列挙型) として返されます。
• グループの種類や環境によっては、mappedRole や scope などの追加のフィールドが存在する場合があります。

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

要求の例

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