ルールを作成

組織内に新しい認可ルールを作成します。

エンドポイント

POST /api/Rule

要求本文

フィールド	入力	Required	説明
name	文字列	はい	ルールの名前です。
description	文字列	いいえ	ルールの目的の説明です。
enabled	Boolean	はい	ルールがアクティブかどうかを示します。
definition	文字列	いいえ	ルールの定義です。JSON エンコード形式の文字列として表されます。
partitionGlobalId	GUID	はい	組織のグローバル識別子です。 partitionGlobalId を取得する手順については、「API で使用するために partitionGlobalId を取得する」をご覧ください。

要求ヘッダー

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

応答

注:

1. 応答では、作成されたルールは RuleDto として返されます。これには、生成されたid も含まれます。
2. partitionGlobalId は、環境またはルールのプロバイダーの動作によっては、ゼロの GUID として返される場合があります。
3. definition は永続化され、JSON エンコード形式の文字列として返されます。
4. assignedGroups は、作成時にグループが解決されない場合、空の配列 ([]) として返されます。

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

要求の例

{
  "name": "Test",
  "description": "Test",
  "partitionGlobalId": "47a714db-cd27-4250-9668-2054e008c448",
  "enabled": true,
  "definition": "{\"GroupsToAssign\":[\"4d161738-7204-4794-b839-8f7fed28366c\"],\"Conditions\":[]}"
}

エラー応答

• 400 Bad Request: 要求の本文が無効か、検証エラーです。
• 401 Unauthorized: 認証トークンが存在しないか無効です。
• 403 Forbidden: 権限が不十分です。
• 404 Not Found: 組織が存在しません。