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

更新ロール

put

/access-governance/access-controls/20250331/roles/{roleId}

指定されたIDの既存のロールの詳細を更新します。

リクエスト

パス・パラメータ
ヘッダー・パラメータ
  • トレース用のクライアント・リクエストID。 リクエストIDに有効な文字は、文字、数字、アンダースコアおよびダッシュのみです。
本文()
更新されたロールの詳細。
ルート・スキーマ : UpdateRoleDetails
型: 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
エラー情報。
ソースを表示

412レスポンス

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

429レスポンス

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

500レスポンス

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

デフォルト・レスポンス

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

例

次の例は、PUTリクエストを送信してロールを更新する方法を示しています。 この例では、作成例の拡張として、データベース管理者用に別のアクセス・バンドル権限セットを追加

ノート:

grant_type = passwordを使用してアクセス・トークンを生成します。

cURL例 - 問合せパラメータなし

curl -i -L -X PUT \
   -H "Authorization:Bearer <your-access-token>" \
   -H "Content-Type:application/json" \
   -d \
'{
  "name": "Database Administrator Role",
  "description": "Responsible for managing database access and ensuring optimized SQL performance.",
  "requestableBy": "ANY",
  "approvalWorkflowId": "NO_APPROVAL_REQUIRED",
  "tags": [
    "Database 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
        }
      ]
    },
    {
      "id": "9f6a9e49-xxxx-4211-b702-cd47072346a2",
      "name": "ALTER ANY TABLE",
      "displayName": "Database Privilege - ALTER ANY TABLE",
      "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/${roleID}>'

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

{
  "name": "Database Administrator Role",
  "description": "Responsible for managing database access and ensuring optimized SQL performance.",
  "requestableBy": "ANY",
  "approvalWorkflowId": "NO_APPROVAL_REQUIRED",
  "tags": [
    "Database 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
        }
      ]
    },
    {
      "id": "9f6a9e49-xxxx-4211-b702-cd47072346a2",
      "name": "ALTER ANY TABLE",
      "displayName": "Database Privilege - ALTER ANY TABLE",
      "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
    }
  ]
}

レスポンス本文の例

次の例は、ロールを更新したアイデンティティの詳細を含む、JSON形式のレスポンス本文の内容を示しています:

{
  "id": "7642ff7d-xxxx-45c4-88d4-db7d2e79e85f",
  "name": "Database Administrator Role",
  "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": [
    {
      "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
        }
      ],
  "createdBy" : {
    "id" : "globalId.125123c3-xxxx-4d6a-b6d4-6c0f6537bad2.18.02e36bbb4b201421b44aa046b3ceb16a",
    "name" : "Amel Maclead",
    "displayName" : "Amel Maclead"
  },
  "updatedBy" : {
    "id" : "globalId.125123c3-xxxx-4d6a-b6d4-6c0f6537bad2.18.02e36bbb4b201421b44aa046b3ceb16a",
    "name" : "Amel Maclead",
    "displayName" : "Amel Maclead"
  },
  "customAttributes" : null,
  "externalId" : "cid1.agcsgovernanceinstance.dev.dev.xxxxxxxxpzw5rdia4pv5rudpgmf5enb2yzcloj2pbd5ogxaructfrhgbuq7a",
  "displayName" : "Database Admin Role"
}
先頭に戻る