1
0
Fork 0
mirror of https://github.com/imjasonh/gcloud-help synced 2026-07-19 07:15:23 +00:00

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

This commit is contained in:
Automated 2024-08-21 09:39:51 +00:00
parent d35819d273
commit ed5fe34b64
163 changed files with 3541 additions and 717 deletions

View file

@ -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):

View file

@ -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,

View file

@ -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

View file

@ -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

View file

@ -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

View file

@ -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.

View file

@ -98,10 +98,8 @@ FLAGS
Principal access boundary policy details
--details-rules=[description=DESCRIPTION],[effect=EFFECT],[resources=RESOURCES]
A list of principal access boundary policy rules. The number of rules
in a policy is limited to 500. Required, A list of principal access
boundary policy rules. The number of rules in a policy is limited to
500.
Required, A list of principal access boundary policy rules. The
number of rules in a policy is limited to 500.
description
The description of the principal access boundary policy rule.
@ -116,14 +114,15 @@ FLAGS
the descendants are included. The number of resources in a policy
is limited to 500 across all rules.
The following resource names are supported:
▫ Organization, such as
"//cloudresourcemanager.googleapis.com/organizations/123".
▫ Folder, such as
"//cloudresourcemanager.googleapis.com/folders/123".
▫ Project, such as
"//cloudresourcemanager.googleapis.com/projects/123" or
"//cloudresourcemanager.googleapis.com/projects/my-project-id".
The following resource types are supported:
▫ Organizations, such as
//cloudresourcemanager.googleapis.com/organizations/123.
▫ Folders, such as
//cloudresourcemanager.googleapis.com/folders/123.
▫ Projects, such as
//cloudresourcemanager.googleapis.com/projects/123 or
//cloudresourcemanager.googleapis.com/projects/my-project-id.
Shorthand Example:
@ -141,10 +140,10 @@ FLAGS
this group are specified.
--details-enforcement-version=DETAILS_ENFORCEMENT_VERSION
The version number that indicates which GCP services are included in
the enforcement (e.g. "latest", "1", ...). If empty, the PAB policy
version will be set to the current latest version, and this version
won't get updated when new versions are released.
The version number that indicates which Google Cloud services are
included in the enforcement (e.g. "latest", "1", ...). If empty, the
PAB policy version will be set to the current latest version, and
this version won't get updated when new versions are released.
GCLOUD WIDE FLAGS
These flags are available to all commands: --access-token-file, --account,

View file

@ -6,7 +6,7 @@ SYNOPSIS
gcloud beta iam principal-access-boundary-policies delete
(PRINCIPAL_ACCESS_BOUNDARY_POLICY
: --location=LOCATION --organization=ORGANIZATION) [--async]
[--etag=ETAG] [--force] [--validate-only] [GCLOUD_WIDE_FLAG ...]
[--etag=ETAG] [--force] [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(BETA) Delete PrincipalAccessBoundaryPolicy instance.
@ -68,10 +68,6 @@ FLAGS
If set to true, the request will force the deletion of the Policy even
if the Policy references PolicyBindings.
--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,

View file

@ -86,7 +86,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.
@ -109,7 +109,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.
@ -140,10 +140,10 @@ FLAGS
Principal access boundary policy details
--details-enforcement-version=DETAILS_ENFORCEMENT_VERSION
The version number that indicates which GCP services are included in
the enforcement (e.g. "latest", "1", ...). If empty, the PAB policy
version will be set to the current latest version, and this version
won't get updated when new versions are released.
The version number that indicates which Google Cloud services are
included in the enforcement (e.g. "latest", "1", ...). If empty, the
PAB policy version will be set to the current latest version, and
this version won't get updated when new versions are released.
Update details_rules.
@ -166,14 +166,15 @@ FLAGS
all the descendants are included. The number of resources in a
policy is limited to 500 across all rules.
The following resource names are supported:
◇ Organization, such as
"//cloudresourcemanager.googleapis.com/organizations/123".
◇ Folder, such as
"//cloudresourcemanager.googleapis.com/folders/123".
◇ Project, such as
"//cloudresourcemanager.googleapis.com/projects/123" or
"//cloudresourcemanager.googleapis.com/projects/my-project-id".
The following resource types are supported:
◇ Organizations, such as
//cloudresourcemanager.googleapis.com/organizations/123.
◇ Folders, such as
//cloudresourcemanager.googleapis.com/folders/123.
◇ Projects, such as
//cloudresourcemanager.googleapis.com/projects/123 or
//cloudresourcemanager.googleapis.com/projects/my-project-id.
Shorthand Example:
@ -205,14 +206,15 @@ FLAGS
all the descendants are included. The number of resources in a
policy is limited to 500 across all rules.
The following resource names are supported:
◇ Organization, such as
"//cloudresourcemanager.googleapis.com/organizations/123".
◇ Folder, such as
"//cloudresourcemanager.googleapis.com/folders/123".
◇ Project, such as
"//cloudresourcemanager.googleapis.com/projects/123" or
"//cloudresourcemanager.googleapis.com/projects/my-project-id".
The following resource types are supported:
◇ Organizations, such as
//cloudresourcemanager.googleapis.com/organizations/123.
◇ Folders, such as
//cloudresourcemanager.googleapis.com/folders/123.
◇ Projects, such as
//cloudresourcemanager.googleapis.com/projects/123 or
//cloudresourcemanager.googleapis.com/projects/my-project-id.
Shorthand Example:
@ -249,14 +251,15 @@ FLAGS
all the descendants are included. The number of resources in
a policy is limited to 500 across all rules.
The following resource names are supported:
▹ Organization, such as
"//cloudresourcemanager.googleapis.com/organizations/123".
▹ Folder, such as
"//cloudresourcemanager.googleapis.com/folders/123".
▹ Project, such as
"//cloudresourcemanager.googleapis.com/projects/123" or
"//cloudresourcemanager.googleapis.com/projects/my-project-id".
The following resource types are supported:
▹ Organizations, such as
//cloudresourcemanager.googleapis.com/organizations/123.
▹ Folders, such as
//cloudresourcemanager.googleapis.com/folders/123.
▹ Projects, such as
//cloudresourcemanager.googleapis.com/projects/123 or
//cloudresourcemanager.googleapis.com/projects/my-project-id.
Shorthand Example: