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

アクセス・バンドルの作成

post

/access-governance/access-controls/20250331/accessBundles

指定された詳細で新しいアクセス・バンドルを作成します。

リクエスト

ヘッダー・パラメータ
  • トレース用のクライアント・リクエストID。 リクエストIDに有効な文字は、文字、数字、アンダースコアおよびダッシュのみです。
本文()
新しいアクセス・バンドルの詳細
ルート・スキーマ : CreateAccessBundleDetails
型: object
新しいアクセス・バンドルに関する情報。
ソースを表示
ネストされたスキーマ : AccessBundleTimeLimit
型: object
時間制限の定義。 daysLimit、hoursLimitまたはdateTimeLimitのいずれか1つのみを指定する必要があります。
ソースを表示
ネストされたスキーマ : customAttributes
型: object
アクセス・バンドルに関連付けられたメタデータ。
ソースを表示
ネストされたスキーマ : OrchestratedSystemAttributeSummary
型: object
アカウント属性と権限属性。
ソースを表示
ネストされたスキーマ: owner
型: array
所有者エンティティのリスト。
ソースを表示
ネストされたスキーマ: tags
型: array
アクセス・バンドルに添付されたタグのリスト。
ソースを表示
ネストされたスキーマ : AccessBundleTimeLimitDays
型: object
時間制限の定義(日数)。
ソースを表示
ネストされたスキーマ : AccessBundleTimeLimitHours
型: object
時間制限の定義(時間)。
ソースを表示
ネストされたスキーマ : IdInfo
型: object
汎用識別情報オブジェクト。
ソースを表示
ネストされたスキーマ : accountAttributes
型: array
オーケストレーション済システム・アカウント属性のリスト。
ソースを表示
ネストされたスキーマ : permissionAttributes
型: array
オーケストレート済システム権限属性のリスト。
ソースを表示
ネストされたスキーマ : OrchestratedSystemAttributeDataSummary
型: object
オーケストレーション・システム属性
ソースを表示
ネストされたスキーマ: children
型: array
ネストされた属性
ソースを表示
ネストされたスキーマ: values
型: array
属性値
ソースを表示
ネストされたスキーマ : NestedAttributesSummary
型: object
オーケストレーション・システム属性のネストされたセット
ソースを表示
ネストされたスキーマ: items
型: array
オーケストレーションされたシステム属性
ソースを表示
ネストされたスキーマ : OwnerSummary
型: object
所有者エンティティ・オブジェクト
ソースを表示
トップに戻る

レスポンス

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

200レスポンス

新しく作成されたアクセス・バンドル
ヘッダー
  • オプティミスティックな同時実行性制御用。 `if-match`を参照してください。
  • リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。
本文()
ルート・スキーマ : AccessBundle
型: object
バンドル・オブジェクトにアクセスします。
ソースを表示
ネストされたスキーマ : AccessGuardrailDetails
型: object
Guardrailオブジェクトにアクセスします。
ソースを表示
ネストされたスキーマ : AccessBundleTimeLimit
型: object
時間制限の定義。 daysLimit、hoursLimitまたはdateTimeLimitのいずれか1つのみを指定する必要があります。
ソースを表示
ネストされたスキーマ : IdInfo
型: object
汎用識別情報オブジェクト。
ソースを表示
ネストされたスキーマ : customAttributes
型: object
アクセス・バンドルに関連付けられたメタデータ。
ソースを表示
ネストされたスキーマ : OrchestratedSystemAttributeSummary
型: object
アカウント属性と権限属性。
ソースを表示
ネストされたスキーマ: owner
型: array
所有者エンティティのリスト。
ソースを表示
ネストされたスキーマ : 許可
型: array
権限のリスト
ソースを表示
ネストされたスキーマ: tags
型: array
アクセス・バンドルに添付されたタグのリスト。
ソースを表示
ネストされたスキーマ : AccessBundleTimeLimitDays
型: object
時間制限の定義(日数)。
ソースを表示
ネストされたスキーマ : AccessBundleTimeLimitHours
型: object
時間制限の定義(時間)。
ソースを表示
ネストされたスキーマ : accountAttributes
型: array
オーケストレーション済システム・アカウント属性のリスト。
ソースを表示
ネストされたスキーマ : permissionAttributes
型: array
オーケストレート済システム権限属性のリスト。
ソースを表示
ネストされたスキーマ : OrchestratedSystemAttributeDataSummary
型: object
オーケストレーション・システム属性
ソースを表示
ネストされたスキーマ: children
型: array
ネストされた属性
ソースを表示
ネストされたスキーマ: values
型: array
属性値
ソースを表示
ネストされたスキーマ : NestedAttributesSummary
型: object
オーケストレーション・システム属性のネストされたセット
ソースを表示
ネストされたスキーマ: items
型: array
オーケストレーションされたシステム属性
ソースを表示
ネストされたスキーマ : OwnerSummary
型: object
所有者エンティティ・オブジェクト
ソースを表示
ネストされたスキーマ : PermissionSummary
型: object
権限の説明。
ソースを表示
ネストされたスキーマ : PermissionTypeSummary
型: object
PermissionTypeサマリー。
ソースを表示
ネストされたスキーマ : ResourceSummary
型: object
資源要約
ソースを表示
ネストされたスキーマ : customAttributes
型: 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}/orchestratedSystem
  • オーケストレーションされたシステムのすべてのアクセス権を一覧表示 - [GET] {BasePath}/orchestratedSystem/{id}/permissions
  • オーケストレーションされたシステムの権限属性の検索 - [POST] {BasePath}/orchestratedSystem/{id}/permissionAttributes
  • 指定された参照タイプのすべての参照値をリスト - [GET] {BasePath}/orchestratedSystem/{id}/lookupAttributes?lookupType=<lookupType>
  • オーケストレーション・システムのすべてのアカウント・プロファイルのリスト - [GET] {BasePath}/orchestratedSystem/{id}/accountProfiles
  • すべての承認ワークフローのリスト - [GET] {BasePath}/approvalWorkflows
  • 新規アクセス・バンドルの作成 - [POST] {BasePath}/accessBundles
.

cURLリクエストの例

curl -i -X POST \
   -H "Authorization:Bearer <your-access-token>" \
   -H "Content-Type:application/json" \
   -d \
'{
  "name": "DBUM Standard SQL Tuning Access time limit",
  "displayName": "DBUM AB UA API - Time limit",
  "description": "DBUM AB UA API - Time Limit",
  "tags": ["DBUM UA"],
  "owners": [
    {
      "id": "globalId.8d51efxx-ab68-4f09-ae89-7bcc0fxxxxxxxx",
      "name": "Amel Maclead",
      "isPrimary": true
    }
  ],
  "requestableBy": "ANY",
  "approvalWorkflowId": "NO_APPROVAL_REQUIRED",
  "orchestratedSystemId": "180a797x-a20b-4ebf-b7b1-xxxxxxxxxxxx",
  "accessBundleType": "PERMISSION_BUNDLE",
  "verb": "string",
  "items": [
    {
      "id": "privileges.ICF.180a797x-a20b-4ebf-b7b1-xxxxxxxxxxxx",
      "name": "ADMINISTER ANY SQL TUNING SET"
    }
  ],
  "externalId": null,
  "domainName": null,
  "resourceType": null,
  "accountProfileId": "eadea6xx-ad32-47ef-a69f-xxxxxxxxxxxx",
  "accountProfileName": "Profile_other",
  "orchestratedSystemAttributes": {
    "accountAttributes": [],
    "permissionAttributes": [
      {
        "name": "privileges.ICF.180a797x-a20b-4ebf-b7b1-xxxxxxxxxxxx",
        "type": "RepeatableFieldSet",
        "title": null,
        "values": ["ADMINISTER ANY SQL TUNING SET"],
        "children": [
          {
            "items": [
              {
                "name": "privilegeAdminOption",
                "title": "Privilege admin option",
                "values": ["YES"],
                "children": [],
                "lookupType": "withAdminOption",
                "permissionType": null,
                "discriminator": null,
                "values": ["YES"]
              }
            ]
          }
        ],
        "discriminator": null,
        "isQuestion": true
      }
    ]
  },
  "customAttributes": {},
  "autoApproveIfNoViolation": false,
  "accessTimeLimitType": "NUMBER_OF_HOURS",
  "accessTimeLimit": {
    "hoursLimit": {
      "accessLimitInHours": 24,
      "notificationInHours": 1,
      "extensionInHours": 6,
      "extensionApprovalWorkflowId": {
        "id": "Guid_03f0exxx-129a-43dc-a8e9-xxxxxxxxxxxx",
        "name": "Custom_WF_Amel Maclead",
        "displayName": "Custom_WF_Amel Maclead"
      }
    }
  }
}
' \
 '<${service-instance-url}/access-governance/access-controls/20250331/accessBundles>'

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

{
  "name": "DBUM Standard SQL Tuning Access time limit",
  "displayName": "DBUM AB UA API - Time limit",
  "description": "DBUM AB UA API - Time Limit",
  "tags": ["DBUM UA"],
  "owners": [
    {
      "id": "globalId.8d51efxx-ab68-4f09-ae89-7bcc0fxxxxxxxx",
      "name": "Amel Maclead",
      "isPrimary": true
    }
  ],
  "requestableBy": "ANY",
  "approvalWorkflowId": "NO_APPROVAL_REQUIRED",
  "orchestratedSystemId": "180a797x-a20b-4ebf-b7b1-xxxxxxxxxxxx",
  "accessBundleType": "PERMISSION_BUNDLE",
  "verb": "string",
  "items": [
    {
      "id": "privileges.ICF.180a797x-a20b-4ebf-b7b1-xxxxxxxxxxxx",
      "name": "ADMINISTER ANY SQL TUNING SET"
    }
  ],
  "externalId": null,
  "domainName": null,
  "resourceType": null,
  "accountProfileId": "eadea6xx-ad32-47ef-a69f-xxxxxxxxxxxx",
  "accountProfileName": "Profile_other",
  "orchestratedSystemAttributes": {
    "accountAttributes": [],
    "permissionAttributes": [
      {
        "name": "privileges.ICF.180a797x-a20b-4ebf-b7b1-xxxxxxxxxxxx",
        "type": "RepeatableFieldSet",
        "title": null,
        "values": ["ADMINISTER ANY SQL TUNING SET"],
        "children": [
          {
            "items": [
              {
                "name": "privilegeAdminOption",
                "title": "Privilege admin option",
                "values": ["YES"],
                "children": [],
                "lookupType": "withAdminOption",
                "permissionType": null,
                "discriminator": null,
                "values": ["YES"]
              }
            ]
          }
        ],
        "discriminator": null,
        "isQuestion": true
      }
    ]
  },
  "customAttributes": {},
  "autoApproveIfNoViolation": false,
  "accessTimeLimitType": "NUMBER_OF_HOURS",
  "accessTimeLimit": {
    "hoursLimit": {
      "accessLimitInHours": 24,
      "notificationInHours": 1,
      "extensionInHours": 6,
      "extensionApprovalWorkflowId": {
        "id": "Guid_03f0exxx-129a-43dc-a8e9-xxxxxxxxxxxx",
        "name": "Custom_WF_Amel Maclead",
        "displayName": "Custom_WF_Amel Maclead"
      }
    }
  }
}

レスポンス・コードの例

アクセス・バンドルの作成には数秒かかる場合があります。 リクエストを中断しないでください。

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

{
    "id": "20f536xx-f8c1-40f5-98f7-6fc0e2xxxxxx",
    "name": "DBUM Standard SQL Tuning Access time limit",
    "displayName": "DBUM AB UA API - Time limit",
    "description": "DBUM AB UA API - Time Limit",
    "tags": ["DBUM UA"],
    "timeCreated": "2025-06-16T06:44:xx.xxxZ",
    "timeUpdated": "2025-06-16T06:44:xx.xxxZ",
    "createdBy": {
        "id": "88b969xxce3446539535704800xxxxxx",
        "name": "88b969xxce3446539535704800xxxxxx",
        "displayName": "88b969xxce3446539535704800xxxxxx"
    },
    "updatedBy": {
        "id": "88b969xxce3446539535704800xxxxxx",
        "name": "88b969xxce3446539535704800xxxxxx",
        "displayName": "88b969xxce3446539535704800xxxxxx"
    },
    "owners": [
        {
            "id": "globalId.8d51efxx-ab68-4f09-ae89-7bcc0fxxxxxxxx",
            "name": "Amel Maclead",
            "isPrimary": true
        }
    ],
    "externalId": "ocid1.agcsgovernanceinstance.oc1.iad.amaaaaaaxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "accountProfileId": "eadea6xx-ad32-47ef-a69f-94dfa2xxxxxxxx",
    "accountProfileName": "Profile_other",
    "permissions": [
        {
            "id": "privileges.ICF.180a797xx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
            "name": "ADMINISTER ANY SQL TUNING SET",
            "timeCreated": "2025-02-12T11:48:xx.xxxZ",
            "resource": {
                "id": "resource.ICF.180a797xx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
                "name": "DBUM OnBoard QA",
                "displayName": "DBUM OnBoard QA"
            }
        }
    ],
    "accessTimeLimit": {
        "hoursLimit": {
            "accessLimitInHours": 24,
            "notificationInHours": 1,
            "extensionInHours": 6,
            "extensionApprovalWorkflowId": {
                "id": "Guid_03f0eaxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
                "name": "Custom_WF_Amel Maclead",
                "displayName": "Custom_WF_Amel Maclead"
            }
        }
    }
}
先頭に戻る