アクセス・バンドルの取得
get
/access-governance/access-controls/20250331/accessBundles/{accessBundleId}
指定されたIDのアクセス・バンドルの詳細を返します。
リクエスト
パス・パラメータ
- accessBundleId(required): string
指定されたIDのアクセス・バンドルの検索に使用されるフィルタ。 使用可能な値は、ListAccessBundles操作を使用して確認できます。
ヘッダー・パラメータ
- opc-request-id: string
トレース用のクライアント・リクエストID。 リクエストIDに有効な文字は、文字、数字、アンダースコアおよびダッシュのみです。
レスポンス
サポートされているメディア・タイプ
- application/json
200レスポンス
指定されたIDのアクセス・バンドル
ヘッダー
- etag: string
オプティミスティックな同時実行性制御用。 `if-match`を参照してください。
- opc-request-id: string
リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。
ルート・スキーマ : AccessBundle
型:
object
バンドル・オブジェクトにアクセスします。
ソースを表示
- accessGuardrail: object AccessGuardrailDetails
Guardrailオブジェクトにアクセスします。
- accessTimeLimit: object AccessBundleTimeLimit
時間制限の定義。 daysLimit、hoursLimitまたはdateTimeLimitのいずれか1つのみを指定する必要があります。
- accessTimeLimitType: string
許容値:
[ "INDEFINITELY", "NUMBER_OF_DAYS", "NUMBER_OF_HOURS" ]
アクセス・バンドルの時間制限タイプ。 - accountProfileId: string
アクセス・バンドルの構成済アカウント・プロファイルID。
- accountProfileName: string
アクセス・バンドルの構成済アカウント・プロファイル名。
- approvalWorkflowId: object IdInfo
汎用識別情報オブジェクト。
- autoApproveIfNoViolation: boolean
アクセス・バンドルへのアクセス・リクエストに違反がない場合に自動承認を示すブール・フラグ。
- cloudAccountName: string
OCIバンドルのクラウド・アカウント名(OCIテナンシなど)。
- compartmentFqn: string
OCIバンドルのコンパートメントのフルネーム。
- compartmentName: string
OCIバンドルのコンパートメント名。
- createdBy: object IdInfo
汎用識別情報オブジェクト。
- customAttributes: object customAttributes
アクセス・バンドルに関連付けられたメタデータ。
- description: string
アクセス・バンドルの説明。
- displayName: string
アクセス・バンドルの表示名。
- domainName: string
OCIバンドルのドメイン名。
- externalId: string
Access BundleのExternalId。
- id(必須): string
作成時に変更できない一意の識別子
- name: string
アクセス・バンドルの名前。
- orchestratedSystem: object IdInfo
汎用識別情報オブジェクト。
- orchestratedSystemAttributes: object OrchestratedSystemAttributeSummary
アカウント属性と権限属性。
- orchestratedSystemType: string
オーケストレート済システム・タイプ。
- owners: array owners
所有者エンティティのリスト。
- ownershipCollectionId: string
アクセス・バンドルに関連付けられた所有権コレクション。
- permissions: array permissions
権限のリスト
- requestableBy: object IdInfo
汎用識別情報オブジェクト。
- resourceType: string
OCI Access Bundleのリソース・タイプ。
- status: string
許容値:
[ "ACTIVE", "DRAFT", "INACTIVE", "PENDING", "FAILED", "IN_PROGRESS", "SAVED", "SUCCESS", "TIMEOUT" ]
アクセス・バンドルのステータス。 - tags: array tags
アクセス・バンドルに添付されたタグのリスト。
- timeCreated: string(date-time)
アクセス・バンドルが作成された時間。 RFC3339形式の日時文字列
- timeUpdated: string(date-time)
アクセス・バンドルが最後に更新された時間。 RFC3339形式の日時文字列
- updatedBy: object IdInfo
汎用識別情報オブジェクト。
ネストされたスキーマ : AccessGuardrailDetails
型:
object
Guardrailオブジェクトにアクセスします。
ソースを表示
- id(必須): string
アクセス・ガード・レールID。
- name(required): string
アクセス・ガード・レール名。
ネストされたスキーマ : AccessBundleTimeLimit
型:
object
時間制限の定義。 daysLimit、hoursLimitまたはdateTimeLimitのいずれか1つのみを指定する必要があります。
ソースを表示
- daysLimit: object AccessBundleTimeLimitDays
時間制限の定義(日数)。
- hoursLimit: object AccessBundleTimeLimitHours
時間制限の定義(時間)。
ネストされたスキーマ : IdInfo
型:
object
汎用識別情報オブジェクト。
ソースを表示
- displayName: string
エンティティの表示名。
- id: string
エンティティのID。
- name: string
エンティティの名前。
ネストされたスキーマ : OrchestratedSystemAttributeSummary
型:
object
アカウント属性と権限属性。
ソースを表示
- accountAttributes: array accountAttributes
オーケストレーション済システム・アカウント属性のリスト。
- permissionAttributes: array permissionAttributes
オーケストレート済システム権限属性のリスト。
ネストされたスキーマ : AccessBundleTimeLimitDays
型:
object
時間制限の定義(日数)。
ソースを表示
- accessLimitInDays(required): integer
最小値:
1
最大値:365
失効までに許可される最大日数。 - extensionApprovalWorkflowId(required): object IdInfo
汎用識別情報オブジェクト。
- extensionInDays(required): integer
最小値:
1
最大値:90
拡張が許可される日数。 - notificationInDays(required): integer
最小値:
1
最大値:30
通知を送信する日数。
ネストされたスキーマ : AccessBundleTimeLimitHours
型:
object
時間制限の定義(時間)。
ソースを表示
- accessLimitInHours(required): integer
最小値:
1
最大値:24
失効までに許可される最大時間数。 - extensionApprovalWorkflowId(required): object IdInfo
汎用識別情報オブジェクト。
- extensionInHours(required): integer
最小値:
1
最大値:8
時間数の延長が許可されています。 - notificationInHours(required): integer
最小値:
1
最大値:24
通知を送信する時間数。
ネストされたスキーマ : accountAttributes
型:
array
オーケストレーション済システム・アカウント属性のリスト。
ソースを表示
- Array of: object OrchestratedSystemAttributeDataSummary
オーケストレーション・システム属性
ネストされたスキーマ : permissionAttributes
型:
array
オーケストレート済システム権限属性のリスト。
ソースを表示
- Array of: object OrchestratedSystemAttributeDataSummary
オーケストレーション・システム属性
ネストされたスキーマ : OrchestratedSystemAttributeDataSummary
型:
object
オーケストレーション・システム属性
ソースを表示
- children: array children
ネストされた属性
- discriminator: string
このフィールドは、属性フィールドがパスワードであることを示します
- isQuestion: boolean
このオーケストレーション・システム属性が質問として表示されるかどうかを示します。
- name: string
属性名 - 一意の識別子
- permissionType: string
パーミッション・タイプ
- title: string
属性の表示名。
- type: string
属性のタイプ
- values: array values
属性値
ネストされたスキーマ: children
型:
array
ネストされた属性
ソースを表示
- Array of: object NestedAttributesSummary
オーケストレーション・システム属性のネストされたセット
ネストされたスキーマ : NestedAttributesSummary
型:
object
オーケストレーション・システム属性のネストされたセット
ソースを表示
- items: array items
オーケストレーションされたシステム属性
ネストされたスキーマ: items
型:
array
オーケストレーションされたシステム属性
ソースを表示
- Array of: object OrchestratedSystemAttributeDataSummary
オーケストレーション・システム属性
ネストされたスキーマ : OwnerSummary
型:
object
所有者エンティティ・オブジェクト
ソースを表示
- id(必須): string
作成時に変更できない一意の識別子
- isPrimary(required): boolean
このエンティティはプライマリ所有者ですか?
- name(required): string
所有者の名前
ネストされたスキーマ : PermissionSummary
型:
object
権限の説明。
ソースを表示
- description: string
権限の説明
- id(必須): string
作成時に不変である一意のOracle ID (OCID)
- name: string
パーミッション名
- permissionType: object PermissionTypeSummary
PermissionTypeサマリー。
- resource: object ResourceSummary
資源要約
- timeCreated: string(date-time)
権限が最後に作成された時間。 「An RFC3339」書式設定日時文字列
- timeUpdated: string(date-time)
権限が最後に更新された時間。 「An RFC3339」書式設定日時文字列
- type: string
権限のタイプ
ネストされたスキーマ : PermissionTypeSummary
型:
object
PermissionTypeサマリー。
ソースを表示
- displayName: string
PermissionTypeの表示名。
- externalId: string
PermissionTypeの外部ID
- id: string
作成時に不変である一意のOracle ID (OCID)。
- name: string
PermissionTypeの名前。
ネストされたスキーマ : ResourceSummary
型:
object
資源要約
ソースを表示
- customAttributes: object customAttributes
リソースに関連付けられたメタデータ
- displayName: string
リソースの表示名。
- id(必須): string
作成時に不変である一意のOracle ID (OCID)。
- name: string
リソースの名前。
- type: 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
判読可能なエラー文字列。
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
判読可能なエラー文字列。
例
次の例は、特定のアクセス・バンドルの詳細を取得する方法を示しています。 サンプル・コマンドを実行する前に、プレースホルダー値を実際の値に置き換えます。
cURL例 - 問合せパラメータなし
curl -i -X GET \
-H "Authorization:Bearer <your access token>" \
'${service-instance-url}/access-governance/access-controls/${version}/accessBundles/${accessBundleID}'
レスポンス本文の例
次の例は、使用可能なすべてのアクセス・バンドルのリストを含む、JSON形式のレスポンス本文のコンテンツを示しています:
{
"accessBundleType" : "PERMISSION_BUNDLE",
"id" : "cbcf4668-4fed-4f70-8692-6xxxxxxxx",
"name" : "Administer, Management, Sql, Xdbadmin, Wm_Admin_Role ('ag-api-demo-DBUM' system)",
"displayName" : "Administer, Management, Sql, Xdbadmin, Wm_Admin_Role ('ag-api-demo-DBUM' system)",
"description" : "Bundle for 'ag-api-demo-DBUM-DBUM' system having key terms: 'Administer, Wm_Admin_Role, Xs_Cache_Admin'",
"tags" : [ "DBUM"],
"timeCreated" : "2025-02-24T22:45:02.155Z",
"timeUpdated" : "2025-03-18T16:20:19.819Z",
"createdBy" : {
"id" : "globalId.ICF.Non-Human-Test-Nov02.8xxxxxxxxxxxf4aa551989b7ec",
"name" : "Abel Maclead",
"displayName" : "Abel Maclead"
},
"updatedBy" : {
"id" : "globalId.ICF.Non-Human-Test-Nov02.84923636exxxxxxxxxxec",
"name" : "Abel Maclead",
"displayName" : "Abel Maclead"
},
"requestableBy" : {
"id" : "ANY",
"name" : "Anyone",
"displayName" : "Anyone"
},
"status" : "ACTIVE",
"approvalWorkflowId" : {
"id" : "NO_APPROVAL_REQUIRED",
"name" : "No Approval Required",
"displayName" : "No Approval Required"
},
"orchestratedSystem" : {
"id" : "07cfd352-a6a1-42ae-9409-731cb41a74fc",
"name" : "ag-api-demo-3-DBUM",
"displayName" : "ag-api-demo-DBUM-DBUM"
},
"orchestratedSystemType" : "ICF",
"ownershipCollectionId" : "d830b750-cee1-44f1-a5b8-cbxxxxxea6",
"owners" : [ {
"id" : "globalId.ICF.Non-Human-Test-Nov02.84923636xxxxxxxxxxxec",
"name" : "Ama Maclead",
"isPrimary" : true
} ],
"externalId" : "4354203e-910d-4cc8-ab3f-xxxx48023b94",
"cloudAccountName" : null,
"domainName" : null,
"resourceType" : null,
"compartmentName" : null,
"compartmentFqn" : null,
"customAttributes" : { },
"permissions" : [ {
"id" : "roles.ICF.ag-api-demo-DBUM-DBUM.d58d0fe8974dd1cb97xxxxxxx",
"name" : "AUTHENTICATEDUSER",
"description" : null,
"type" : "ENTITLEMENTS",
"timeCreated" : "2024-10-06T07:34:30.633Z",
"timeUpdated" : null,
"resource" : {
"id" : "resource.ICF.ag-api-demo-DBUM-DBUM.7e083f9851db103540xxxxxxxx",
"name" : "ag-api-demo-DBUM-DBUM",
"displayName" : "ag-api-demo-DBUM-DBUM",
"type" : "DBUM",
"customAttributes" : null
},
"permissionType" : {
"id" : "etype.ICF.ag-api-demo-DBUM-DBUM.6ae3be9a18b9aae2f8baxxxxxx",
"name" : "icf.connector.entitlement.type.roles",
"displayName" : "Role",
"externalId" : "roles"
}
}, {
"id" : "roles.ICF.ag-api-demo-DBUM-DBUM.9690282467b46e171f1c0xxxxxx",
"name" : "XS_CACHE_ADMIN",
"description" : null,
"type" : "ENTITLEMENTS",
"timeCreated" : "2024-10-06T07:34:29.043Z",
"timeUpdated" : null,
"resource" : {
"id" : "resource.ICF.ag-api-demo-DBUM-DBUM.123456xxxxxxxxxxxxxxxx",
"name" : "ag-api-demo-DBUM-DBUM",
"displayName" : "ag-api-demo-DBUM-DBUM",
"type" : "DBUM",
"customAttributes" : null
},
"permissionType" : {
"id" : "etype.ICF.ag-api-demo-DBUM-DBUM.6ae3be9a18bxxxxxxxxxxxx",
"name" : "icf.connector.entitlement.type.roles",
"displayName" : "Role",
"externalId" : "roles"
}
}, {
"id" : "roles.ICF.ag-api-demo-DBUM-DBUM.c554da3bb5e17e380affd24bb461d522",
"name" : "XS_SESSION_ADMIN",
"description" : null,
"type" : "ENTITLEMENTS",
"timeCreated" : "2024-10-06T07:34:29.042Z",
"timeUpdated" : null,
"resource" : {
"id" : "resource.ICF.ag-api-demo-DBUM-DBUM.7e083f9851db1035408a877c654d28bd",
"name" : "ag-api-demo-DBUM-DBUM",
"displayName" : "ag-api-demo-DBUM-DBUM",
"type" : "DBUM",
"customAttributes" : null
},
"permissionType" : {
"id" : "etype.ICF.ag-api-demo-DBUM-DBUM.6ae3be9a18b9aae2f8ba02e7f8908eaf",
"name" : "icf.connector.entitlement.type.roles",
"displayName" : "Role",
"externalId" : "roles"
}
}, {
"id" : "roles.ICF.ag-api-demo-DBUM-DBUM.af0048cc3156c0d61bb4dd704d5a3502",
"name" : "WM_ADMIN_ROLE",
"description" : null,
"type" : "ENTITLEMENTS",
"timeCreated" : "2024-10-06T07:34:30.634Z",
"timeUpdated" : null,
"resource" : {
"id" : "resource.ICF.ag-api-demo-DBUM-DBUM.7e083f9851db1035408a877c654d28bd",
"name" : "ag-api-demo-DBUM-DBUM",
"displayName" : "ag-api-demo-DBUM-DBUM",
"type" : "DBUM",
"customAttributes" : null
},
"permissionType" : {
"id" : "etype.ICF.ag-api-demo-DBUM.6ae3be9a18b9aae2f8ba02e7f8908eaf",
"name" : "icf.connector.entitlement.type.roles",
"displayName" : "Role",
"externalId" : "roles"
}
}, {
"id" : "privileges.ICF.ag-api-demo-DBUM-DBUM.34ac64704d5894a58xxxxxxxx",
"name" : "CREATE USER",
"description" : null,
"type" : "ENTITLEMENTS",
"timeCreated" : "2024-10-06T07:34:29.080Z",
"timeUpdated" : null,
"resource" : {
"id" : "resource.ICF.ag-api-demo-DBUM.7e083f9851db103xxxxxxxxx",
"name" : "ag-api-demo-DBUM",
"displayName" : "ag-api-demo-DBUM",
"type" : "DBUM",
"customAttributes" : null
},
"permissionType" : {
"id" : "etype.ICF.ag-api-demo-DBUM.d1ecb6a39a6fd079c76bxxxxxxxx",
"name" : "icf.connector.entitlement.type.privileges",
"displayName" : "Privilege",
"externalId" : "privileges"
}
}
} ]
}