機械翻訳について
  1. Oracle Access Governance REST APIs
  2. タスク
  3. IdentityCollections

新しいアイデンティティ・コレクションを作成

post

/access-governance/access-controls/20250331/identityCollections

リクエスト

ヘッダー・パラメータ
  • トレース用のクライアント・リクエストID。 リクエストIDに有効な文字は、文字、数字、アンダースコアおよびダッシュのみです。
本文()
新しいアイデンティティ・コレクションの詳細。
ルート・スキーマ : CreateIdentityCollectionDetails
型: object
新規アイデンティティ・コレクションの作成に必要なモデル。
ソースを表示
ネストされたスキーマ : customAttributes
型: object
アイデンティティ・コレクションに関連付けられたメタデータ。
ソースを表示
ネストされたスキーマ : excludedIdentities
型: array
除外されたアイデンティティのリスト。
ソースを表示
ネストされたスキーマ : includedIdentities
型: array
含まれるアイデンティティのリスト。
ソースを表示
ネストされたスキーマ : orchestratedSystemMetadataAttributes
型: array
オーケストレート済システム構成のリスト。
ソースを表示
ネストされたスキーマ: owner
型: array
所有者エンティティのリスト。
ソースを表示
ネストされたスキーマ: tags
型: array
アイデンティティ・コレクションに添付されたタグのリスト。
ソースを表示
ネストされたスキーマ : IdInfo
型: object
汎用識別情報オブジェクト。
ソースを表示
ネストされたスキーマ : OrchestratedSystemMetadataAttributes
型: object
オーケストレート済システム・メタデータ属性モデル。
ソースを表示
ネストされたスキーマ : OrchestratedSystemAttributes
型: object
オーケストレーション・システム属性メタデータに関する情報
ソースを表示
ネストされたスキーマ: items
型: array
アカウントと権限属性のコレクション
ソースを表示
ネストされたスキーマ : OrchestratedSystemAttribute
型: object
アカウントおよび権限の属性
ソースを表示
ネストされたスキーマ : accountAttributes
型: array
オーケストレーション・システム・アカウント属性のリスト
ソースを表示
ネストされたスキーマ : 情報
型: object
汎用情報オブジェクト。
ソースを表示
ネストされたスキーマ : permissionAttributes
型: array
オーケストレーション・システム権限属性のリスト
ソースを表示
ネストされたスキーマ : OrchestratedSystemAttributeData
型: object
オーケストレーション・システム属性
ソースを表示
ネストされたスキーマ: children
型: array
ネストされた属性
ソースを表示
ネストされたスキーマ : defaultValues
型: array
属性値
ソースを表示
ネストされたスキーマ : NestedAttributes
型: object
オーケストレーション・システム属性のネストされたセット
ソースを表示
ネストされたスキーマ: items
型: array
オーケストレーションされたシステム属性
ソースを表示
ネストされたスキーマ : OwnerSummary
型: object
所有者エンティティ・オブジェクト
ソースを表示
トップに戻る

レスポンス

サポートされているメディア・タイプ

200レスポンス

アイデンティティ・グループが正常に作成されました。
ヘッダー
  • オプティミスティックな同時実行性制御用。 `if-match`を参照してください。
  • リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。
本文()
ルート・スキーマ : IdentityCollectionResponse
型: object
アイデンティティ収集モデル。
ソースを表示
ネストされたスキーマ : IdInfo
型: object
汎用識別情報オブジェクト。
ソースを表示
ネストされたスキーマ : customAttributes
型: object
ポリシー・ルールに関連付けられたメタデータ。
ソースを表示
ネストされたスキーマ : excludedIdentities
型: array
除外されたアイデンティティのリスト。
ソースを表示
ネストされたスキーマ : finalIdentities
型: array
最後のアイデンティティのリスト。
ソースを表示
ネストされたスキーマ : includedIdentities
型: array
含まれるアイデンティティのリスト。
ソースを表示
ネストされたスキーマ : orchestratedSystemMetadataAttributes
型: array
オーケストレート済システム構成のリスト。
ソースを表示
ネストされたスキーマ: owner
型: array
所有者エンティティのリスト。
ソースを表示
ネストされたスキーマ : ParsedIdentityRuleResponse
型: object
解析されたメンバーシップ・ルール・オブジェクト。
ソースを表示
ネストされたスキーマ : parsedMembers
型: array
解析されたIDのリスト。
ソースを表示
ネストされたスキーマ: tags
型: array
アイデンティティ・コレクションに添付されたタグのリスト。
ソースを表示
ネストされたスキーマ : IdentitySummary
型: object
アイデンティティ・サマリー。
ソースを表示
ネストされたスキーマ : agOrganizations
型: array
アイデンティティが含まれるAGOrganizations。
ソースを表示
ネストされたスキーマ : OrchestratedSystemMetadataAttributes
型: object
オーケストレート済システム・メタデータ属性モデル。
ソースを表示
ネストされたスキーマ : OrchestratedSystemAttributes
型: object
オーケストレーション・システム属性メタデータに関する情報
ソースを表示
ネストされたスキーマ: items
型: array
アカウントと権限属性のコレクション
ソースを表示
ネストされたスキーマ : OrchestratedSystemAttribute
型: object
アカウントおよび権限の属性
ソースを表示
ネストされたスキーマ : accountAttributes
型: array
オーケストレーション・システム・アカウント属性のリスト
ソースを表示
ネストされたスキーマ : 情報
型: object
汎用情報オブジェクト。
ソースを表示
ネストされたスキーマ : permissionAttributes
型: array
オーケストレーション・システム権限属性のリスト
ソースを表示
ネストされたスキーマ : OrchestratedSystemAttributeData
型: object
オーケストレーション・システム属性
ソースを表示
ネストされたスキーマ: children
型: array
ネストされた属性
ソースを表示
ネストされたスキーマ : defaultValues
型: array
属性値
ソースを表示
ネストされたスキーマ : NestedAttributes
型: object
オーケストレーション・システム属性のネストされたセット
ソースを表示
ネストされたスキーマ: items
型: array
オーケストレーションされたシステム属性
ソースを表示
ネストされたスキーマ : OwnerSummary
型: object
所有者エンティティ・オブジェクト
ソースを表示
ネストされたスキーマ : attributeConditions
型: array
属性条件
ソースを表示
ネストされたスキーマ : AttributeConditionResponse
型: object
属性条件
ソースを表示
ネストされたスキーマ: values
型: array
複数値演算子の属性値
ソースを表示

400レスポンス

不正なリクエスト
ヘッダー
  • リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。
本文()
ルート・スキーマ : Error
型: object
エラー情報。
ソースを表示

401レスポンス

未認可
ヘッダー
  • リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。
本文()
ルート・スキーマ : Error
型: object
エラー情報。
ソースを表示

404レスポンス

見つかりません
ヘッダー
  • リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。
本文()
ルート・スキーマ : Error
型: object
エラー情報。
ソースを表示

409レスポンス

競合
ヘッダー
  • リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。
本文()
ルート・スキーマ : Error
型: object
エラー情報。
ソースを表示

429レスポンス

リクエストが多すぎます
ヘッダー
  • リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。
本文()
ルート・スキーマ : Error
型: object
エラー情報。
ソースを表示

500レスポンス

内部サーバー・エラー
ヘッダー
  • リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。
本文()
ルート・スキーマ : Error
型: object
エラー情報。
ソースを表示

デフォルト・レスポンス

不明なエラー
ヘッダー
  • リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。
本文()
ルート・スキーマ : Error
型: object
エラー情報。
ソースを表示
トップに戻る

例

次の例は、Oracle Access Governanceでアイデンティティ・コレクションを作成する方法を示しています。 サンプル・コマンドを実行する前に、プレースホルダー値を実際の値に置き換えます。 アイデンティティ・コレクションにアイデンティティが含まれていない場合、新しいアイデンティティ・コレクションは「失敗しました」ステータスで作成されます。

ノート:

grant_type = passwordまたは認可コードを使用してアクセス・トークンを生成します。

アイデンティティ・コレクションを作成する前に、リスト・アイデンティティを実行 - [GET]必要なデータをフェッチするための{BasePath}/identities。

cURLリクエストの例 - 指定アイデンティティのみ

curl -i -X POST \
   -H "Authorization:Bearer <your-access-token>" \
   -H "Content-Type:application/json" \
   -d \
'{
  "name": "HR Operations Test Team",
  "description": "Human Resources Operations Department",
  "includedIdentities": [
    {
      "id": "globalId.OCI.f101xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.6axxxxxx",
      "name": "john.doe@example.com",
      "displayName": "John Doe"
    },
    {
      "id": "globalId.OCI.f101xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.17xxxxxx",
      "name": "emma.smith@example.com",
      "displayName": "Emma Smith"
    }
  ],
  "membershipRule": "",
  "excludedIdentities": [],
  "owners": [
    {
      "id": "globalId.OCI.f101xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.daxxxxxx",
      "name": "Sophia Johnson",
      "isPrimary": true
    }
  ],
  "tags": [
    "HR Operations"
  ],
  "displayName": "HR Operations Team",
  "isManagedAtOrchestratedSystem": false
}' \
 '<${service-instance-url}/access-governance/access-controls/${version}/identityCollections>'

リクエスト・ペイロードの例 - 指定アイデンティティのみ

{
  "name": "HR Operations Test Team",
  "description": "Human Resources Operations Department",
  "includedIdentities": [
    {
      "id": "globalId.OCI.f101xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.6axxxxxx",
      "name": "john.doe@example.com",
      "displayName": "John Doe"
    },
    {
      "id": "globalId.OCI.f101xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.17xxxxxx",
      "name": "emma.smith@example.com",
      "displayName": "Emma Smith"
    }
  ],
  "membershipRule": "",
  "excludedIdentities": [],
  "owners": [
    {
      "id": "globalId.OCI.f101xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.daxxxxxx",
      "name": "Sophia Johnson",
      "isPrimary": true
    }
  ],
  "tags": [
    "HR Operations"
  ],
  "displayName": "HR Operations Team",
  "isManagedAtOrchestratedSystem": false
}

レスポンス・コードの例

アイデンティティ・コレクションの作成には数秒かかる場合があります。 リクエストを中断しないでください。

次のレスポンス本文とともに200 OKレスポンスを受信します:

{
    "id": "58e7xxxx-46b9-4f8b-81ee-ed30xxxxxx",
    "name": "HR Operations Team",
    "description": "Human Resources Operations Department",
    "status": "ACTIVE",
    "orchestratedSystemId": null,
    "membershipRule": "",
    "parsedMembers": [],
    "parsedIdentityRule": null,
    "includedIdentities": [
        {
            "id": "globalId.OCI.f101xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.6axxxxxx",
            "name": "john.doe@example.com",
            "userLogin": "john.doe@example.com",
            "email": "john.doe@example.com",
            "manager": null,
            "organization": null,
            "isRuleBased": false,
            "jobCode": null,
            "location": null,
            "employeeType": null,
            "agOrganizations": null
        },
        {
            "id": "globalId.OCI.f101xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.17xxxxxx",
            "name": "emma.smith@example.com",
            "userLogin": "emma.smith@example.com",
            "email": "emma.smith@example.com",
            "manager": null,
            "organization": null,
            "isRuleBased": false,
            "jobCode": null,
            "location": null,
            "employeeType": null,
            "agOrganizations": null
        }
    ],
    "excludedIdentities": [],
    "ownershipCollectionId": "ff0bxxxx-78a2-4741-88c3-277xxxxx3d4b",
    "owners": [
        {
            "id": "globalId.OCI.f101xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.daxxxxxx",
            "name": "Sophia Johnson",
            "isPrimary": true
        }
    ],
    "createdBy": {
        "id": "clientId.AG-xxxxxx-cm-jun-28-xxxxx_APPID.AG-xxxxxx-cm-jun-28-xxxxx",
        "name": "clientId.AG-xxxxxx-cm-jun-28-xxxxx_APPID.AG-xxxxxx-cm-jun-28-xxxxx",
        "displayName": "System Generated"
    },
    "updatedBy": {
        "id": "clientId.AG-xxxxxx-cm-jun-28-xxxxx_APPID.AG-xxxxxx-cm-jun-28-xxxxx",
        "name": "clientId.AG-xxxxxx-cm-jun-28-xxxxx_APPID.AG-xxxxxx-cm-jun-28-xxxxx",
        "displayName": "System Generated"
    },
    "timeCreated": "2025-06-12T16:05:33.569Z",
    "timeUpdated": "2025-06-12T16:05:33.569Z",
    "identityGroupType": "HUMAN",
    "finalIdentities": null,
    "tags": ["HR Operations"],
    "customAttributes": null,
    "externalId": null,
    "displayName": "HR Operations Team",
    "isManagedAtOrchestratedSystem": false,
    "orchestratedSystemMetadataAttributes": []
}

リクエスト・ペイロードの例 - メンバーシップ・ルールの使用

{
  "name": "Networking Group",
  "description": "Networking Team for Infrastructure",
  "includedIdentities": [],
  "membershipRule": "all { department EQ 0865 , agOrganizations.displayName EQ Network Administrators }",
  "excludedIdentities": [],
  "owners": [
    {
      "id": "globalId.OCI.f101xxxx-xxxx-xxxx-xxxx-xxxx3765xxxx.daxxxxxx",
      "name": "Ama Maclead",
      "isPrimary": true
    }
  ],
  "tags": [
    "Networking Infrastructure"
  ],
  "displayName": "Networking Team",
  "isManagedAtOrchestratedSystem": false
}

レスポンス・コードの例

ロールの作成には数秒かかる場合があります。 リクエストを中断しないでください。

次のレスポンス本文とともに200 OKレスポンスを受信します:

{
    "id": "1d8fxxxx-acee-45b1-a6ca-18b9xxxxx",
    "name": "Networking Team",
    "description": "Networking Team for Infrastructure",
    "status": "IN_PROGRESS",
    "orchestratedSystemId": null,
    "membershipRule": "all { department EQ 0865 , agOrganizations.displayName EQ Network Administrators }",
    "parsedMembers": null,
    "parsedIdentityRule": {
        "bindingOperator": "ALL",
        "parsedOn": "2549970323079902",
        "attributeConditions": [
            {
                "attrKey": {
                    "id": "department",
                    "name": "Department",
                    "displayName": "Department"
                },
                "operator": {
                    "id": "EQ",
                    "name": "EQ",
                    "displayName": "Equals"
                },
                "attrValue": "0865",
                "attrType": "string",
                "parentType": null,
                "parentId": null,
                "values": null
            },
            {
                "attrKey": {
                    "id": "agOrganizations.displayName",
                    "name": "Organization",
                    "displayName": "Organization"
                },
                "operator": {
                    "id": "EQ",
                    "name": "EQ",
                    "displayName": "Equals"
                },
                "attrValue": "Network Administrators",
                "attrType": "string",
                "parentType": null,
                "parentId": "agOrganizations",
                "values": null
            }
        ]
    },
    "includedIdentities": [],
    "excludedIdentities": [],
    "ownershipCollectionId": "6687xxxx-6db7-4dc4-bb6f-5ceaxxxxx",
    "owners": [
        {
            "id": "globalId.OCI.f101xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.daxxxxxx",
            "name": "Sophia Johnson",
            "isPrimary": true
        }
    ],
    "createdBy": {
        "id": "clientId.AG-xxxxxx-cm-jun-28-xxxxx_APPID.AG-xxxxxx-cm-jun-28-xxxxx",
        "name": "clientId.AG-xxxxxx-cm-jun-28-xxxxx_APPID.AG-xxxxxx-cm-jun-28-xxxxx",
        "displayName": "System Generated"
    },
    "updatedBy": {
        "id": "clientId.AG-xxxxxx-cm-jun-28-xxxxx_APPID.AG-xxxxxx-cm-jun-28-xxxxx",
        "name": "clientId.AG-xxxxxx-cm-jun-28-xxxxx_APPID.AG-xxxxxx-cm-jun-28-xxxxx",
        "displayName": "System Generated"
    },
    "timeCreated": "2025-06-13T08:40:44.592Z",
    "timeUpdated": "2025-06-13T08:40:44.592Z",
    "identityGroupType": "HUMAN",
    "finalIdentities": null,
    "tags": [
        "Networking Infrastructure"
    ],
    "customAttributes": null,
    "externalId": null,
    "displayName": "Networking Team",
    "isManagedAtOrchestratedSystem": false,
    "orchestratedSystemMetadataAttributes": []
}
先頭に戻る