機械翻訳について
  1. Oracle Access Governance REST APIs
  2. タスク
  3. ポリシー

ポリシーの作成

post

/access-governance/access-controls/20250331/policies

指定された詳細で新しいポリシーを作成します。

リクエスト

ヘッダー・パラメータ
  • トレース用のクライアント・リクエストID。 リクエストIDに有効な文字は、文字、数字、アンダースコアおよびダッシュのみです。
本文()
新規ポリシーの詳細
ルート・スキーマ : CreatePolicyDetails
型: object
新規ポリシーの作成に必要なモデル
ソースを表示
ネストされたスキーマ : assignments
型: array
ポリシーに関連付けられた割当のリスト。
ソースを表示
ネストされたスキーマ : customAttributes
型: object
ポリシーに関連付けられたメタデータ
ソースを表示
ネストされたスキーマ: owner
型: array
所有者エンティティのリスト
ソースを表示
ネストされたスキーマ: tags
型: array
ポリシーに添付されたタグのリスト。
ソースを表示
ネストされたスキーマ : PolicyAssignment
型: object
PolicyAssignmentモデル。
ソースを表示
ネストされたスキーマ : accessBundles
型: array
アクセス・バンドルのリスト
ソースを表示
ネストされたスキーマ : customAttributes
型: object
権限アソシエーションに関連付けられたメタデータ
ソースを表示
ネストされたスキーマ : identityCollections
型: array
アイデンティティ・コレクションのリスト
ソースを表示
ネストされたスキーマ: roles
型: array
ロールのリスト
ソースを表示
ネストされたスキーマ : 情報
型: object
汎用情報オブジェクト。
ソースを表示
ネストされたスキーマ : OwnerSummary
型: object
所有者エンティティ・オブジェクト
ソースを表示
トップに戻る

レスポンス

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

200レスポンス

新しく作成されたポリシー
ヘッダー
  • オプティミスティックな同時実行性制御用。 `if-match`を参照してください。
  • リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。
本文()
ルート・スキーマ: Policy
型: object
ポリシー・モデル。
ソースを表示
ネストされたスキーマ : assignments
型: array
権限関連に関連付けられたアサイメントのリスト。
ソースを表示
ネストされたスキーマ : IdInfo
型: object
汎用識別情報オブジェクト。
ソースを表示
ネストされたスキーマ : customAttributes
型: object
権限アソシエーションに関連付けられたメタデータ
ソースを表示
ネストされたスキーマ: owner
型: array
所有者エンティティのリスト
ソースを表示
ネストされたスキーマ: tags
型: array
権限関連に添付されたタグのリスト。
ソースを表示
ネストされたスキーマ : PolicyAssignment
型: object
PolicyAssignmentモデル。
ソースを表示
ネストされたスキーマ : accessBundles
型: array
アクセス・バンドルのリスト
ソースを表示
ネストされたスキーマ : customAttributes
型: object
権限アソシエーションに関連付けられたメタデータ
ソースを表示
ネストされたスキーマ : identityCollections
型: array
アイデンティティ・コレクションのリスト
ソースを表示
ネストされたスキーマ: roles
型: array
ロールのリスト
ソースを表示
ネストされたスキーマ : 情報
型: object
汎用情報オブジェクト。
ソースを表示
ネストされたスキーマ : OwnerSummary
型: object
所有者エンティティ・オブジェクト
ソースを表示

400レスポンス

不正なリクエスト
ヘッダー
  • リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。
本文()
ルート・スキーマ : Error
型: object
エラー情報。
ソースを表示

401レスポンス

未認可
ヘッダー
  • リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。
本文()
ルート・スキーマ : Error
型: object
エラー情報。
ソースを表示

404レスポンス

見つかりません
ヘッダー
  • リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。
本文()
ルート・スキーマ : Error
型: object
エラー情報。
ソースを表示

409レスポンス

競合
ヘッダー
  • リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。
本文()
ルート・スキーマ : Error
型: object
エラー情報。
ソースを表示

429レスポンス

リクエストが多すぎます
ヘッダー
  • リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。
本文()
ルート・スキーマ : Error
型: object
エラー情報。
ソースを表示

500レスポンス

内部サーバー・エラー
ヘッダー
  • リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。
本文()
ルート・スキーマ : Error
型: object
エラー情報。
ソースを表示

デフォルト・レスポンス

不明なエラー
ヘッダー
  • リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。
本文()
ルート・スキーマ : Error
型: object
エラー情報。
ソースを表示
トップに戻る

例

次の例は、ポリシーの作成方法を示しています。 サンプル・コマンドを実行する前に、プレースホルダー値を実際の値に置き換えます。

ポリシーを作成する前に、次のAPIを実行して必要なデータをフェッチする必要があります:
  • アクセス・バンドルのリスト - [GET] {BasePath}/accessBundles
  • ロールのリスト - [GET] {BasePath}/roles
  • アイデンティティのリスト - [GET] {BasePath}/identities
.

cURLリクエストの例

curl -i -X POST \
   -H "Authorization:Bearer <your-access-token>" \
   -H "Content-Type:application/json" \
   -d \
'{
  "name": "Admin DBUM Policy",
  "description": "Admin DBUM Policy",
  "submittedBy": "globalId.125123c3-xxx-4d6a-b6d4-xxx.18.xxx",
  "tags": [
    "DBUM Performance"
  ],
  "customAttributes": {},
  "displayName": "Admin Database Policy",
  "assignments": [
    {
      "assignmentId": "",
      "assignmentType": "ACCESS_BUNDLE",
      "identityType": "ALL",
      "identityCollections": [
        {
          "id": "a4b3dd4b-xxx-4d77-858c-xxx",
          "name": "Database Administrators"
        },
        {
          "id": "fbc9774f-xxx-415d-8b81-xxx",
          "name": "Database Performance Administrators"
        }
      ],
      "accessBundles": [
        {
          "id": "52fea7fb-xxx-4b1e-bc37-xxx",
          "name": "SQL Tuning Access"
        },
        {
          "id": "45ed5c4c-xxx-4e80-ba1c-xxx",
          "name": "DBUM Standard SQL Tuning Access UA2"
        },
        {
          "id": "xxx-xxx-xxx-xxx-xxx",
          "name": "Oracle DBUM Performance Admin Access"
        }
      ]
    }
  ],
  "owners": [
    {
      "id": "globalId.125123c3-xxx-4d6a-b6d4-xxx.18.xxx",
      "name": "Amel Maclead",
      "isPrimary": true
    }
  ]
}' \
 '<${service-instance-url}/access-governance/access-controls/20250331/policies/>'

POSTリクエストの送信

${service-instance-url}/access-governance/access-controls/${version}/policies/

リクエスト・ペイロードの例

{
  "name": "Admin DBUM Policy",
  "description": "Admin DBUM Policy",
  "submittedBy": "globalId.125123c3-xxx-4d6a-b6d4-xxx.18.xxx",
  "tags": [
    "DBUM UA"
  ],
  "customAttributes": {},
  "displayName": "Admin Database Policy",
  "assignments": [
    {
      "assignmentId": "",
      "assignmentType": "ACCESS_BUNDLE",
      "identityType": "ALL",
      "identityCollections": [
        {
          "id": "a4b3dd4b-xxx-4d77-858c-xxx",
          "name": "Database Administrators"
        },
        {
          "id": "fbc9774f-xxx-415d-8b81-xxx",
          "name": "Database Performance Administrators"
        }
      ],
      "accessBundles": [
        {
          "id": "52fea7fb-xxx-4b1e-bc37-xxx",
          "name": "SQL Tuning Access"
        },
        {
          "id": "45ed5c4c-xxx-4e80-ba1c-xxx",
          "name": "DBUM Standard SQL Tuning Access UA2"
        },
        {
          "id": "xxx-xxx-xxx-xxx-xxx",
          "name": "Oracle DBUM Performance Admin Access"
        }
      ]
    }
  ],
  "owners": [
    {
      "id": "globalId.125123c3-xxx-4d6a-b6d4-xxx.18.xxx",
      "name": "Amel Maclead",
      "isPrimary": true
    }
  ]
}

レスポンス・コードの例

ポリシーの作成には数秒かかる場合があります。 リクエストを中断しないでください。

次のレスポンス本文とともに200 OKレスポンスを受信します:

{
    "id": "2e451b51-xxx-4bbc-9894-xxx",
    "name": "Admin DBUM Policy",
    "description": "Admin DBUM Policy",
    "status": "ACTIVE",
    "timeCreated": "2025-05-07T15:44:50.209Z",
    "timeUpdated": "2025-05-07T15:44:50.209Z",
    "ownershipCollectionId": "03b05e0d-xxx-4f7e-a101-xxx",
    "owners": [
        {
            "id": "globalId.125123c3-xxx-4d6a-b6d4-xxx.18.xxx",
            "name": "Amel Maclead",
            "isPrimary": true
        }
    ],
    "createdBy": {
        "id": "globalId.125123c3-xxx-4d6a-b6d4-xxx.18.xxx",
        "name": "Amel Maclead",
        "displayName": "Amel Maclead"
    },
    "updatedBy": {
        "id": "globalId.125123c3-xxx-4d6a-b6d4-xxx.18.xxx",
        "name": "Amel Maclead",
        "displayName": "Amel Maclead"
    },
    "tags": [
        "DBUM UA"
    ],
    "customAttributes": {},
    "displayName": "Admin Database Policy",
    "assignments": [
        {
            "assignmentId": "44b7d7a9-xxx-4a11-88f9-xxx",
            "assignmentType": "ACCESS_BUNDLE",
            "identityType": "HUMAN",
            "identityCollections": [
                {
                    "id": "fbc9774f-xxx-415d-8b81-xxx",
                    "name": "testICArun1",
                    "displayName": "testICArun1",
                    "owners": null
                },
                {
                    "id": "a4b3dd4b-xxx-4d77-858c-xxx",
                    "name": "Database Administrators"
                },
                {
                    "id": "xxx-xxx-xxx-xxx-xxx",
                    "name": "Database Performance Administrators"
                }
            ],
            "accessBundles": [
                {
                    "id": "45ed5c4c-xxx-4e80-ba1c-xxx",
                    "name": "DBUM Standard SQL Tuning Access UA2",
                    "displayName": "DBUM Standard SQL Tuning Access UA2",
                    "owners": null
                },
                {
                    "id": "52fea7fb-xxx-4b1e-bc37-xxx",
                    "name": "SQL Tuning Access"
                },
                {
                    "id": "xxx-xxx-xxx-xxx-xxx",
                    "name": "Oracle DBUM Performance Admin Access"
                }
            ],
            "roles": [],
            "customAttributes": null
        }
    ],
    "riskLevel": null
}
先頭に戻る