機械翻訳について

移動先

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

アクセス・リクエストの取得

get

/access-governance/access-controls/20250331/accessRequests/{accessRequestId}

指定されたIDのアクセス・リクエストの詳細を返します。

リクエスト

パス・パラメータ

• accessRequestId(required): string
  一意のAccessRequest識別子

ヘッダー・パラメータ

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

トップに戻る

レスポンス

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

• application/json

200レスポンス

指定されたIDのアクセス・リクエスト

ヘッダー

• etag: string
  オプティミスティックな同時実行性制御用。 `if-match`を参照してください。
• opc-request-id: string
  リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。

本文()

ルート・スキーマ : AccessRequest

型: object

AccessRequestの説明。

ソースを表示

• accessBundles: array accessBundles
  アクセス・バンドル・アイテムのリスト。
• approvalRequests: array approvalRequests
  アクセス・リクエストの一部として作成された承認リクエストのリスト
• attributes: object attributes
  許可される追加のプロパティ: additionalProperties

  対応するモデルの属性。 例: `{"foo-namespace": {"bar-key": "value"}}`
• createdBy: string
  リクエストを作成したユーザー
• id(必須): string
  作成時に不変である一意のOracle ID (OCID)。
• identities: array identities
  アイデンティティのリスト
• justification: string
  アクセス・リクエストの作成または更新の理由
• permissionRoles: array permissionRoles
  権限ロール項目のリスト。
• requestStatus: string
  アクセス・リクエストのステータス
• timeCreated: string(date-time)
  AccessRequestが作成された時間。 「An RFC3339」書式設定日時文字列
• timeUpdated: string(date-time)
  AccessRequestが最後に更新された時間。 「An RFC3339」書式設定日時文字列

{
    "type":"object",
    "required":[
        "id"
    ],
    "properties":{
        "id":{
            "type":"string",
            "description":"The Unique Oracle ID (OCID) that is immutable on creation."
        },
        "justification":{
            "type":"string",
            "description":"Justification for creating or updating the access request"
        },
        "requestStatus":{
            "type":"string",
            "description":"Status of the access request"
        },
        "timeCreated":{
            "type":"string",
            "format":"date-time",
            "description":"The time the the AccessRequest was created. An RFC3339 formatted datetime string"
        },
        "timeUpdated":{
            "type":"string",
            "format":"date-time",
            "description":"The time the the AccessRequest was last updated. An RFC3339 formatted datetime string"
        },
        "createdBy":{
            "type":"string",
            "description":"The user that created the request"
        },
        "permissionRoles":{
            "type":"array",
            "description":"list of Permission roles items.",
            "items":{
                "$ref":"#/definitions/Info"
            }
        },
        "accessBundles":{
            "type":"array",
            "description":"list of Access bundle items.",
            "items":{
                "$ref":"#/definitions/AccessBundleInfo"
            }
        },
        "identities":{
            "type":"array",
            "description":"list of identities",
            "items":{
                "$ref":"#/definitions/Info"
            }
        },
        "attributes":{
            "type":"object",
            "description":"Attributes of the corresponding model. \nExample: `{\"foo-namespace\": {\"bar-key\": \"value\"}}`\n",
            "additionalProperties":{
                "type":"object",
                "properties":{
                }
            }
        },
        "approvalRequests":{
            "type":"array",
            "description":"List of approval requests created as part of the access request",
            "items":{
                "$ref":"#/definitions/ApprovalRequest"
            }
        }
    },
    "description":"Description of AccessRequest."
}

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

型: array

アクセス・バンドル・アイテムのリスト。

ソースを表示

• Array of: object AccessBundleInfo
  汎用情報オブジェクト。

{
    "type":"array",
    "description":"list of Access bundle items.",
    "items":{
        "$ref":"#/definitions/AccessBundleInfo"
    }
}

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

型: array

アクセス・リクエストの一部として作成された承認リクエストのリスト

ソースを表示

• Array of: object ApprovalRequest
  承認リクエストの詳細。

{
    "type":"array",
    "description":"List of approval requests created as part of the access request",
    "items":{
        "$ref":"#/definitions/ApprovalRequest"
    }
}

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

型: object

使用可能なその他のプロパティ

ソースを表示

• object additionalProperties

{
    "type":"object",
    "description":"Attributes of the corresponding model. \nExample: `{\"foo-namespace\": {\"bar-key\": \"value\"}}`\n",
    "additionalProperties":{
        "type":"object",
        "properties":{
        }
    }
}

対応するモデルの属性。 例: `{"foo-namespace": {"bar-key": "value"}}`

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

型: array

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

ソースを表示

• Array of: object Info
  汎用情報オブジェクト。

{
    "type":"array",
    "description":"list of identities",
    "items":{
        "$ref":"#/definitions/Info"
    }
}

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

型: array

権限ロール項目のリスト。

ソースを表示

• Array of: object Info
  汎用情報オブジェクト。

{
    "type":"array",
    "description":"list of Permission roles items.",
    "items":{
        "$ref":"#/definitions/Info"
    }
}

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

型: object

汎用情報オブジェクト。

ソースを表示

• accountProfileId: string
  アカウント・プロファイルID
• displayName: string
  エンティティの表示名
• id: string
  エンティティのID。
• name: string
  エンティティの名前。

{
    "type":"object",
    "properties":{
        "id":{
            "type":"string",
            "description":"id of the entity."
        },
        "name":{
            "type":"string",
            "description":"name of the entity."
        },
        "displayName":{
            "type":"string",
            "description":"display name of the entity"
        },
        "accountProfileId":{
            "type":"string",
            "description":"account profile id"
        }
    },
    "description":"Generic information object."
}

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

型: object

承認リクエストの詳細。

ソースを表示

• accessStartTime: string(date-time)
  一時アクセス開始時間
• assignmentDescription: string
  リクエストされているアサイメントの摘要。
• assignmentName: string
  リクエストされているアサイメントの名前。
• assignmentType: string
  許容値: [ "ACCESS_BUNDLE", "ROLE" ]

  リクエストされるアサイメントのタイプ。
• beneficiary: string
  受取人の識別子。
• beneficiaryEmail: string
  受益者の電子メール。
• failedDueToAccessGuardrailViolations: boolean
  アクセス・ガードレール違反のためにリクエストが失敗した場合、ブール・フラグはtrueに設定されます。
• id(必須): string
  プロセス・インスタンスID。
• requestor: string
  リクエスト者の識別子。
• requestType: string
  許容値: [ "WORKFLOW", "NO_WORKFLOW" ]

  リクエストを入力 - ワークフローまたはワークフローなし。
• status: string
  許容値: [ "PENDING_APPROVALS", "INFO_REQUESTED", "APPROVED", "REJECTED", "DELETED", "FAILED", "CANCELLED", "PENDING_SOD", "PROVISIONED", "PROVISIONING_IN_PROGRESS", "PROVISIONING_FAILED" ]

  承認プロセス・インスタンスのステータス。
• timeUpdated: string(date-time)
  リクエストの最終更新日。

{
    "type":"object",
    "required":[
        "id"
    ],
    "properties":{
        "id":{
            "type":"string",
            "description":"process instance id."
        },
        "requestor":{
            "type":"string",
            "description":"Identifier of the requestor."
        },
        "beneficiary":{
            "type":"string",
            "description":"Identifier of the beneficiary."
        },
        "beneficiaryEmail":{
            "type":"string",
            "description":"email of the beneficiary."
        },
        "status":{
            "type":"string",
            "description":"The status of the approval process instance.",
            "enum":[
                "PENDING_APPROVALS",
                "INFO_REQUESTED",
                "APPROVED",
                "REJECTED",
                "DELETED",
                "FAILED",
                "CANCELLED",
                "PENDING_SOD",
                "PROVISIONED",
                "PROVISIONING_IN_PROGRESS",
                "PROVISIONING_FAILED"
            ],
            "x-obmcs-top-level-enum":"#/definitions/RequestStatus"
        },
        "assignmentName":{
            "type":"string",
            "description":"Name of the assignment that is being requested."
        },
        "assignmentType":{
            "type":"string",
            "description":"Type of the assignment that is being requested.",
            "enum":[
                "ACCESS_BUNDLE",
                "ROLE"
            ],
            "x-obmcs-top-level-enum":"#/definitions/AssignmentType"
        },
        "assignmentDescription":{
            "type":"string",
            "description":"Description of the assignment that is being requested."
        },
        "requestType":{
            "type":"string",
            "description":"Type the request - workflow or no workflow.",
            "enum":[
                "WORKFLOW",
                "NO_WORKFLOW"
            ],
            "x-obmcs-top-level-enum":"#/definitions/RequestType"
        },
        "timeUpdated":{
            "type":"string",
            "format":"date-time",
            "description":"The last update date of the request."
        },
        "failedDueToAccessGuardrailViolations":{
            "type":"boolean",
            "description":"Boolean flag set to true if request failed due to Access Guardrail violations."
        },
        "accessStartTime":{
            "type":"string",
            "format":"date-time",
            "description":"The temporal access start time"
        }
    },
    "description":"Details of an Approval Request."
}

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

型: object

ソースを表示

{
    "type":"object",
    "properties":{
    }
}

ネストされたスキーマ : 情報

型: object

汎用情報オブジェクト。

ソースを表示

• displayName: string
  エンティティの表示名。
• id: string
  エンティティのID。
• name: string
  エンティティの名前。

{
    "type":"object",
    "properties":{
        "id":{
            "type":"string",
            "description":"id of the entity."
        },
        "name":{
            "type":"string",
            "description":"name of the entity."
        },
        "displayName":{
            "type":"string",
            "description":"Display Name of the entity."
        }
    },
    "description":"Generic information object."
}

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-controls/${version}/accessRequests/${accessRequestID}'

RESTクライアントを使用したGETコマンドの例

http://${si}/access-governance/access-controls/${version}/accessRequests/${accessRequestID}

レスポンス本文の例

{
 "id": "042752a3-22f7-4187-9664-6c1afa3xxxx",
 "justification": "REST API Sample",
 "requestStatus": "PENDING_APPROVALS",
 "timeCreated": "2025-03-21T10:43:28.637Z",
 "timeUpdated": "2025-03-21T10:43:28.637Z",
 "createdBy": "globalId.ICF.Non-Human-Test-Nov02.84923636ecda906f23f4aa55xxxxxx",
 "permissionRoles": [
 ],
 "accessBundles": [
 {
 "id": "47acf2e1-ccbe-46ee-b6e8-xxxxxx",
 "name": "DBUM AB - DEMO Test",
 "displayName": null,
 "accountProfileId": null
 }
 ],
 "identities": [
 {
 "id": "globalId.OCI.ag-test.7e5xxxxxxxx",
 "name": "Carmel Stjohn",
 "displayName": null,
 "owners": null
 }
 ],
 "attributes": {
 }
}
    

先頭に戻る