ポリシーの取得
get
/access-governance/access-controls/20250331/policies/{policyId}
指定されたIDのポリシーの詳細を返します。
リクエスト
パス・パラメータ
- policyId(required): string
一意のポリシー識別子
ヘッダー・パラメータ
- opc-request-id: string
トレース用のクライアント・リクエストID。 リクエストIDに有効な文字は、文字、数字、アンダースコアおよびダッシュのみです。
レスポンス
サポートされているメディア・タイプ
- application/json
200レスポンス
指定されたIDのポリシー
ヘッダー
- etag: string
オプティミスティックな同時実行性制御用。 `if-match`を参照してください。
- opc-request-id: string
リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。
ルート・スキーマ: Policy
型:
object
ポリシー・モデル。
ソースを表示
- assignments: array assignments
権限関連に関連付けられたアサイメントのリスト。
- createdBy: object IdInfo
汎用識別情報オブジェクト。
- customAttributes: object customAttributes
権限アソシエーションに関連付けられたメタデータ
- description: string
権限関連付けの説明。
- displayName: string
権限関連付けのdisplayName
- id(必須): string
作成時に不変である一意のOracle ID (OCID)。
- name: string
わかりやすい名前。 ユニークでなければいけないし、それは変わりやすい。 機密情報の入力は避けてください。
- owners: array owners
所有者エンティティのリスト
- ownershipCollectionId: string
アイデンティティ・グループに関連付けられた所有権コレクション
- riskLevel: integer
リスク・レベル・オブ・ポリシー。0は低、1は高リスクを表します。
- status: string
許容値:
[ "ACTIVE", "DRAFT", "INACTIVE", "PENDING", "FAILED", "IN_PROGRESS", "SAVED", "SUCCESS", "TIMEOUT" ]
権限関連付けのステータス。 - tags: array tags
権限関連に添付されたタグのリスト。
- timeCreated: string(date-time)
権限関連ルールが作成された時間。 「An RFC3339」書式設定日時文字列
- timeUpdated: string(date-time)
権限関連ルールが最後に更新された時間。 「An RFC3339」書式設定日時文字列
- updatedBy: object IdInfo
汎用識別情報オブジェクト。
ネストされたスキーマ : assignments
型:
array
権限関連に関連付けられたアサイメントのリスト。
ソースを表示
- Array of: object PolicyAssignment
PolicyAssignmentモデル。
ネストされたスキーマ : IdInfo
型:
object
汎用識別情報オブジェクト。
ソースを表示
- displayName: string
エンティティの表示名。
- id: string
エンティティのID。
- name: string
エンティティの名前。
ネストされたスキーマ : PolicyAssignment
型:
object
PolicyAssignmentモデル。
ソースを表示
- accessBundles: array accessBundles
アクセス・バンドルのリスト
- assignmentId: string
権限関連に使用されるアサイメントID..
- assignmentType: string
許容値:
[ "ACCESS_BUNDLE", "ROLE" ]
リクエストされるアサイメントのタイプ。 - customAttributes: object customAttributes
権限アソシエーションに関連付けられたメタデータ
- identityCollections: array identityCollections
アイデンティティ・コレクションのリスト
- identityType: string
アイデンティティのタイプ
- roles: array roles
ロールのリスト
ネストされたスキーマ : identityCollections
型:
array
アイデンティティ・コレクションのリスト
ソースを表示
- Array of: object Info
汎用情報オブジェクト。
ネストされたスキーマ : 情報
型:
object
汎用情報オブジェクト。
ソースを表示
- displayName: string
エンティティの表示名。
- id: string
エンティティのID。
- name: string
エンティティの名前。
ネストされたスキーマ : OwnerSummary
型:
object
所有者エンティティ・オブジェクト
ソースを表示
- id(必須): string
作成時に変更できない一意の識別子
- isPrimary(required): boolean
このエンティティはプライマリ所有者ですか?
- name(required): 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>" \
'https://<host>/access-governance/access-controls/20250331/policy/${policyId}'
レスポンス本文の例
JSON形式のレスポンス本文のコンテンツの例を次に示します。
{
"id": "958b9x2a-0993-4x16-8ff2-d4730307c1c0",
"name": "Database Admin Policy",
"description": "Defines administrative privileges for managing database systems, including schema, object management, and maintenance operations.",
"status": "ACTIVE",
"timeCreated": "2025-04-10T20:58:00.273Z",
"timeUpdated": "2025-04-10T20:58:00.273Z",
"ownershipCollectionId": null,
"owners": [
{
"id": "globalId.12512xx3-eedc-4d6a-b6d4-6c0f6537bad2.18.02e36bbb4b20x421b44aa046b3ceb16a",
"name": "Amel MacLead",
"isPrimary": true
}
],
"createdBy": {
"id": "globalId.12512xx3-eedc-4d6a-b6d4-6c0f6537bad2.18.02e36bbb4b20x421b44aa046b3ceb16a",
"name": "Amel MacLead",
"displayName": "Amel MacLead"
},
"updatedBy": {
"id": "globalId.12512xx3-eedc-4d6a-b6d4-6c0f6537bad2.18.02e36bbb4b20x421b44aa046b3ceb16a",
"name": "Amel MacLead",
"displayName": "Amel MacLead"
},
"tags": null,
"customAttributes": null,
"displayName": "Database Admin Policy",
"assignments": [
{
"assignmentId": "222075f6-xxx-4c0e-b42c-47dbbaf0546d",
"assignmentType": "ACCESS_BUNDLE",
"identityType": "HUMAN",
"identityGroups": [
{
"id": "a4b3dd4b-xxx-4d77-858c-383a9c809f35",
"name": "Database Admin Group",
"displayName": "Database Admin Group",
"owners": [
{
"id": "globalId.12512xx3-eedc-4d6a-b6d4-6c0f6537bad2.18.02e36bbb4b20x421b44aa046b3ceb16a",
"name": "Amel MacLead",
"isPrimary": true
}
]
}
],
"accessBundles": [
{
"id": "feb5f02e-324a-4fb8-a9b6-a6da93139387",
"name": "DB-Admin-operations-0404b",
"displayName": "DB-Admin-operations-0404b",
"owners": [
{
"id": "globalId.12512xx3-eedc-4d6a-b6d4-6c0f6537bad2.18.02e36bbb4b20x421b44aa046b3ceb16a",
"name": "Amel MacLead",
"isPrimary": true
}
]
},
{
"id": "fdae3a05-8004-4f7d-98f7-a82f749c8de0",
"name": "Database Schema Management",
"displayName": "Database Schema Management",
"owners": [
{
"id": "globalId.12512xx3-eedc-4d6a-b6d4-6c0f6537bad2.18.02e36bbb4b20x421b44aa046b3ceb16a",
"name": "Amel MacLead",
"isPrimary": true
}
]
},
{
"id": "402da86b-87b7-4792-9121-dc10516f119b",
"name": "Database Object Management",
"displayName": "Database Object Management",
"owners": [
{
"id": "globalId.12512xx3-eedc-4d6a-b6d4-6c0f6537bad2.18.02e36bbb4b20x421b44aa046b3ceb16a",
"name": "Amel MacLead",
"isPrimary": true
}
]
}
],
"roles": [],
"customAttributes": null
}
],
"riskLevel": null
}