機械翻訳について

移動先

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

アクセス・コントロール・アクセス・レビューのリストの取得

get

/access-governance/access-reviews/20250331/accessReviews/accessControl

ページ区切りをサポートしている特定のユーザーのすべてのアクセス制御アクセス・レビューの詳細を返します。

リクエスト

問合せパラメータ

• keywordContains: array[string]
  コレクション形式: multi

  最大アイテム数: 5

  フィルタするキーワードのリスト
• limit: integer
  最小値: 1

  最大値: 1000

  返されるアイテムの最大数。

  デフォルト値: 10
• page: string
  最小長: 1

  結果の取得を開始する位置を表すトークン。 これは、前のレスポンスの`opc-next-page`ヘッダー・フィールドから取得する必要があります。
• sortBy: string
  ソートの基準となるフィールド。 デフォルト値はassignmentNameです。

  デフォルト値: assignmentName

  許容値: [ "owner", "assignmentName", "recommendation", "daysRemaining", "campaignName" ]
• sortOrder: string
  使用するソート順(ASCまたはDESC)。

  許容値: [ "ASC", "DESC" ]
• userId(required): string
  最小長: 1

  最大長: 255

  操作を実行しているユーザーの識別子。

ヘッダー・パラメータ

• opc-request-id: string
  トレース用のクライアント・リクエストID。 リクエストIDに有効な文字は、文字、数字、アンダースコアおよびダッシュのみです。

トップに戻る

レスポンス

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

• application/json

200レスポンス

ReviewTaskSummaryオブジェクトのページ。

ヘッダー

• opc-next-page: string
  アイテム・リストのページ区切り。 リストをページングする際、このヘッダーがレスポンスに表示される場合は、部分的なリストが返されている可能性があります。 この値を後続のGETリクエストの`page`パラメータとして含め、次のアイテム・バッチを取得します。
• opc-request-id: string
  リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。
• opc-total-items: integer
  アイテムの総数。

本文()

ルート・スキーマ : AccessControlAccessReviewSummaryCollection

型: object

アクセス・コントロール・アクセス・レビューの検索結果。

ソースを表示

• items(必須): array items
  アクセス・コントロール・アクセス・レビュー・サマリーのリスト。

{
    "type":"object",
    "description":"Results of an access control access reviews search.",
    "required":[
        "items"
    ],
    "properties":{
        "items":{
            "description":"List of access control access review summaries.",
            "type":"array",
            "items":{
                "$ref":"#/definitions/AccessControlAccessReviewSummary"
            }
        }
    }
}

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

型: array

アクセス・コントロール・アクセス・レビュー・サマリーのリスト。

ソースを表示

• Array of: object AccessControlAccessReviewSummary
  アクセス・コントロール・レビュー・タスクの要約。

{
    "description":"List of access control access review summaries.",
    "type":"array",
    "items":{
        "$ref":"#/definitions/AccessControlAccessReviewSummary"
    }
}

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

型: object

アクセス・コントロール・レビュー・タスクの要約。

ソースを表示

• assignmentDescription: string
  レビューする割当の摘要。
• assignmentName(required): string
  アクセス制御レビュー・タスクの割当の名前。
• assignmentType(required): string
  許容値: [ "ACCOUNT", "PERMISSION", "ROLE", "POLICY", "IC_STRUCTURAL", "UNMATCHED_ACCOUNT", "ORCH_SYSTEM", "AM_WORKFLOW", "ACCESS_GUARDRAIL" ]

  レビューするアサイメントのタイプ。
• campaignId: string
  レビュー・タスクのキャンペーンID。
• campaignName(required): string
  アクセス制御レビュー・タスクのキャンペーン名。
• campaignType(required): string
  許容値: [ "ACCESS", "OWNERSHIP" ]

  レビュー・タスクは、どのキャンペーン・タイプ(アクセスまたは所有権)に属しています。
• daysRemaining(required): integer
  アクセス制御レビュー・タスクの残り日数。
• id(必須): string
  アクセス制御レビュー・タスクのID。
• isReassignable: boolean
  レビュー・タスクを再割当できるかどうかを示すフラグ。
• owner: string
  アクセス制御レビュー・タスクの所有者名。
• recommendation(required): string
  許容値: [ "ACCEPT", "REVIEW" ]

  アクセス制御レビュー・タスクの推奨事項。
• templateType: string
  許容値: [ "IDENTITY", "AG_IDENTITY", "EVENT", "AG_EVENT", "CLOUD_PROVIDER", "POLICY", "IC_STRUCTURAL", "AG_POLICY", "GOVERNANCE_SYSTEM", "AG", "GOVERNANCE_SYSTEM_EVENT", "CLOUD_PROVIDER_EVENT" ]

  キャンペーンのテンプレート・タイプ。

{
    "type":"object",
    "description":"The summary of access control review task.",
    "required":[
        "id",
        "assignmentName",
        "assignmentType",
        "recommendation",
        "campaignName",
        "campaignType",
        "daysRemaining"
    ],
    "properties":{
        "id":{
            "description":"The ID of the access control review task.",
            "type":"string"
        },
        "campaignId":{
            "description":"Campaign Id for the review task.",
            "type":"string"
        },
        "assignmentName":{
            "description":"The name of the assignment for access control review task.",
            "type":"string"
        },
        "assignmentDescription":{
            "description":"The description of the assignment to be reviewed.",
            "type":"string"
        },
        "assignmentType":{
            "description":"The type of the assignment to be reviewed.",
            "type":"string",
            "x-obmcs-top-level-enum":"#/definitions/AssignmentType",
            "enum":[
                "ACCOUNT",
                "PERMISSION",
                "ROLE",
                "POLICY",
                "IC_STRUCTURAL",
                "UNMATCHED_ACCOUNT",
                "ORCH_SYSTEM",
                "AM_WORKFLOW",
                "ACCESS_GUARDRAIL"
            ]
        },
        "owner":{
            "description":"The owner name of the access control review task.",
            "type":"string"
        },
        "recommendation":{
            "description":"The recommendation of the access control review task.",
            "type":"string",
            "x-obmcs-top-level-enum":"#/definitions/Recommendation",
            "enum":[
                "ACCEPT",
                "REVIEW"
            ]
        },
        "campaignName":{
            "description":"The campaign name of the access control review task.",
            "type":"string"
        },
        "daysRemaining":{
            "description":"The days remaining of the access control review task.",
            "type":"integer"
        },
        "templateType":{
            "description":"The template type of the campaign.",
            "type":"string",
            "x-obmcs-top-level-enum":"#/definitions/TemplateType",
            "enum":[
                "IDENTITY",
                "AG_IDENTITY",
                "EVENT",
                "AG_EVENT",
                "CLOUD_PROVIDER",
                "POLICY",
                "IC_STRUCTURAL",
                "AG_POLICY",
                "GOVERNANCE_SYSTEM",
                "AG",
                "GOVERNANCE_SYSTEM_EVENT",
                "CLOUD_PROVIDER_EVENT"
            ]
        },
        "campaignType":{
            "description":"review task belongs to which campaign type (access or ownership).",
            "type":"string",
            "x-obmcs-top-level-enum":"#/definitions/CampaignType",
            "enum":[
                "ACCESS",
                "OWNERSHIP"
            ]
        },
        "isReassignable":{
            "description":"Flag indicating whether the review task can be reassigned or not.",
            "type":"boolean"
        }
    }
}

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."
}

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."
}

トップに戻る

例

次の例は、アイデンティティに対するすべてのアクセス制御レビューのリストを取得する方法を示しています。 リストの取得中は、userId問合せパラメータが必須です。

cURL例 - 問合せパラメータあり

curl -i -X GET \
   -H "Authorization:Bearer <your access token>" \
 'https://${service-instance}/access-governance/access-reviews/${version}/accessReviews/accessControl?userId=${userId}'

レスポンス本文の例

次の例は、進行中のキャンペーンのリストを含む、JSON形式のレスポンス本文の内容を示しています:

{
    "items": [
        {
            "id": "ocid1.agcsreviewtask.oc1.iad.amaaaaaaebkbezqaaviu73xxxxxg7owxbz2iijxxxxxjaucd2yrxxxxxewia",
            "campaignId": "ocid1.agcscampaign.oc1.iad.amaaaaaaebkbezqack7shxxxxxjbv4y2je67xxxxxaeipcr33xxxxxupa",
            "assignmentName": "Finance Team Access Group Membership Review",
            "assignmentDescription": "Review group membership of Finance Team for Payroll",
            "assignmentType": "IC_STRUCTURAL",
            "owner": "John Doe",
            "recommendation": "ACCEPT",
            "campaignName": "Finance Group Membership Review - Apr 2025",
            "daysRemaining": 3582,
            "templateType": "AG",
            "campaignType": "ACCESS",
            "isReassignable": false
        },
        {
            "id": "ocid1.agcsreviewtask.oc1.iad.amaaaaaaebkbezqac6b34lxxxxxotefv4qpf75xxxxxah3724lyxxxxxw7ra",
            "campaignId": "ocid1.agcscampaign.oc1.iad.amaaaaaaebkbezqamftsexxxxx7nsm2coxljxxxxxbiswto5axxxxxq2a",
            "assignmentName": "HR Group Review",
            "assignmentDescription": "Evaluate group membership of HR Team for Operations",
            "assignmentType": "IC_STRUCTURAL",
            "owner": "Jane Smith",
            "recommendation": "REVIEW",
            "campaignName": "HR Group Membership Review - Apr 2025",
            "daysRemaining": 3593,
            "templateType": "CLOUD_PROVIDER",
            "campaignType": "ACCESS",
            "isReassignable": false
        }
    ]
}

先頭に戻る