Method: projects.locations.endpointPolicies.setIamPolicy

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

可以返回 NOT_FOUND、INVALID_ARGUMENT、PERMISSION_DENIED 错误。

HTTP 请求

POST https://networkservices.googleapis.com/v1/{resource=projects/*/locations/*/endpointPolicies/*}: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

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