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

アクセス・バンドルの更新

put

/access-governance/access-controls/20250331/accessBundles/{accessBundleId}

既存のアクセス・バンドルの詳細を指定のIDで更新します。

リクエスト

パス・パラメータ
  • 指定されたIDのアクセス・バンドルの検索に使用されるフィルタ。 使用可能な値は、ListAccessBundles操作を使用して確認できます。
ヘッダー・パラメータ
  • オプティミスティックな同時実行性制御用。 リソースのPUTまたはDELETEコールで、`if-match`パラメータを、そのリソースの以前のGETまたはPOSTレスポンスからのetagの値に設定します。 リソースは、指定したetagがリソースの現在のetag値と一致する場合にのみ更新または削除されます。
  • トレース用のクライアント・リクエストID。 リクエストIDに有効な文字は、文字、数字、アンダースコアおよびダッシュのみです。
本文()
更新されたアクセス・バンドルの詳細。
ルート・スキーマ : UpdateAccessBundleDetails
型: object
更新する情報。
ソースを表示
ネストされたスキーマ : AccessBundleTimeLimit
型: object
時間制限の定義。 daysLimit、hoursLimitまたはdateTimeLimitのいずれか1つのみを指定する必要があります。
ソースを表示
ネストされたスキーマ : customAttributes
型: object
アクセス・バンドルに関連付けられたメタデータ。
ソースを表示
ネストされたスキーマ : OrchestratedSystemAttributeSummary
型: object
アカウント属性と権限属性。
ソースを表示
ネストされたスキーマ: owner
型: array
所有者エンティティのリスト。
ソースを表示
ネストされたスキーマ: tags
型: array
アクセス・バンドルに添付されたタグのリスト。
ソースを表示
ネストされたスキーマ : AccessBundleTimeLimitDays
型: object
時間制限の定義(日数)。
ソースを表示
ネストされたスキーマ : AccessBundleTimeLimitHours
型: object
時間制限の定義(時間)。
ソースを表示
ネストされたスキーマ : IdInfo
型: object
汎用識別情報オブジェクト。
ソースを表示
ネストされたスキーマ : accountAttributes
型: array
オーケストレーション済システム・アカウント属性のリスト。
ソースを表示
ネストされたスキーマ : permissionAttributes
型: array
オーケストレート済システム権限属性のリスト。
ソースを表示
ネストされたスキーマ : OrchestratedSystemAttributeDataSummary
型: object
オーケストレーション・システム属性
ソースを表示
ネストされたスキーマ: children
型: array
ネストされた属性
ソースを表示
ネストされたスキーマ: values
型: array
属性値
ソースを表示
ネストされたスキーマ : NestedAttributesSummary
型: object
オーケストレーション・システム属性のネストされたセット
ソースを表示
ネストされたスキーマ: items
型: array
オーケストレーションされたシステム属性
ソースを表示
ネストされたスキーマ : OwnerSummary
型: object
所有者エンティティ・オブジェクト
ソースを表示
トップに戻る

レスポンス

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

200レスポンス

更新されたアクセス・バンドル
ヘッダー
  • オプティミスティックな同時実行性制御用。 `if-match`を参照してください。
  • リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。
本文()
ルート・スキーマ : AccessBundle
型: object
バンドル・オブジェクトにアクセスします。
ソースを表示
ネストされたスキーマ : AccessGuardrailDetails
型: object
Guardrailオブジェクトにアクセスします。
ソースを表示
ネストされたスキーマ : AccessBundleTimeLimit
型: object
時間制限の定義。 daysLimit、hoursLimitまたはdateTimeLimitのいずれか1つのみを指定する必要があります。
ソースを表示
ネストされたスキーマ : IdInfo
型: object
汎用識別情報オブジェクト。
ソースを表示
ネストされたスキーマ : customAttributes
型: object
アクセス・バンドルに関連付けられたメタデータ。
ソースを表示
ネストされたスキーマ : OrchestratedSystemAttributeSummary
型: object
アカウント属性と権限属性。
ソースを表示
ネストされたスキーマ: owner
型: array
所有者エンティティのリスト。
ソースを表示
ネストされたスキーマ : 許可
型: array
権限のリスト
ソースを表示
ネストされたスキーマ: tags
型: array
アクセス・バンドルに添付されたタグのリスト。
ソースを表示
ネストされたスキーマ : AccessBundleTimeLimitDays
型: object
時間制限の定義(日数)。
ソースを表示
ネストされたスキーマ : AccessBundleTimeLimitHours
型: object
時間制限の定義(時間)。
ソースを表示
ネストされたスキーマ : accountAttributes
型: array
オーケストレーション済システム・アカウント属性のリスト。
ソースを表示
ネストされたスキーマ : permissionAttributes
型: array
オーケストレート済システム権限属性のリスト。
ソースを表示
ネストされたスキーマ : OrchestratedSystemAttributeDataSummary
型: object
オーケストレーション・システム属性
ソースを表示
ネストされたスキーマ: children
型: array
ネストされた属性
ソースを表示
ネストされたスキーマ: values
型: array
属性値
ソースを表示
ネストされたスキーマ : NestedAttributesSummary
型: object
オーケストレーション・システム属性のネストされたセット
ソースを表示
ネストされたスキーマ: items
型: array
オーケストレーションされたシステム属性
ソースを表示
ネストされたスキーマ : OwnerSummary
型: object
所有者エンティティ・オブジェクト
ソースを表示
ネストされたスキーマ : PermissionSummary
型: object
権限の説明。
ソースを表示
ネストされたスキーマ : PermissionTypeSummary
型: object
PermissionTypeサマリー。
ソースを表示
ネストされたスキーマ : ResourceSummary
型: object
資源要約
ソースを表示
ネストされたスキーマ : customAttributes
型: object
リソースに関連付けられたメタデータ
ソースを表示

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を使用してアクセス・トークンを生成します。 詳細は、「パスワード資格証明を使用した認証のBearerトークンの取得」を参照してください。

cURLリクエストの例

curl -i -X PUT \
   -H "Authorization:Bearer <your-access-token>" \
   -H "Content-Type:application/json" \
   -d \
'{
  "name": "DBUM Standard SQL Tuning Access UA - Update",
  "displayName": "DBUM AB UA API Update",
  "description": "DBUM AB UA API",
  "tags": ["DBUM UA"],
  "owners": [
    {
      "id": "globalId.125123c3-eedc-4d6a-b6d4-6c0f6537bad2.xxxxx",
      "name": "Amel MacLead",
      "isPrimary": true
    }
  ],
  "requestableBy": "ANY",
  "approvalWorkflowId": "NO_APPROVAL_REQUIRED",
  "orchestratedSystemId": "da7efca4-8c7a-4d4f-8ad3.xxxxx",
  "accessBundleType": "PERMISSION_BUNDLE",
  "verb": "string",
  "items": [
    {
      "id": "privileges.ICF.da7efca4-8c7a-4d4f-8ad3-c55ac9362de6.xxxxx",
      "name": "ADMINISTER ANY SQL TUNING SET"
    }
  ],
  "externalId": null,
  "domainName": null,
  "resourceType": null,
  "accountProfileId": "84321700-1a93-4cf2-9226-3f4c26fd.xxxxx",
  "accountProfileName": "dbum AP 1",
  "orchestratedSystemAttributes": {
    "accountAttributes": [],
    "permissionAttributes": [
      {
        "name": "privileges.ICF.da7efca4-8c7a-4d4f-8ad3-c55ac9362de6.xxxxx",
        "type": "RepeatableFieldSet",
        "title": null,
        "values": ["ADMINISTER ANY SQL TUNING SET"],
        "children": [
          {
            "items": [
              {
                "name": "privilegeAdminOption",
                "type": "String",
                "title": "dbum.targetAccount.armd.privileges.privilegeAdminOption.title",
                "children": [],
                "lookupType": "withAdminOption",
                "permissionType": "privileges",
                "discriminator": null,
                "values":["YES"]
              }
            ]
          }
        ],
        "discriminator": null,
        "isQuestion": true
      }
    ]
  },
  "customAttributes": {}
}' \
 '<${service-instance-url}/access-governance/access-controls/20250331/accessBundles/${accessBundleID}>'

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

{
  "name": "DBUM Standard SQL Tuning Access UA",
  "displayName": "DBUM AB UA API",
  "description": "DBUM AB UA API",
  "tags": ["DBUM UA"],
  "owners": [
    {
      "id": "globalId.125123c3-eedc-4d6a-b6d4-6c0f6537bad2.xxxxx",
      "name": "Amel MacLead",
      "isPrimary": true
    }
  ],
  "requestableBy": "ANY",
  "approvalWorkflowId": "NO_APPROVAL_REQUIRED",
  "orchestratedSystemId": "da7efca4-8c7a-4d4f-8ad3.xxxxx",
  "accessBundleType": "PERMISSION_BUNDLE",
  "verb": "string",
  "items": [
    {
      "id": "privileges.ICF.da7efca4-8c7a-4d4f-8ad3-c55ac9362de6.xxxxx",
      "name": "ADMINISTER ANY SQL TUNING SET"
    }
  ],
  "externalId": null,
  "domainName": null,
  "resourceType": null,
  "accountProfileId": "84321700-1a93-4cf2-9226-3f4c26fd.xxxxx",
  "accountProfileName": "dbum AP 1",
  "orchestratedSystemAttributes": {
    "accountAttributes": [],
    "permissionAttributes": [
      {
        "name": "privileges.ICF.da7efca4-8c7a-4d4f-8ad3-c55ac9362de6.xxxxx",
        "type": "RepeatableFieldSet",
        "title": null,
        "values": ["ADMINISTER ANY SQL TUNING SET"],
        "children": [
          {
            "items": [
              {
                "name": "privilegeAdminOption",
                "type": "String",
                "title": "dbum.targetAccount.armd.privileges.privilegeAdminOption.title",
                "children": [],
                "lookupType": "withAdminOption",
                ""permissionType": "privileges",
                "discriminator": null,
                "values":["YES"]
              }
            ]
          }
        ],
        "discriminator": null,
        "isQuestion": true
      }
    ]
  },
  "customAttributes": {}
}

レスポンス・コードの例

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

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

{
  "accessBundleType" : "PERMISSION_BUNDLE",
  "id" : "8307dc91-d378-41e0-8589-1e4812cd.xxxxx",
  "name" : "DBUM Standard SQL Tuning Access UA",
  "displayName" : "DBUM AB UA API",
  "description" : "DBUM AB UA API",
  "tags" : ["DBUM UA"],
  "timeCreated" : "2025-03-26T07:35:53.262Z",
  "timeUpdated" : "2025-03-26T07:35:53.262Z",
  "createdBy" : {
    "id" : "globalId.125123c3-eedc-4d6a-b6d4-6c0f6537bad2.xxxxx",
    "name" : "Ama Maclead",
    "displayName" : "Ama Maclead"
  },
  "updatedBy" : {
    "id" : "globalId.125123c3-eedc-4d6a-b6d4-6c0f6537bad2.xxxxx",
    "name" : "Ama Maclead",
    "displayName" : "Ama Maclead"
  },
  "requestableBy" : {
    "id" : "ANY",
    "name" : "Anyone",
    "displayName" : "Anyone"
  },
  "status" : "ACTIVE",
  "approvalWorkflowId" : {
    "id" : "NO_APPROVAL_REQUIRED",
    "name" : "No Approval Required",
    "displayName" : "No Approval Required"
  },
  "orchestratedSystem" : {
    "id" : "da7efca4-8c7a-4d4f-8ad3.xxxxx",
    "name" : "ownership-reviews-july-DBUM",
    "displayName" : "ownership-reviews-july-DBUM"
  },
  "orchestratedSystemType" : "ICF",
  "ownershipCollectionId" : "9ce09155-968f-46b0-98f0-b81313f4.xxxxx",
  "owners" : [
    {
      "id" : "globalId.125123c3-eedc-4d6a-b6d4-6c0f6537bad2.xxxxx",
      "name" : "Amel MacLead",
      "isPrimary" : true
    }
  ],
  "externalId" : "ocid1.agcsgovernanceinstance.dev.dev.amaaaaaapzw5rdia.xxxxx",
  "cloudAccountName" : null,
  "domainName" : null,
  "resourceType" : null,
  "compartmentName" : null,
  "compartmentFqn" : null,
  "orchestratedSystemAttributes" : {
    "accountAttributes" : [],
    "permissionAttributes" : [
      {
        "name" : "privileges.ICF.da7efca4-8c7a-4d4f-8ad3-c55ac9362de6.xxxxx",
        "title" : "ADMINISTER ANY SQL TUNING SET",
        "values" : null,
        "type" : "RepeatableFieldSet",
        "permissionType" : null,
        "children" : [
          {
            "items" : [
              {
                "name" : "privilegeAdminOption",
                "title" : "dbum.targetAccount.armd.privileges.privilegeAdminOption.title",
                "values" : null,
                "type" : "String",
                "permissionType" : null,
                "children" : [],
                "discriminator" : null,
                "isQuestion" : null
              }
            ]
          }
        ],
        "discriminator" : null,
        "isQuestion" : true
      }
    ]
  },
  "accountProfileId" : "84321700-1a93-4cf2-9226-3f4c26fd.xxxxx",
  "accountProfileName" : "dbum AP 1",
  "customAttributes" : {},
  "permissions" : [
    {
      "id" : "privileges.ICF.da7efca4-8c7a-4d4f-8ad3-c55ac9362de6.xxxxx",
      "name" : "ADMINISTER ANY SQL TUNING SET",
      "description" : null,
      "type" : "ENTITLEMENTS",
      "timeCreated" : "2024-09-25T13:02:20.369Z",
      "timeUpdated" : null,
      "resource" : {
        "id" : "resource.ICF.da7efca4-8c7a-4d4f-8ad3-c55ac9362de6.xxxxx",
        "name" : "ownership-reviews-july-DBUM",
        "displayName" : "ownership-reviews-july-DBUM",
        "type" : "DBUM",
        "customAttributes" : null
      },
      "permissionType" : {
        "id" : "etype.ICF.da7efca4-8c7a-4d4f-8ad3-c55ac9362de6.xxxxx",
        "name" : "icf.connector.entitlement.type.privileges",
        "displayName" : "Privilege",
        "externalId" : "privileges"
      }
    }
  ]
}
先頭に戻る