機械翻訳について

移動先

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

指定されたレビュー・タスクのアクセス関連のリストを取得

get

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

指定されたアクセス・レビューのアクセス関連のリストを返します。

リクエスト

パス・パラメータ

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

問合せパラメータ

• limit: integer
  最小値: 1

  最大値: 1000

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

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

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

  デフォルト値: position

  許容値: [ "position" ]
• sortOrder: string
  使用するソート順(ASCまたはDESC)。

  許容値: [ "ASC", "DESC" ]

ヘッダー・パラメータ

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

トップに戻る

レスポンス

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

• application/json

200レスポンス

アクセス・レビューの関連付け。

ヘッダー

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

本文()

ルート・スキーマ : AssociationSummaryCollection

型: object

関連のリスト。

ソースを表示

• items(必須): array items
  関連のリスト。

{
    "type":"object",
    "description":"List of Associations.",
    "required":[
        "items"
    ],
    "properties":{
        "items":{
            "description":"List of Associations.",
            "type":"array",
            "items":{
                "$ref":"#/definitions/AssociationSummary"
            }
        }
    }
}

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

型: array

関連のリスト。

ソースを表示

• Array of: object AssociationSummary
  アクセス・レビューの関連付けサマリー。

{
    "description":"List of Associations.",
    "type":"array",
    "items":{
        "$ref":"#/definitions/AssociationSummary"
    }
}

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

型: object

アクセス・レビューの関連付けサマリー。

ソースを表示

• accesses: array accesses
  AccessBundlesまたはロールのリスト。
• id(必須): string
  関連付けのID。
• identityCollections: array identityCollections
  アイデンティティ・コレクションのリスト。
• position(required): integer
  関連付けでの文の位置。
• type: string
  許容値: [ "ROLE", "ACCESS_BUNDLE" ]

  関連付けのタイプ。

{
    "type":"object",
    "description":"The Association summary for the access review.",
    "required":[
        "id",
        "position"
    ],
    "properties":{
        "id":{
            "description":"The ID of the association.",
            "type":"string"
        },
        "type":{
            "description":"The type of the association.",
            "type":"string",
            "x-obmcs-top-level-enum":"#/definitions/AssociationType",
            "enum":[
                "ROLE",
                "ACCESS_BUNDLE"
            ]
        },
        "identityCollections":{
            "description":"The list of Identity Collections.",
            "type":"array",
            "items":{
                "$ref":"#/definitions/IdNameObject"
            }
        },
        "accesses":{
            "description":"The list of AccessBundles or Roles.",
            "type":"array",
            "items":{
                "$ref":"#/definitions/IdNameObject"
            }
        },
        "position":{
            "description":"The position of the statement in the association.",
            "type":"integer"
        }
    }
}

ネストされたスキーマ : アクセス

型: array

AccessBundlesまたはロールのリスト。

ソースを表示

• Array of: object IdNameObject
  メンバーシップ・ルールの属性キーまたは演算子条件。

{
    "description":"The list of AccessBundles or Roles.",
    "type":"array",
    "items":{
        "$ref":"#/definitions/IdNameObject"
    }
}

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

型: array

アイデンティティ・コレクションのリスト。

ソースを表示

• Array of: object IdNameObject
  メンバーシップ・ルールの属性キーまたは演算子条件。

{
    "description":"The list of Identity Collections.",
    "type":"array",
    "items":{
        "$ref":"#/definitions/IdNameObject"
    }
}

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

型: object

メンバーシップ・ルールの属性キーまたは演算子条件。

ソースを表示

• displayName(必須): string
  属性キーまたは演算子の表示名。
• id(必須): string
  属性キーまたは演算子のID。
• name(required): string
  属性キーまたは演算子の名前。

{
    "type":"object",
    "description":"The Attribute key or Operator condition for the Membership rule.",
    "required":[
        "id",
        "name",
        "displayName"
    ],
    "properties":{
        "id":{
            "description":"The ID of the Attribute Key or Operator.",
            "type":"string"
        },
        "name":{
            "description":"The name of the Attribute Key or Operator.",
            "type":"string"
        },
        "displayName":{
            "description":"The display name of the Attribute Key or Operator.",
            "type":"string"
        }
    }
}

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

トップに戻る

例

次の例は、ポリシーのアクセス関連付けを取得する方法を示しています。 これは、アイデンティティ・コレクションがアクセス・バンドルまたはロールを介してリソースへのアクセス権を付与されるポリシー関連付けの取得に役立ちます。

cURLの例

curl -i -X GET \
   -H "Authorization:Bearer <your access token>" \
 '${service-instance-url}/access-governance/access-reviews/accessReviews/${accessReviewId}/associations

レスポンス本文の例

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

{
  "items": [
    {
      "id": "421xxxx-c5e3-4781-aeb9-f417xxxxxx",
      "type": "ACCESS_BUNDLE",
      "identityCollections": [
        {
          "id": "236xxxx-3bd7-495a-a559-dacexxxxxx",
          "name": "IC_Database.QA",
          "displayName": "IC_Database.QA"
        }
      ],
      "accesses": [
        {
          "id": "49a0xxxx-a522-4b7d-b4a8-5b3dxxxxxx",
          "name": "DBAT_AB",
          "displayName": "DBAT_AB"
        }
      ],
      "position": 0
    }
  ]
}

ポリシー・アクセス・レビューID以外のアクセス・レビュー・タスクIDを使用した場合、またはアクション可能な文が含まれていない場合は、次のレスポンスを受け取ります:

{
    "items": [
    ]
}

先頭に戻る