機械翻訳について

移動先

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

ConditionTypeパラメータに基づいて、所有権またはアイデンティティ・コレクション・アクセス・レビューのアイデンティティのリストを取得

get

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

所有権またはアイデンティティ・コレクション・アクセス・レビューのアイデンティティのリストを返します。

リクエスト

パス・パラメータ

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

問合せパラメータ

• limit: integer
  最小値: 1

  最大値: 1000

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

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

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

  デフォルト値: entityName

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

  許容値: [ "ASC", "DESC" ]
• type(required): string
  メンバー・アイデンティティのタイプ。

  許容値: [ "EXCLUDED", "INCLUDED", "NON_REVIEWABLE" ]

ヘッダー・パラメータ

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

トップに戻る

レスポンス

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

• application/json

200レスポンス

アクセス・レビューにはアイデンティティが含まれていました。

ヘッダー

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

本文()

ルート・スキーマ : IdentitySummaryCollection

型: object

アイデンティティのリスト

ソースを表示

• items(必須): array items
  アイデンティティのリスト

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

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

型: array

アイデンティティのリスト

ソースを表示

• Array of: object IdentitySummary
  アイデンティティ・サマリー。

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

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

型: object

アイデンティティ・サマリー。

ソースを表示

• agOrganizations: array agOrganizations
  アイデンティティが含まれるAGOrganizations。
• email: string
  作成時に不変である一意のOracle ID (OCID)。
• employeeType: string
  アイデンティティのemployeeType。
• id(必須): string
  作成時に不変である一意のOracle ID (OCID)。
• isRuleBased: boolean
  (オプション・パラメータ)このアイデンティティはルール・ベースです。
• jobCode: string
  アイデンティティのjobCode。
• location: string
  IDのロケーション。
• manager: string
  作成時に不変である一意のOracle ID (OCID)。
• name: string
  わかりやすい名前。 一意である必要はなく、変更可能です。 機密情報の入力は避けてください。
• organization: string
  作成時に不変である一意のOracle ID (OCID)。
• userLogin: string
  作成時に不変である一意のOracle ID (OCID)。

{
    "type":"object",
    "required":[
        "id"
    ],
    "properties":{
        "id":{
            "type":"string",
            "description":"The Unique Oracle ID (OCID) that is immutable on creation."
        },
        "name":{
            "type":"string",
            "description":"A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information."
        },
        "userLogin":{
            "type":"string",
            "description":"The Unique Oracle ID (OCID) that is immutable on creation."
        },
        "email":{
            "type":"string",
            "description":"The Unique Oracle ID (OCID) that is immutable on creation."
        },
        "manager":{
            "type":"string",
            "description":"The Unique Oracle ID (OCID) that is immutable on creation."
        },
        "organization":{
            "type":"string",
            "description":"The Unique Oracle ID (OCID) that is immutable on creation."
        },
        "isRuleBased":{
            "type":"boolean",
            "description":"(optional parameter) Is this identity ruled based."
        },
        "jobCode":{
            "type":"string",
            "description":"The jobCode of the identity."
        },
        "location":{
            "type":"string",
            "description":"The location of the identitiy."
        },
        "employeeType":{
            "type":"string",
            "description":"The employeeType of the identitiy."
        },
        "agOrganizations":{
            "type":"array",
            "description":"The AGOrganizations of which the identity is part of.",
            "items":{
                "type":"string"
            }
        }
    },
    "description":"Identity Summary."
}

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

型: array

アイデンティティが含まれるAGOrganizations。

ソースを表示

• Array of: string

{
    "type":"array",
    "description":"The AGOrganizations of which the identity is part of.",
    "items":{
        "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."
}

トップに戻る

例

次の例は、所有権レビューまたはアイデンティティ・コレクション・アクセス制御レビュー・タスクのアイデンティティ・リストを取得する方法を示しています。 type問合せパラメータを含める必要があります。

cURL例 - 所有権レビュー・タスクに含まれる所有者

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

レスポンス本文の例

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

{
    "items": [
        {
            "id": "globalId.8d51efbf-ab68-4f09-xxxx-7bcc0f9de5be.18.a84836xxxxx02afd63a7fb",
            "name": "Amel Maclead",
            "email": "[e-mail]",
            "manager": John Smith,
            "org": null,
            "employeeType": null,
            "jobCode": null,
            "location": null,
            "userName": null,
            "ownerType": "PRIMARY",
            "agOrganizations": [
            ]
        }
    ]
}

先頭に戻る