Method: projects.locations.services.setIamPolicy

Sets the IAM Access control policy for the specified Service. Overwrites any existing policy.

HTTP request

POST https://{endpoint}/v1alpha1/{resource}:setIamPolicy

Where {endpoint} is one of the supported service endpoints.

Path parameters

Parameters
resource

string

REQUIRED: The resource for which the policy is being specified. See the operation documentation for the appropriate value for this field. It takes the form projects/{project_id}/locations/{location_id}/services/{service_id}.

Request body

The request body contains data with the following structure:

JSON representation
{
  "policy": {
    object (Policy)
  },
  "updateMask": string
}
Fields
policy

object (Policy)

REQUIRED: The complete policy to be applied to the resource. The size of the policy is limited to a few 10s of KB. An empty policy is a valid policy but certain Cloud Platform services (such as Projects) might reject them.

updateMask

string (FieldMask format)

OPTIONAL: A FieldMask specifying which fields of the policy to modify. Only the fields in the mask will be modified. If no mask is provided, the following default mask is used: paths: "bindings, etag" This field is only used by Cloud IAM.

A comma-separated list of fully qualified names of fields. Example: "user.displayName,photo".

Response body

If successful, the response body contains an instance of Policy.

Authorization Scopes

Requires the following OAuth scope:

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

For more information, see the Authentication Overview.

Was this page helpful? Let us know how we did:

Send feedback about...