メソッド: keyRings.setIamPolicy

フルネーム: projects.locations.keyRings.setIamPolicy

指定したリソースにアクセス制御ポリシーを設定します。既存のポリシーは、すべて置き換えられます。

HTTP リクエスト

POST https://cloudkms.googleapis.com/v1/{resource=projects/*/locations/*/keyRings/*}:setIamPolicy

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
resource

string

必須: ポリシーが指定されているリソース。このフィールドに適切な値については、オペレーション ドキュメントをご覧ください。

リクエストの本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現

{
  "policy": {
    object(Policy)
  },
  "updateMask": string
}
フィールド
policy

object(Policy)

必須: resource に適用する完全なポリシー。ポリシーのサイズは数 10 KB に制限されています。空のポリシーは有効なポリシーですが、特定の Cloud Platform サービス(Projects など)では、これらが拒否される場合があります。

updateMask

string(FieldMask 形式)

省略可: 変更するポリシー フィールドを指定する FieldMask。マスク内のフィールドのみが変更されます。マスクが指定されていない場合、次のデフォルト マスクが使用されます。パス: "bindings, etag"。このフィールドは、Cloud IAM のみが使用します。

フィールドの完全修飾名のカンマ区切りリスト。例: "user.displayName,photo"

レスポンスの本文

成功した場合、レスポンスの本文には Policy のインスタンスが含まれます。

承認スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/cloudkms
  • https://www.googleapis.com/auth/cloud-platform

詳細については、認証の概要をご覧ください。

試してみましょう

このページは役立ちましたか?評価をお願いいたします。

フィードバックを送信...

Cloud KMS ドキュメント