アクセス・バンドルのアクティブ化
patch
/access-governance/access-controls/20250331/accessBundles/{accessBundleId}/activate
指定されたIDで現在ドラフト状態にあるアクセス・バンドルをアクティブ化します。 アクセス・バンドルが現在「ドラフト」ステータスではない場合、エラーが返されます。
リクエスト
パス・パラメータ
- accessBundleId(required): string
指定されたIDのアクセス・バンドルの検索に使用されるフィルタ。 使用可能な値は、ListAccessBundles操作を使用して確認できます。
ヘッダー・パラメータ
- opc-request-id: string
トレース用のクライアント・リクエストID。 リクエストIDに有効な文字は、文字、数字、アンダースコアおよびダッシュのみです。
レスポンス
サポートされているメディア・タイプ
- application/json
200レスポンス
アクティブ化されたアクセス・バンドル
ヘッダー
- 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
判読可能なエラー文字列。
412レスポンス
事前条件は失敗しました
ヘッダー
- 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
判読可能なエラー文字列。
例
次の例は、パッチ・リクエストを送信してアクセス・バンドルをアクティブ化する方法を示しています。 このAPIの実行後、アクセス・バンドルのステータスが「ドラフト」から「アクティブ」に変更されます。
cURL PATCHの例
curl -i -X \
PATCH \
-H \
"Authorization:Bearer <your access token>" \
-d \
'' \
'${service-instance-url}/access-governance/access-controls/20250331/accessBundles/${accessBundleId}/activate'
レスポンス・コードの例
次のレスポンス本文を含む200 OKレスポンス・コードを受け取ります:
{
"accessBundleType" : "PERMISSION_BUNDLE",
"id" : "787190ce-b440-4619-a020-88a1xxx995",
"name" : "AD-Basic-Permissions",
"displayName" : "AD-Basic-Permissions",
"description" : "",
"tags" : [ "REST API UA" ],
"timeCreated" : "2025-03-21T16:50:28.624Z",
"timeUpdated" : "2025-03-21T16:52:02.609Z",
"createdBy" : {
"id" : "globalId.125123c3-eedc-4d6a-b6d4-6c0f6537bad2.18.02e36bbb4xxxxxb44aa046b3ceb16a",
"name" : "Amel Maclead",
"displayName" : "Amel Maclead"
},
"updatedBy" : {
"id" : "globalId.125123c3-eedc-4d6a-b6d4-6c0f6537bad2.18.02e36bccxxx21b44aa046b3ceb16a",
"name" : "Amel Maclead",
"displayName" : "Amel 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" : "e4aa3f66-9eed-4a25-b8cc-a04c3fb2d84a",
"name" : "AD System AG_App_Owner_Admin",
"displayName" : "AD System AG_App_Owner_Admin"
},
"orchestratedSystemType" : "ICF",
"ownershipCollectionId" : "6957a649-308b-408f-b0f1-aa675dcfa07d",
"owners" : [ {
"id" : "globalId.125123c3-eedc-4d6a-b6d4-6c0f6537bad2.18.02e36bbxxxxb44aa046b3ceb16a",
"name" : "Amel Maclead",
"isPrimary" : true
} ],
"externalId" : "ocid1.agcsgovernanceinstance.dev.dev.amaaaaaapzw5rdiaxxxxmf5enb2yzcloj2pbd5ogxaructfrhgbuq7a",
"cloudAccountName" : null,
"domainName" : null,
"resourceType" : null,
"compartmentName" : null,
"compartmentFqn" : null,
"customAttributes" : { },
"permissions" : [ {
"id" : "groups.ICF.e4aa3f66-9eed-4a25-b8cc-a04c3fb2d84a.95dexxxxf8af649d7709915e0",
"name" : "AD_JML_GRP1",
"description" : null,
"type" : "ENTITLEMENTS",
"timeCreated" : "2024-08-12T13:44:07.205Z",
"timeUpdated" : null,
"resource" : {
"id" : "resource.ICF.e4aa3f66-9eed-4a25-b8cc-a04c3fb2d84a.e427xxxxxxxxx7f067fc39be6f",
"name" : "AD System AG_App_Owner_Admin",
"displayName" : "AD System AG_App_Owner_Admin",
"type" : "AD",
"customAttributes" : null
},
"permissionType" : {
"id" : "etype.ICF.e4aa3f66-9eed-4a25-b8cc-a04c3fb2d84a.936d9xxxxxx01c59cdaeaa3",
"name" : "icf.connector.entitlement.type.groups",
"displayName" : "Group",
"externalId" : "groups"
}
}, {
"id" : "groups.ICF.e4aa3f66-9eed-4a25-b8cc-a04c3fb2d84a.edba9xxxxxx99d1a944",
"name" : "AD_JML_PERSONAS1",
"description" : null,
"type" : "ENTITLEMENTS",
"timeCreated" : "2024-08-12T14:34:43.034Z",
"timeUpdated" : null,
"resource" : {
"id" : "resource.ICF.e4aa3f66-9eed-4a25-b8cc-a04c3fb2d84a.e427125e46e48xxxxx7fc39be6f",
"name" : "AD System AG_App_Owner_Admin",
"displayName" : "AD System AG_App_Owner_Admin",
"type" : "AD",
"customAttributes" : null
},
"permissionType" : {
"id" : "etype.ICF.e4aa3f66-9eed-4a25-b8cc-a04c3fb2d84a.936d9be0ce4c3ce91d9401c59cdaeaa3",
"name" : "icf.connector.entitlement.type.groups",
"displayName" : "Group",
"externalId" : "groups"
}
} ]
}