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

IDで識別されるアイデンティティ・コレクションを更新

put

/access-governance/access-controls/20250331/identityCollections/{identityCollectionId}

アイデンティティ・コレクションを更新

リクエスト

パス・パラメータ
ヘッダー・パラメータ
  • トレース用のクライアント・リクエストID。 リクエストIDに有効な文字は、文字、数字、アンダースコアおよびダッシュのみです。
本文()
更新する情報。
ルート・スキーマ : UpdateIdentityCollectionDetails
型: object
更新する情報。
ソースを表示
ネストされたスキーマ : AGRiskModel
型: object
Access GovernanceエンティティのriskLevelホルダー
ソースを表示
ネストされたスキーマ : customAttributes
型: object
アイデンティティ・コレクションに関連付けられたメタデータ。
ソースを表示
ネストされたスキーマ : excludedIdentities
型: array
除外されたアイデンティティのリスト。
ソースを表示
ネストされたスキーマ : includedIdentities
型: array
含まれるアイデンティティのリスト。
ソースを表示
ネストされたスキーマ : orchestratedSystemMetadataAttributes
型: array
オーケストレート済システム構成のリスト。
ソースを表示
ネストされたスキーマ: owner
型: array
所有者エンティティのリスト。
ソースを表示
ネストされたスキーマ: tags
型: array
アイデンティティ・コレクションに添付されたタグのリスト。
ソースを表示
ネストされたスキーマ : customAttributes
型: object
アクセス・ガバナンス・エンティティのriskLevelに関連付けられたメタデータ
ソースを表示
ネストされたスキーマ : 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
エラー情報。
ソースを表示

412レスポンス

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

429レスポンス

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

500レスポンス

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

デフォルト・レスポンス

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

例

次の例は、アイデンティティ・コレクションの更新方法を示しています。 この例では、作成例の拡張として、アイデンティティ・コレクションから少数のメンバーを除外します。

ノート:

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

cURLの例

curl -i -L -X PUT \
   -H "Authorization:Bearer <your-access-token>" \
   -H "Content-Type:application/json" \
   -d \
'{
  "name": "Networking Team",
  "description": "Networking Team for Infrastructure",
  "includedIdentities": [],
  "membershipRule": "all { domainOCID EQ ocid1.domain.oc1..aaaaaaaa64xxxxxxgsgdxn36e6pcunmzktgka }",
  "excludedIdentities": [
    {
      "id": "globalId.OCI.1245xxxx-b600-48eb-a9b1-xxxxxxxxxxxx",
      "name": "Michael Carter"
    }
  ],
  "owners": [
    {
      "id": "globalId.OCI.f101xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.daxxxxxx",
      "name": "Sophia Johnson",
      "isPrimary": true
    }
  ],
  "tags": [
    "Networking Infrastructure"
  ],
  "displayName": "Networking Team",
  "isManagedAtOrchestratedSystem": false
}' \
 '<${service-instance-url}/access-governance/access-controls/20250331/identityCollections/${identityCollectionsID}>'

リクエスト・ペイロードの例

{
  "name": "Networking Team",
  "description": "Networking Team for Infrastructure",
  "includedIdentities": [],
  "membershipRule": "all { domainOCID EQ ocid1.domain.oc1..aaaaaaaa64xxxxxxgsgdxn36e6pcunmzktgka }",
  "excludedIdentities": [
    {
      "id": "globalId.OCI.1245xxxx-b600-48eb-a9b1-xxxxxxxxxxxx",
      "name": "Michael Carter"
    }
  ],
  "owners": [
    {
      "id": "globalId.OCI.f101xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.daxxxxxx",
      "name": "Sophia Johnson",
      "isPrimary": true
    }
  ],
  "tags": [
    "Networking Infrastructure"
  ],
  "displayName": "Networking Team",
  "isManagedAtOrchestratedSystem": false
}

レスポンス本文の例

JSON形式のレスポンス本文のコンテンツの例を次に示します。

{
    "id": "1d8fxxxx-acee-45b1-a6ca-18b9xxxxx",
    "name": "Networking Team",
    "description": "Networking Team for Infrastructure",
    "status": "ACTIVE",
    "orchestratedSystemId": null,
    "membershipRule": "all { domainOCID EQ ocid1.domain.oc1..aaaaaaaa64xxxxxxgsgdxn36e6pcunmzktgka }",
    "parsedMembers": null,
    "parsedIdentityRule": {
        "bindingOperator": "ALL",
        "parsedOn": "2550790010577879",
        "attributeConditions": [
            {
                "attrKey": {
                    "id": "domainOCID",
                    "name": "Domain OCID",
                    "displayName": "Domain OCID"
                },
                "operator": {
                    "id": "EQ",
                    "name": "EQ",
                    "displayName": "Equals"
                },
                "attrValue": "ocid1.domain.oc1..aaaaaaaa64xxxxxxgsgdxn36e6pcunmzktgka",
                "attrType": "string",
                "parentType": null,
                "parentId": null,
                "values": null
            }
        ]
    },
    "includedIdentities": [],
    "excludedIdentities": [
        {
            "id": "globalId.OCI.1245xxxx-b600-48eb-a9b1-xxxxxxxxxxxx",
            "name": "Michael Carter",
            "userLogin": "michael.carter@example.com",
            "email": "michael.carter@example.com",
            "manager": null,
            "organization": null,
            "isRuleBased": false,
            "jobCode": null,
            "location": null,
            "employeeType": null,
            "agOrganizations": null
        }
    ],
    "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-13T09:02:31.972Z",
    "identityGroupType": "HUMAN",
    "finalIdentities": [],
    "tags": [
        "Networking Infrastructure"
    ],
    "customAttributes": null,
    "externalId": null,
    "displayName": "Networking Team",
    "isManagedAtOrchestratedSystem": false,
    "orchestratedSystemMetadataAttributes": []
}
先頭に戻る