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

新規ロールの作成

post

/access-governance/access-controls/20250331/roles

指定された詳細で新しいロールを作成します。

リクエスト

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

レスポンス

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

200レスポンス

新しく作成されたロール
ヘッダー
  • オプティミスティックな同時実行性制御用。 `if-match`を参照してください。
  • リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。
本文()
ルート・スキーマ: Role
型: object
ロール・オブジェクト。
ソースを表示
ネストされたスキーマ : accessBundles
型: array
アクセス・バンドルのリスト
ソースを表示
ネストされたスキーマ : IdInfo
型: object
汎用識別情報オブジェクト。
ソースを表示
ネストされたスキーマ : customAttributes
型: object
ロールに関連付けられたメタデータ
ソースを表示
ネストされたスキーマ: owner
型: array
所有者エンティティのリスト
ソースを表示
ネストされたスキーマ: tags
型: array
ロールに添付されたタグのリスト
ソースを表示
ネストされたスキーマ : AccessBundle
型: object
バンドル・オブジェクトにアクセスします。
ソースを表示
ネストされたスキーマ : AccessGuardrailDetails
型: object
Guardrailオブジェクトにアクセスします。
ソースを表示
ネストされたスキーマ : AccessBundleTimeLimit
型: object
時間制限の定義。 daysLimit、hoursLimitまたはdateTimeLimitのいずれか1つのみを指定する必要があります。
ソースを表示
ネストされたスキーマ : 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
エラー情報。
ソースを表示
トップに戻る

例

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

ノート:

grant_type = passwordまたは認可コードを使用してアクセス・トークンを生成します。
ロールを作成する前に、次のAPIを実行して必要なデータをフェッチする必要があります:
  • すべての承認ワークフローのリスト - [GET] {BasePath}/approvalWorkflows
  • アクセス・バンドルのリスト - [GET] {BasePath}/accessBundles
.

cURLリクエストの例

curl -i -X POST \
   -H "Authorization:Bearer <your-access-token>" \
   -H "Content-Type:application/json" \
   -d \
'{
  "name": "Database Administrator",
  "description": "Responsible for managing database access and ensuring optimized SQL performance.",
  "requestableBy": "ANY",
  "approvalWorkflowId": "NO_APPROVAL_REQUIRED",
  "tags": [
    "UA Role"
  ],
  "accessBundles": [
    {
      "id": "b943f987-xxxx-4bac-bca0-6a09ded5dcad",
      "name": "DBUM Standard SQL Tuning Access UA 8",
      "displayName": "DBUM Standard SQL Tuning Access UA 8",
      "owners": [
        {
          "id": "globalId.125123c3-xxxx-4d6a-b6d4-6c0f6537bad2.18.02e36bbb4b201421b44aa046b3ceb16a",
          "name": "Bill Clark",
          "isPrimary": true
        }
      ]
    }
  ],
  "customAttributes": null,
  "displayName": "Database Administrator Role",
  "owners": [
    {
      "id": "globalId.125123c3-xxxx-4d6a-b6d4-6c0f6537bad2.18.02e36bbb4b201421b44aa046b3ceb16a",
      "name": "Bill Clark",
      "isPrimary": true
    }
  ]
}' \
 '<${service-instance-url}/access-governance/access-controls/20250331/roles>'

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

{
  "name": "Database Administrator",
  "description": "Responsible for managing database access and ensuring optimized SQL performance.",
  "requestableBy": "ANY",
  "approvalWorkflowId": "NO_APPROVAL_REQUIRED",
  "tags": [
    "UA Role"
  ],
  "accessBundles": [
    {
      "id": "b943f987-xxxx-4bac-bca0-6a09ded5dcad",
      "name": "DBUM Standard SQL Tuning Access UA 8",
      "displayName": "DBUM Standard SQL Tuning Access UA 8",
      "owners": [
        {
          "id": "globalId.125123c3-xxxx-4d6a-b6d4-6c0f6537bad2.18.02e36bbb4b201421b44aa046b3ceb16a",
          "name": "Bill Clark",
          "isPrimary": true
        }
      ]
    }
  ],
  "customAttributes": null,
  "displayName": "Database Administrator Role",
  "owners": [
    {
      "id": "globalId.125123c3-xxxx-4d6a-b6d4-6c0f6537bad2.18.02e36bbb4b201421b44aa046b3ceb16a",
      "name": "Bill Clark",
      "isPrimary": true
    }
  ]
}

レスポンス・コードの例

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

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

{
    "id": "7642ff7d-xxxx-45c4-88d4-db7d2e79e85f",
    "name": "Database Administrator",
    "description": "Responsible for managing database access and ensuring optimized SQL performance.",
    "requestableBy": {
        "id": "ANY",
        "name": "Anyone",
        "displayName": "Anyone"
    },
    "status": "ACTIVE",
    "approvalWorkflowId": {
        "id": "NO_APPROVAL_REQUIRED",
        "name": "No Approval Required",
        "displayName": "No Approval Required"
    },
    "tags": [
        "Database Role"
    ],
    "accessBundles": null,
    "timeCreated": "2025-04-24T06:55:26.546Z",
    "timeUpdated": "2025-04-24T06:55:26.546Z",
    "ownershipCollectionId": "b384e140-xxxx-413f-843b-bafc38182db7",
    "owners": [
        {
            "id": "globalId.125123c3-xxxx-4d6a-b6d4-6c0f6537bad2.18.02e36bbb4b201421b44aa046b3ceb16a",
            "name": "Bill Clark",
            "isPrimary": true
        }
    ],
    "createdBy": {
        "id": "globalId.125123c3-xxxx-4d6a-b6d4-6c0f6537bad2.18.02e36bbb4b201421b44aa046b3ceb16a",
        "name": "Bill Clark",
        "displayName": "Bill Clark"
    },
    "updatedBy": {
        "id": "globalId.125123c3-xxxx-4d6a-b6d4-6c0f6537bad2.18.02e36bbb4b201421b44aa046b3ceb16a",
        "name": "Bill Clark",
        "displayName": "Bill Clark"
    },
    "customAttributes": null,
    "externalId": "ocid1.agcsgovernanceinstance.dev.dev.xxxxxxxxpzw5rdia4pv5rudpgmf5enb2yzcloj2pbd5ogxaructfrhgbuq7a",
    "displayName": "Database Admin Role"
}
先頭に戻る