Method: projects.locations.targets.setIamPolicy

设置对指定资源的访问权限控制政策。替换任何现有政策。

可以返回 NOT_FOUNDINVALID_ARGUMENTPERMISSION_DENIED 错误。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
resource

string

必需:要为其指定政策的资源。如需了解此字段的适当值,请参阅资源名称

请求正文

请求正文中包含结构如下的数据:

JSON 表示法
{
  "policy": {
    object (Policy)
  },
  "updateMask": string
}
字段
policy

object (Policy)

必需:要应用于 resource 的完整政策。政策的大小限制为几十 KB。空政策是有效的政策,但可能被某些 Google Cloud 服务(例如项目)拒绝。

updateMask

string (FieldMask format)

可选:用于指定要修改哪些政策字段的 FieldMask。只有掩码中的字段会被修改。如果未提供掩码,则使用以下默认掩码:

paths: "bindings, etag"

这是完全限定字段名称的逗号分隔列表。示例:"user.displayName,photo"

响应正文

如果成功,则响应正文包含一个 Policy 实例。

授权范围

需要以下 OAuth 范围:

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

如需了解详情,请参阅身份验证概览