機械翻訳について

移動先

• リクエスト
• レスポンス
• 例

アクセス・レビューの変更

post

/access-governance/access-reviews/20250331/accessReviews/{accessReviewId}/actions/modify

指定されたaccessReviewIdのアクセス・レビューを変更します。

リクエスト

パス・パラメータ

• accessReviewId(required): string
  一意のアクセス・レビュー識別子。

ヘッダー・パラメータ

• if-match: string
  オプティミスティックな同時実行性制御用。 リソースのPUTまたはDELETEコールで、`if-match`パラメータを、そのリソースの以前のGETまたはPOSTレスポンスからのetagの値に設定します。 リソースは、指定したetagがリソースの現在のetag値と一致する場合にのみ更新または削除されます。
• opc-request-id: string
  トレース用のクライアント・リクエストID。 リクエストIDに有効な文字は、文字、数字、アンダースコアおよびダッシュのみです。

本文()

アクセス・レビューを変更するための詳細。

ルート・スキーマ : ModifyAccessReviewDetails

型: object

アクセス・レビューを変更するための詳細。revokedChildIdsとacceptedChildIdsは相互に排他的です。

ソースを表示

• acceptedChildIds: array acceptedChildIds
  最大アイテム数: 500

  指定されたアクセス・レビューに対して受け入れられる子IDのリスト。
• justification: string
  最大長: 500

  ディシジョンの正当性。
• revokedChildIds: array revokedChildIds
  最大アイテム数: 500

  特定のアクセス・レビューに対して取り消された子IDのリスト。

{
    "type":"object",
    "description":"Details to modify the access review. revokedChildIds and acceptedChildIds are mutually exclusive.",
    "properties":{
        "justification":{
            "description":"The justification for the decision.",
            "type":"string",
            "maxLength":500
        },
        "revokedChildIds":{
            "type":"array",
            "description":"List of child ids that are revoked for given access review.",
            "items":{
                "$ref":"#/definitions/ChildId"
            },
            "maxItems":500
        },
        "acceptedChildIds":{
            "type":"array",
            "description":"List of child ids that are accepted for given access review.",
            "items":{
                "$ref":"#/definitions/ChildId"
            },
            "maxItems":500
        }
    }
}

ネストされたスキーマ : acceptedChildIds

型: array

最大アイテム数: 500

指定されたアクセス・レビューに対して受け入れられる子IDのリスト。

ソースを表示

• Array of: object ChildId
  子IDオブジェクト。

{
    "type":"array",
    "description":"List of child ids that are accepted for given access review.",
    "items":{
        "$ref":"#/definitions/ChildId"
    },
    "maxItems":500
}

ネストされたスキーマ : revokedChildIds

型: array

最大アイテム数: 500

特定のアクセス・レビューに対して取り消された子IDのリスト。

ソースを表示

• Array of: object ChildId
  子IDオブジェクト。

{
    "type":"array",
    "description":"List of child ids that are revoked for given access review.",
    "items":{
        "$ref":"#/definitions/ChildId"
    },
    "maxItems":500
}

ネストされたスキーマ : ChildId

型: object

子IDオブジェクト。

ソースを表示

• id(必須): string
  最小長: 1

  最大長: 255

  子オブジェクトのID。
• type(必須): string
  許容値: [ "ASSOCIATION", "CONDITION", "EXCLUDED", "INCLUDED", "PRIMARY", "NON_REVIEWABLE" ]

  子オブジェクトのタイプ。

{
    "type":"object",
    "description":"The child ID object.",
    "required":[
        "id",
        "type"
    ],
    "properties":{
        "id":{
            "description":"The ID of the child object.",
            "type":"string",
            "minLength":1,
            "maxLength":255
        },
        "type":{
            "description":"The type of the child object.",
            "type":"string",
            "x-obmcs-top-level-enum":"#/definitions/ChildType",
            "enum":[
                "ASSOCIATION",
                "CONDITION",
                "EXCLUDED",
                "INCLUDED",
                "PRIMARY",
                "NON_REVIEWABLE"
            ]
        }
    }
}

トップに戻る

レスポンス

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

• application/json

202レスポンス

アクセス・レビューを変更するリクエストが正常に発行されました。

ヘッダー

• opc-request-id: string
  リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。

400レスポンス

不正なリクエスト

ヘッダー

• opc-request-id: string
  リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。

本文()

ルート・スキーマ : Error

型: object

エラー情報。

ソースを表示

• code(必須): string
  プログラム解析用のエラーを定義する短いエラー・コード。
• message(必須): string
  判読可能なエラー文字列。

{
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"A short error code that defines the error, meant for programmatic parsing."
        },
        "message":{
            "type":"string",
            "description":"A human-readable error string."
        }
    },
    "description":"Error Information."
}

401レスポンス

未認可

ヘッダー

• opc-request-id: string
  リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。

本文()

ルート・スキーマ : Error

型: object

エラー情報。

ソースを表示

• code(必須): string
  プログラム解析用のエラーを定義する短いエラー・コード。
• message(必須): string
  判読可能なエラー文字列。

{
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"A short error code that defines the error, meant for programmatic parsing."
        },
        "message":{
            "type":"string",
            "description":"A human-readable error string."
        }
    },
    "description":"Error Information."
}

404レスポンス

見つかりません

ヘッダー

• opc-request-id: string
  リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。

本文()

ルート・スキーマ : Error

型: object

エラー情報。

ソースを表示

• code(必須): string
  プログラム解析用のエラーを定義する短いエラー・コード。
• message(必須): string
  判読可能なエラー文字列。

{
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"A short error code that defines the error, meant for programmatic parsing."
        },
        "message":{
            "type":"string",
            "description":"A human-readable error string."
        }
    },
    "description":"Error Information."
}

412レスポンス

事前条件は失敗しました

ヘッダー

• opc-request-id: string
  リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。

本文()

ルート・スキーマ : Error

型: object

エラー情報。

ソースを表示

• code(必須): string
  プログラム解析用のエラーを定義する短いエラー・コード。
• message(必須): string
  判読可能なエラー文字列。

{
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"A short error code that defines the error, meant for programmatic parsing."
        },
        "message":{
            "type":"string",
            "description":"A human-readable error string."
        }
    },
    "description":"Error Information."
}

429レスポンス

リクエストが多すぎます

ヘッダー

• opc-request-id: string
  リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。

本文()

ルート・スキーマ : Error

型: object

エラー情報。

ソースを表示

• code(必須): string
  プログラム解析用のエラーを定義する短いエラー・コード。
• message(必須): string
  判読可能なエラー文字列。

{
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"A short error code that defines the error, meant for programmatic parsing."
        },
        "message":{
            "type":"string",
            "description":"A human-readable error string."
        }
    },
    "description":"Error Information."
}

500レスポンス

内部サーバー・エラー

ヘッダー

• opc-request-id: string
  リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。

本文()

ルート・スキーマ : Error

型: object

エラー情報。

ソースを表示

• code(必須): string
  プログラム解析用のエラーを定義する短いエラー・コード。
• message(必須): string
  判読可能なエラー文字列。

{
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"A short error code that defines the error, meant for programmatic parsing."
        },
        "message":{
            "type":"string",
            "description":"A human-readable error string."
        }
    },
    "description":"Error Information."
}

デフォルト・レスポンス

不明なエラー

ヘッダー

• opc-request-id: string
  リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。

本文()

ルート・スキーマ : Error

型: object

エラー情報。

ソースを表示

• code(必須): string
  プログラム解析用のエラーを定義する短いエラー・コード。
• message(必須): string
  判読可能なエラー文字列。

{
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"A short error code that defines the error, meant for programmatic parsing."
        },
        "message":{
            "type":"string",
            "description":"A human-readable error string."
        }
    },
    "description":"Error Information."
}

トップに戻る

例

次の例は、各ポリシー・ステートメントを確認する方法を示しています。ここで、いくつかのステートメントを受け入れ、いくつかのステートメントを拒否します。 ポリシー・アクセス・レビュー・タスクに適用可能。 使用

/access-governance/access-reviews/20250331/accessReviews/{accessReviewId}/actions/accept

ポリシー・レビュー・タスクのすべてのポリシー・ステートメントを受け入れます。

ノート:

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

cURLリクエストの例

curl -i -X POST \
   -H "Authorization:Bearer <your-access-token>" \
   -H "Content-Type:application/json" \
    -d \
    '{
  "justification": "Accepted one of the two",
  "revokedChildIds": [
    {
      "id": "tapolicystmt.OCI.f101xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.bebxxxxx",
      "type": "ASSOCIATION"
    }
  ],
  "acceptedChildIds": [
    {
      "id": "tapolicystmt.OCI.f101xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.248xxxxx",
      "type": "ASSOCIATION"
    }
  ]
}'
 '<${service-instance-url}/access-governance/access-reviews/${version}/accessReviews/${accessReviewId}/actions/modify>'

サンプル要求ペイロード

POSTを選択し、次のURLを追加

${service-instance-url}/access-governance/access-reviews/${version}/accessReviews/${accessReviewId}/actions/modify>

{
  "justification": "Accepted one of the two",
  "revokedChildIds": [
    {
      "id": "tapolicystmt.OCI.f101xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.bebxxxxx",
      "type": "ASSOCIATION"
    }
  ],
  "acceptedChildIds": [
    {
      "id": "tapolicystmt.OCI.f101xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.248xxxxx",
      "type": "ASSOCIATION"
    }
  ]
}

レスポンス・コードの例

204レスポンスの本文コンテンツはありません。

アクセス・レビュー・タスクの監査証跡による再割当の確認

アクセス・レビュー・タスクを使用して次のAPIを実行

/access-governance/access-reviews/20250331/accessReviews/{accessReviewId}/priorActions

次のレスポンスが表示されます:

{
  "items": [
    {
      "campaignName": "Policy Review Example - June 2025",
      "level": 1,
      "reviewerName": "John Doe",
      "reviewerType": "CUSTOM_USER",
      "action": "MODIFY",
      "timeReviewed": "2025-06-12T10:23:29.820Z",
      "isAutoActioned": null,
      "isCompletionRuleActioned": null,
      "justification": "Accepted one of the two",
      "finalAction": "MODIFY",
      "subLevel": null,
      "hasSodViolation": false
    }
  ]
}

先頭に戻る