gcloud: Wed Jan 8 10:03:00 UTC 2025

gcloud/iam/list-grantable-roles

@@ -3,7 +3,7 @@ NAME
 
 SYNOPSIS
     gcloud iam list-grantable-roles RESOURCE [--filter=EXPRESSION]
-        [--page-size=PAGE_SIZE; default=100] [GCLOUD_WIDE_FLAG ...]
+        [--page-size=PAGE_SIZE; default=300] [GCLOUD_WIDE_FLAG ...]
 
 DESCRIPTION
     This command displays the list of grantable roles for a resource. The
@@ -49,9 +49,9 @@ LIST COMMAND FLAGS
         This flag interacts with other flags that are applied in this order:
         --flatten, --sort-by, --filter, --limit.
 
-     --page-size=PAGE_SIZE; default=100
+     --page-size=PAGE_SIZE; default=300
         Some services group resource list output into pages. This flag
-        specifies the maximum number of resources per page. The default is 100.
+        specifies the maximum number of resources per page. The default is 300.
         Paging may be applied before or after --filter and --limit depending on
         the service.
 

gcloud/iam/policies/delete

@@ -32,8 +32,11 @@ REQUIRED FLAGS
 
 OPTIONAL FLAGS
      --etag=ETAG
-        Etag that identifies the version of the existing policy. If omitted,
-        the policy is deleted regardless of its current etag.
+        Etag that identifies the version of the existing policy. It can be
+        obtained by running gcloud iam policies get. When deleting a policy, if
+        the etag is omitted, the policy is deleted regardless of its current
+        etag. When updating a policy, if the etag 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,

gcloud/iam/policies/update

@@ -4,18 +4,20 @@ NAME
 
 SYNOPSIS
     gcloud iam policies update POLICY_ID --attachment-point=ATTACHMENT_POINT
-        --kind=KIND --policy-file=POLICY_FILE [GCLOUD_WIDE_FLAG ...]
+        --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 policy defined at the resource
-    project 123 of kind denypolicies and id my-deny-policy:
+    The following command updates the IAM policy my-deny-policy, which is
+    attached to the resource project 123 and has the etag abc:
 
         $ gcloud iam policies update my-deny-policy \
             --attachment-point=cloudresourcemanager.googleapis.com/\
-        projects/123 --kind=denypolicies --policy-file=policy.json
+        projects/123 --kind=denypolicies --policy-file=policy.json \
+            --etag=abc
 
 POSITIONAL ARGUMENTS
      POLICY_ID
@@ -34,6 +36,14 @@ REQUIRED FLAGS
         Path to the file that contains the policy, in JSON or YAML format. For
         valid syntax, see https://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 by running gcloud iam policies get. When deleting a policy, if
+        the etag is omitted, the policy is deleted regardless of its current
+        etag. When updating a policy, if the etag 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,