アクセス・リクエストの作成
post
/access-governance/access-controls/20250331/accessRequests
指定された詳細を持つアイデンティティの新しいアクセス・リクエストを作成します。
リクエスト
ヘッダー・パラメータ
- opc-request-id: string
トレース用のクライアント・リクエストID。 リクエストIDに有効な文字は、文字、数字、アンダースコアおよびダッシュのみです。
新規アクセス・リクエストの詳細
ルート・スキーマ : CreateAccessRequestDetails
型:
object
新しいAccessRequestに関する情報。
ソースを表示
- accessBundles: array accessBundles
アクセス・バンドル・アイテムのリスト。
- accessLimitDataDetails: array accessLimitDataDetails
権限リクエストに関連付けられたアクセス制限データのリスト
- accountProfileDetails: array accountProfileDetails
アクセス・リクエストに関連付けられたアカウント・プロファイルのリスト。 関連付けられたアクセス・バンドルにアカウント・プロファイルが添付されている場合にのみ必要です。
- attributes: object attributes
許可される追加のプロパティ: additionalProperties対応するモデルの属性。 例: `{"foo-namespace": {"bar-key": "value"}}`
- createdBy: string
リクエストを作成したユーザー
- identities: array identities
アイデンティティIDのリスト
- justification: string
アクセス・リクエストの作成理由
- orchestratedSystemAttributes: array orchestratedSystemAttributes
ターゲットに関連付けられたorchestratedSystemAttributesのリスト
- permissionRoles: array permissionRoles
権限ロール項目のリスト。
- requestStatus: string
アクセス・リクエストのステータス
ネストされたスキーマ : accessLimitDataDetails
型:
array
権限リクエストに関連付けられたアクセス制限データのリスト
ソースを表示
- Array of: object AccessLimitDataDetails
アイデンティティで構成されたアクセス制限データ
ネストされたスキーマ : accountProfileDetails
型:
array
アクセス・リクエストに関連付けられたアカウント・プロファイルのリスト。 関連付けられたアクセス・バンドルにアカウント・プロファイルが添付されている場合にのみ必要です。
ソースを表示
- Array of: object AccountProfileInfo
アイデンティティ別アカウント・プロファイル構成
ネストされたスキーマ: attributes
型:
object
使用可能なその他のプロパティ
ソースを表示
対応するモデルの属性。 例: `{"foo-namespace": {"bar-key": "value"}}`
ネストされたスキーマ : orchestratedSystemAttributes
型:
array
ターゲットに関連付けられたorchestratedSystemAttributesのリスト
ソースを表示
- Array of: object OrchestratedSystemAttribute
アカウントおよび権限の属性
ネストされたスキーマ : AccessLimitDataDetails
型:
object
アイデンティティで構成されたアクセス制限データ
ソースを表示
- accessBundleId: string
アクセス・バンドルID
- accessLimitDataInfo: object AccessLimitDataInfo
アクセス制限データ情報オブジェクト。
- identityAccessLimitDetails: array identityAccessLimitDetails
アイデンティティのアクセス制限データ
- isIdentitySpecific: boolean
すべてのアイデンティティに対して同じ構成。
ネストされたスキーマ : AccessLimitDataInfo
型:
object
アクセス制限データ情報オブジェクト。
ソースを表示
- accessLimitData: object AccessLimitData
一時アクセス・バンドル・データ。
- accessLimitType: string
許容値:
[ "INDEFINITELY", "NUMBER_OF_DAYS", "NUMBER_OF_HOURS", "DATE_TIME_RANGE" ]
アクセス・バンドルの時間制限タイプ
ネストされたスキーマ : identityAccessLimitDetails
型:
array
アイデンティティのアクセス制限データ
ソースを表示
- Array of: object IdentityAccessLimitDataInfo
アイデンティティのアクセス制限データ
ネストされたスキーマ : AccessLimitData
型:
object
一時アクセス・バンドル・データ。
ソースを表示
- dateTimeConfig: object AccessLimitDateTimeConfig
日時の一時アクセス・バンドル・データ。
- daysConfig: object AccessLimitDaysConfig
一時アクセス・バンドル・データ(日数)。
- hoursConfig: object AccessLimitHoursConfig
一時アクセス・バンドル・データ(時間)。
ネストされたスキーマ : AccessLimitDateTimeConfig
型:
object
日時の一時アクセス・バンドル・データ。
ソースを表示
- expirationEndTime: integer(int64)
アクセスの有効期限が切れるべきエポック時間
- expirationStartTime: integer(int64)
アクセスを付与する必要があるエポック時間
ネストされたスキーマ : AccessLimitDaysConfig
型:
object
一時アクセス・バンドル・データ(日数)。
ソースを表示
- expirationInDays: integer
失効までに許可される最大日数
- extensionApprovalWorkflowId: object IdInfo
汎用識別情報オブジェクト。
- extensionInDays: integer
拡張が許可される日数
- notificationInDays: integer
通知を送信する日数
ネストされたスキーマ : AccessLimitHoursConfig
型:
object
一時アクセス・バンドル・データ(時間)。
ソースを表示
- expirationInHours: integer
失効までに許可される最大時間数
- extensionApprovalWorkflowId: object IdInfo
汎用識別情報オブジェクト。
- extensionInHours: integer
延長が許可される時間数
- notificationInHours: integer
通知を送信する時間数
ネストされたスキーマ : IdInfo
型:
object
汎用識別情報オブジェクト。
ソースを表示
- displayName: string
エンティティの表示名。
- id: string
エンティティのID。
- name: string
エンティティの名前。
ネストされたスキーマ : IdentityAccessLimitDataInfo
型:
object
アイデンティティのアクセス制限データ
ソースを表示
- accessLimitDataInfo: object AccessLimitDataInfo
アクセス制限データ情報オブジェクト。
- identityId: string
グローバル・アイデンティティ
ネストされたスキーマ : AccountProfileInfo
型:
object
アイデンティティ別アカウント・プロファイル構成
ソースを表示
- accountAttributes: array accountAttributes
アカウント属性値
- accountProfileId: string
取引先プロファイルID
- identityAccountAttributesDetails: array identityAccountAttributesDetails
アイデンティティ別アカウント属性情報
- identitySpecific: boolean
すべてのアイデンティティに対して同じ構成。
ネストされたスキーマ : accountAttributes
型:
array
アカウント属性値
ソースを表示
- Array of: object QuestionAttributeDataSummary
アカウント・プロファイルの質問属性
ネストされたスキーマ : identityAccountAttributesDetails
型:
array
アイデンティティ別アカウント属性情報
ソースを表示
- Array of: object IdentityAccountAttributesInfo
アカウント・プロファイル属性
ネストされたスキーマ : QuestionAttributeDataSummary
型:
object
アカウント・プロファイルの質問属性
ソースを表示
- children: array children
ネストされた属性
- isQuestion: boolean
属性がリクエスタの質問かどうかを確認するためのブール値。
- name: string
属性名 - 一意の識別子
- values: array values
属性値
ネストされたスキーマ: children
型:
array
ネストされた属性
ソースを表示
- Array of: object NestedQuestionAttributeSummary
質問属性のネストされたセット
ネストされたスキーマ: items
型:
array
質問属性
ソースを表示
- Array of: object QuestionAttributeDataSummary
アカウント・プロファイルの質問属性
ネストされたスキーマ : IdentityAccountAttributesInfo
型:
object
アカウント・プロファイル属性
ソースを表示
- accountAttributes: array accountAttributes
アカウント属性値
- identityId: string
グローバル・アイデンティティ
ネストされたスキーマ : accountAttributes
型:
array
アカウント属性値
ソースを表示
- Array of: object QuestionAttributeDataSummary
アカウント・プロファイルの質問属性
ネストされたスキーマ : OrchestratedSystemAttribute
型:
object
アカウントおよび権限の属性
ソースを表示
- accountAttributes: array accountAttributes
オーケストレーション・システム・アカウント属性のリスト
- orchestratedSystem: object Info
汎用情報オブジェクト。
- permissionAttributes: array permissionAttributes
オーケストレーション・システム権限属性のリスト
ネストされたスキーマ : accountAttributes
型:
array
オーケストレーション・システム・アカウント属性のリスト
ソースを表示
- Array of: object OrchestratedSystemAttributeData
オーケストレーション・システム属性
ネストされたスキーマ : 情報
型:
object
汎用情報オブジェクト。
ソースを表示
- displayName: string
エンティティの表示名。
- id: string
エンティティのID。
- name: string
エンティティの名前。
ネストされたスキーマ : permissionAttributes
型:
array
オーケストレーション・システム権限属性のリスト
ソースを表示
- Array of: object OrchestratedSystemAttributeData
オーケストレーション・システム属性
ネストされたスキーマ : OrchestratedSystemAttributeData
型:
object
オーケストレーション・システム属性
ソースを表示
- children: array children
ネストされた属性
- defaultValues: array defaultValues
属性値
- discriminator: string
このフィールドは、属性フィールドがパスワードであることを示します
- lookupType: string
属性のLookupID
- name: string
属性名
- permissionType: string
パーミッション・タイプ
- title: string
属性の表示名。
- type: string
属性のタイプ
ネストされたスキーマ: children
型:
array
ネストされた属性
ソースを表示
- Array of: object NestedAttributes
オーケストレーション・システム属性のネストされたセット
ネストされたスキーマ : NestedAttributes
型:
object
オーケストレーション・システム属性のネストされたセット
ソースを表示
- items: array items
オーケストレーションされたシステム属性
ネストされたスキーマ: items
型:
array
オーケストレーションされたシステム属性
ソースを表示
- Array of: object OrchestratedSystemAttributeData
オーケストレーション・システム属性
レスポンス
サポートされているメディア・タイプ
- application/json
200レスポンス
新しく作成されたアクセス・リクエスト
ヘッダー
- 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」書式設定日時文字列
ネストされたスキーマ : accessBundles
型:
array
アクセス・バンドル・アイテムのリスト。
ソースを表示
- Array of: object AccessBundleInfo
汎用情報オブジェクト。
ネストされたスキーマ : approvalRequests
型:
array
アクセス・リクエストの一部として作成された承認リクエストのリスト
ソースを表示
- Array of: object ApprovalRequest
承認リクエストの詳細。
ネストされたスキーマ: attributes
型:
object
使用可能なその他のプロパティ
ソースを表示
対応するモデルの属性。 例: `{"foo-namespace": {"bar-key": "value"}}`
ネストされたスキーマ : AccessBundleInfo
型:
object
汎用情報オブジェクト。
ソースを表示
- accountProfileId: string
アカウント・プロファイルID
- displayName: string
エンティティの表示名
- id: string
エンティティのID。
- name: string
エンティティの名前。
ネストされたスキーマ : 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)
リクエストの最終更新日。
ネストされたスキーマ : 情報
型:
object
汎用情報オブジェクト。
ソースを表示
- displayName: string
エンティティの表示名。
- id: string
エンティティのID。
- name: string
エンティティの名前。
400レスポンス
不正なリクエスト
ヘッダー
- opc-request-id: string
リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。
ルート・スキーマ : Error
型:
object
エラー情報。
ソースを表示
- code(必須): string
プログラム解析用のエラーを定義する短いエラー・コード。
- message(必須): string
判読可能なエラー文字列。
401レスポンス
未認可
ヘッダー
- opc-request-id: string
リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。
ルート・スキーマ : Error
型:
object
エラー情報。
ソースを表示
- code(必須): string
プログラム解析用のエラーを定義する短いエラー・コード。
- message(必須): string
判読可能なエラー文字列。
404レスポンス
見つかりません
ヘッダー
- opc-request-id: string
リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。
ルート・スキーマ : Error
型:
object
エラー情報。
ソースを表示
- code(必須): string
プログラム解析用のエラーを定義する短いエラー・コード。
- message(必須): string
判読可能なエラー文字列。
409レスポンス
競合
ヘッダー
- opc-request-id: string
リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。
ルート・スキーマ : Error
型:
object
エラー情報。
ソースを表示
- code(必須): string
プログラム解析用のエラーを定義する短いエラー・コード。
- message(必須): string
判読可能なエラー文字列。
429レスポンス
リクエストが多すぎます
ヘッダー
- opc-request-id: string
リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。
ルート・スキーマ : Error
型:
object
エラー情報。
ソースを表示
- code(必須): string
プログラム解析用のエラーを定義する短いエラー・コード。
- message(必須): string
判読可能なエラー文字列。
500レスポンス
内部サーバー・エラー
ヘッダー
- opc-request-id: string
リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。
ルート・スキーマ : Error
型:
object
エラー情報。
ソースを表示
- code(必須): string
プログラム解析用のエラーを定義する短いエラー・コード。
- message(必須): string
判読可能なエラー文字列。
デフォルト・レスポンス
不明なエラー
ヘッダー
- opc-request-id: string
リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。
ルート・スキーマ : Error
型:
object
エラー情報。
ソースを表示
- code(必須): string
プログラム解析用のエラーを定義する短いエラー・コード。
- message(必須): string
判読可能なエラー文字列。
例
次の例は、新しいアクセス・リクエストの作成方法を示しています。 1つのアクセス・リクエストで、複数のアイデンティティに対して複数のアクセス・バンドルをリクエストできます。
アカウント属性の詳細とともに、アクセス・バンドルID、アイデンティティID、アカウント・プロファイルIDおよび詳細が必要です。 この例では、すべてのアイデンティティに同じ質問値を使用します。
サンプル・コマンドを実行する前に、プレースホルダー値を実際の値に置き換えます。
cURLリクエストの例
curl -i -X POST \
-H "Authorization:Bearer <your access token>" \
-H "Content-Type:application/json" \
-d \
'{
"justification": "Sample Request Access",
"createdBy": "globalId.125xxx3c3-eedc-4d6a-b6d4-6c0f6537bad2.18.02e36bbb4b2xxxxxaa046b3ceb16a",
"accessBundles": ["6adcbc8d-1816-44a7-af70-78c40bf850fb"],
"identities": ["globalId.OCI.bd49ff2a-5c47-4242-8975-9ba235fbb0ec.9fxxxxxxx69c2af598b63d4"],
"accountProfileDetails": [
{
"accountProfileId": "84321700-1a93-4cf2-9226-3f4xxxxx68",
"identitySpecific": false,
"accountAttributes": [
{
"name": "defaultTablespaceQuotaInMB",
"values": [
"100"
],
"children": [],
"isQuestion": true
}
]
}
]
}' \
'${service-instance-url}/access-governance/access-controls/20250331/accessRequests'
リクエスト・ペイロードの例
{
"justification": "Sample Request Access",
"createdBy": "globalId.125123c3-eedc-4d6a-b6d4-6c0f6537bad2.18.02e36bbb4b20xxxxxxaa046b3ceb16a",
"accessBundles": [
"6adcbc8d-1816-44a7-af70-7xxxxxf850fb"
],
"identities": [
"globalId.OCI.bd49ff2a-5c47-4242-8975-9ba235fbb0ec.9f6exxxxx4960469c2af598b63d4"
],
"accountProfileDetails": [
{
"accountProfileId": "8432xx700-1a93-4cf2-9226-3fxxxxxxxx768",
"identitySpecific": false,
"accountAttributes": [
{
"name": "defaultTablespaceQuotaInMB",
"values": [
"100"
],
"children": [],
"isQuestion": true
}
]
}
]
}
レスポンス・コードの例
次のレスポンス本文とともに200 OKレスポンスを受信します:
{
"id": "0ff9207f-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"justification": "Sample justification",
"requestStatus": "PENDING_APPROVALS",
"timeCreated": "2025-04-11T08:10:51.357Z",
"timeUpdated": "2025-04-11T08:10:51.357Z",
"createdBy": "globalId.125123c3-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"permissionRoles": [],
"accessBundles": [
{
"id": "6adcbc8d-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"name": "Example payload",
"displayName": "Example payload",
"accountProfileId": "84321700-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
],
"identities": [
{
"id": "globalId.OCI.bd49ff2a-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"name": "Bill.Clark@example.com",
"displayName": "Bill Clark",
"owners": null
}
],
"attributes": {
"orchestratedSystemAttributes": null
},
"approvalRequests": null
}