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

ポリシーの更新

put

/access-governance/access-controls/20250331/policies/{policyId}

指定されたIDで既存のポリシーの詳細を更新します。

リクエスト

パス・パラメータ
ヘッダー・パラメータ
  • トレース用のクライアント・リクエストID。 リクエストIDに有効な文字は、文字、数字、アンダースコアおよびダッシュのみです。
本文()
更新されたポリシーの詳細。
ルート・スキーマ : UpdatePolicyDetails
型: object
更新する情報
ソースを表示
ネストされたスキーマ : assignments
型: array
ポリシーに関連付けられた割当のリスト。
ソースを表示
ネストされたスキーマ : customAttributes
型: object
ポリシーに関連付けられたメタデータ
ソースを表示
ネストされたスキーマ: owner
型: array
所有者エンティティのリスト
ソースを表示
ネストされたスキーマ: tags
型: array
ポリシーに添付されたタグのリスト。
ソースを表示
ネストされたスキーマ : PolicyAssignment
型: object
PolicyAssignmentモデル。
ソースを表示
ネストされたスキーマ : accessBundles
型: array
アクセス・バンドルのリスト
ソースを表示
ネストされたスキーマ : customAttributes
型: object
権限アソシエーションに関連付けられたメタデータ
ソースを表示
ネストされたスキーマ : identityCollections
型: array
アイデンティティ・コレクションのリスト
ソースを表示
ネストされたスキーマ: roles
型: array
ロールのリスト
ソースを表示
ネストされたスキーマ : 情報
型: object
汎用情報オブジェクト。
ソースを表示
ネストされたスキーマ : OwnerSummary
型: object
所有者エンティティ・オブジェクト
ソースを表示
トップに戻る

レスポンス

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

200レスポンス

更新されたポリシー
ヘッダー
  • オプティミスティックな同時実行性制御用。 `if-match`を参照してください。
  • リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。
本文()
ルート・スキーマ: Policy
型: object
ポリシー・モデル。
ソースを表示
ネストされたスキーマ : assignments
型: array
権限関連に関連付けられたアサイメントのリスト。
ソースを表示
ネストされたスキーマ : IdInfo
型: object
汎用識別情報オブジェクト。
ソースを表示
ネストされたスキーマ : customAttributes
型: object
権限アソシエーションに関連付けられたメタデータ
ソースを表示
ネストされたスキーマ: owner
型: array
所有者エンティティのリスト
ソースを表示
ネストされたスキーマ: tags
型: array
権限関連に添付されたタグのリスト。
ソースを表示
ネストされたスキーマ : PolicyAssignment
型: object
PolicyAssignmentモデル。
ソースを表示
ネストされたスキーマ : accessBundles
型: array
アクセス・バンドルのリスト
ソースを表示
ネストされたスキーマ : customAttributes
型: object
権限アソシエーションに関連付けられたメタデータ
ソースを表示
ネストされたスキーマ : identityCollections
型: array
アイデンティティ・コレクションのリスト
ソースを表示
ネストされたスキーマ: roles
型: array
ロールのリスト
ソースを表示
ネストされたスキーマ : 情報
型: object
汎用情報オブジェクト。
ソースを表示
ネストされたスキーマ : OwnerSummary
型: object
所有者エンティティ・オブジェクト
ソースを表示

400レスポンス

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

401レスポンス

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

404レスポンス

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

429レスポンス

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

500レスポンス

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

デフォルト・レスポンス

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

例

次の例は、PUTリクエストを送信してポリシーを更新する方法を示しています。 この例では、作成例の拡張として、1つのアイデンティティ・コレクションをポリシーに保持します。

cURL例 - 問合せパラメータなし

curl -i -L -X PUT \
   -H "Authorization:Bearer <your-access-token>" \
   -H "Content-Type:application/json" \
   -d \
'{
  "name": "Admin DBUM Policy Update",
  "description": "Admin DBUM Policy Update",
  "submittedBy": "globalId.125123c3-xxx-4d6a-b6d4-xxx.18.xxx",
  "tags": [
    "DBUM UA Policy Update"
  ],
  "customAttributes": {},
  "displayName": "Admin Database Policy Update",
  "assignments": [
    {
      "assignmentId": "",
      "assignmentType": "ACCESS_BUNDLE",
      "identityType": "ALL",
      "identityCollections": [
        {
          "id": "a4b3dd4b-xxx-4d77-858c-xxx",
          "name": "Database Administrators"
        }
      ],
      "accessBundles": [
        {
          "id": "52fea7fb-xxx-4b1e-bc37-xxx",
          "name": "SQL Tuning Access"
        },
        {
          "id": "45ed5c4c-xxx-4e80-ba1c-xxx",
          "name": "DBUM Standard SQL Tuning Access UA2"
        },
        {
          "id": "xxx-xxx-xxx-xxx-xxx",
          "name": "Oracle DBUM Performance Admin Access"
        }
      ]
    }
  ],
  "owners": [
    {
      "id": "globalId.125123c3-xxx-4d6a-b6d4-xxx.18.xxx",
      "name": "Amel Maclead",
      "isPrimary": true
    }
  ]
}' \
 '<${service-instance-url}/access-governance/access-controls/20250331/policies/${policyID}>'

PUTリクエストの発行

${service-instance-url}/access-governance/access-controls/${version}/policies/${policyID}

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

{
  "name": "Admin DBUM Policy Update",
  "description": "Admin DBUM Policy Update",
  "submittedBy": "globalId.125123c3-xxx-4d6a-b6d4-xxx.18.xxx",
  "tags": [
    "DBUM UA Policy Update"
  ],
  "customAttributes": {},
  "displayName": "Admin Database Policy Update",
  "assignments": [
    {
      "assignmentId": "",
      "assignmentType": "ACCESS_BUNDLE",
      "identityType": "ALL",
      "identityCollections": [
        {
          "id": "a4b3dd4b-xxx-4d77-858c-xxx",
          "name": "Database Administrators"
        }
      ],
      "accessBundles": [
        {
          "id": "52fea7fb-xxx-4b1e-bc37-xxx",
          "name": "SQL Tuning Access"
        },
        {
          "id": "45ed5c4c-xxx-4e80-ba1c-xxx",
          "name": "DBUM Standard SQL Tuning Access UA2"
        },
        {
          "id": "xxx-xxx-xxx-xxx-xxx",
          "name": "Oracle DBUM Performance Admin Access"
        }
      ]
    }
  ],
  "owners": [
    {
      "id": "globalId.125123c3-xxx-4d6a-b6d4-xxx.18.xxx",
      "name": "Amel Maclead",
      "isPrimary": true
    }
  ]
}

レスポンス本文の例

次の例は、ポリシーを更新したアイデンティティの詳細を含む、JSON形式のレスポンス本文の内容を示しています:

{
    "id": "2e451b51-xxx-4bbc-9894-xxx",
    "name": "Admin DBUM Policy Update",
    "description": "Admin DBUM Policy Update",
    "status": "ACTIVE",
    "timeCreated": "2025-05-07T15:44:50.209Z",
    "timeUpdated": "2025-05-07T15:47:43.301Z",
    "ownershipCollectionId": "03b05e0d-xxx-4f7e-a101-xxx",
    "owners": [
        {
            "id": "globalId.125123c3-xxx-4d6a-b6d4-xxx.18.xxx",
            "name": "Amel Maclead",
            "isPrimary": true
        }
    ],
    "createdBy": {
        "id": "globalId.125123c3-xxx-4d6a-b6d4-xxx.18.xxx",
        "name": "Amel Maclead",
        "displayName": "Amel Maclead"
    },
    "updatedBy": {
        "id": "globalId.125123c3-xxx-4d6a-b6d4-xxx.18.xxx",
        "name": "Amel Maclead",
        "displayName": "Amel Maclead"
    },
    "tags": [
        "DBUM UA Policy Update"
    ],
    "customAttributes": {},
    "displayName": "Admin Database Policy Update",
    "assignments": [
        {
            "assignmentId": "54831c9d-xxx-459a-b209-xxx",
            "assignmentType": "ACCESS_BUNDLE",
            "identityType": "HUMAN",
            "identityCollections": [
                {
                    "id": "a4b3dd4b-xxx-4d77-858c-xxx",
                    "name": "Database Administrators"
                }
            ],
            "accessBundles": [
                {
                    "id": "45ed5c4c-xxx-4e80-ba1c-xxx",
                    "name": "DBUM Standard SQL Tuning Access UA2",
                    "displayName": "DBUM Standard SQL Tuning Access UA2",
                    "owners": null
                },
                {
                    "id": "52fea7fb-xxx-4b1e-bc37-xxx",
                    "name": "SQL Tuning Access"
                },
                {
                    "id": "xxx-xxx-xxx-xxx-xxx",
                    "name": "Oracle DBUM Performance Admin Access"
                }
            ],
            "roles": [],
            "customAttributes": null
        }
    ],
    "riskLevel": null
}
先頭に戻る