gcloud iam policies update

NAME
gcloud iam policies update - update the policy on the given attachment point with the given name
SYNOPSIS
gcloud iam policies updatePOLICY_ID--attachment-point=ATTACHMENT_POINT--kind=KIND--policy-file=POLICY_FILE[--etag=ETAG][GCLOUD_WIDE_FLAG …]
DESCRIPTION
Update the policy on the given attachment point with the given name.
EXAMPLES
The following command updates the IAM policymy-deny-policy, which is attached to theresource project123 and has the etagabc:
gcloudiampoliciesupdatemy-deny-policy--attachment-point=cloudresourcemanager.googleapis.com/projects/123--kind=denypolicies--policy-file=policy.json--etag=abc
POSITIONAL ARGUMENTS
POLICY_ID
Policy ID that is unique for the resource to which the policy is attached.
REQUIRED FLAGS
--attachment-point=ATTACHMENT_POINT
Resource to which the policy is attached. For valid formats, seehttps://cloud.google.com/iam/help/deny/attachment-point.
--kind=KIND
Policy type. Usedenypolicies for deny policies.
--policy-file=POLICY_FILE
Path to the file that contains the policy, in JSON or YAML format. For validsyntax, seehttps://cloud.google.com/iam/help/deny/policy-syntax.
OPTIONAL FLAGS
--etag=ETAG
Etag that identifies the version of the existing policy. It can be obtained byrunninggcloud iampolicies get. When deleting a policy, if the etag is omitted, thepolicy is deleted regardless of its current etag. When updating a policy, if theetag is omitted, the update uses the etag provided in the policy file.
GCLOUD WIDE FLAGS
These flags are available to all commands:--access-token-file,--account,--billing-project,--configuration,--flags-file,--flatten,--format,--help,--impersonate-service-account,--log-http,--project,--quiet,--trace-token,--user-output-enabled,--verbosity.

Run$gcloud help for details.

NOTES
These variants are also available:
gcloudalphaiampoliciesupdate
gcloudbetaiampoliciesupdate

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-05-07 UTC.