gcloud: Wed Aug 21 09:39:51 UTC 2024

gcloud/beta/iam/policy-bindings/create

@@ -28,18 +28,21 @@ EXAMPLES
         organizations/123
 
 POSITIONAL ARGUMENTS
-     PolicyBinding resource - Identifier. The resource name of the policy
-     binding. The binding parent is the closest CRM resource (i.e., Project,
-     Folder or Organization) to the binding target.
+     PolicyBinding resource - Identifier. The name of the policy binding, in
+     the format
+     {binding_parent/locations/{location}/policyBindings/{policy_binding_id}.
+     The binding parent is the closest Resource Manager resource (i.e.,
+     Project, Folder or Organization) to the binding target.
 
      Format:
-     projects/{project_id}/locations/{location}/policyBindings/{policy_binding_id}
-     projects/{project_number}/locations/{location}/policyBindings/{policy_binding_id}
-     folders/{folder_id}/locations/{location}/policyBindings/{policy_binding_id}
-     organizations/{organization_id}/locations/{location}/policyBindings/{policy_binding_id}
-     The arguments in this group can be used to specify the attributes of this
-     resource. (NOTE) Some attributes are not given arguments in this group but
-     can be set in other ways.
+
+      ◆ projects/{project_id}/locations/{location}/policyBindings/{policy_binding_id}
+      ◆ projects/{project_number}/locations/{location}/policyBindings/{policy_binding_id}
+      ◆ folders/{folder_id}/locations/{location}/policyBindings/{policy_binding_id}
+      ◆ organizations/{organization_id}/locations/{location}/policyBindings/{policy_binding_id}
+        The arguments in this group can be used to specify the attributes of
+        this resource. (NOTE) Some attributes are not given arguments in this
+        group but can be set in other ways.
 
      To set the project attribute:
       ◆ provide the argument policy_binding on the command line with a fully
@@ -104,18 +107,20 @@ REQUIRED FLAGS
 
          --target-principal-set=TARGET_PRINCIPAL_SET
             Full Resource Name used for principal access boundary policy
-            bindings Examples: Organization:
-            "//cloudresourcemanager.googleapis.com/organizations/ORGANIZATION_ID"
-            Folder: "//cloudresourcemanager.googleapis.com/folders/FOLDER_ID"
-            Project:
-            "//cloudresourcemanager.googleapis.com/projects/PROJECT_NUMBER"
-            "//cloudresourcemanager.googleapis.com/projects/PROJECT_ID"
-            Workload Identity Pool:
-            "//iam.googleapis.com/projects/PROJECT_NUMBER/locations/LOCATION/workloadIdentityPools/WORKLOAD_POOL_ID"
-            Workforce Identity:
-            "//iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID"
-            Workspace Identity:
-            "//iam.googleapis.com/locations/global/workspace/WORKSPACE_ID"
+            bindings Examples:
+
+            ▫ Organization:
+              //cloudresourcemanager.googleapis.com/organizations/ORGANIZATION_ID
+            ▫ Folder: //cloudresourcemanager.googleapis.com/folders/FOLDER_ID
+            ▫ Project:
+              ◇ //cloudresourcemanager.googleapis.com/projects/PROJECT_NUMBER
+              ◇ //cloudresourcemanager.googleapis.com/projects/PROJECT_ID
+            ▫ Workload Identity Pool:
+              //iam.googleapis.com/projects/PROJECT_NUMBER/locations/LOCATION/workloadIdentityPools/WORKLOAD_POOL_ID
+            ▫ Workforce Identity:
+              //iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID
+            ▫ Workspace Identity:
+              //iam.googleapis.com/locations/global/workspace/WORKSPACE_ID
 
 OPTIONAL FLAGS
      --annotations=[ANNOTATIONS,...]
@@ -153,11 +158,11 @@ OPTIONAL FLAGS
         match the server's etag.
 
      --policy-kind=POLICY_KIND
-        The kind of the policy to attach in this binding:
+        The kind of the policy to attach in this binding. This field must be
+        one of the following:
 
-        + When the policy is empty, this field must be set. + When the policy
-        is set, this field + can be left empty and will be set to the policy
-        kind, or + must set to the input policy kind
+        ◆ Left empty (will be automatically set to the policy kind)
+        ◆ The input policy kind.
 
         POLICY_KIND must be (only one value is supported):
 

gcloud/beta/iam/policy-bindings/delete

@@ -5,7 +5,7 @@ SYNOPSIS
     gcloud beta iam policy-bindings delete
         (POLICY_BINDING
           : --folder=FOLDER --location=LOCATION --organization=ORGANIZATION)
-        [--async] [--etag=ETAG] [--validate-only] [GCLOUD_WIDE_FLAG ...]
+        [--async] [--etag=ETAG] [GCLOUD_WIDE_FLAG ...]
 
 DESCRIPTION
     (BETA) Delete PolicyBinding instance.
@@ -20,13 +20,14 @@ POSITIONAL ARGUMENTS
      PolicyBinding resource - The name of the policy binding to delete.
 
      Format:
-     projects/{project_id}/locations/{location}/policyBindings/{policy_binding_id}
-     projects/{project_number}/locations/{location}/policyBindings/{policy_binding_id}
-     folders/{folder_id}/locations/{location}/policyBindings/{policy_binding_id}
-     organizations/{organization_id}/locations/{location}/policyBindings/{policy_binding_id}
-     The arguments in this group can be used to specify the attributes of this
-     resource. (NOTE) Some attributes are not given arguments in this group but
-     can be set in other ways.
+
+      ◆ projects/{project_id}/locations/{location}/policyBindings/{policy_binding_id}
+      ◆ projects/{project_number}/locations/{location}/policyBindings/{policy_binding_id}
+      ◆ folders/{folder_id}/locations/{location}/policyBindings/{policy_binding_id}
+      ◆ organizations/{organization_id}/locations/{location}/policyBindings/{policy_binding_id}
+        The arguments in this group can be used to specify the attributes of
+        this resource. (NOTE) Some attributes are not given arguments in this
+        group but can be set in other ways.
 
      To set the project attribute:
       ◆ provide the argument policy_binding on the command line with a fully
@@ -86,10 +87,6 @@ FLAGS
         The etag of the policy binding. If this is provided, it must match the
         server's etag.
 
-     --validate-only
-        If set, validate the request and preview the deletion, but do not
-        actually post it.
-
 GCLOUD WIDE FLAGS
     These flags are available to all commands: --access-token-file, --account,
     --billing-project, --configuration, --flags-file, --flatten, --format,

gcloud/beta/iam/policy-bindings/describe

@@ -21,13 +21,14 @@ POSITIONAL ARGUMENTS
      PolicyBinding resource - The name of the policy binding to retrieve.
 
      Format:
-     projects/{project_id}/locations/{location}/policyBindings/{policy_binding_id}
-     projects/{project_number}/locations/{location}/policyBindings/{policy_binding_id}
-     folders/{folder_id}/locations/{location}/policyBindings/{policy_binding_id}
-     organizations/{organization_id}/locations/{location}/policyBindings/{policy_binding_id}
-     The arguments in this group can be used to specify the attributes of this
-     resource. (NOTE) Some attributes are not given arguments in this group but
-     can be set in other ways.
+
+      ◆ projects/{project_id}/locations/{location}/policyBindings/{policy_binding_id}
+      ◆ projects/{project_number}/locations/{location}/policyBindings/{policy_binding_id}
+      ◆ folders/{folder_id}/locations/{location}/policyBindings/{policy_binding_id}
+      ◆ organizations/{organization_id}/locations/{location}/policyBindings/{policy_binding_id}
+        The arguments in this group can be used to specify the attributes of
+        this resource. (NOTE) Some attributes are not given arguments in this
+        group but can be set in other ways.
 
      To set the project attribute:
       ◆ provide the argument policy_binding on the command line with a fully

gcloud/beta/iam/policy-bindings/list

@@ -20,13 +20,15 @@ REQUIRED FLAGS
      Location resource - The parent resource, which owns the collection of
      policy bindings.
 
-     Format: projects/{project_id}/locations/{location}
-     projects/{project_number}/locations/{location}
-     folders/{folder_id}/locations/{location}
-     organizations/{organization_id}/locations/{location} The arguments in this
-     group can be used to specify the attributes of this resource. (NOTE) Some
-     attributes are not given arguments in this group but can be set in other
-     ways.
+     Format:
+
+      ◆ projects/{project_id}/locations/{location}
+      ◆ projects/{project_number}/locations/{location}
+      ◆ folders/{folder_id}/locations/{location}
+      ◆ organizations/{organization_id}/locations/{location} The arguments in
+        this group can be used to specify the attributes of this resource.
+        (NOTE) Some attributes are not given arguments in this group but can be
+        set in other ways.
 
      To set the project attribute:
       ◆ provide the argument --location on the command line with a fully

gcloud/beta/iam/policy-bindings/search-target-policy-bindings

@@ -23,23 +23,28 @@ REQUIRED FLAGS
      --target=TARGET
         The target resource, which is bound to the policy in the binding.
 
-        Format: //iam.googleapis.com/locations/global/workforcePools/POOL_ID
-        //iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID
-        //iam.googleapis.com/locations/global/workspace/WORKSPACE_ID
-        //cloudresourcemanager.googleapis.com/projects/{project_number}
-        //cloudresourcemanager.googleapis.com/folders/{folder_id}
-        //cloudresourcemanager.googleapis.com/organizations/{organization_id}
+        Format:
+
+        ◆ //iam.googleapis.com/locations/global/workforcePools/POOL_ID
+        ◆ //iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID
+        ◆ //iam.googleapis.com/locations/global/workspace/WORKSPACE_ID
+        ◆ //cloudresourcemanager.googleapis.com/projects/{project_number}
+        ◆ //cloudresourcemanager.googleapis.com/folders/{folder_id}
+        ◆ //cloudresourcemanager.googleapis.com/organizations/{organization_id}
 
      Location resource - The parent resource where this search will be
-     performed. This should be the nearest CRM resource to the target.
+     performed. This should be the nearest Resource Manager resource (project,
+     folder, or organization) to the target.
 
-     Format: projects/{project_id}/locations/{location}
-     projects/{project_number}/locations/{location}
-     folders/{folder_id}/locations/{location}
-     organizations/{organization_id}/locations/{location} The arguments in this
-     group can be used to specify the attributes of this resource. (NOTE) Some
-     attributes are not given arguments in this group but can be set in other
-     ways.
+     Format:
+
+      ◆ projects/{project_id}/locations/{location}
+      ◆ projects/{project_number}/locations/{location}
+      ◆ folders/{folder_id}/locations/{location}
+      ◆ organizations/{organization_id}/locations/{location} The arguments in
+        this group can be used to specify the attributes of this resource.
+        (NOTE) Some attributes are not given arguments in this group but can be
+        set in other ways.
 
      To set the project attribute:
       ◆ provide the argument --location on the command line with a fully

gcloud/beta/iam/policy-bindings/update

@@ -25,18 +25,21 @@ EXAMPLES
             --display-name=new-display-name
 
 POSITIONAL ARGUMENTS
-     PolicyBinding resource - Identifier. The resource name of the policy
-     binding. The binding parent is the closest CRM resource (i.e., Project,
-     Folder or Organization) to the binding target.
+     PolicyBinding resource - Identifier. The name of the policy binding, in
+     the format
+     {binding_parent/locations/{location}/policyBindings/{policy_binding_id}.
+     The binding parent is the closest Resource Manager resource (i.e.,
+     Project, Folder or Organization) to the binding target.
 
      Format:
-     projects/{project_id}/locations/{location}/policyBindings/{policy_binding_id}
-     projects/{project_number}/locations/{location}/policyBindings/{policy_binding_id}
-     folders/{folder_id}/locations/{location}/policyBindings/{policy_binding_id}
-     organizations/{organization_id}/locations/{location}/policyBindings/{policy_binding_id}
-     The arguments in this group can be used to specify the attributes of this
-     resource. (NOTE) Some attributes are not given arguments in this group but
-     can be set in other ways.
+
+      ◆ projects/{project_id}/locations/{location}/policyBindings/{policy_binding_id}
+      ◆ projects/{project_number}/locations/{location}/policyBindings/{policy_binding_id}
+      ◆ folders/{folder_id}/locations/{location}/policyBindings/{policy_binding_id}
+      ◆ organizations/{organization_id}/locations/{location}/policyBindings/{policy_binding_id}
+        The arguments in this group can be used to specify the attributes of
+        this resource. (NOTE) Some attributes are not given arguments in this
+        group but can be set in other ways.
 
      To set the project attribute:
       ◆ provide the argument policy_binding on the command line with a fully
@@ -107,7 +110,7 @@ FLAGS
        --annotations=[ANNOTATIONS,...]
           Set annotations to new value. User defined annotations. See
           https://google.aip.dev/148#annotations for more details such as
-          format and size limitations
+          format and size limitations.
 
            KEY
               Sets KEY value.
@@ -130,7 +133,7 @@ FLAGS
        --update-annotations=[UPDATE_ANNOTATIONS,...]
           Update annotations value or add key value pair. User defined
           annotations. See https://google.aip.dev/148#annotations for more
-          details such as format and size limitations
+          details such as format and size limitations.
 
            KEY
               Sets KEY value.