diff --git a/gcloud/_version b/gcloud/_version index ce459da2e..4d837435c 100644 --- a/gcloud/_version +++ b/gcloud/_version @@ -1,8 +1,8 @@ -Google Cloud SDK 535.0.0 -alpha 2025.08.15 -beta 2025.08.15 +Google Cloud SDK 536.0.0 +alpha 2025.08.22 +beta 2025.08.22 bq 2.1.22 bundled-python3-unix 3.12.9 -core 2025.08.15 +core 2025.08.22 gcloud-crc32c 1.0.0 gsutil 5.35 diff --git a/gcloud/alpha/backup-dr/backup-plan-associations/update b/gcloud/alpha/backup-dr/backup-plan-associations/update index 95bb73beb..38d46ac8e 100644 --- a/gcloud/alpha/backup-dr/backup-plan-associations/update +++ b/gcloud/alpha/backup-dr/backup-plan-associations/update @@ -126,5 +126,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud backup-dr backup-plan-associations update diff --git a/gcloud/alpha/backup-dr/backup-plans/update b/gcloud/alpha/backup-dr/backup-plans/update index 274c61212..f8953b0db 100644 --- a/gcloud/alpha/backup-dr/backup-plans/update +++ b/gcloud/alpha/backup-dr/backup-plans/update @@ -285,5 +285,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud backup-dr backup-plans update diff --git a/gcloud/alpha/backup-dr/backups/restore/disk b/gcloud/alpha/backup-dr/backups/restore/disk index c7c5bfc15..40d49c7cc 100644 --- a/gcloud/alpha/backup-dr/backups/restore/disk +++ b/gcloud/alpha/backup-dr/backups/restore/disk @@ -213,5 +213,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud backup-dr backups restore disk diff --git a/gcloud/alpha/cluster-director/clusters/create b/gcloud/alpha/cluster-director/clusters/create new file mode 100644 index 000000000..98ef380f8 --- /dev/null +++ b/gcloud/alpha/cluster-director/clusters/create @@ -0,0 +1,624 @@ +NAME + gcloud alpha cluster-director clusters create - creates a Cluster Director + resource + +SYNOPSIS + gcloud alpha cluster-director clusters create + (CLUSTER : --location=LOCATION) + --config=[compute=COMPUTE],[description=DESCRIPTION],[labels=LABELS], + [name=NAME],[networkResources=NETWORKRESOURCES],[networks=NETWORKS], + [orchestrator=ORCHESTRATOR],[reconciling=RECONCILING], + [storageResources=STORAGERESOURCES],[storages=STORAGES] [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Creates a Cluster Director resource. + +EXAMPLES + To create a cluster my-cluster in location us-central1-a with config in + JSON string format run the following example: + + $ gcloud alpha cluster-director clusters create my-cluster \ + --location=us-central1-a --config='{"key": "value"}' + + Or create a JSON file my-cluster-config.json with the cluster specs and run + the following file example: + + $ gcloud alpha cluster-director clusters create my-cluster \ + --location=us-central1-a --config=my-cluster-config.json + +POSITIONAL ARGUMENTS + Cluster resource - Identifier. Name of the cluster. Formats: cluster | + projects/{project}/locations/{locations}/clusters/{cluster} 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 cluster on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + CLUSTER + ID of the cluster or fully qualified identifier for the cluster. + + To set the cluster attribute: + ▸ provide the argument cluster on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the cluster resource. + + To set the location attribute: + ▸ provide the argument cluster on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + --config=[compute=COMPUTE],[description=DESCRIPTION],[labels=LABELS],[name=NAME],[networkResources=NETWORKRESOURCES],[networks=NETWORKS],[orchestrator=ORCHESTRATOR],[reconciling=RECONCILING],[storageResources=STORAGERESOURCES],[storages=STORAGES] + Required, Configuration of the cluster specs in shorthand | JSON string + | file path format. + + compute + Sets compute value. + + resourceRequests + Sets resourceRequests value. + + disks + Sets disks value. + + boot + Sets boot value. + + sizeGb + Sets sizeGb value. + + sourceImage + Sets sourceImage value. + + type + Sets type value. + + guestAccelerators + Sets guestAccelerators value. + + acceleratorType + Sets acceleratorType value. + + count + Sets count value. + + id + Sets id value. + + machineType + Sets machineType value. + + maxRunDuration + Sets maxRunDuration value. + + provisioningModel + Sets provisioningModel value. + + reservationAffinity + Sets reservationAffinity value. + + key + Sets key value. + + type + Sets type value. + + values + Sets values value. + + terminationAction + Sets terminationAction value. + + zone + Sets zone value. + + description + Sets description value. + + labels + Sets labels value. + + KEY + Keys must start with a lowercase character and contain only + hyphens (-), underscores (_), lowercase characters, and + numbers. + + VALUE + Values must contain only hyphens (-), underscores (_), + lowercase characters, and numbers. + + name + Sets name value. + + networkResources + Sets networkResources value. + + KEY + Sets KEY value. + + VALUE + Sets VALUE value. + + computeNetwork + Sets computeNetwork value. + + network + Sets network value. + + subnetwork + Sets subnetwork value. + + config + Sets config value. + + existingComputeNetwork + Sets existingComputeNetwork value. + + network + Sets network value. + + subnetwork + Sets subnetwork value. + + newComputeNetwork + Sets newComputeNetwork value. + + description + Sets description value. + + network + Sets network value. + + networks + Sets networks value. + + initializeParams + Sets initializeParams value. + + description + Sets description value. + + network + Sets network value. + + network + Sets network value. + + networkSource + Sets networkSource value. + + network + Sets network value. + + subnetwork + Sets subnetwork value. + + subnetwork + Sets subnetwork value. + + orchestrator + Sets orchestrator value. + + slurm + Sets slurm value. + + config + Sets config value. + + prologEpilogTimeout + Sets prologEpilogTimeout value. + + prologFlags + Sets prologFlags value. + + requeueExitCodes + Sets requeueExitCodes value. + + requeueHoldExitCodes + Sets requeueHoldExitCodes value. + + defaultPartition + Sets defaultPartition value. + + epilogBashScripts + Sets epilogBashScripts value. + + loginNodes + Sets loginNodes value. + + count + Sets count value. + + disks + Sets disks value. + + boot + Sets boot value. + + sizeGb + Sets sizeGb value. + + sourceImage + Sets sourceImage value. + + type + Sets type value. + + enableOsLogin + Sets enableOsLogin value. + + enablePublicIps + Sets enablePublicIps value. + + instances + Sets instances value. + + instance + Sets instance value. + + labels + Sets labels value. + + KEY + Keys must start with a lowercase character and + contain only hyphens (-), underscores (_), + lowercase characters, and numbers. + + VALUE + Values must contain only hyphens (-), underscores + (_), lowercase characters, and numbers. + + machineType + Sets machineType value. + + serviceAccount + Sets serviceAccount value. + + email + Sets email value. + + scopes + Sets scopes value. + + startupScript + Sets startupScript value. + + storageConfigs + Sets storageConfigs value. + + id + Sets id value. + + localMount + Sets localMount value. + + zone + Sets zone value. + + nodeSets + Sets nodeSets value. + + canIpForward + Sets canIpForward value. + + enableOsLogin + Sets enableOsLogin value. + + enablePublicIps + Sets enablePublicIps value. + + id + Sets id value. + + labels + Sets labels value. + + KEY + Keys must start with a lowercase character and + contain only hyphens (-), underscores (_), + lowercase characters, and numbers. + + VALUE + Values must contain only hyphens (-), underscores + (_), lowercase characters, and numbers. + + maxDynamicNodeCount + Sets maxDynamicNodeCount value. + + resourceRequestId + Sets resourceRequestId value. + + serviceAccount + Sets serviceAccount value. + + email + Sets email value. + + scopes + Sets scopes value. + + startupScript + Sets startupScript value. + + staticNodeCount + Sets staticNodeCount value. + + storageConfigs + Sets storageConfigs value. + + id + Sets id value. + + localMount + Sets localMount value. + + partitions + Sets partitions value. + + exclusive + Sets exclusive value. + + id + Sets id value. + + nodeSetIds + Sets nodeSetIds value. + + prologBashScripts + Sets prologBashScripts value. + + taskEpilogBashScripts + Sets taskEpilogBashScripts value. + + taskPrologBashScripts + Sets taskPrologBashScripts value. + + reconciling + Sets reconciling value. + + storageResources + Sets storageResources value. + + KEY + Sets KEY value. + + VALUE + Sets VALUE value. + + bucket + Sets bucket value. + + bucket + Sets bucket value. + + config + Sets config value. + + existingBucket + Sets existingBucket value. + + bucket + Sets bucket value. + + existingFilestore + Sets existingFilestore value. + + filestore + Sets filestore value. + + existingLustre + Sets existingLustre value. + + lustre + Sets lustre value. + + newBucket + Sets newBucket value. + + autoclass + Sets autoclass value. + + enabled + Sets enabled value. + + terminalStorageClass + Sets terminalStorageClass value. + + bucket + Sets bucket value. + + hierarchicalNamespace + Sets hierarchicalNamespace value. + + enabled + Sets enabled value. + + storageClass + Sets storageClass value. + + newFilestore + Sets newFilestore value. + + description + Sets description value. + + fileShares + Sets fileShares value. + + capacityGb + Sets capacityGb value. + + fileShare + Sets fileShare value. + + filestore + Sets filestore value. + + protocol + Sets protocol value. + + tier + Sets tier value. + + newLustre + Sets newLustre value. + + capacityGb + Sets capacityGb value. + + description + Sets description value. + + filesystem + Sets filesystem value. + + lustre + Sets lustre value. + + filestore + Sets filestore value. + + filestore + Sets filestore value. + + lustre + Sets lustre value. + + lustre + Sets lustre value. + + storages + Sets storages value. + + id + Sets id value. + + initializeParams + Sets initializeParams value. + + filestore + Sets filestore value. + + description + Sets description value. + + fileShares + Sets fileShares value. + + capacityGb + Sets capacityGb value. + + fileShare + Sets fileShare value. + + filestore + Sets filestore value. + + protocol + Sets protocol value. + + tier + Sets tier value. + + gcs + Sets gcs value. + + autoclass + Sets autoclass value. + + enabled + Sets enabled value. + + terminalStorageClass + Sets terminalStorageClass value. + + bucket + Sets bucket value. + + hierarchicalNamespace + Sets hierarchicalNamespace value. + + enabled + Sets enabled value. + + storageClass + Sets storageClass value. + + lustre + Sets lustre value. + + capacityGb + Sets capacityGb value. + + description + Sets description value. + + filesystem + Sets filesystem value. + + lustre + Sets lustre value. + + storage + Sets storage value. + + storageSource + Sets storageSource value. + + bucket + Sets bucket value. + + filestore + Sets filestore value. + + lustre + Sets lustre value. + + Shorthand Example: + + --config=compute={resourceRequests=[{disks=[{boot=boolean,sizeGb=int,sourceImage=string,type=string}],guestAccelerators=[{acceleratorType=string,count=int}],id=string,machineType=string,maxRunDuration=int,provisioningModel=string,reservationAffinity={key=string,type=string,values=[string]},terminationAction=string,zone=string}]},description=string,labels={string=string},name=string,networkResources={string={computeNetwork={network=string,subnetwork=string},config={existingComputeNetwork={network=string,subnetwork=string},newComputeNetwork={description=string,network=string}}}},networks=[{initializeParams={description=string,network=string},network=string,networkSource={network=string,subnetwork=string},subnetwork=string}],orchestrator={slurm={config={prologEpilogTimeout=string,prologFlags=[string],requeueExitCodes=[int],requeueHoldExitCodes=[int]},defaultPartition=string,epilogBashScripts=[string],loginNodes={count=int,disks=[{boot=boolean,sizeGb=int,sourceImage=string,type=string}],enableOsLogin=boolean,enablePublicIps=boolean,instances=[{instance=string}],labels={string=string},machineType=string,serviceAccount={email=string,scopes=[string]},startupScript=string,storageConfigs=[{id=string,localMount=string}],zone=string},nodeSets=[{canIpForward=boolean,enableOsLogin=boolean,enablePublicIps=boolean,id=string,labels={string=string},maxDynamicNodeCount=int,resourceRequestId=string,serviceAccount={email=string,scopes=[string]},startupScript=string,staticNodeCount=int,storageConfigs=[{id=string,localMount=string}]}],partitions=[{exclusive=boolean,id=string,nodeSetIds=[string]}],prologBashScripts=[string],taskEpilogBashScripts=[string],taskPrologBashScripts=[string]}},reconciling=boolean,storageResources={string={bucket={bucket=string},config={existingBucket={bucket=string},existingFilestore={filestore=string},existingLustre={lustre=string},newBucket={autoclass={enabled=boolean,terminalStorageClass=string},bucket=string,hierarchicalNamespace={enabled=boolean},storageClass=string},newFilestore={description=string,fileShares=[{capacityGb=int,fileShare=string}],filestore=string,protocol=string,tier=string},newLustre={capacityGb=int,description=string,filesystem=string,lustre=string}},filestore={filestore=string},lustre={lustre=string}}},storages=[{id=string,initializeParams={filestore={description=string,fileShares=[{capacityGb=int,fileShare=string}],filestore=string,protocol=string,tier=string},gcs={autoclass={enabled=boolean,terminalStorageClass=string},bucket=string,hierarchicalNamespace={enabled=boolean},storageClass=string},lustre={capacityGb=int,description=string,filesystem=string,lustre=string}},storage=string,storageSource={bucket=string,filestore=string,lustre=string}}] + + JSON Example: + + --config='{"compute": {"resourceRequests": [{"disks": [{"boot": boolean, "sizeGb": int, "sourceImage": "string", "type": "string"}], "guestAccelerators": [{"acceleratorType": "string", "count": int}], "id": "string", "machineType": "string", "maxRunDuration": int, "provisioningModel": "string", "reservationAffinity": {"key": "string", "type": "string", "values": ["string"]}, "terminationAction": "string", "zone": "string"}]}, "description": "string", "labels": {"string": "string"}, "name": "string", "networkResources": {"string": {"computeNetwork": {"network": "string", "subnetwork": "string"}, "config": {"existingComputeNetwork": {"network": "string", "subnetwork": "string"}, "newComputeNetwork": {"description": "string", "network": "string"}}}}, "networks": [{"initializeParams": {"description": "string", "network": "string"}, "network": "string", "networkSource": {"network": "string", "subnetwork": "string"}, "subnetwork": "string"}], "orchestrator": {"slurm": {"config": {"prologEpilogTimeout": "string", "prologFlags": ["string"], "requeueExitCodes": [int], "requeueHoldExitCodes": [int]}, "defaultPartition": "string", "epilogBashScripts": ["string"], "loginNodes": {"count": int, "disks": [{"boot": boolean, "sizeGb": int, "sourceImage": "string", "type": "string"}], "enableOsLogin": boolean, "enablePublicIps": boolean, "instances": [{"instance": "string"}], "labels": {"string": "string"}, "machineType": "string", "serviceAccount": {"email": "string", "scopes": ["string"]}, "startupScript": "string", "storageConfigs": [{"id": "string", "localMount": "string"}], "zone": "string"}, "nodeSets": [{"canIpForward": boolean, "enableOsLogin": boolean, "enablePublicIps": boolean, "id": "string", "labels": {"string": "string"}, "maxDynamicNodeCount": int, "resourceRequestId": "string", "serviceAccount": {"email": "string", "scopes": ["string"]}, "startupScript": "string", "staticNodeCount": int, "storageConfigs": [{"id": "string", "localMount": "string"}]}], "partitions": [{"exclusive": boolean, "id": "string", "nodeSetIds": ["string"]}], "prologBashScripts": ["string"], "taskEpilogBashScripts": ["string"], "taskPrologBashScripts": ["string"]}}, "reconciling": boolean, "storageResources": {"string": {"bucket": {"bucket": "string"}, "config": {"existingBucket": {"bucket": "string"}, "existingFilestore": {"filestore": "string"}, "existingLustre": {"lustre": "string"}, "newBucket": {"autoclass": {"enabled": boolean, "terminalStorageClass": "string"}, "bucket": "string", "hierarchicalNamespace": {"enabled": boolean}, "storageClass": "string"}, "newFilestore": {"description": "string", "fileShares": [{"capacityGb": int, "fileShare": "string"}], "filestore": "string", "protocol": "string", "tier": "string"}, "newLustre": {"capacityGb": int, "description": "string", "filesystem": "string", "lustre": "string"}}, "filestore": {"filestore": "string"}, "lustre": {"lustre": "string"}}}, "storages": [{"id": "string", "initializeParams": {"filestore": {"description": "string", "fileShares": [{"capacityGb": int, "fileShare": "string"}], "filestore": "string", "protocol": "string", "tier": "string"}, "gcs": {"autoclass": {"enabled": boolean, "terminalStorageClass": "string"}, "bucket": "string", "hierarchicalNamespace": {"enabled": boolean}, "storageClass": "string"}, "lustre": {"capacityGb": int, "description": "string", "filesystem": "string", "lustre": "string"}}, "storage": "string", "storageSource": {"bucket": "string", "filestore": "string", "lustre": "string"}}]}' + + File Example: + + --config=path_to_file.(yaml|json) + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +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. + +API REFERENCE + This command uses the hypercomputecluster/v1alpha API. The full + documentation for this API can be found at: + https://cloud.google.com/ai-hypercomputer/docs/cluster-director + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/cluster-director/clusters/delete b/gcloud/alpha/cluster-director/clusters/delete new file mode 100644 index 000000000..57d132843 --- /dev/null +++ b/gcloud/alpha/cluster-director/clusters/delete @@ -0,0 +1,73 @@ +NAME + gcloud alpha cluster-director clusters delete - deletes a Cluster Director + resource + +SYNOPSIS + gcloud alpha cluster-director clusters delete + (CLUSTER : --location=LOCATION) [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Deletes a Cluster Director resource. + +EXAMPLES + To delete a cluster my-cluster in location us-central1-a run: + + $ gcloud alpha cluster-director clusters delete my-cluster \ + --location=us-central1-a + +POSITIONAL ARGUMENTS + Cluster resource - Identifier. Name of the cluster to delete. Formats: + cluster | projects/{project}/locations/{locations}/clusters/{cluster} 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 cluster on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + CLUSTER + ID of the cluster or fully qualified identifier for the cluster. + + To set the cluster attribute: + ▸ provide the argument cluster on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the cluster resource. + + To set the location attribute: + ▸ provide the argument cluster on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +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. + +API REFERENCE + This command uses the hypercomputecluster/v1alpha API. The full + documentation for this API can be found at: + https://cloud.google.com/ai-hypercomputer/docs/cluster-director + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/cluster-director/clusters/describe b/gcloud/alpha/cluster-director/clusters/describe new file mode 100644 index 000000000..a2d22134d --- /dev/null +++ b/gcloud/alpha/cluster-director/clusters/describe @@ -0,0 +1,68 @@ +NAME + gcloud alpha cluster-director clusters describe - gets details of a Cluster + Director resource + +SYNOPSIS + gcloud alpha cluster-director clusters describe + (CLUSTER : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Gets details of a Cluster Director resource. + +EXAMPLES + To get the details of a cluster my-cluster in location us-central1-a run: + + $ gcloud alpha cluster-director clusters describe my-cluster \ + --location=us-central1-a + +POSITIONAL ARGUMENTS + Cluster resource - Identifier. Name of the cluster to retrieve. Format: + cluster | projects/{project}/locations/{location}/clusters/{cluster} 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 cluster on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + CLUSTER + ID of the cluster or fully qualified identifier for the cluster. + + To set the cluster attribute: + ▸ provide the argument cluster on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the cluster resource. + + To set the location attribute: + ▸ provide the argument cluster on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +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. + +API REFERENCE + This command uses the hypercomputecluster/v1alpha API. The full + documentation for this API can be found at: + https://cloud.google.com/ai-hypercomputer/docs/cluster-director + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/cluster-director/clusters/help b/gcloud/alpha/cluster-director/clusters/help new file mode 100644 index 000000000..f20627b4e --- /dev/null +++ b/gcloud/alpha/cluster-director/clusters/help @@ -0,0 +1,39 @@ +NAME + gcloud alpha cluster-director clusters - manage Cluster Director cluster + resources + +SYNOPSIS + gcloud alpha cluster-director clusters COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Cluster Director cluster resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (ALPHA) Creates a Cluster Director resource. + + delete + (ALPHA) Deletes a Cluster Director resource. + + describe + (ALPHA) Gets details of a Cluster Director resource. + + list + (ALPHA) List Cluster Director resources. + + update + (ALPHA) Updates the parameters of a Cluster Director resource. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/cluster-director/clusters/list b/gcloud/alpha/cluster-director/clusters/list new file mode 100644 index 000000000..1001baf6a --- /dev/null +++ b/gcloud/alpha/cluster-director/clusters/list @@ -0,0 +1,89 @@ +NAME + gcloud alpha cluster-director clusters list - list Cluster Director + resources + +SYNOPSIS + gcloud alpha cluster-director clusters list --location=LOCATION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List Cluster Director resources. + +EXAMPLES + To list all clusters in particular location us-central1-a run: + + $ gcloud alpha cluster-director clusters list \ + --location=us-central1-a + +REQUIRED FLAGS + Location resource - Identifier. Parent collection which own list of + clusters. Format: location | projects/{project}/locations/{location} This + represents a Cloud 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 + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +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. + +API REFERENCE + This command uses the hypercomputecluster/v1alpha API. The full + documentation for this API can be found at: + https://cloud.google.com/ai-hypercomputer/docs/cluster-director + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/cluster-director/clusters/update b/gcloud/alpha/cluster-director/clusters/update new file mode 100644 index 000000000..18ac55e1d --- /dev/null +++ b/gcloud/alpha/cluster-director/clusters/update @@ -0,0 +1,646 @@ +NAME + gcloud alpha cluster-director clusters update - updates the parameters of a + Cluster Director resource + +SYNOPSIS + gcloud alpha cluster-director clusters update + (CLUSTER : --location=LOCATION) + --config=[compute=COMPUTE],[description=DESCRIPTION],[labels=LABELS], + [name=NAME],[networkResources=NETWORKRESOURCES],[networks=NETWORKS], + [orchestrator=ORCHESTRATOR],[reconciling=RECONCILING], + [storageResources=STORAGERESOURCES],[storages=STORAGES] + --update-mask=UPDATE_MASK [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Updates the parameters of a Cluster Director resource. + +EXAMPLES + To update the labels of a cluster my-cluster in location us-central1-a with + config file my-cluster-config.json run the following JSON example: + + $ gcloud alpha cluster-director clusters update my-cluster \ + --location=us-central1-a --update-mask=labels \ + --config='{"key": "value"}' + + Or create a JSON file with the cluster specs and run the following file + example: + + $ gcloud alpha cluster-director clusters update my-cluster \ + --location=us-central1-a --update-mask=labels \ + --config-from-file=my-cluster-config.json + + Or create a JSON file with the update mask and run the following file + example: + + $ gcloud alpha cluster-director clusters update my-cluster \ + --location=us-central1-a \ + --update-mask-from-file=my-update-mask.json \ + --config-from-file=my-cluster-config.json + +POSITIONAL ARGUMENTS + Cluster resource - Identifier. Name of the cluster. Formats: cluster | + projects/{project}/locations/{locations}/clusters/{cluster} 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 cluster on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + CLUSTER + ID of the cluster or fully qualified identifier for the cluster. + + To set the cluster attribute: + ▸ provide the argument cluster on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the cluster resource. + + To set the location attribute: + ▸ provide the argument cluster on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + --config=[compute=COMPUTE],[description=DESCRIPTION],[labels=LABELS],[name=NAME],[networkResources=NETWORKRESOURCES],[networks=NETWORKS],[orchestrator=ORCHESTRATOR],[reconciling=RECONCILING],[storageResources=STORAGERESOURCES],[storages=STORAGES] + Required, Configuration of the cluster specs to be updated in shorthand + | JSON string | file path format. + + compute + Sets compute value. + + resourceRequests + Sets resourceRequests value. + + disks + Sets disks value. + + boot + Sets boot value. + + sizeGb + Sets sizeGb value. + + sourceImage + Sets sourceImage value. + + type + Sets type value. + + guestAccelerators + Sets guestAccelerators value. + + acceleratorType + Sets acceleratorType value. + + count + Sets count value. + + id + Sets id value. + + machineType + Sets machineType value. + + maxRunDuration + Sets maxRunDuration value. + + provisioningModel + Sets provisioningModel value. + + reservationAffinity + Sets reservationAffinity value. + + key + Sets key value. + + type + Sets type value. + + values + Sets values value. + + terminationAction + Sets terminationAction value. + + zone + Sets zone value. + + description + Sets description value. + + labels + Sets labels value. + + KEY + Keys must start with a lowercase character and contain only + hyphens (-), underscores (_), lowercase characters, and + numbers. + + VALUE + Values must contain only hyphens (-), underscores (_), + lowercase characters, and numbers. + + name + Sets name value. + + networkResources + Sets networkResources value. + + KEY + Sets KEY value. + + VALUE + Sets VALUE value. + + computeNetwork + Sets computeNetwork value. + + network + Sets network value. + + subnetwork + Sets subnetwork value. + + config + Sets config value. + + existingComputeNetwork + Sets existingComputeNetwork value. + + network + Sets network value. + + subnetwork + Sets subnetwork value. + + newComputeNetwork + Sets newComputeNetwork value. + + description + Sets description value. + + network + Sets network value. + + networks + Sets networks value. + + initializeParams + Sets initializeParams value. + + description + Sets description value. + + network + Sets network value. + + network + Sets network value. + + networkSource + Sets networkSource value. + + network + Sets network value. + + subnetwork + Sets subnetwork value. + + subnetwork + Sets subnetwork value. + + orchestrator + Sets orchestrator value. + + slurm + Sets slurm value. + + config + Sets config value. + + prologEpilogTimeout + Sets prologEpilogTimeout value. + + prologFlags + Sets prologFlags value. + + requeueExitCodes + Sets requeueExitCodes value. + + requeueHoldExitCodes + Sets requeueHoldExitCodes value. + + defaultPartition + Sets defaultPartition value. + + epilogBashScripts + Sets epilogBashScripts value. + + loginNodes + Sets loginNodes value. + + count + Sets count value. + + disks + Sets disks value. + + boot + Sets boot value. + + sizeGb + Sets sizeGb value. + + sourceImage + Sets sourceImage value. + + type + Sets type value. + + enableOsLogin + Sets enableOsLogin value. + + enablePublicIps + Sets enablePublicIps value. + + instances + Sets instances value. + + instance + Sets instance value. + + labels + Sets labels value. + + KEY + Keys must start with a lowercase character and + contain only hyphens (-), underscores (_), + lowercase characters, and numbers. + + VALUE + Values must contain only hyphens (-), underscores + (_), lowercase characters, and numbers. + + machineType + Sets machineType value. + + serviceAccount + Sets serviceAccount value. + + email + Sets email value. + + scopes + Sets scopes value. + + startupScript + Sets startupScript value. + + storageConfigs + Sets storageConfigs value. + + id + Sets id value. + + localMount + Sets localMount value. + + zone + Sets zone value. + + nodeSets + Sets nodeSets value. + + canIpForward + Sets canIpForward value. + + enableOsLogin + Sets enableOsLogin value. + + enablePublicIps + Sets enablePublicIps value. + + id + Sets id value. + + labels + Sets labels value. + + KEY + Keys must start with a lowercase character and + contain only hyphens (-), underscores (_), + lowercase characters, and numbers. + + VALUE + Values must contain only hyphens (-), underscores + (_), lowercase characters, and numbers. + + maxDynamicNodeCount + Sets maxDynamicNodeCount value. + + resourceRequestId + Sets resourceRequestId value. + + serviceAccount + Sets serviceAccount value. + + email + Sets email value. + + scopes + Sets scopes value. + + startupScript + Sets startupScript value. + + staticNodeCount + Sets staticNodeCount value. + + storageConfigs + Sets storageConfigs value. + + id + Sets id value. + + localMount + Sets localMount value. + + partitions + Sets partitions value. + + exclusive + Sets exclusive value. + + id + Sets id value. + + nodeSetIds + Sets nodeSetIds value. + + prologBashScripts + Sets prologBashScripts value. + + taskEpilogBashScripts + Sets taskEpilogBashScripts value. + + taskPrologBashScripts + Sets taskPrologBashScripts value. + + reconciling + Sets reconciling value. + + storageResources + Sets storageResources value. + + KEY + Sets KEY value. + + VALUE + Sets VALUE value. + + bucket + Sets bucket value. + + bucket + Sets bucket value. + + config + Sets config value. + + existingBucket + Sets existingBucket value. + + bucket + Sets bucket value. + + existingFilestore + Sets existingFilestore value. + + filestore + Sets filestore value. + + existingLustre + Sets existingLustre value. + + lustre + Sets lustre value. + + newBucket + Sets newBucket value. + + autoclass + Sets autoclass value. + + enabled + Sets enabled value. + + terminalStorageClass + Sets terminalStorageClass value. + + bucket + Sets bucket value. + + hierarchicalNamespace + Sets hierarchicalNamespace value. + + enabled + Sets enabled value. + + storageClass + Sets storageClass value. + + newFilestore + Sets newFilestore value. + + description + Sets description value. + + fileShares + Sets fileShares value. + + capacityGb + Sets capacityGb value. + + fileShare + Sets fileShare value. + + filestore + Sets filestore value. + + protocol + Sets protocol value. + + tier + Sets tier value. + + newLustre + Sets newLustre value. + + capacityGb + Sets capacityGb value. + + description + Sets description value. + + filesystem + Sets filesystem value. + + lustre + Sets lustre value. + + filestore + Sets filestore value. + + filestore + Sets filestore value. + + lustre + Sets lustre value. + + lustre + Sets lustre value. + + storages + Sets storages value. + + id + Sets id value. + + initializeParams + Sets initializeParams value. + + filestore + Sets filestore value. + + description + Sets description value. + + fileShares + Sets fileShares value. + + capacityGb + Sets capacityGb value. + + fileShare + Sets fileShare value. + + filestore + Sets filestore value. + + protocol + Sets protocol value. + + tier + Sets tier value. + + gcs + Sets gcs value. + + autoclass + Sets autoclass value. + + enabled + Sets enabled value. + + terminalStorageClass + Sets terminalStorageClass value. + + bucket + Sets bucket value. + + hierarchicalNamespace + Sets hierarchicalNamespace value. + + enabled + Sets enabled value. + + storageClass + Sets storageClass value. + + lustre + Sets lustre value. + + capacityGb + Sets capacityGb value. + + description + Sets description value. + + filesystem + Sets filesystem value. + + lustre + Sets lustre value. + + storage + Sets storage value. + + storageSource + Sets storageSource value. + + bucket + Sets bucket value. + + filestore + Sets filestore value. + + lustre + Sets lustre value. + + Shorthand Example: + + --config=compute={resourceRequests=[{disks=[{boot=boolean,sizeGb=int,sourceImage=string,type=string}],guestAccelerators=[{acceleratorType=string,count=int}],id=string,machineType=string,maxRunDuration=int,provisioningModel=string,reservationAffinity={key=string,type=string,values=[string]},terminationAction=string,zone=string}]},description=string,labels={string=string},name=string,networkResources={string={computeNetwork={network=string,subnetwork=string},config={existingComputeNetwork={network=string,subnetwork=string},newComputeNetwork={description=string,network=string}}}},networks=[{initializeParams={description=string,network=string},network=string,networkSource={network=string,subnetwork=string},subnetwork=string}],orchestrator={slurm={config={prologEpilogTimeout=string,prologFlags=[string],requeueExitCodes=[int],requeueHoldExitCodes=[int]},defaultPartition=string,epilogBashScripts=[string],loginNodes={count=int,disks=[{boot=boolean,sizeGb=int,sourceImage=string,type=string}],enableOsLogin=boolean,enablePublicIps=boolean,instances=[{instance=string}],labels={string=string},machineType=string,serviceAccount={email=string,scopes=[string]},startupScript=string,storageConfigs=[{id=string,localMount=string}],zone=string},nodeSets=[{canIpForward=boolean,enableOsLogin=boolean,enablePublicIps=boolean,id=string,labels={string=string},maxDynamicNodeCount=int,resourceRequestId=string,serviceAccount={email=string,scopes=[string]},startupScript=string,staticNodeCount=int,storageConfigs=[{id=string,localMount=string}]}],partitions=[{exclusive=boolean,id=string,nodeSetIds=[string]}],prologBashScripts=[string],taskEpilogBashScripts=[string],taskPrologBashScripts=[string]}},reconciling=boolean,storageResources={string={bucket={bucket=string},config={existingBucket={bucket=string},existingFilestore={filestore=string},existingLustre={lustre=string},newBucket={autoclass={enabled=boolean,terminalStorageClass=string},bucket=string,hierarchicalNamespace={enabled=boolean},storageClass=string},newFilestore={description=string,fileShares=[{capacityGb=int,fileShare=string}],filestore=string,protocol=string,tier=string},newLustre={capacityGb=int,description=string,filesystem=string,lustre=string}},filestore={filestore=string},lustre={lustre=string}}},storages=[{id=string,initializeParams={filestore={description=string,fileShares=[{capacityGb=int,fileShare=string}],filestore=string,protocol=string,tier=string},gcs={autoclass={enabled=boolean,terminalStorageClass=string},bucket=string,hierarchicalNamespace={enabled=boolean},storageClass=string},lustre={capacityGb=int,description=string,filesystem=string,lustre=string}},storage=string,storageSource={bucket=string,filestore=string,lustre=string}}] + + JSON Example: + + --config='{"compute": {"resourceRequests": [{"disks": [{"boot": boolean, "sizeGb": int, "sourceImage": "string", "type": "string"}], "guestAccelerators": [{"acceleratorType": "string", "count": int}], "id": "string", "machineType": "string", "maxRunDuration": int, "provisioningModel": "string", "reservationAffinity": {"key": "string", "type": "string", "values": ["string"]}, "terminationAction": "string", "zone": "string"}]}, "description": "string", "labels": {"string": "string"}, "name": "string", "networkResources": {"string": {"computeNetwork": {"network": "string", "subnetwork": "string"}, "config": {"existingComputeNetwork": {"network": "string", "subnetwork": "string"}, "newComputeNetwork": {"description": "string", "network": "string"}}}}, "networks": [{"initializeParams": {"description": "string", "network": "string"}, "network": "string", "networkSource": {"network": "string", "subnetwork": "string"}, "subnetwork": "string"}], "orchestrator": {"slurm": {"config": {"prologEpilogTimeout": "string", "prologFlags": ["string"], "requeueExitCodes": [int], "requeueHoldExitCodes": [int]}, "defaultPartition": "string", "epilogBashScripts": ["string"], "loginNodes": {"count": int, "disks": [{"boot": boolean, "sizeGb": int, "sourceImage": "string", "type": "string"}], "enableOsLogin": boolean, "enablePublicIps": boolean, "instances": [{"instance": "string"}], "labels": {"string": "string"}, "machineType": "string", "serviceAccount": {"email": "string", "scopes": ["string"]}, "startupScript": "string", "storageConfigs": [{"id": "string", "localMount": "string"}], "zone": "string"}, "nodeSets": [{"canIpForward": boolean, "enableOsLogin": boolean, "enablePublicIps": boolean, "id": "string", "labels": {"string": "string"}, "maxDynamicNodeCount": int, "resourceRequestId": "string", "serviceAccount": {"email": "string", "scopes": ["string"]}, "startupScript": "string", "staticNodeCount": int, "storageConfigs": [{"id": "string", "localMount": "string"}]}], "partitions": [{"exclusive": boolean, "id": "string", "nodeSetIds": ["string"]}], "prologBashScripts": ["string"], "taskEpilogBashScripts": ["string"], "taskPrologBashScripts": ["string"]}}, "reconciling": boolean, "storageResources": {"string": {"bucket": {"bucket": "string"}, "config": {"existingBucket": {"bucket": "string"}, "existingFilestore": {"filestore": "string"}, "existingLustre": {"lustre": "string"}, "newBucket": {"autoclass": {"enabled": boolean, "terminalStorageClass": "string"}, "bucket": "string", "hierarchicalNamespace": {"enabled": boolean}, "storageClass": "string"}, "newFilestore": {"description": "string", "fileShares": [{"capacityGb": int, "fileShare": "string"}], "filestore": "string", "protocol": "string", "tier": "string"}, "newLustre": {"capacityGb": int, "description": "string", "filesystem": "string", "lustre": "string"}}, "filestore": {"filestore": "string"}, "lustre": {"lustre": "string"}}}, "storages": [{"id": "string", "initializeParams": {"filestore": {"description": "string", "fileShares": [{"capacityGb": int, "fileShare": "string"}], "filestore": "string", "protocol": "string", "tier": "string"}, "gcs": {"autoclass": {"enabled": boolean, "terminalStorageClass": "string"}, "bucket": "string", "hierarchicalNamespace": {"enabled": boolean}, "storageClass": "string"}, "lustre": {"capacityGb": int, "description": "string", "filesystem": "string", "lustre": "string"}}, "storage": "string", "storageSource": {"bucket": "string", "filestore": "string", "lustre": "string"}}]}' + + File Example: + + --config=path_to_file.(yaml|json) + + --update-mask=UPDATE_MASK + Required, Field mask to be updated in shorthand | JSON string | file + path format. + + Input Example: + + --update-mask=string + + File Example: + + --update-mask=path_to_file.(yaml|json) + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +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. + +API REFERENCE + This command uses the hypercomputecluster/v1alpha API. The full + documentation for this API can be found at: + https://cloud.google.com/ai-hypercomputer/docs/cluster-director + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/cluster-director/help b/gcloud/alpha/cluster-director/help new file mode 100644 index 000000000..de46f8e4d --- /dev/null +++ b/gcloud/alpha/cluster-director/help @@ -0,0 +1,32 @@ +NAME + gcloud alpha cluster-director - manage Cluster Director resources + +SYNOPSIS + gcloud alpha cluster-director GROUP [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Cluster Director resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + clusters + (ALPHA) Manage Cluster Director cluster resources. + + locations + (ALPHA) View Locations resources. + + operations + (ALPHA) Manage Operation resources. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/cluster-director/locations/describe b/gcloud/alpha/cluster-director/locations/describe new file mode 100644 index 000000000..cbdacd0e2 --- /dev/null +++ b/gcloud/alpha/cluster-director/locations/describe @@ -0,0 +1,53 @@ +NAME + gcloud alpha cluster-director locations describe - describe locations + +SYNOPSIS + gcloud alpha cluster-director locations describe LOCATION + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe a location. + +EXAMPLES + To describe the operation, run: + + $ gcloud alpha cluster-director locations describe us-central1 + +POSITIONAL ARGUMENTS + Location resource - The name of the location resource. This represents a + Cloud 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 + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument location on the command line. + +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. + +API REFERENCE + This command uses the hypercomputecluster/v1alpha API. The full + documentation for this API can be found at: + https://cloud.google.com/ai-hypercomputer/docs/cluster-director + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/cluster-director/locations/help b/gcloud/alpha/cluster-director/locations/help new file mode 100644 index 000000000..ad30c4982 --- /dev/null +++ b/gcloud/alpha/cluster-director/locations/help @@ -0,0 +1,29 @@ +NAME + gcloud alpha cluster-director locations - view Locations resources + +SYNOPSIS + gcloud alpha cluster-director locations COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) View Locations resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + (ALPHA) Describe locations. + + list + (ALPHA) List locations. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/cluster-director/locations/list b/gcloud/alpha/cluster-director/locations/list new file mode 100644 index 000000000..ca6defa5e --- /dev/null +++ b/gcloud/alpha/cluster-director/locations/list @@ -0,0 +1,61 @@ +NAME + gcloud alpha cluster-director locations list - list locations + +SYNOPSIS + gcloud alpha cluster-director locations list [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List locations. + +EXAMPLES + To list all locations, run: + + $ gcloud alpha cluster-director locations list + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + +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. + +API REFERENCE + This command uses the hypercomputecluster/v1alpha API. The full + documentation for this API can be found at: + https://cloud.google.com/ai-hypercomputer/docs/cluster-director + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/cluster-director/operations/describe b/gcloud/alpha/cluster-director/operations/describe new file mode 100644 index 000000000..3a0afd054 --- /dev/null +++ b/gcloud/alpha/cluster-director/operations/describe @@ -0,0 +1,66 @@ +NAME + gcloud alpha cluster-director operations describe - describe operations + +SYNOPSIS + gcloud alpha cluster-director operations describe + (OPERATION : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe an operation + +EXAMPLES + To describe the operation my-operation in location us-central1-a, run: + + $ gcloud alpha cluster-director operations describe my-operation \ + --location=us-central1-a + +POSITIONAL ARGUMENTS + Operation resource - The name of the operation resource. 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 operation on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + OPERATION + ID of the operation or fully qualified identifier for the operation. + + To set the operation attribute: + ▸ provide the argument operation on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the operation resource. + + To set the location attribute: + ▸ provide the argument operation on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +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. + +API REFERENCE + This command uses the hypercomputecluster/v1alpha API. The full + documentation for this API can be found at: + https://cloud.google.com/ai-hypercomputer/docs/cluster-director + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/cluster-director/operations/help b/gcloud/alpha/cluster-director/operations/help new file mode 100644 index 000000000..c227fce56 --- /dev/null +++ b/gcloud/alpha/cluster-director/operations/help @@ -0,0 +1,26 @@ +NAME + gcloud alpha cluster-director operations - manage Operation resources + +SYNOPSIS + gcloud alpha cluster-director operations COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Operation resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + (ALPHA) Describe operations. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/composer/environments/run b/gcloud/alpha/composer/environments/run index 5d63b8bef..dfaa1c6b7 100644 --- a/gcloud/alpha/composer/environments/run +++ b/gcloud/alpha/composer/environments/run @@ -81,17 +81,17 @@ POSITIONAL ARGUMENTS SUBCOMMAND The Airflow CLI subcommand to run. Available subcommands include (listed with Airflow versions that support): backfill [**, 2.0.0), - clear [**, 2.0.0), connections [**, 3.0.0), dag_state [**, 2.0.0), dags - [1.10.14, 3.0.0), db [2.3.0, 3.0.0), delete_dag [1.10.1, 2.0.0), - kerberos [**, 3.0.0), kubernetes [2.1.4, 3.0.0), list-import-errors + clear [**, 2.0.0), connections [**, 3.1.0), dag_state [**, 2.0.0), dags + [1.10.14, 3.1.0), db [2.3.0, 3.0.0), delete_dag [1.10.1, 2.0.0), + kerberos [**, 3.1.0), kubernetes [2.1.4, 3.1.0), list-import-errors [**, 3.0.0), list_dag_runs [1.10.2, 2.0.0), list_dags [**, 2.0.0), list_tasks [**, 2.0.0), next_execution [1.10.2, 2.0.0), pause [**, - 2.0.0), pool [**, 2.0.0), pools [1.10.14, 3.0.0), render [**, 2.0.0), - roles [2.0.0, 3.0.0), run [**, 2.0.0), sync-perm [1.10.14, 3.0.0), + 2.0.0), pool [**, 2.0.0), pools [1.10.14, 3.1.0), render [**, 2.0.0), + roles [2.0.0, 3.1.0), run [**, 2.0.0), sync-perm [1.10.14, 3.1.0), sync_perm [1.10.2, 2.0.0), task_failed_deps [**, 2.0.0), task_state - [**, 2.0.0), tasks [1.10.14, 3.0.0), test [**, 2.0.0), trigger_dag [**, + [**, 2.0.0), tasks [1.10.14, 3.1.0), test [**, 2.0.0), trigger_dag [**, 2.0.0), unpause [**, 2.0.0), upgrade_check [1.10.15, 2.0.0), users - [1.10.14, 3.0.0), variables [**, 3.0.0), version [**, 3.0.0) (see + [1.10.14, 3.1.0), variables [**, 3.1.0), version [**, 3.1.0) (see https://airflow.apache.org/docs/apache-airflow/stable/cli-and-env-variables-ref.html for more info). diff --git a/gcloud/alpha/compute/backend-buckets/create b/gcloud/alpha/compute/backend-buckets/create index 0df1f487f..ee8c13b08 100644 --- a/gcloud/alpha/compute/backend-buckets/create +++ b/gcloud/alpha/compute/backend-buckets/create @@ -14,7 +14,8 @@ SYNOPSIS [--[no-]enable-cdn] [--load-balancing-scheme=LOAD_BALANCING_SCHEME] [--max-ttl=MAX_TTL] [--[no-]negative-caching] [--negative-caching-policy=[[CODE=TTL],...]] - [--[no-]request-coalescing] [--serve-while-stale=SERVE_WHILE_STALE] + [--[no-]request-coalescing] [--resource-manager-tags=[KEY=VALUE,...]] + [--serve-while-stale=SERVE_WHILE_STALE] [--signed-url-cache-max-age=SIGNED_URL_CACHE_MAX_AGE] [--global | --region=REGION] [GCLOUD_WIDE_FLAG ...] @@ -163,7 +164,7 @@ OPTIONAL FLAGS The load balancing scheme of the backend bucket. If left blank, the backend bucket will be compatible with Global External Application Load Balancer or Classic Application Load Balancer. LOAD_BALANCING_SCHEME - must be (only one value is supported): INTERNAL_MANAGED. + must be one of: INTERNAL_MANAGED, EXTERNAL_MANAGED. --max-ttl=MAX_TTL Specifies the maximum allowed TTL for cached content served by this @@ -258,6 +259,10 @@ OPTIONAL FLAGS Use --request-coalescing to enable and --no-request-coalescing to disable. + --resource-manager-tags=[KEY=VALUE,...] + Comma-separated list of Resource Manager tags to apply to the backend + bucket. + --serve-while-stale=SERVE_WHILE_STALE Serve existing content from the cache (if available) when revalidating content with the origin; this allows content to be served more quickly, diff --git a/gcloud/alpha/compute/backend-services/create b/gcloud/alpha/compute/backend-services/create index 2facf28bb..3d78e738c 100644 --- a/gcloud/alpha/compute/backend-services/create +++ b/gcloud/alpha/compute/backend-services/create @@ -35,7 +35,8 @@ SYNOPSIS [--logging-sample-rate=LOGGING_SAMPLE_RATE] [--max-ttl=MAX_TTL] [--[no-]negative-caching] [--negative-caching-policy=[[CODE=TTL],...]] [--network=NETWORK] [--port-name=PORT_NAME] [--protocol=PROTOCOL] - [--[no-]request-coalescing] [--serve-while-stale=SERVE_WHILE_STALE] + [--[no-]request-coalescing] [--resource-manager-tags=[KEY=VALUE,...]] + [--serve-while-stale=SERVE_WHILE_STALE] [--service-bindings=SERVICE_BINDING,[...]] [--service-lb-policy=SERVICE_LOAD_BALANCING_POLICY] [--session-affinity=SESSION_AFFINITY] @@ -592,6 +593,10 @@ FLAGS Use --request-coalescing to enable and --no-request-coalescing to disable. + --resource-manager-tags=[KEY=VALUE,...] + A comma-separated list of Resource Manager tags to apply to the backend + service. + --serve-while-stale=SERVE_WHILE_STALE Serve existing content from the cache (if available) when revalidating content with the origin; this allows content to be served more quickly, diff --git a/gcloud/alpha/compute/interconnects/wire-groups/create b/gcloud/alpha/compute/interconnects/wire-groups/create index f306ada57..f182ba7ba 100644 --- a/gcloud/alpha/compute/interconnects/wire-groups/create +++ b/gcloud/alpha/compute/interconnects/wire-groups/create @@ -5,12 +5,12 @@ NAME SYNOPSIS gcloud alpha compute interconnects wire-groups create NAME --bandwidth-unmetered=BANDWIDTH_UNMETERED - --cross-site-network=CROSS_SITE_NETWORK --type=TYPE [--admin-enabled] + --cross-site-network=CROSS_SITE_NETWORK [--admin-enabled] [--bandwidth-allocation=BANDWIDTH_ALLOCATION] [--bandwidth-metered=BANDWIDTH_METERED] [--description=DESCRIPTION] [--fault-response=FAULT_RESPONSE] - [--network-service-class=NETWORK_SERVICE_CLASS] [--validate-only] - [GCLOUD_WIDE_FLAG ...] + [--network-service-class=NETWORK_SERVICE_CLASS] [--type=TYPE] + [--validate-only] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) gcloud alpha compute interconnects wire-groups create is used to @@ -26,7 +26,7 @@ EXAMPLES $ gcloud alpha compute interconnects wire-groups create \ example-wire-group --project my-project \ --cross-site-network example-cross-site-network \ - --type REDUNDANT --bandwidth-unmetered 1 + --bandwidth-unmetered 1 POSITIONAL ARGUMENTS NAME @@ -39,18 +39,6 @@ REQUIRED FLAGS --cross-site-network=CROSS_SITE_NETWORK Name of the crossSiteNetwork to operate on. - --type=TYPE - The type for the wire group. TYPE must be one of: - - BOX_AND_CROSS - Box and cross type wire groups must have two VLAN tags. The first - is for the same-zone pseudowire, and the second is for the - cross-zone pseudowire. - REDUNDANT - Redundant type wire groups must have only one VLAN tag. - WIRE - Single wire type wire groups must have only one VLAN tag. - OPTIONAL FLAGS --admin-enabled Administrative status of the wire group. If not provided on creation, @@ -97,6 +85,18 @@ OPTIONAL FLAGS GOLD The highest service class. + --type=TYPE + The type for the wire group. TYPE must be one of: + + BOX_AND_CROSS + Box and cross type wire groups must have two VLAN tags. The first + is for the same-zone pseudowire, and the second is for the + cross-zone pseudowire. + REDUNDANT + Redundant type wire groups must have only one VLAN tag. + WIRE + Single wire type wire groups must have only one VLAN tag. + --validate-only Validate the new configuration, but don't update it. diff --git a/gcloud/alpha/compute/networks/peerings/request-delete b/gcloud/alpha/compute/networks/peerings/request-delete index fe65927db..57407e767 100644 --- a/gcloud/alpha/compute/networks/peerings/request-delete +++ b/gcloud/alpha/compute/networks/peerings/request-delete @@ -49,7 +49,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud compute networks peerings request-delete $ gcloud beta compute networks peerings request-delete diff --git a/gcloud/alpha/compute/service-attachments/update b/gcloud/alpha/compute/service-attachments/update index c113c9812..2a3c48031 100644 --- a/gcloud/alpha/compute/service-attachments/update +++ b/gcloud/alpha/compute/service-attachments/update @@ -11,7 +11,8 @@ SYNOPSIS [--nat-subnets=NAT_SUBNETS,[NAT_SUBNETS,...]] [--nat-subnets-region=NAT_SUBNETS_REGION] [--propagated-connection-limit=PROPAGATED_CONNECTION_LIMIT] - [--[no-]reconcile-connections] [--region=REGION] [GCLOUD_WIDE_FLAG ...] + [--[no-]reconcile-connections] [--region=REGION] + [--target-service=TARGET_SERVICE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) gcloud alpha compute service-attachments update is used to update @@ -146,6 +147,9 @@ FLAGS Alternatively, the region can be stored in the environment variable CLOUDSDK_COMPUTE_REGION. + --target-service=TARGET_SERVICE + URL of the target service that receives forwarded traffic. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/compute/target-vpn-gateways/create b/gcloud/alpha/compute/target-vpn-gateways/create index 45ca80552..25833e4d2 100644 --- a/gcloud/alpha/compute/target-vpn-gateways/create +++ b/gcloud/alpha/compute/target-vpn-gateways/create @@ -4,7 +4,8 @@ NAME SYNOPSIS gcloud alpha compute target-vpn-gateways create NAME --network=NETWORK - [--description=DESCRIPTION] [--region=REGION] [GCLOUD_WIDE_FLAG ...] + [--description=DESCRIPTION] [--region=REGION] + [--resource-manager-tags=[KEY=VALUE,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) gcloud alpha compute target-vpn-gateways create is used to create a @@ -45,6 +46,10 @@ OPTIONAL FLAGS Alternatively, the region can be stored in the environment variable CLOUDSDK_COMPUTE_REGION. + --resource-manager-tags=[KEY=VALUE,...] + A comma-separated list of Resource Manager tags to apply to the target + VPN gateway. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/config/get b/gcloud/alpha/config/get index a43148730..464e50193 100644 --- a/gcloud/alpha/config/get +++ b/gcloud/alpha/config/get @@ -399,6 +399,9 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud healthcare command group. Defaults to https://healthcare.googleapis.com/ + hypercomputecluster + Overrides API endpoint for gcloud cluster-director command group. + iam Overrides API endpoint for gcloud iam command group. Defaults to https://iam.googleapis.com/ @@ -1240,7 +1243,7 @@ AVAILABLE PROPERTIES Chunk size used for copying to in clouds or on disk. download_chunk_size - Chunk size used for downloadinging to clouds. + Chunk size used for downloading to clouds. exponential_sleep_multiplier Used in exponential backoff for retrying operations. diff --git a/gcloud/alpha/config/help b/gcloud/alpha/config/help index c233fffca..c4639854a 100644 --- a/gcloud/alpha/config/help +++ b/gcloud/alpha/config/help @@ -431,6 +431,9 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud healthcare command group. Defaults to https://healthcare.googleapis.com/ + hypercomputecluster + Overrides API endpoint for gcloud cluster-director command group. + iam Overrides API endpoint for gcloud iam command group. Defaults to https://iam.googleapis.com/ @@ -1272,7 +1275,7 @@ AVAILABLE PROPERTIES Chunk size used for copying to in clouds or on disk. download_chunk_size - Chunk size used for downloadinging to clouds. + Chunk size used for downloading to clouds. exponential_sleep_multiplier Used in exponential backoff for retrying operations. diff --git a/gcloud/alpha/config/list b/gcloud/alpha/config/list index c3bbd695e..186e47a11 100644 --- a/gcloud/alpha/config/list +++ b/gcloud/alpha/config/list @@ -443,6 +443,9 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud healthcare command group. Defaults to https://healthcare.googleapis.com/ + hypercomputecluster + Overrides API endpoint for gcloud cluster-director command group. + iam Overrides API endpoint for gcloud iam command group. Defaults to https://iam.googleapis.com/ @@ -1284,7 +1287,7 @@ AVAILABLE PROPERTIES Chunk size used for copying to in clouds or on disk. download_chunk_size - Chunk size used for downloadinging to clouds. + Chunk size used for downloading to clouds. exponential_sleep_multiplier Used in exponential backoff for retrying operations. diff --git a/gcloud/alpha/config/set b/gcloud/alpha/config/set index 2d5acb290..9c3f1f774 100644 --- a/gcloud/alpha/config/set +++ b/gcloud/alpha/config/set @@ -446,6 +446,9 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud healthcare command group. Defaults to https://healthcare.googleapis.com/ + hypercomputecluster + Overrides API endpoint for gcloud cluster-director command group. + iam Overrides API endpoint for gcloud iam command group. Defaults to https://iam.googleapis.com/ @@ -1287,7 +1290,7 @@ AVAILABLE PROPERTIES Chunk size used for copying to in clouds or on disk. download_chunk_size - Chunk size used for downloadinging to clouds. + Chunk size used for downloading to clouds. exponential_sleep_multiplier Used in exponential backoff for retrying operations. diff --git a/gcloud/alpha/config/unset b/gcloud/alpha/config/unset index 8795ef5e6..ea1149db8 100644 --- a/gcloud/alpha/config/unset +++ b/gcloud/alpha/config/unset @@ -407,6 +407,9 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud healthcare command group. Defaults to https://healthcare.googleapis.com/ + hypercomputecluster + Overrides API endpoint for gcloud cluster-director command group. + iam Overrides API endpoint for gcloud iam command group. Defaults to https://iam.googleapis.com/ @@ -1248,7 +1251,7 @@ AVAILABLE PROPERTIES Chunk size used for copying to in clouds or on disk. download_chunk_size - Chunk size used for downloadinging to clouds. + Chunk size used for downloading to clouds. exponential_sleep_multiplier Used in exponential backoff for retrying operations. diff --git a/gcloud/alpha/container/clusters/create b/gcloud/alpha/container/clusters/create index 15cc8e5da..cb5aece21 100644 --- a/gcloud/alpha/container/clusters/create +++ b/gcloud/alpha/container/clusters/create @@ -67,6 +67,7 @@ SYNOPSIS [--max-pods-per-node=MAX_PODS_PER_NODE] [--max-surge-upgrade=MAX_SURGE_UPGRADE; default=1] [--max-unavailable-upgrade=MAX_UNAVAILABLE_UPGRADE] + [--membership-type=MEMBERSHIP_TYPE] [--metadata=KEY=VALUE,[KEY=VALUE,...]] [--metadata-from-file=KEY=LOCAL_FILE_PATH,[...]] [--min-cpu-platform=PLATFORM] [--monitoring=[COMPONENT,...]] @@ -991,6 +992,15 @@ FLAGS Must be used in conjunction with '--max-surge-upgrade'. + --membership-type=MEMBERSHIP_TYPE + Specify a membership type for the cluster's fleet membership. Example: + $ gcloud alpha container clusters create \ + --membership-type=LIGHTWEIGHT. MEMBERSHIP_TYPE must be (only \ one + value is supported): + + LIGHTWEIGHT + Fleet membership representing this cluster will be lightweight. + --metadata=KEY=VALUE,[KEY=VALUE,...] Compute Engine metadata to be made available to the guest operating system running on nodes within the node pool. diff --git a/gcloud/alpha/container/clusters/create-auto b/gcloud/alpha/container/clusters/create-auto index 25849144d..b257f9252 100644 --- a/gcloud/alpha/container/clusters/create-auto +++ b/gcloud/alpha/container/clusters/create-auto @@ -27,12 +27,13 @@ SYNOPSIS [--enable-ray-cluster-logging] [--enable-ray-cluster-monitoring] [--enable-ray-operator] [--fleet-project=PROJECT_ID_OR_NUMBER] [--hpa-profile=HPA_PROFILE] [--labels=[KEY=VALUE,...]] - [--logging=[COMPONENT,...]] [--monitoring=[COMPONENT,...]] - [--network=NETWORK] [--private-endpoint-subnetwork=NAME] - [--release-channel=CHANNEL] [--security-group=SECURITY_GROUP] - [--security-posture=SECURITY_POSTURE] [--services-ipv4-cidr=CIDR] - [--services-secondary-range-name=NAME] [--subnetwork=SUBNETWORK] - [--tier=TIER] [--workload-policies=WORKLOAD_POLICIES] + [--logging=[COMPONENT,...]] [--membership-type=MEMBERSHIP_TYPE] + [--monitoring=[COMPONENT,...]] [--network=NETWORK] + [--private-endpoint-subnetwork=NAME] [--release-channel=CHANNEL] + [--security-group=SECURITY_GROUP] [--security-posture=SECURITY_POSTURE] + [--services-ipv4-cidr=CIDR] [--services-secondary-range-name=NAME] + [--subnetwork=SUBNETWORK] [--tier=TIER] + [--workload-policies=WORKLOAD_POLICIES] [--workload-vulnerability-scanning=WORKLOAD_VULNERABILITY_SCANNING] [--additive-vpc-scope-dns-domain=ADDITIVE_VPC_SCOPE_DNS_DOMAIN | --disable-additive-vpc-scope] @@ -382,6 +383,15 @@ FLAGS --logging=SYSTEM,WORKLOAD,API_SERVER,CONTROLLER_MANAGER,\ SCHEDULER + --membership-type=MEMBERSHIP_TYPE + Specify a membership type for the cluster's fleet membership. Example: + $ gcloud alpha container clusters create-auto \ + --membership-type=LIGHTWEIGHT. MEMBERSHIP_TYPE must be (only \ one + value is supported): + + LIGHTWEIGHT + Fleet membership representing this cluster will be lightweight. + --monitoring=[COMPONENT,...] Set the components that have monitoring enabled. Valid component values are: SYSTEM, WORKLOAD (Deprecated), NONE, API_SERVER, diff --git a/gcloud/alpha/container/clusters/update b/gcloud/alpha/container/clusters/update index f5f1e0d58..ba3067387 100644 --- a/gcloud/alpha/container/clusters/update +++ b/gcloud/alpha/container/clusters/update @@ -65,9 +65,10 @@ SYNOPSIS | --binauthz-policy-bindings=[name=BINAUTHZ_POLICY, enforcement-mode=ENFORCEMENT_MODE,...] --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE - | --enable-binauthz | --clear-fleet-project - --enable-fleet --fleet-project=PROJECT_ID_OR_NUMBER - | --clear-maintenance-window | --remove-maintenance-exclusion=NAME + | --enable-binauthz | --clear-fleet-project --enable-fleet + --fleet-project=PROJECT_ID_OR_NUMBER + --membership-type=MEMBERSHIP_TYPE | --clear-maintenance-window + | --remove-maintenance-exclusion=NAME | [--add-maintenance-exclusion-end=TIME_STAMP : --add-maintenance-exclusion-name=NAME --add-maintenance-exclusion-scope=SCOPE @@ -1043,6 +1044,15 @@ REQUIRED FLAGS Example: $ gcloud alpha container clusters update --fleet-project=my-project + --membership-type=MEMBERSHIP_TYPE + Specify a membership type for the cluster's fleet membership. + Example: $ gcloud alpha container clusters update \ + --membership-type=LIGHTWEIGHT. MEMBERSHIP_TYPE must be (only \ one + value is supported): + + LIGHTWEIGHT + Fleet membership representing this cluster will be lightweight. + At most one of these can be specified: --clear-maintenance-window diff --git a/gcloud/alpha/container/fleet/config-management/describe b/gcloud/alpha/container/fleet/config-management/describe index 28483c7fc..8139e2e17 100644 --- a/gcloud/alpha/container/fleet/config-management/describe +++ b/gcloud/alpha/container/fleet/config-management/describe @@ -21,7 +21,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container fleet config-management describe $ gcloud beta container fleet config-management describe diff --git a/gcloud/alpha/container/fleet/config-management/disable b/gcloud/alpha/container/fleet/config-management/disable index 6d1862657..0807e02ba 100644 --- a/gcloud/alpha/container/fleet/config-management/disable +++ b/gcloud/alpha/container/fleet/config-management/disable @@ -110,7 +110,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container fleet config-management disable $ gcloud beta container fleet config-management disable diff --git a/gcloud/alpha/container/fleet/config-management/help b/gcloud/alpha/container/fleet/config-management/help index 81c962fb9..3c2e126de 100644 --- a/gcloud/alpha/container/fleet/config-management/help +++ b/gcloud/alpha/container/fleet/config-management/help @@ -1,5 +1,5 @@ NAME - gcloud alpha container fleet config-management - manage Config Management + gcloud alpha container fleet config-management - use the Config Management feature SYNOPSIS @@ -59,7 +59,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container fleet config-management $ gcloud beta container fleet config-management diff --git a/gcloud/alpha/container/fleet/help b/gcloud/alpha/container/fleet/help index 5c13145ce..a6a084984 100644 --- a/gcloud/alpha/container/fleet/help +++ b/gcloud/alpha/container/fleet/help @@ -52,7 +52,7 @@ GROUPS (ALPHA) Configure the Fleet clusterupgrade feature. config-management - (ALPHA) Manage Config Management feature. + (ALPHA) Use the Config Management feature. dataplane-v2-encryption (ALPHA) Manage Dataplane V2 Encryption Feature. diff --git a/gcloud/alpha/container/hub/config-management/describe b/gcloud/alpha/container/hub/config-management/describe index 7e3b9a5b4..0d79272ee 100644 --- a/gcloud/alpha/container/hub/config-management/describe +++ b/gcloud/alpha/container/hub/config-management/describe @@ -21,7 +21,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container hub config-management describe $ gcloud beta container hub config-management describe diff --git a/gcloud/alpha/container/hub/config-management/disable b/gcloud/alpha/container/hub/config-management/disable index ec166858b..a5868374f 100644 --- a/gcloud/alpha/container/hub/config-management/disable +++ b/gcloud/alpha/container/hub/config-management/disable @@ -109,7 +109,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container hub config-management disable $ gcloud beta container hub config-management disable diff --git a/gcloud/alpha/container/hub/config-management/help b/gcloud/alpha/container/hub/config-management/help index 2d21e3885..c31818734 100644 --- a/gcloud/alpha/container/hub/config-management/help +++ b/gcloud/alpha/container/hub/config-management/help @@ -1,5 +1,5 @@ NAME - gcloud alpha container hub config-management - manage Config Management + gcloud alpha container hub config-management - use the Config Management feature SYNOPSIS @@ -58,7 +58,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud container hub config-management $ gcloud beta container hub config-management diff --git a/gcloud/alpha/container/hub/help b/gcloud/alpha/container/hub/help index a17163c52..e0901b93b 100644 --- a/gcloud/alpha/container/hub/help +++ b/gcloud/alpha/container/hub/help @@ -52,7 +52,7 @@ GROUPS (ALPHA) Configure the Fleet clusterupgrade feature. config-management - (ALPHA) Manage Config Management feature. + (ALPHA) Use the Config Management feature. dataplane-v2-encryption (ALPHA) Manage Dataplane V2 Encryption Feature. diff --git a/gcloud/alpha/managed-kafka/schema-registries/describe b/gcloud/alpha/managed-kafka/schema-registries/describe index ef2fb26f2..ecc4f5d5d 100644 --- a/gcloud/alpha/managed-kafka/schema-registries/describe +++ b/gcloud/alpha/managed-kafka/schema-registries/describe @@ -14,7 +14,7 @@ EXAMPLES --schema_registry=SCHEMA_REGISTRY_ID POSITIONAL ARGUMENTS - Schema registry resource - The schema registry to create. The arguments in + Schema registry resource - The schema registry resource. 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. diff --git a/gcloud/alpha/managed-kafka/schema-registries/help b/gcloud/alpha/managed-kafka/schema-registries/help index bd0797d6a..945d67077 100644 --- a/gcloud/alpha/managed-kafka/schema-registries/help +++ b/gcloud/alpha/managed-kafka/schema-registries/help @@ -17,7 +17,7 @@ GCLOUD WIDE FLAGS GROUPS GROUP is one of the following: - subject + subjects (ALPHA) Administer Managed Service for Apache Kafka schema-registries. COMMANDS diff --git a/gcloud/alpha/managed-kafka/schema-registries/subject/describe b/gcloud/alpha/managed-kafka/schema-registries/subjects/describe similarity index 79% rename from gcloud/alpha/managed-kafka/schema-registries/subject/describe rename to gcloud/alpha/managed-kafka/schema-registries/subjects/describe index 87c67cdbb..95830866f 100644 --- a/gcloud/alpha/managed-kafka/schema-registries/subject/describe +++ b/gcloud/alpha/managed-kafka/schema-registries/subjects/describe @@ -1,21 +1,21 @@ NAME - gcloud alpha managed-kafka schema-registries subject describe - describe a + gcloud alpha managed-kafka schema-registries subjects describe - describe a subject in a schema registry with all of its fields SYNOPSIS - gcloud alpha managed-kafka schema-registries subject describe - (SUBJECT : --location=LOCATION --schema-registry=SCHEMA_REGISTRY) - [--context=CONTEXT] [GCLOUD_WIDE_FLAG ...] + gcloud alpha managed-kafka schema-registries subjects describe + (SUBJECT : --location=LOCATION --registry=REGISTRY) [--context=CONTEXT] + [GCLOUD_WIDE_FLAG ...] EXAMPLES Describe the subject in a schema registry with all of its fields: - $ gcloud alpha managed-kafka schema-registries subject describe \ + $ gcloud alpha managed-kafka schema-registries subjects describe \ --project=PROJECT_ID --location=LOCATION_ID \ - --schema_registry=SCHEMA_REGISTRY_ID + --registry=SCHEMA_REGISTRY_ID POSITIONAL ARGUMENTS - Subject resource - The subject to create. The arguments in this group can + Subject resource - The subject resource. 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. @@ -47,13 +47,13 @@ POSITIONAL ARGUMENTS specified name; ▸ provide the argument --location on the command line. - --schema-registry=SCHEMA_REGISTRY + --registry=REGISTRY The schema registry name. To set the schema-registry attribute: ▸ provide the argument subject on the command line with a fully specified name; - ▸ provide the argument --schema-registry on the command line. + ▸ provide the argument --registry on the command line. FLAGS --context=CONTEXT diff --git a/gcloud/alpha/managed-kafka/schema-registries/subject/help b/gcloud/alpha/managed-kafka/schema-registries/subjects/help similarity index 84% rename from gcloud/alpha/managed-kafka/schema-registries/subject/help rename to gcloud/alpha/managed-kafka/schema-registries/subjects/help index ef8f3d54d..ed90ad2ad 100644 --- a/gcloud/alpha/managed-kafka/schema-registries/subject/help +++ b/gcloud/alpha/managed-kafka/schema-registries/subjects/help @@ -1,9 +1,9 @@ NAME - gcloud alpha managed-kafka schema-registries subject - administer Managed + gcloud alpha managed-kafka schema-registries subjects - administer Managed Service for Apache Kafka schema-registries SYNOPSIS - gcloud alpha managed-kafka schema-registries subject COMMAND + gcloud alpha managed-kafka schema-registries subjects COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION diff --git a/gcloud/alpha/managed-kafka/schema-registries/subject/update b/gcloud/alpha/managed-kafka/schema-registries/subjects/update similarity index 78% rename from gcloud/alpha/managed-kafka/schema-registries/subject/update rename to gcloud/alpha/managed-kafka/schema-registries/subjects/update index 9637a89f8..21a21fb18 100644 --- a/gcloud/alpha/managed-kafka/schema-registries/subject/update +++ b/gcloud/alpha/managed-kafka/schema-registries/subjects/update @@ -1,26 +1,29 @@ NAME - gcloud alpha managed-kafka schema-registries subject update - update the + gcloud alpha managed-kafka schema-registries subjects update - update the mode and compatibility of a subject SYNOPSIS - gcloud alpha managed-kafka schema-registries subject update - (SUBJECT : --location=LOCATION --schema-registry=SCHEMA_REGISTRY) + gcloud alpha managed-kafka schema-registries subjects update + (SUBJECT : --location=LOCATION --registry=REGISTRY) (--compatibility=COMPATIBILITY | --delete-config | --delete-mode | --mode=MODE) [--context=CONTEXT] [GCLOUD_WIDE_FLAG ...] EXAMPLES Modify the mode of the subject to READONLY: - $ gcloud alpha managed-kafka schema-registries subject update \ - --mode=READONLY + $ gcloud alpha managed-kafka schema-registries subjects update \ + --registry=SCHEMA_REGISTRY --context=CONTEXT \ + --project=PROJECT_ID --location=LOCATION_ID --mode=READONLY Modify the compatibility of the subject to BACKWARDS: - $ gcloud alpha managed-kafka schema-registries subject update \ + $ gcloud alpha managed-kafka schema-registries subjects update \ + --registry=SCHEMA_REGISTRY --context=CONTEXT \ + --project=PROJECT_ID --location=LOCATION_ID \ --compatibility=BACKWARDS POSITIONAL ARGUMENTS - Subject resource - The subject to create. The arguments in this group can + Subject resource - The subject resource. 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. @@ -52,13 +55,13 @@ POSITIONAL ARGUMENTS specified name; ▸ provide the argument --location on the command line. - --schema-registry=SCHEMA_REGISTRY + --registry=REGISTRY The schema registry name. To set the schema-registry attribute: ▸ provide the argument subject on the command line with a fully specified name; - ▸ provide the argument --schema-registry on the command line. + ▸ provide the argument --registry on the command line. REQUIRED FLAGS Exactly one of these must be specified: diff --git a/gcloud/alpha/managed-kafka/schema-registries/update b/gcloud/alpha/managed-kafka/schema-registries/update index ef651bef1..7e1302b50 100644 --- a/gcloud/alpha/managed-kafka/schema-registries/update +++ b/gcloud/alpha/managed-kafka/schema-registries/update @@ -18,7 +18,7 @@ EXAMPLES --compatibility=BACKWARDS POSITIONAL ARGUMENTS - Schema registry resource - The schema registry to create. The arguments in + Schema registry resource - The schema registry resource. 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. diff --git a/gcloud/alpha/source-manager/help b/gcloud/alpha/source-manager/help index 8a4f471aa..18fa2b966 100644 --- a/gcloud/alpha/source-manager/help +++ b/gcloud/alpha/source-manager/help @@ -31,7 +31,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud source-manager $ gcloud beta source-manager diff --git a/gcloud/alpha/source-manager/instances/add-iam-policy-binding b/gcloud/alpha/source-manager/instances/add-iam-policy-binding index 4a6ddc735..1ae18f8ee 100644 --- a/gcloud/alpha/source-manager/instances/add-iam-policy-binding +++ b/gcloud/alpha/source-manager/instances/add-iam-policy-binding @@ -91,7 +91,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud source-manager instances add-iam-policy-binding $ gcloud beta source-manager instances add-iam-policy-binding diff --git a/gcloud/alpha/source-manager/instances/create b/gcloud/alpha/source-manager/instances/create index 3b7185939..c2179a048 100644 --- a/gcloud/alpha/source-manager/instances/create +++ b/gcloud/alpha/source-manager/instances/create @@ -97,7 +97,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud source-manager instances create $ gcloud beta source-manager instances create diff --git a/gcloud/alpha/source-manager/instances/delete b/gcloud/alpha/source-manager/instances/delete index f10fffe2c..a1c717b65 100644 --- a/gcloud/alpha/source-manager/instances/delete +++ b/gcloud/alpha/source-manager/instances/delete @@ -78,7 +78,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud source-manager instances delete $ gcloud beta source-manager instances delete diff --git a/gcloud/alpha/source-manager/instances/describe b/gcloud/alpha/source-manager/instances/describe index 89fc191ce..b3d3a1cb4 100644 --- a/gcloud/alpha/source-manager/instances/describe +++ b/gcloud/alpha/source-manager/instances/describe @@ -64,7 +64,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud source-manager instances describe $ gcloud beta source-manager instances describe diff --git a/gcloud/alpha/source-manager/instances/get-iam-policy b/gcloud/alpha/source-manager/instances/get-iam-policy index 6c849943c..44ae61dd3 100644 --- a/gcloud/alpha/source-manager/instances/get-iam-policy +++ b/gcloud/alpha/source-manager/instances/get-iam-policy @@ -91,7 +91,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud source-manager instances get-iam-policy $ gcloud beta source-manager instances get-iam-policy diff --git a/gcloud/alpha/source-manager/instances/help b/gcloud/alpha/source-manager/instances/help index 2a207d7dc..c84205412 100644 --- a/gcloud/alpha/source-manager/instances/help +++ b/gcloud/alpha/source-manager/instances/help @@ -45,7 +45,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud source-manager instances $ gcloud beta source-manager instances diff --git a/gcloud/alpha/source-manager/instances/list b/gcloud/alpha/source-manager/instances/list index 7d439b166..b56e4373f 100644 --- a/gcloud/alpha/source-manager/instances/list +++ b/gcloud/alpha/source-manager/instances/list @@ -84,7 +84,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud source-manager instances list $ gcloud beta source-manager instances list diff --git a/gcloud/alpha/source-manager/instances/remove-iam-policy-binding b/gcloud/alpha/source-manager/instances/remove-iam-policy-binding index a359a5aaa..01e6fc053 100644 --- a/gcloud/alpha/source-manager/instances/remove-iam-policy-binding +++ b/gcloud/alpha/source-manager/instances/remove-iam-policy-binding @@ -92,7 +92,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud source-manager instances remove-iam-policy-binding $ gcloud beta source-manager instances remove-iam-policy-binding diff --git a/gcloud/alpha/source-manager/instances/set-iam-policy b/gcloud/alpha/source-manager/instances/set-iam-policy index f66e77445..459c510d8 100644 --- a/gcloud/alpha/source-manager/instances/set-iam-policy +++ b/gcloud/alpha/source-manager/instances/set-iam-policy @@ -71,7 +71,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud source-manager instances set-iam-policy $ gcloud beta source-manager instances set-iam-policy diff --git a/gcloud/alpha/source-manager/locations/help b/gcloud/alpha/source-manager/locations/help index 4e75c3c47..74fa9dce8 100644 --- a/gcloud/alpha/source-manager/locations/help +++ b/gcloud/alpha/source-manager/locations/help @@ -23,7 +23,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud source-manager locations $ gcloud beta source-manager locations diff --git a/gcloud/alpha/source-manager/locations/list b/gcloud/alpha/source-manager/locations/list index 60343eb11..2dcf50d70 100644 --- a/gcloud/alpha/source-manager/locations/list +++ b/gcloud/alpha/source-manager/locations/list @@ -65,7 +65,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud source-manager locations list $ gcloud beta source-manager locations list diff --git a/gcloud/alpha/source-manager/operations/describe b/gcloud/alpha/source-manager/operations/describe index 5016666ee..234073c25 100644 --- a/gcloud/alpha/source-manager/operations/describe +++ b/gcloud/alpha/source-manager/operations/describe @@ -64,7 +64,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud source-manager operations describe $ gcloud beta source-manager operations describe diff --git a/gcloud/alpha/source-manager/operations/help b/gcloud/alpha/source-manager/operations/help index 114639d6d..0bbf34b86 100644 --- a/gcloud/alpha/source-manager/operations/help +++ b/gcloud/alpha/source-manager/operations/help @@ -26,7 +26,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud source-manager operations $ gcloud beta source-manager operations diff --git a/gcloud/alpha/source-manager/operations/list b/gcloud/alpha/source-manager/operations/list index d6809c7ec..1a3ac05c6 100644 --- a/gcloud/alpha/source-manager/operations/list +++ b/gcloud/alpha/source-manager/operations/list @@ -84,7 +84,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud source-manager operations list $ gcloud beta source-manager operations list diff --git a/gcloud/alpha/source-manager/repos/add-iam-policy-binding b/gcloud/alpha/source-manager/repos/add-iam-policy-binding index 95d06a3f2..5846e1b2d 100644 --- a/gcloud/alpha/source-manager/repos/add-iam-policy-binding +++ b/gcloud/alpha/source-manager/repos/add-iam-policy-binding @@ -93,7 +93,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud source-manager repos add-iam-policy-binding $ gcloud beta source-manager repos add-iam-policy-binding diff --git a/gcloud/alpha/source-manager/repos/create b/gcloud/alpha/source-manager/repos/create index b87d43a31..411f90722 100644 --- a/gcloud/alpha/source-manager/repos/create +++ b/gcloud/alpha/source-manager/repos/create @@ -89,7 +89,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud source-manager repos create $ gcloud beta source-manager repos create diff --git a/gcloud/alpha/source-manager/repos/delete b/gcloud/alpha/source-manager/repos/delete index 1109cf136..0b7f08106 100644 --- a/gcloud/alpha/source-manager/repos/delete +++ b/gcloud/alpha/source-manager/repos/delete @@ -65,7 +65,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud source-manager repos delete $ gcloud beta source-manager repos delete diff --git a/gcloud/alpha/source-manager/repos/describe b/gcloud/alpha/source-manager/repos/describe index 4bebf3c36..b9847369e 100644 --- a/gcloud/alpha/source-manager/repos/describe +++ b/gcloud/alpha/source-manager/repos/describe @@ -65,7 +65,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud source-manager repos describe $ gcloud beta source-manager repos describe diff --git a/gcloud/alpha/source-manager/repos/get-iam-policy b/gcloud/alpha/source-manager/repos/get-iam-policy index 63f5ddc34..3ebd96254 100644 --- a/gcloud/alpha/source-manager/repos/get-iam-policy +++ b/gcloud/alpha/source-manager/repos/get-iam-policy @@ -92,7 +92,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud source-manager repos get-iam-policy $ gcloud beta source-manager repos get-iam-policy diff --git a/gcloud/alpha/source-manager/repos/help b/gcloud/alpha/source-manager/repos/help index f171d85e7..37411fc29 100644 --- a/gcloud/alpha/source-manager/repos/help +++ b/gcloud/alpha/source-manager/repos/help @@ -49,7 +49,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud source-manager repos $ gcloud beta source-manager repos diff --git a/gcloud/alpha/source-manager/repos/list b/gcloud/alpha/source-manager/repos/list index 65bc82952..285c38e3c 100644 --- a/gcloud/alpha/source-manager/repos/list +++ b/gcloud/alpha/source-manager/repos/list @@ -63,7 +63,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud source-manager repos list $ gcloud beta source-manager repos list diff --git a/gcloud/alpha/source-manager/repos/remove-iam-policy-binding b/gcloud/alpha/source-manager/repos/remove-iam-policy-binding index 4272fcd80..c2d21c5d2 100644 --- a/gcloud/alpha/source-manager/repos/remove-iam-policy-binding +++ b/gcloud/alpha/source-manager/repos/remove-iam-policy-binding @@ -94,7 +94,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud source-manager repos remove-iam-policy-binding $ gcloud beta source-manager repos remove-iam-policy-binding diff --git a/gcloud/alpha/source-manager/repos/set-iam-policy b/gcloud/alpha/source-manager/repos/set-iam-policy index 4f8bad852..de48d0340 100644 --- a/gcloud/alpha/source-manager/repos/set-iam-policy +++ b/gcloud/alpha/source-manager/repos/set-iam-policy @@ -72,7 +72,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud source-manager repos set-iam-policy $ gcloud beta source-manager repos set-iam-policy diff --git a/gcloud/alpha/source-manager/repos/update b/gcloud/alpha/source-manager/repos/update index 714a06fff..0372321c4 100644 --- a/gcloud/alpha/source-manager/repos/update +++ b/gcloud/alpha/source-manager/repos/update @@ -68,5 +68,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. These variants are also available: + + $ gcloud source-manager repos update + + $ gcloud beta source-manager repos update diff --git a/gcloud/alpha/storage/restore b/gcloud/alpha/storage/restore index ed4584794..15ab29ab3 100644 --- a/gcloud/alpha/storage/restore +++ b/gcloud/alpha/storage/restore @@ -4,7 +4,9 @@ NAME SYNOPSIS gcloud alpha storage restore [URLS ...] [--all-versions, -a] [--async] [--[no-]preserve-acl, -p] [--read-paths-from-stdin, -I] - [--allow-overwrite --deleted-after-time=DELETED_AFTER_TIME + [--allow-overwrite --created-after-time=CREATED_AFTER_TIME + --created-before-time=CREATED_BEFORE_TIME + --deleted-after-time=DELETED_AFTER_TIME --deleted-before-time=DELETED_BEFORE_TIME] [--if-generation-match=GENERATION --if-metageneration-match=METAGENERATION] [GCLOUD_WIDE_FLAG ...] @@ -19,49 +21,74 @@ EXAMPLES $ gcloud alpha storage restore gs://bucket#123 - Restore several soft-deleted buckets with generations: + Restore several soft-deleted buckets with generations: $ gcloud alpha storage restore gs://bucket1#123 gs://bucket2#456 - Restore latest soft-deleted version of object in a bucket. + Restore latest soft-deleted version of object in a bucket. $ gcloud alpha storage restore gs://bucket/file1.txt - Restore a specific soft-deleted version of object in a bucket by specifying - the generation. + Restore a specific soft-deleted version of object in a bucket by specifying the generation. $ gcloud alpha storage restore gs://bucket/file1.txt#123 - Restore all soft-deleted versions of object in a bucket. + Restore all soft-deleted versions of object in a bucket. $ gcloud alpha storage restore gs://bucket/file1.txt --all-versions - Restore several objects in a bucket (with or without generation): + Restore several objects in a bucket (with or without generation): $ gcloud alpha storage restore gs://bucket/file1.txt \ - gs://bucket/file2.txt#456 + gs://bucket/file2.txt#456 - Restore the latest soft-deleted version of all text objects in a bucket: + Restore the latest soft-deleted version of all text objects in a bucket: $ gcloud alpha storage restore gs://bucket/**.txt - Restore a list of objects read from stdin (with or without generation): + Restore a list of objects read from stdin (with or without generation): $ cat list-of-files.txt | gcloud alpha storage restore \ - --read-paths-from-stdin + --read-paths-from-stdin - Restore object with its original ACL policy: + Restore object with its original ACL policy: $ gcloud alpha storage restore gs://bucket/file1.txt --preserve-acl - Restore all objects in a bucket asynchronously: + Restore all objects in a bucket asynchronously: $ gcloud alpha storage restore gs://bucket/** --async - Restore all text files in a bucket asynchronously: + Restore all text files in a bucket asynchronously: $ gcloud alpha storage restore gs://bucket/**.txt --async + Restore objects created within a specific time range: + + $ gcloud alpha storage restore gs://bucket/** --async \ + --created-after-time="2023-01-01T00:00:00Z" \ + --created-before-time="2023-01-31T23:59:59Z" + + Restore objects soft-deleted within a specific time range: + + $ gcloud alpha storage restore gs://bucket/** --async \ + --deleted-after-time="2023-01-01T00:00:00Z" \ + --deleted-before-time="2023-01-31T23:59:59Z" + + Restore objects using a combination of creation and deletion time filters: + + $ gcloud alpha storage restore gs://bucket/** --async \ + --allow-overwrite --created-after-time="2023-01-01T00:00:00Z" \ + --deleted-after-time="2023-01-01T00:00:00Z" + + This command filters the objects that were live at 2023-01-01T00:00:00Z + and then soft-deleted afterwards. + + This combination of filters is especially helpful if there is a period of + erroneous overwrites. They allow you to go back to the point just before + the overwrites began. You will also need to set the --allow-overwrite + option to true. + POSITIONAL ARGUMENTS [URLS ...] The url of objects to list. @@ -104,6 +131,12 @@ FLAGS enabled, this will result in a noncurrent object. If versioning is not enabled, this will result in a soft-deleted object. + --created-after-time=CREATED_AFTER_TIME + Restores only the objects that were created after this time. + + --created-before-time=CREATED_BEFORE_TIME + Restores only the objects that were created before this time. + --deleted-after-time=DELETED_AFTER_TIME Restores only the objects that were soft-deleted after this time. diff --git a/gcloud/backup-dr/backup-plan-associations/help b/gcloud/backup-dr/backup-plan-associations/help index 3ae60e763..6c30b6478 100644 --- a/gcloud/backup-dr/backup-plan-associations/help +++ b/gcloud/backup-dr/backup-plan-associations/help @@ -31,6 +31,9 @@ COMMANDS trigger-backup Create an on-demand backup for a resource. + update + Update a specific backup plan within a backup plan association. + NOTES This variant is also available: diff --git a/gcloud/backup-dr/backup-plan-associations/update b/gcloud/backup-dr/backup-plan-associations/update new file mode 100644 index 000000000..725d46310 --- /dev/null +++ b/gcloud/backup-dr/backup-plan-associations/update @@ -0,0 +1,127 @@ +NAME + gcloud backup-dr backup-plan-associations update - update a specific backup + plan within a backup plan association + +SYNOPSIS + gcloud backup-dr backup-plan-associations update + (BACKUP_PLAN_ASSOCIATION + : --location=LOCATION --workload-project=WORKLOAD_PROJECT) + --backup-plan=BACKUP_PLAN [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Update a specific backup plan within a backup plan association. + +EXAMPLES + To update backup plan association sample-bpa in project sample-project and + location us-central1 with backup plan sample-backup-plan in the same + project and location, run: + + $ gcloud backup-dr backup-plan-associations update sample-bpa \ + --project=sample-project --location=us-central1 \ + --backup-plan=sample-backup-plan + + To update backup plan association sample-bpa-uri with backup plan + sample-backup-plan-uri (using full URIs), run: + + $ gcloud backup-dr backup-plan-associations update sample-bpa-uri \ + --backup-plan=sample-backup-plan-uri + + To update backup plan association sample-bpa in location us-central1 with + backup plan sample-backup-plan-uri, run: + + $ gcloud backup-dr backup-plan-associations update sample-bpa \ + --location=us-central1 --backup-plan=sample-backup-plan-uri + + To update backup plan association sample-bpa in project workload-project + and location us-central1 with backup plan sample-backup-plan in project + sample-project, run: + + $ gcloud backup-dr backup-plan-associations update sample-bpa \ + --workload-project=workload-project --location=us-central1 \ + --backup-plan=sample-backup-plan --project=sample-project + +POSITIONAL ARGUMENTS + Backup Plan Association resource - Backup plan association to be updated. + To update backup plan associations in a project that's different from the + backup plan, use the --workload-project flag. The arguments in this group + can be used to specify the attributes of this resource. + + This must be specified. + + BACKUP_PLAN_ASSOCIATION + ID of the Backup Plan Association or fully qualified identifier for + the Backup Plan Association. + + To set the name attribute: + ▸ provide the argument BACKUP_PLAN_ASSOCIATION on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the Backup Plan Association. + + To set the location attribute: + ▸ provide the argument BACKUP_PLAN_ASSOCIATION on the command line + with a fully specified name; + ▸ provide the argument --location on the command line. + + --workload-project=WORKLOAD_PROJECT + Cloud project id for the Backup Plan Association. + + To set the workload-project attribute: + ▸ provide the argument BACKUP_PLAN_ASSOCIATION on the command line + with a fully specified name; + ▸ provide the argument --workload-project on the command line; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + +REQUIRED FLAGS + Backup Plan resource - Name of the specific backup plan to be applied to + the backup plan association. E.g., + projects/sample-project/locations/us-central1/backupPlans/sample-backup-plan + This represents a Cloud 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 --backup-plan on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument --backup-plan on the command line with a fully + specified name; + ◆ provide the argument --location on the command line. + + This must be specified. + + --backup-plan=BACKUP_PLAN + ID of the Backup Plan or fully qualified identifier for the Backup + Plan. + + To set the name attribute: + ▸ provide the argument --backup-plan on the command line. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. The default is True. Enabled by default, use --no-async to + disable. + +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. + +BRIEF + Update a specific backup plan within a backup plan association. + +NOTES + This variant is also available: + + $ gcloud alpha backup-dr backup-plan-associations update + diff --git a/gcloud/backup-dr/backup-plans/help b/gcloud/backup-dr/backup-plans/help index 281acf3db..8e94ceaad 100644 --- a/gcloud/backup-dr/backup-plans/help +++ b/gcloud/backup-dr/backup-plans/help @@ -27,6 +27,9 @@ COMMANDS list List backup plans in the project. + update + Update a specific backup plan. + NOTES This variant is also available: diff --git a/gcloud/backup-dr/backup-plans/update b/gcloud/backup-dr/backup-plans/update new file mode 100644 index 000000000..417e2ae5a --- /dev/null +++ b/gcloud/backup-dr/backup-plans/update @@ -0,0 +1,287 @@ +NAME + gcloud backup-dr backup-plans update - update a specific backup plan + +SYNOPSIS + gcloud backup-dr backup-plans update (BACKUP_PLAN : --location=LOCATION) + [--add-backup-rule=[PROPERTY=VALUE,...]] [--async] + [--backup-rule=[PROPERTY=VALUE,...]] + [--backup-rules-from-file=PATH_TO_FILE] [--description=DESCRIPTION] + [--remove-backup-rule=RULE-ID] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Update a specific backup plan in the project. It can only be updated in + regions supported by the Backup and DR Service. + +EXAMPLES + To update 2 backup rules and description of an existing backup plan + sample-backup-plan in project sample-project, at location us-central1: + + run: + + $ gcloud backup-dr backup-plans update sample-backup-plan \ + --project=sample-project --location=us-central1 \ + --backup-rule --backup-rule \ + --description "This is a sample backup plan" + + To add backup rules to an existing backup plan sample-backup-plan in + project sample-project, at location us-central1: + + run: + + $ gcloud backup-dr backup-plans update sample-backup-plan \ + --project=sample-project --location=us-central1 \ + --add-backup-rule --add-backup-rule + + To remove a backup rule with id sample-daily-rule from an existing backup + plan sample-backup-plan in project sample-project, at location us-central1: + + run: + + $ gcloud backup-dr backup-plans update sample-backup-plan \ + --project=sample-project --location=us-central1 \ + --remove-backup-rule sample-daily-rule + + To override backup rules in an existing backup plan sample-backup-plan in + project sample-project, at location us-central1, pass a file path + containing backup rules in YAML or JSON format: This flag is mutually + exclusive with --add-backup-rule, --remove-backup-rule and --backup-rule + flags. + + run: $ gcloud backup-dr backup-plans update sample-backup-plan \ + --project=sample-project --location=us-central1 \ + --backup-rules-fom-file + + Backup Rule Examples: + + 1. Hourly backup rule with hourly backup frequency of 6 hours and store it + for 30 days, and expect the backups to run only between 10:00 to 20:00 UTC + + : + rule-id=sample-hourly-rule,retention-days=30,recurrence=HOURLY,hourly-frequency=6,time-zone=UTC,backup-window-start=10,backup-window-end=20 + + Properties: + ▪ rule-id = "sample-hourly-rule" + ▪ retention-days = 30 + ▪ recurrence = HOURLY + ▪ hourly-frequency = 6 + ▪ time-zone = UTC + ▪ backup-window-start = 10 + ▪ backup-window-end = 20 + + 2. Daily backup rule with daily backup frequency of 6 hours and store it + for 7 days + + : + rule-id=sample-daily-rule,retention-days=7,recurrence=DAILY,backup-window-start=1,backup-window-end=14 + + Properties: + ▪ rule-id = "sample-daily-rule" + ▪ retention-days = 7 + ▪ recurrence = DAILY + ▪ backup-window-start = 1 + ▪ backup-window-end = 14 + + 3. Weekly backup rule with weekly backup frequency on every MONDAY & FRIDAY + and store it for 21 days + + : + rule-id=sample-weekly-rule,retention-days=21,recurrence=WEEKLY,days-of-week="MONDAY + FRIDAY",backup-window-start=10,backup-window-end=20 + + Properties: + ▪ rule-id = "sample-weekly-rule" + ▪ retention-days: 21 + ▪ recurrence = WEEKLY + ▪ days-of-week = "MONDAY FRIDAY" + ▪ backup-window-start = 10 + ▪ backup-window-end = 20 + + YAML and JSON file examples: + + YAML file example: + + backup-rules: + - rule-id: weekly-rule + retention-days: 7 + recurrence: WEEKLY + backup-window-start: 0 + backup-window-end: 23 + days-of-week: [MONDAY, TUESDAY] + time-zone: UTC + - rule-id: daily-rule + retention-days: 1 + recurrence: DAILY + backup-window-start: 1 + backup-window-end: 24 + time-zone: UTC + + JSON file example: { + "backup-rules": [ + { + "rule-id": "weekly-rule", + "retention-days": 7, + "recurrence": "WEEKLY", + "backup-window-start": 0, + "backup-window-end": 23, + "days-of-week": ["MONDAY", "TUESDAY"], + "time-zone": "UTC" + }, + { + "rule-id": "daily-rule", + "retention-days": 1, + "recurrence": "DAILY", + "backup-window-start": 1, + "backup-window-end": 24, + "time-zone": "UTC" + } + ] + } + +POSITIONAL ARGUMENTS + Backup Plan resource - Name of the backup plan to be updated. The name + must be unique for a project and 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 backup_plan on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + BACKUP_PLAN + ID of the Backup Plan or fully qualified identifier for the Backup + Plan. + + To set the name attribute: + ▸ provide the argument backup_plan on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the Backup Plan. + + To set the location attribute: + ▸ provide the argument backup_plan on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --add-backup-rule=[PROPERTY=VALUE,...] + Parameters of backup rule to be added to the Backup Plan. This flag can + be repeated to add more backup rules. + + --async + Return immediately, without waiting for the operation in progress to + complete. The default is True. Enabled by default, use --no-async to + disable. + + --backup-rule=[PROPERTY=VALUE,...] + Full definition of an existing backup rule with updated values. The + existing backup rule is replaced by this new set of values. This flag + can be repeated to update multiple backup rules. It is not allowed to + pass the same rule-id in this flag more than once in the same command. + + Parameters for the backup rule include: + + rule-id + Name of the backup rule. The name must be unique and start with a + lowercase letter followed by up to 62 lowercase letters, numbers, + or hyphens. + + retention-days + Duration for which backup data should be retained. It must be + defined in "days". The value should be greater than or equal to the + enforced retention period set for the backup vault. + + recurrence + Frequency for the backup schedule. It must be either: HOURLY, + DAILY, WEEKLY, MONTHLY or YEARLY. + + backup-window-start + Start time of the interval during which backup jobs should be + executed. It can be defined as backup-window-start=2, that means + backup window starts at 2 a.m. The start time and end time must + have an interval of 6 hours. + + backup-window-end + End time of the interval during which backup jobs should be + executed. It can be defined as backup-window-end=14, that means + backup window ends at 2 p.m. The start time and end time must have + an interval of 6 hours. + + Jobs are queued at the beginning of the window and will be marked + as SKIPPED if they do not start by the end time. Jobs that are in + progress will not be canceled at the end time. + + time-zone + The time zone to be used for the backup schedule. The value must + exist in the IANA tz database (https://www.iana.org/time-zones). + The default value is UTC. E.g., Europe/Paris + + Following flags are mutually exclusive: + + hourly-frequency + Frequency for hourly backups. An hourly frequency of 2 means backup + jobs will run every 2 hours from start time till the end time + defined. The hourly frequency must be between 4 and 23. The value + is needed only if recurrence type is HOURLY. + + days-of-week + Days of the week when the backup job should be executed. The value + is needed if recurrence type is WEEKLY. E.g., MONDAY,TUESDAY + + days-of-month + Days of the month when the backup job should be executed. The value + is needed only if recurrence type is YEARLY. E.g.,"1,5,14" + + months + Month for the backup schedule. The value is needed only if + recurrence type is YEARLY. E.g., JANUARY, MARCH + + week-day-of-month + Recurring day of the week in the month or year when the backup job + should be executed. E.g. FIRST-SUNDAY, THIRD-MONDAY. The value can + only be provided if the recurrence type is MONTHLY or YEARLY. + Allowed values for the number of week - FIRST, SECOND, THIRD, + FOURTH, LAST. Allowed values for days of the week - MONDAY to + SUNDAY. + + E.g., + "rule-id=sample-daily-rule,recurrence=WEEKLY,backup-window-start=2,backup-window-end=14,retention-days=20,days-of-week='SUNDAY + MONDAY'" + + --backup-rules-from-file=PATH_TO_FILE + Path to a YAML or JSON file containing backup rules. Use a full or + relative path to a local file containing the value of backup_rules. + + --description=DESCRIPTION + Provide a description of the backup plan, such as specific use cases + and relevant details, in 2048 characters or less. + + E.g., This is a backup plan that performs a daily backup at 6 p.m. and + retains data for 3 months. + + --remove-backup-rule=RULE-ID + Name of an existing backup rule to be removed from the Backup Plan. + This flag can be repeated to remove more backup rules. + +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. + +BRIEF + Update a specific backup plan + +NOTES + This variant is also available: + + $ gcloud alpha backup-dr backup-plans update + diff --git a/gcloud/backup-dr/backups/restore/disk b/gcloud/backup-dr/backups/restore/disk new file mode 100644 index 000000000..4194a015d --- /dev/null +++ b/gcloud/backup-dr/backups/restore/disk @@ -0,0 +1,215 @@ +NAME + gcloud backup-dr backups restore disk - restores a Compute Disk Backup + +SYNOPSIS + gcloud backup-dr backups restore disk + (BACKUP : --backup-vault=BACKUP_VAULT + --data-source=DATA_SOURCE --location=LOCATION) --name=NAME + --target-project=TARGET_PROJECT [--access-mode=ACCESS_MODE] + [--architecture=ARCHITECTURE] [--async] [--confidential-compute] + [--description=DESCRIPTION] + [--guest-os-features=[GUEST_OS_FEATURES,...]] [--kms-key=KMS_KEY] + [--labels=[KEY=VALUE,...]] [--licenses=LICENSE,[LICENSE,...]] + [--provisioned-iops=PROVISIONED_IOPS] + [--provisioned-throughput=PROVISIONED_THROUGHPUT] + [--replica-zones=ZONE,ZONE] [--resource-policies=RESOURCE_POLICY,[...]] + [--size=SIZE] [--storage-pool=STORAGE_POOL] + [--target-region=TARGET_REGION] [--target-zone=TARGET_ZONE] + [--type=TYPE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Restores a Compute Disk Backup. + +EXAMPLES + To restore a backup sample-backup in project sample-project and location + us-central1, with sample-data-store and sample-backup-vault, and additional + target properties, run: + + $ gcloud backup-dr backups restore disk sample-backup \ + --project=sample-project --location=us-central1 \ + --backup-vault=sample-backup-vault \ + --data-source=sample-data-source -- + +POSITIONAL ARGUMENTS + Backup resource - The backup of a resource to be restored. 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 backup on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + BACKUP + ID of the Backup or fully qualified identifier for the Backup. + + To set the name attribute: + ▸ provide the argument backup on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --backup-vault=BACKUP_VAULT + The ID of the Backup Vault. + + To set the backup-vault attribute: + ▸ provide the argument backup on the command line with a fully + specified name; + ▸ provide the argument --backup-vault on the command line. + + --data-source=DATA_SOURCE + The ID of the Data Source. + + To set the data-source attribute: + ▸ provide the argument backup on the command line with a fully + specified name; + ▸ provide the argument --data-source on the command line. + + --location=LOCATION + The location of the Backup. + + To set the location attribute: + ▸ provide the argument backup on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + --name=NAME + Name of the restored Disk. + + --target-project=TARGET_PROJECT + Project where the restore should happen. + +OPTIONAL FLAGS + --access-mode=ACCESS_MODE + Specifies how VMs attached to the disk can access the data on the disk. + To grant read-only access to multiple VMs attached to the disk, set + access-mode to READ_ONLY_MANY. To grant read-write access to only one + VM attached to the disk, use READ_WRITE_SINGLE. READ_WRITE_SINGLE is + used if omitted. ACCESS_MODE must be one of: READ_ONLY_MANY, + READ_WRITE_MANY, READ_WRITE_SINGLE. ACCESS_MODE must be one of: + + READ_ONLY_MANY + The AccessMode means the disk can be attached to multiple instances + in RW mode. + READ_WRITE_MANY + The AccessMode means the disk can be attached to multiple instances + in RO mode. + READ_WRITE_SINGLE + The default AccessMode, means the disk can be attached to single + instance in RW mode. + + --architecture=ARCHITECTURE + Specifies the architecture or processor type that this disk can + support. For available processor types on Compute Engine, see + https://cloud.google.com/compute/docs/cpu-platforms. ARCHITECTURE must + be one of: ARM64, X86_64. ARCHITECTURE must be one of: + + ARM64 + The disk can only be used with ARM64 machines. + X86_64 + The disk can only be used with x86_64 machines. + + --async + Return immediately, without waiting for the operation in progress to + complete. The default is True. Enabled by default, use --no-async to + disable. + + --confidential-compute + Creates the disk with confidential compute mode enabled. Encryption + with a Cloud KMS key is required to enable this option. + + --description=DESCRIPTION + Specifies a textual description of the restored disk. + + --guest-os-features=[GUEST_OS_FEATURES,...] + Enables one or more features for VM instances that use the image for + their boot disks. See the descriptions of supported features at: + https://cloud.google.com/compute/docs/images/create-delete-deprecate-private-images#guest-os-features. + GUEST_OS_FEATURE must be one of: VIRTIO_SCSI_MULTIQUEUE, WINDOWS, + MULTI_IP_SUBNET, UEFI_COMPATIBLE, SEV_CAPABLE, SEV_LIVE_MIGRATABLE, + SEV_LIVE_MIGRATABLE_V2, SEV_SNP_CAPABLE, GVNIC, IDPF, TDX_CAPABLE, + SUSPEND_RESUME_COMPATIBLE. + + --kms-key=KMS_KEY + The Cloud KMS (Key Management Service) cryptokey that will be used to + protect the disk Provide the full resource name of the cryptokey in the + format: + projects//locations//keyRings//cryptoKeys/ + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (), lowercase characters, and + numbers. + + --licenses=LICENSE,[LICENSE,...] + A list of URIs to license resources. The provided licenses will be + added onto the created disks to indicate the licensing and billing + policies. + + --provisioned-iops=PROVISIONED_IOPS + Provisioned IOPS of disk to create. Only for use with disks of type + pd-extreme and hyperdisk-extreme. + + --provisioned-throughput=PROVISIONED_THROUGHPUT + Provisioned throughput of disk to create. The throughput unit is MB per + sec. Only for use with disks of type hyperdisk-throughput. + + --replica-zones=ZONE,ZONE + A comma-separated list of exactly 2 URLs of the zones where the disk + should be replicated to. Required when restoring to a regional disk. + The zones must be in the same region as specified in the + --target-region flag. See available zones with gcloud compute zones + list. + + --resource-policies=RESOURCE_POLICY,[...] + A list of resource policy names to be added to the disk. The policies + must exist in the same region as the disk. + + --size=SIZE + Size of the disk in GB. Disk size must be a multiple of 1 GB. If disk + size is not specified, the default size of 500GB for pd-standard disks, + 100GB for pd-balanced disks, 100GB for pd-ssd disks, and 1000GB for + pd-extreme disks will be used. For details about disk size limits, + refer to: https://cloud.google.com/compute/docs/disks + + --storage-pool=STORAGE_POOL + Specifies the URI of the storage pool in which the disk is created. + + --target-region=TARGET_REGION + Region where the target disk is restored. This flag is mutually + exclusive with --target-zone. + + --target-zone=TARGET_ZONE + Zone where the target disk is restored. This flag is mutually exclusive + with --target-region. + + --type=TYPE + URL of the disk type describing which disk type to use to restore the + disk. For example: projects/project/zones/zone/diskTypes/pd-ssd. To get + a list of available disk types, run gcloud compute disk-types list. The + default disk type is pd-standard. + +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. + +BRIEF + Restores the specified backup + +NOTES + This variant is also available: + + $ gcloud alpha backup-dr backups restore disk + diff --git a/gcloud/backup-dr/backups/restore/help b/gcloud/backup-dr/backups/restore/help index 51d091469..0cbb44908 100644 --- a/gcloud/backup-dr/backups/restore/help +++ b/gcloud/backup-dr/backups/restore/help @@ -18,6 +18,9 @@ COMMANDS compute Restores a Compute Engine VM Backup. + disk + Restores a Compute Disk Backup. + NOTES This variant is also available: diff --git a/gcloud/beta/composer/environments/run b/gcloud/beta/composer/environments/run index eb6a4c9b0..1aa313f74 100644 --- a/gcloud/beta/composer/environments/run +++ b/gcloud/beta/composer/environments/run @@ -81,17 +81,17 @@ POSITIONAL ARGUMENTS SUBCOMMAND The Airflow CLI subcommand to run. Available subcommands include (listed with Airflow versions that support): backfill [**, 2.0.0), - clear [**, 2.0.0), connections [**, 3.0.0), dag_state [**, 2.0.0), dags - [1.10.14, 3.0.0), db [2.3.0, 3.0.0), delete_dag [1.10.1, 2.0.0), - kerberos [**, 3.0.0), kubernetes [2.1.4, 3.0.0), list-import-errors + clear [**, 2.0.0), connections [**, 3.1.0), dag_state [**, 2.0.0), dags + [1.10.14, 3.1.0), db [2.3.0, 3.0.0), delete_dag [1.10.1, 2.0.0), + kerberos [**, 3.1.0), kubernetes [2.1.4, 3.1.0), list-import-errors [**, 3.0.0), list_dag_runs [1.10.2, 2.0.0), list_dags [**, 2.0.0), list_tasks [**, 2.0.0), next_execution [1.10.2, 2.0.0), pause [**, - 2.0.0), pool [**, 2.0.0), pools [1.10.14, 3.0.0), render [**, 2.0.0), - roles [2.0.0, 3.0.0), run [**, 2.0.0), sync-perm [1.10.14, 3.0.0), + 2.0.0), pool [**, 2.0.0), pools [1.10.14, 3.1.0), render [**, 2.0.0), + roles [2.0.0, 3.1.0), run [**, 2.0.0), sync-perm [1.10.14, 3.1.0), sync_perm [1.10.2, 2.0.0), task_failed_deps [**, 2.0.0), task_state - [**, 2.0.0), tasks [1.10.14, 3.0.0), test [**, 2.0.0), trigger_dag [**, + [**, 2.0.0), tasks [1.10.14, 3.1.0), test [**, 2.0.0), trigger_dag [**, 2.0.0), unpause [**, 2.0.0), upgrade_check [1.10.15, 2.0.0), users - [1.10.14, 3.0.0), variables [**, 3.0.0), version [**, 3.0.0) (see + [1.10.14, 3.1.0), variables [**, 3.1.0), version [**, 3.1.0) (see https://airflow.apache.org/docs/apache-airflow/stable/cli-and-env-variables-ref.html for more info). diff --git a/gcloud/beta/compute/backend-buckets/create b/gcloud/beta/compute/backend-buckets/create index 50100fd97..fa9cea915 100644 --- a/gcloud/beta/compute/backend-buckets/create +++ b/gcloud/beta/compute/backend-buckets/create @@ -14,7 +14,8 @@ SYNOPSIS [--[no-]enable-cdn] [--load-balancing-scheme=LOAD_BALANCING_SCHEME] [--max-ttl=MAX_TTL] [--[no-]negative-caching] [--negative-caching-policy=[[CODE=TTL],...]] - [--[no-]request-coalescing] [--serve-while-stale=SERVE_WHILE_STALE] + [--[no-]request-coalescing] [--resource-manager-tags=[KEY=VALUE,...]] + [--serve-while-stale=SERVE_WHILE_STALE] [--signed-url-cache-max-age=SIGNED_URL_CACHE_MAX_AGE] [GCLOUD_WIDE_FLAG ...] @@ -257,6 +258,10 @@ OPTIONAL FLAGS Use --request-coalescing to enable and --no-request-coalescing to disable. + --resource-manager-tags=[KEY=VALUE,...] + Comma-separated list of Resource Manager tags to apply to the backend + bucket. + --serve-while-stale=SERVE_WHILE_STALE Serve existing content from the cache (if available) when revalidating content with the origin; this allows content to be served more quickly, diff --git a/gcloud/beta/compute/backend-services/create b/gcloud/beta/compute/backend-services/create index 62101b9f1..4cfbb0728 100644 --- a/gcloud/beta/compute/backend-services/create +++ b/gcloud/beta/compute/backend-services/create @@ -35,7 +35,8 @@ SYNOPSIS [--logging-sample-rate=LOGGING_SAMPLE_RATE] [--max-ttl=MAX_TTL] [--[no-]negative-caching] [--negative-caching-policy=[[CODE=TTL],...]] [--network=NETWORK] [--port-name=PORT_NAME] [--protocol=PROTOCOL] - [--[no-]request-coalescing] [--serve-while-stale=SERVE_WHILE_STALE] + [--[no-]request-coalescing] [--resource-manager-tags=[KEY=VALUE,...]] + [--serve-while-stale=SERVE_WHILE_STALE] [--service-bindings=SERVICE_BINDING,[...]] [--service-lb-policy=SERVICE_LOAD_BALANCING_POLICY] [--session-affinity=SESSION_AFFINITY] @@ -585,6 +586,10 @@ FLAGS Use --request-coalescing to enable and --no-request-coalescing to disable. + --resource-manager-tags=[KEY=VALUE,...] + A comma-separated list of Resource Manager tags to apply to the backend + service. + --serve-while-stale=SERVE_WHILE_STALE Serve existing content from the cache (if available) when revalidating content with the origin; this allows content to be served more quickly, diff --git a/gcloud/beta/compute/interconnects/wire-groups/create b/gcloud/beta/compute/interconnects/wire-groups/create index 6778be2ef..be598e7c0 100644 --- a/gcloud/beta/compute/interconnects/wire-groups/create +++ b/gcloud/beta/compute/interconnects/wire-groups/create @@ -5,9 +5,9 @@ NAME SYNOPSIS gcloud beta compute interconnects wire-groups create NAME --bandwidth-unmetered=BANDWIDTH_UNMETERED - --cross-site-network=CROSS_SITE_NETWORK --type=TYPE [--admin-enabled] + --cross-site-network=CROSS_SITE_NETWORK [--admin-enabled] [--description=DESCRIPTION] [--fault-response=FAULT_RESPONSE] - [--validate-only] [GCLOUD_WIDE_FLAG ...] + [--type=TYPE] [--validate-only] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) gcloud beta compute interconnects wire-groups create is used to @@ -23,7 +23,7 @@ EXAMPLES $ gcloud beta compute interconnects wire-groups create \ example-wire-group --project my-project \ --cross-site-network example-cross-site-network \ - --type REDUNDANT --bandwidth-unmetered 1 + --bandwidth-unmetered 1 POSITIONAL ARGUMENTS NAME @@ -36,18 +36,6 @@ REQUIRED FLAGS --cross-site-network=CROSS_SITE_NETWORK Name of the crossSiteNetwork to operate on. - --type=TYPE - The type for the wire group. TYPE must be one of: - - BOX_AND_CROSS - Box and cross type wire groups must have two VLAN tags. The first - is for the same-zone pseudowire, and the second is for the - cross-zone pseudowire. - REDUNDANT - Redundant type wire groups must have only one VLAN tag. - WIRE - Single wire type wire groups must have only one VLAN tag. - OPTIONAL FLAGS --admin-enabled Administrative status of the wire group. If not provided on creation, @@ -66,6 +54,18 @@ OPTIONAL FLAGS NONE None + --type=TYPE + The type for the wire group. TYPE must be one of: + + BOX_AND_CROSS + Box and cross type wire groups must have two VLAN tags. The first + is for the same-zone pseudowire, and the second is for the + cross-zone pseudowire. + REDUNDANT + Redundant type wire groups must have only one VLAN tag. + WIRE + Single wire type wire groups must have only one VLAN tag. + --validate-only Validate the new configuration, but don't update it. diff --git a/gcloud/beta/compute/networks/peerings/request-delete b/gcloud/beta/compute/networks/peerings/request-delete index 3282ee1d8..7e6f777e2 100644 --- a/gcloud/beta/compute/networks/peerings/request-delete +++ b/gcloud/beta/compute/networks/peerings/request-delete @@ -46,8 +46,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud compute networks peerings request-delete $ gcloud alpha compute networks peerings request-delete diff --git a/gcloud/beta/config/get b/gcloud/beta/config/get index 7178600da..d52b2722f 100644 --- a/gcloud/beta/config/get +++ b/gcloud/beta/config/get @@ -399,6 +399,9 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud healthcare command group. Defaults to https://healthcare.googleapis.com/ + hypercomputecluster + Overrides API endpoint for gcloud cluster-director command group. + iam Overrides API endpoint for gcloud iam command group. Defaults to https://iam.googleapis.com/ @@ -1240,7 +1243,7 @@ AVAILABLE PROPERTIES Chunk size used for copying to in clouds or on disk. download_chunk_size - Chunk size used for downloadinging to clouds. + Chunk size used for downloading to clouds. exponential_sleep_multiplier Used in exponential backoff for retrying operations. diff --git a/gcloud/beta/config/help b/gcloud/beta/config/help index d8ee99cf4..56800c9d5 100644 --- a/gcloud/beta/config/help +++ b/gcloud/beta/config/help @@ -431,6 +431,9 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud healthcare command group. Defaults to https://healthcare.googleapis.com/ + hypercomputecluster + Overrides API endpoint for gcloud cluster-director command group. + iam Overrides API endpoint for gcloud iam command group. Defaults to https://iam.googleapis.com/ @@ -1272,7 +1275,7 @@ AVAILABLE PROPERTIES Chunk size used for copying to in clouds or on disk. download_chunk_size - Chunk size used for downloadinging to clouds. + Chunk size used for downloading to clouds. exponential_sleep_multiplier Used in exponential backoff for retrying operations. diff --git a/gcloud/beta/config/list b/gcloud/beta/config/list index 1d54b14c4..f24fa60e8 100644 --- a/gcloud/beta/config/list +++ b/gcloud/beta/config/list @@ -443,6 +443,9 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud healthcare command group. Defaults to https://healthcare.googleapis.com/ + hypercomputecluster + Overrides API endpoint for gcloud cluster-director command group. + iam Overrides API endpoint for gcloud iam command group. Defaults to https://iam.googleapis.com/ @@ -1284,7 +1287,7 @@ AVAILABLE PROPERTIES Chunk size used for copying to in clouds or on disk. download_chunk_size - Chunk size used for downloadinging to clouds. + Chunk size used for downloading to clouds. exponential_sleep_multiplier Used in exponential backoff for retrying operations. diff --git a/gcloud/beta/config/set b/gcloud/beta/config/set index 80c0f2358..b48f8da56 100644 --- a/gcloud/beta/config/set +++ b/gcloud/beta/config/set @@ -446,6 +446,9 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud healthcare command group. Defaults to https://healthcare.googleapis.com/ + hypercomputecluster + Overrides API endpoint for gcloud cluster-director command group. + iam Overrides API endpoint for gcloud iam command group. Defaults to https://iam.googleapis.com/ @@ -1287,7 +1290,7 @@ AVAILABLE PROPERTIES Chunk size used for copying to in clouds or on disk. download_chunk_size - Chunk size used for downloadinging to clouds. + Chunk size used for downloading to clouds. exponential_sleep_multiplier Used in exponential backoff for retrying operations. diff --git a/gcloud/beta/config/unset b/gcloud/beta/config/unset index 264a7d9f5..e1e9a6943 100644 --- a/gcloud/beta/config/unset +++ b/gcloud/beta/config/unset @@ -407,6 +407,9 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud healthcare command group. Defaults to https://healthcare.googleapis.com/ + hypercomputecluster + Overrides API endpoint for gcloud cluster-director command group. + iam Overrides API endpoint for gcloud iam command group. Defaults to https://iam.googleapis.com/ @@ -1248,7 +1251,7 @@ AVAILABLE PROPERTIES Chunk size used for copying to in clouds or on disk. download_chunk_size - Chunk size used for downloadinging to clouds. + Chunk size used for downloading to clouds. exponential_sleep_multiplier Used in exponential backoff for retrying operations. diff --git a/gcloud/beta/container/clusters/create b/gcloud/beta/container/clusters/create index b0a7352e1..f80a2d974 100644 --- a/gcloud/beta/container/clusters/create +++ b/gcloud/beta/container/clusters/create @@ -66,6 +66,7 @@ SYNOPSIS [--max-pods-per-node=MAX_PODS_PER_NODE] [--max-surge-upgrade=MAX_SURGE_UPGRADE; default=1] [--max-unavailable-upgrade=MAX_UNAVAILABLE_UPGRADE] + [--membership-type=MEMBERSHIP_TYPE] [--metadata=KEY=VALUE,[KEY=VALUE,...]] [--metadata-from-file=KEY=LOCAL_FILE_PATH,[...]] [--min-cpu-platform=PLATFORM] [--monitoring=[COMPONENT,...]] @@ -972,6 +973,15 @@ FLAGS Must be used in conjunction with '--max-surge-upgrade'. + --membership-type=MEMBERSHIP_TYPE + Specify a membership type for the cluster's fleet membership. Example: + $ gcloud beta container clusters create \ + --membership-type=LIGHTWEIGHT. MEMBERSHIP_TYPE must be (only \ one + value is supported): + + LIGHTWEIGHT + Fleet membership representing this cluster will be lightweight. + --metadata=KEY=VALUE,[KEY=VALUE,...] Compute Engine metadata to be made available to the guest operating system running on nodes within the node pool. diff --git a/gcloud/beta/container/clusters/create-auto b/gcloud/beta/container/clusters/create-auto index b16aac2f4..e7cb0811e 100644 --- a/gcloud/beta/container/clusters/create-auto +++ b/gcloud/beta/container/clusters/create-auto @@ -27,12 +27,13 @@ SYNOPSIS [--enable-ray-cluster-logging] [--enable-ray-cluster-monitoring] [--enable-ray-operator] [--fleet-project=PROJECT_ID_OR_NUMBER] [--hpa-profile=HPA_PROFILE] [--labels=[KEY=VALUE,...]] - [--logging=[COMPONENT,...]] [--monitoring=[COMPONENT,...]] - [--network=NETWORK] [--private-endpoint-subnetwork=NAME] - [--release-channel=CHANNEL] [--security-group=SECURITY_GROUP] - [--security-posture=SECURITY_POSTURE] [--services-ipv4-cidr=CIDR] - [--services-secondary-range-name=NAME] [--subnetwork=SUBNETWORK] - [--tier=TIER] [--workload-policies=WORKLOAD_POLICIES] + [--logging=[COMPONENT,...]] [--membership-type=MEMBERSHIP_TYPE] + [--monitoring=[COMPONENT,...]] [--network=NETWORK] + [--private-endpoint-subnetwork=NAME] [--release-channel=CHANNEL] + [--security-group=SECURITY_GROUP] [--security-posture=SECURITY_POSTURE] + [--services-ipv4-cidr=CIDR] [--services-secondary-range-name=NAME] + [--subnetwork=SUBNETWORK] [--tier=TIER] + [--workload-policies=WORKLOAD_POLICIES] [--workload-vulnerability-scanning=WORKLOAD_VULNERABILITY_SCANNING] [--additive-vpc-scope-dns-domain=ADDITIVE_VPC_SCOPE_DNS_DOMAIN | --disable-additive-vpc-scope] @@ -381,6 +382,15 @@ FLAGS --logging=SYSTEM,WORKLOAD,API_SERVER,CONTROLLER_MANAGER,\ SCHEDULER + --membership-type=MEMBERSHIP_TYPE + Specify a membership type for the cluster's fleet membership. Example: + $ gcloud beta container clusters create-auto \ + --membership-type=LIGHTWEIGHT. MEMBERSHIP_TYPE must be (only \ one + value is supported): + + LIGHTWEIGHT + Fleet membership representing this cluster will be lightweight. + --monitoring=[COMPONENT,...] Set the components that have monitoring enabled. Valid component values are: SYSTEM, WORKLOAD (Deprecated), NONE, API_SERVER, diff --git a/gcloud/beta/container/clusters/update b/gcloud/beta/container/clusters/update index 5ed6088dc..7a22fac2d 100644 --- a/gcloud/beta/container/clusters/update +++ b/gcloud/beta/container/clusters/update @@ -63,9 +63,10 @@ SYNOPSIS | --enable-managed-prometheus | --binauthz-policy-bindings=[name=BINAUTHZ_POLICY] --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE - | --enable-binauthz | --clear-fleet-project - --enable-fleet --fleet-project=PROJECT_ID_OR_NUMBER - | --clear-maintenance-window | --remove-maintenance-exclusion=NAME + | --enable-binauthz | --clear-fleet-project --enable-fleet + --fleet-project=PROJECT_ID_OR_NUMBER + --membership-type=MEMBERSHIP_TYPE | --clear-maintenance-window + | --remove-maintenance-exclusion=NAME | [--add-maintenance-exclusion-end=TIME_STAMP : --add-maintenance-exclusion-name=NAME --add-maintenance-exclusion-scope=SCOPE @@ -1022,6 +1023,15 @@ REQUIRED FLAGS Example: $ gcloud beta container clusters update --fleet-project=my-project + --membership-type=MEMBERSHIP_TYPE + Specify a membership type for the cluster's fleet membership. + Example: $ gcloud beta container clusters update \ + --membership-type=LIGHTWEIGHT. MEMBERSHIP_TYPE must be (only \ one + value is supported): + + LIGHTWEIGHT + Fleet membership representing this cluster will be lightweight. + At most one of these can be specified: --clear-maintenance-window diff --git a/gcloud/beta/container/fleet/config-management/describe b/gcloud/beta/container/fleet/config-management/describe index 456f910ec..0b058be5a 100644 --- a/gcloud/beta/container/fleet/config-management/describe +++ b/gcloud/beta/container/fleet/config-management/describe @@ -18,8 +18,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container fleet config-management describe $ gcloud alpha container fleet config-management describe diff --git a/gcloud/beta/container/fleet/config-management/disable b/gcloud/beta/container/fleet/config-management/disable index 1f0034d70..75d2658cb 100644 --- a/gcloud/beta/container/fleet/config-management/disable +++ b/gcloud/beta/container/fleet/config-management/disable @@ -107,8 +107,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container fleet config-management disable $ gcloud alpha container fleet config-management disable diff --git a/gcloud/beta/container/fleet/config-management/help b/gcloud/beta/container/fleet/config-management/help index faee64181..524f0f699 100644 --- a/gcloud/beta/container/fleet/config-management/help +++ b/gcloud/beta/container/fleet/config-management/help @@ -1,5 +1,5 @@ NAME - gcloud beta container fleet config-management - manage Config Management + gcloud beta container fleet config-management - use the Config Management feature SYNOPSIS @@ -47,8 +47,10 @@ COMMANDS enabled. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container fleet config-management $ gcloud alpha container fleet config-management diff --git a/gcloud/beta/container/fleet/help b/gcloud/beta/container/fleet/help index 5e62f5efe..cdcc7df06 100644 --- a/gcloud/beta/container/fleet/help +++ b/gcloud/beta/container/fleet/help @@ -52,7 +52,7 @@ GROUPS (BETA) Configure the Fleet clusterupgrade feature. config-management - (BETA) Manage Config Management feature. + (BETA) Use the Config Management feature. dataplane-v2-encryption (BETA) Manage Dataplane V2 Encryption Feature. diff --git a/gcloud/beta/container/hub/config-management/describe b/gcloud/beta/container/hub/config-management/describe index 1aa510afc..c3e242b2a 100644 --- a/gcloud/beta/container/hub/config-management/describe +++ b/gcloud/beta/container/hub/config-management/describe @@ -17,8 +17,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container hub config-management describe $ gcloud alpha container hub config-management describe diff --git a/gcloud/beta/container/hub/config-management/disable b/gcloud/beta/container/hub/config-management/disable index ec43ed85c..da37fcb67 100644 --- a/gcloud/beta/container/hub/config-management/disable +++ b/gcloud/beta/container/hub/config-management/disable @@ -106,8 +106,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container hub config-management disable $ gcloud alpha container hub config-management disable diff --git a/gcloud/beta/container/hub/config-management/help b/gcloud/beta/container/hub/config-management/help index d65980ca0..0c00db98f 100644 --- a/gcloud/beta/container/hub/config-management/help +++ b/gcloud/beta/container/hub/config-management/help @@ -1,5 +1,5 @@ NAME - gcloud beta container hub config-management - manage Config Management + gcloud beta container hub config-management - use the Config Management feature SYNOPSIS @@ -46,8 +46,10 @@ COMMANDS enabled. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container hub config-management $ gcloud alpha container hub config-management diff --git a/gcloud/beta/container/hub/help b/gcloud/beta/container/hub/help index 7819c029e..68ef776e5 100644 --- a/gcloud/beta/container/hub/help +++ b/gcloud/beta/container/hub/help @@ -52,7 +52,7 @@ GROUPS (BETA) Configure the Fleet clusterupgrade feature. config-management - (BETA) Manage Config Management feature. + (BETA) Use the Config Management feature. dataplane-v2-encryption (BETA) Manage Dataplane V2 Encryption Feature. diff --git a/gcloud/beta/managed-kafka/schema-registries/describe b/gcloud/beta/managed-kafka/schema-registries/describe index d6ecb1886..cc6e92b2d 100644 --- a/gcloud/beta/managed-kafka/schema-registries/describe +++ b/gcloud/beta/managed-kafka/schema-registries/describe @@ -14,7 +14,7 @@ EXAMPLES --schema_registry=SCHEMA_REGISTRY_ID POSITIONAL ARGUMENTS - Schema registry resource - The schema registry to create. The arguments in + Schema registry resource - The schema registry resource. 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. diff --git a/gcloud/beta/source-manager/help b/gcloud/beta/source-manager/help index e573c173e..0ff67b083 100644 --- a/gcloud/beta/source-manager/help +++ b/gcloud/beta/source-manager/help @@ -28,8 +28,10 @@ GROUPS (BETA) Manage Secure Source Manager repositories. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud source-manager $ gcloud alpha source-manager diff --git a/gcloud/beta/source-manager/instances/add-iam-policy-binding b/gcloud/beta/source-manager/instances/add-iam-policy-binding index bb3efb396..1462beaf8 100644 --- a/gcloud/beta/source-manager/instances/add-iam-policy-binding +++ b/gcloud/beta/source-manager/instances/add-iam-policy-binding @@ -88,8 +88,10 @@ API REFERENCE https://cloud.google.com/secure-source-manager NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud source-manager instances add-iam-policy-binding $ gcloud alpha source-manager instances add-iam-policy-binding diff --git a/gcloud/beta/source-manager/instances/create b/gcloud/beta/source-manager/instances/create index bf03a0ef6..5f2dcd322 100644 --- a/gcloud/beta/source-manager/instances/create +++ b/gcloud/beta/source-manager/instances/create @@ -94,8 +94,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud source-manager instances create $ gcloud alpha source-manager instances create diff --git a/gcloud/beta/source-manager/instances/delete b/gcloud/beta/source-manager/instances/delete index 63608aba6..eb0bf85d3 100644 --- a/gcloud/beta/source-manager/instances/delete +++ b/gcloud/beta/source-manager/instances/delete @@ -75,8 +75,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud source-manager instances delete $ gcloud alpha source-manager instances delete diff --git a/gcloud/beta/source-manager/instances/describe b/gcloud/beta/source-manager/instances/describe index 97d874c98..63eb2bf2c 100644 --- a/gcloud/beta/source-manager/instances/describe +++ b/gcloud/beta/source-manager/instances/describe @@ -61,8 +61,10 @@ API REFERENCE https://cloud.google.com/secure-source-manager NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud source-manager instances describe $ gcloud alpha source-manager instances describe diff --git a/gcloud/beta/source-manager/instances/get-iam-policy b/gcloud/beta/source-manager/instances/get-iam-policy index 8d35e9ff0..1f84287f6 100644 --- a/gcloud/beta/source-manager/instances/get-iam-policy +++ b/gcloud/beta/source-manager/instances/get-iam-policy @@ -88,8 +88,10 @@ API REFERENCE https://cloud.google.com/secure-source-manager NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud source-manager instances get-iam-policy $ gcloud alpha source-manager instances get-iam-policy diff --git a/gcloud/beta/source-manager/instances/help b/gcloud/beta/source-manager/instances/help index baa3e27a3..4b73b40b0 100644 --- a/gcloud/beta/source-manager/instances/help +++ b/gcloud/beta/source-manager/instances/help @@ -42,8 +42,10 @@ COMMANDS (BETA) Set the IAM policy for a Secure Source Manager instance. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud source-manager instances $ gcloud alpha source-manager instances diff --git a/gcloud/beta/source-manager/instances/list b/gcloud/beta/source-manager/instances/list index d22ff7c87..9a82651cf 100644 --- a/gcloud/beta/source-manager/instances/list +++ b/gcloud/beta/source-manager/instances/list @@ -81,8 +81,10 @@ API REFERENCE https://cloud.google.com/secure-source-manager NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud source-manager instances list $ gcloud alpha source-manager instances list diff --git a/gcloud/beta/source-manager/instances/remove-iam-policy-binding b/gcloud/beta/source-manager/instances/remove-iam-policy-binding index 8817f12c3..9642e1e90 100644 --- a/gcloud/beta/source-manager/instances/remove-iam-policy-binding +++ b/gcloud/beta/source-manager/instances/remove-iam-policy-binding @@ -89,8 +89,10 @@ API REFERENCE https://cloud.google.com/secure-source-manager NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud source-manager instances remove-iam-policy-binding $ gcloud alpha source-manager instances remove-iam-policy-binding diff --git a/gcloud/beta/source-manager/instances/set-iam-policy b/gcloud/beta/source-manager/instances/set-iam-policy index 0dbc88f88..82563ff51 100644 --- a/gcloud/beta/source-manager/instances/set-iam-policy +++ b/gcloud/beta/source-manager/instances/set-iam-policy @@ -68,8 +68,10 @@ API REFERENCE https://cloud.google.com/secure-source-manager NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud source-manager instances set-iam-policy $ gcloud alpha source-manager instances set-iam-policy diff --git a/gcloud/beta/source-manager/locations/help b/gcloud/beta/source-manager/locations/help index 2b76a92c0..8f3e03df0 100644 --- a/gcloud/beta/source-manager/locations/help +++ b/gcloud/beta/source-manager/locations/help @@ -20,8 +20,10 @@ COMMANDS (BETA) List Secure Source Manager locations. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud source-manager locations $ gcloud alpha source-manager locations diff --git a/gcloud/beta/source-manager/locations/list b/gcloud/beta/source-manager/locations/list index fa3d1a697..0afc82d1f 100644 --- a/gcloud/beta/source-manager/locations/list +++ b/gcloud/beta/source-manager/locations/list @@ -62,8 +62,10 @@ API REFERENCE https://cloud.google.com/secure-source-manager NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud source-manager locations list $ gcloud alpha source-manager locations list diff --git a/gcloud/beta/source-manager/operations/describe b/gcloud/beta/source-manager/operations/describe index 8d2a1c2e4..103540603 100644 --- a/gcloud/beta/source-manager/operations/describe +++ b/gcloud/beta/source-manager/operations/describe @@ -61,8 +61,10 @@ API REFERENCE https://cloud.google.com/secure-source-manager NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud source-manager operations describe $ gcloud alpha source-manager operations describe diff --git a/gcloud/beta/source-manager/operations/help b/gcloud/beta/source-manager/operations/help index 56f688bd2..968d61396 100644 --- a/gcloud/beta/source-manager/operations/help +++ b/gcloud/beta/source-manager/operations/help @@ -23,8 +23,10 @@ COMMANDS (BETA) List Secure Source Manager operations. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud source-manager operations $ gcloud alpha source-manager operations diff --git a/gcloud/beta/source-manager/operations/list b/gcloud/beta/source-manager/operations/list index 34341daf9..ddeda46c4 100644 --- a/gcloud/beta/source-manager/operations/list +++ b/gcloud/beta/source-manager/operations/list @@ -81,8 +81,10 @@ API REFERENCE https://cloud.google.com/secure-source-manager NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud source-manager operations list $ gcloud alpha source-manager operations list diff --git a/gcloud/beta/source-manager/repos/add-iam-policy-binding b/gcloud/beta/source-manager/repos/add-iam-policy-binding index 5b9863027..c0d3bd12d 100644 --- a/gcloud/beta/source-manager/repos/add-iam-policy-binding +++ b/gcloud/beta/source-manager/repos/add-iam-policy-binding @@ -90,8 +90,10 @@ API REFERENCE https://cloud.google.com/secure-source-manager NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud source-manager repos add-iam-policy-binding $ gcloud alpha source-manager repos add-iam-policy-binding diff --git a/gcloud/beta/source-manager/repos/create b/gcloud/beta/source-manager/repos/create index 0fa7aa681..0c156ffa7 100644 --- a/gcloud/beta/source-manager/repos/create +++ b/gcloud/beta/source-manager/repos/create @@ -86,8 +86,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud source-manager repos create $ gcloud alpha source-manager repos create diff --git a/gcloud/beta/source-manager/repos/delete b/gcloud/beta/source-manager/repos/delete index 9403b1292..120f29c35 100644 --- a/gcloud/beta/source-manager/repos/delete +++ b/gcloud/beta/source-manager/repos/delete @@ -62,8 +62,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud source-manager repos delete $ gcloud alpha source-manager repos delete diff --git a/gcloud/beta/source-manager/repos/describe b/gcloud/beta/source-manager/repos/describe index 1abdd81a1..cf59058f0 100644 --- a/gcloud/beta/source-manager/repos/describe +++ b/gcloud/beta/source-manager/repos/describe @@ -62,8 +62,10 @@ API REFERENCE https://cloud.google.com/secure-source-manager NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud source-manager repos describe $ gcloud alpha source-manager repos describe diff --git a/gcloud/beta/source-manager/repos/get-iam-policy b/gcloud/beta/source-manager/repos/get-iam-policy index 5315ffeb4..07a2d6119 100644 --- a/gcloud/beta/source-manager/repos/get-iam-policy +++ b/gcloud/beta/source-manager/repos/get-iam-policy @@ -89,8 +89,10 @@ API REFERENCE https://cloud.google.com/secure-source-manager NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud source-manager repos get-iam-policy $ gcloud alpha source-manager repos get-iam-policy diff --git a/gcloud/beta/source-manager/repos/help b/gcloud/beta/source-manager/repos/help index b9fdf97cf..8713db078 100644 --- a/gcloud/beta/source-manager/repos/help +++ b/gcloud/beta/source-manager/repos/help @@ -41,9 +41,14 @@ COMMANDS set-iam-policy (BETA) Set the IAM policy for a Secure Source Manager repository. + update + (BETA) Update a Secure Source Manager repository. + NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud source-manager repos $ gcloud alpha source-manager repos diff --git a/gcloud/beta/source-manager/repos/list b/gcloud/beta/source-manager/repos/list index 877553db4..fc924d01e 100644 --- a/gcloud/beta/source-manager/repos/list +++ b/gcloud/beta/source-manager/repos/list @@ -60,8 +60,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud source-manager repos list $ gcloud alpha source-manager repos list diff --git a/gcloud/beta/source-manager/repos/remove-iam-policy-binding b/gcloud/beta/source-manager/repos/remove-iam-policy-binding index 35194a25a..94d3d2280 100644 --- a/gcloud/beta/source-manager/repos/remove-iam-policy-binding +++ b/gcloud/beta/source-manager/repos/remove-iam-policy-binding @@ -91,8 +91,10 @@ API REFERENCE https://cloud.google.com/secure-source-manager NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud source-manager repos remove-iam-policy-binding $ gcloud alpha source-manager repos remove-iam-policy-binding diff --git a/gcloud/beta/source-manager/repos/set-iam-policy b/gcloud/beta/source-manager/repos/set-iam-policy index 2e6754a30..fc46d6f50 100644 --- a/gcloud/beta/source-manager/repos/set-iam-policy +++ b/gcloud/beta/source-manager/repos/set-iam-policy @@ -69,8 +69,10 @@ API REFERENCE https://cloud.google.com/secure-source-manager NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud source-manager repos set-iam-policy $ gcloud alpha source-manager repos set-iam-policy diff --git a/gcloud/beta/source-manager/repos/update b/gcloud/beta/source-manager/repos/update new file mode 100644 index 000000000..041a3b06a --- /dev/null +++ b/gcloud/beta/source-manager/repos/update @@ -0,0 +1,74 @@ +NAME + gcloud beta source-manager repos update - update a Secure Source Manager + repository + +SYNOPSIS + gcloud beta source-manager repos update (REPOSITORY : --region=REGION) + [--description=DESCRIPTION] [--validate-only] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Update a Secure Source Manager repository. + +EXAMPLES + To update the description of a repository called my-repo in location + us-central1, run the following command: + + $ gcloud beta source-manager repos update my-repo \ + --description="new description" --region=us-central1 + +POSITIONAL ARGUMENTS + Repository resource - The Secure Source Manager repository to update. 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 repository on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + REPOSITORY + ID of the repository or fully qualified identifier for the + repository. + + To set the repository attribute: + ▸ provide the argument repository on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Secure Source Manager location. + + To set the region attribute: + ▸ provide the argument repository on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + +FLAGS + --description=DESCRIPTION + Description of the repository. Cannot exceed 500 characters. + + --validate-only + If set to true, the request is validated and the user is provided with + an expected result, but no actual change is made. + +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 + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud source-manager repos update + + $ gcloud alpha source-manager repos update + diff --git a/gcloud/composer/environments/run b/gcloud/composer/environments/run index 09fd65177..5166fa59c 100644 --- a/gcloud/composer/environments/run +++ b/gcloud/composer/environments/run @@ -80,17 +80,17 @@ POSITIONAL ARGUMENTS SUBCOMMAND The Airflow CLI subcommand to run. Available subcommands include (listed with Airflow versions that support): backfill [**, 2.0.0), - clear [**, 2.0.0), connections [**, 3.0.0), dag_state [**, 2.0.0), dags - [1.10.14, 3.0.0), db [2.3.0, 3.0.0), delete_dag [1.10.1, 2.0.0), - kerberos [**, 3.0.0), kubernetes [2.1.4, 3.0.0), list-import-errors + clear [**, 2.0.0), connections [**, 3.1.0), dag_state [**, 2.0.0), dags + [1.10.14, 3.1.0), db [2.3.0, 3.0.0), delete_dag [1.10.1, 2.0.0), + kerberos [**, 3.1.0), kubernetes [2.1.4, 3.1.0), list-import-errors [**, 3.0.0), list_dag_runs [1.10.2, 2.0.0), list_dags [**, 2.0.0), list_tasks [**, 2.0.0), next_execution [1.10.2, 2.0.0), pause [**, - 2.0.0), pool [**, 2.0.0), pools [1.10.14, 3.0.0), render [**, 2.0.0), - roles [2.0.0, 3.0.0), run [**, 2.0.0), sync-perm [1.10.14, 3.0.0), + 2.0.0), pool [**, 2.0.0), pools [1.10.14, 3.1.0), render [**, 2.0.0), + roles [2.0.0, 3.1.0), run [**, 2.0.0), sync-perm [1.10.14, 3.1.0), sync_perm [1.10.2, 2.0.0), task_failed_deps [**, 2.0.0), task_state - [**, 2.0.0), tasks [1.10.14, 3.0.0), test [**, 2.0.0), trigger_dag [**, + [**, 2.0.0), tasks [1.10.14, 3.1.0), test [**, 2.0.0), trigger_dag [**, 2.0.0), unpause [**, 2.0.0), upgrade_check [1.10.15, 2.0.0), users - [1.10.14, 3.0.0), variables [**, 3.0.0), version [**, 3.0.0) (see + [1.10.14, 3.1.0), variables [**, 3.1.0), version [**, 3.1.0) (see https://airflow.apache.org/docs/apache-airflow/stable/cli-and-env-variables-ref.html for more info). diff --git a/gcloud/compute/backend-buckets/create b/gcloud/compute/backend-buckets/create index 097e4bbff..6468de944 100644 --- a/gcloud/compute/backend-buckets/create +++ b/gcloud/compute/backend-buckets/create @@ -14,7 +14,8 @@ SYNOPSIS [--[no-]enable-cdn] [--load-balancing-scheme=LOAD_BALANCING_SCHEME] [--max-ttl=MAX_TTL] [--[no-]negative-caching] [--negative-caching-policy=[[CODE=TTL],...]] - [--[no-]request-coalescing] [--serve-while-stale=SERVE_WHILE_STALE] + [--[no-]request-coalescing] [--resource-manager-tags=[KEY=VALUE,...]] + [--serve-while-stale=SERVE_WHILE_STALE] [--signed-url-cache-max-age=SIGNED_URL_CACHE_MAX_AGE] [GCLOUD_WIDE_FLAG ...] @@ -257,6 +258,10 @@ OPTIONAL FLAGS Use --request-coalescing to enable and --no-request-coalescing to disable. + --resource-manager-tags=[KEY=VALUE,...] + Comma-separated list of Resource Manager tags to apply to the backend + bucket. + --serve-while-stale=SERVE_WHILE_STALE Serve existing content from the cache (if available) when revalidating content with the origin; this allows content to be served more quickly, diff --git a/gcloud/compute/backend-services/create b/gcloud/compute/backend-services/create index 6c3240b77..548d56145 100644 --- a/gcloud/compute/backend-services/create +++ b/gcloud/compute/backend-services/create @@ -34,7 +34,8 @@ SYNOPSIS [--logging-sample-rate=LOGGING_SAMPLE_RATE] [--max-ttl=MAX_TTL] [--[no-]negative-caching] [--negative-caching-policy=[[CODE=TTL],...]] [--network=NETWORK] [--port-name=PORT_NAME] [--protocol=PROTOCOL] - [--[no-]request-coalescing] [--serve-while-stale=SERVE_WHILE_STALE] + [--[no-]request-coalescing] [--resource-manager-tags=[KEY=VALUE,...]] + [--serve-while-stale=SERVE_WHILE_STALE] [--service-bindings=SERVICE_BINDING,[...]] [--service-lb-policy=SERVICE_LOAD_BALANCING_POLICY] [--session-affinity=SESSION_AFFINITY] @@ -575,6 +576,10 @@ FLAGS Use --request-coalescing to enable and --no-request-coalescing to disable. + --resource-manager-tags=[KEY=VALUE,...] + A comma-separated list of Resource Manager tags to apply to the backend + service. + --serve-while-stale=SERVE_WHILE_STALE Serve existing content from the cache (if available) when revalidating content with the origin; this allows content to be served more quickly, diff --git a/gcloud/compute/networks/peerings/create b/gcloud/compute/networks/peerings/create index 05f9a894c..ac39cac78 100644 --- a/gcloud/compute/networks/peerings/create +++ b/gcloud/compute/networks/peerings/create @@ -8,7 +8,7 @@ SYNOPSIS [--export-custom-routes] [--export-subnet-routes-with-public-ip] [--import-custom-routes] [--import-subnet-routes-with-public-ip] [--peer-project=PEER_PROJECT] [--stack-type=STACK_TYPE] - [GCLOUD_WIDE_FLAG ...] + [--update-strategy=UPDATE_STRATEGY] [GCLOUD_WIDE_FLAG ...] DESCRIPTION gcloud compute networks peerings create is used to create peerings between @@ -87,6 +87,18 @@ OPTIONAL FLAGS IPv6 traffic and routes will be exchanged if the matching peering configuration also has stack_type set to IPV4_IPV6. + --update-strategy=UPDATE_STRATEGY + Update strategy of the peering. If not specified, defaults to + INDEPENDENT. + + UPDATE_STRATEGY must be one of: + + INDEPENDENT Updates and deletes to the peering connection can be + performed by either network admin. + + CONSENSUS Updates and deletes to the peering connection must be agreed + upon by both network admins. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/compute/networks/peerings/help b/gcloud/compute/networks/peerings/help index 27a5662b4..874d5dfad 100644 --- a/gcloud/compute/networks/peerings/help +++ b/gcloud/compute/networks/peerings/help @@ -34,6 +34,9 @@ COMMANDS list-routes List received or advertised routes for a VPC network peering. + request-delete + Request deletion of a Compute Engine network peering. + update Update a Compute Engine network peering. diff --git a/gcloud/compute/networks/peerings/request-delete b/gcloud/compute/networks/peerings/request-delete new file mode 100644 index 000000000..6008eb29b --- /dev/null +++ b/gcloud/compute/networks/peerings/request-delete @@ -0,0 +1,54 @@ +NAME + gcloud compute networks peerings request-delete - request deletion of a + Compute Engine network peering + +SYNOPSIS + gcloud compute networks peerings request-delete NAME --network=NETWORK + [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + gcloud compute networks peerings request-delete is used to request deletion + of a consensus peering between virtual networks. The peering can be deleted + if both sides request deletion. + +EXAMPLES + To request deletion of a consensus peering with the name 'peering-name' + between the network 'local-network' and the network 'peer-network', run: + + $ gcloud compute networks peerings request-delete peering-name \ + --network=local-network + + $ gcloud compute networks peerings request-delete peering-name \ + --network=peer-network + + To complete the deletion, run gcloud compute networks peerings delete for + each side of the peering. + +POSITIONAL ARGUMENTS + NAME + The name of the peering. + +REQUIRED FLAGS + --network=NETWORK + The name of the network in the current project containing the peering. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +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: + + $ gcloud alpha compute networks peerings request-delete + + $ gcloud beta compute networks peerings request-delete + diff --git a/gcloud/compute/networks/peerings/update b/gcloud/compute/networks/peerings/update index 8ec238759..6f4190c3c 100644 --- a/gcloud/compute/networks/peerings/update +++ b/gcloud/compute/networks/peerings/update @@ -6,7 +6,8 @@ SYNOPSIS gcloud compute networks peerings update NAME --network=NETWORK [--export-custom-routes] [--export-subnet-routes-with-public-ip] [--import-custom-routes] [--import-subnet-routes-with-public-ip] - [--stack-type=STACK_TYPE] [GCLOUD_WIDE_FLAG ...] + [--stack-type=STACK_TYPE] [--update-strategy=UPDATE_STRATEGY] + [GCLOUD_WIDE_FLAG ...] EXAMPLES To update the peering named peering-name to both export and import custom @@ -63,6 +64,18 @@ OPTIONAL FLAGS IPv6 traffic and routes will be exchanged if the matching peering configuration also has stack_type set to IPV4_IPV6. + --update-strategy=UPDATE_STRATEGY + Update strategy of the peering. If not specified, defaults to + INDEPENDENT. + + UPDATE_STRATEGY must be one of: + + INDEPENDENT Updates and deletes to the peering connection can be + performed by either network admin. + + CONSENSUS Updates and deletes to the peering connection must be agreed + upon by both network admins. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/config/get b/gcloud/config/get index c4415ffed..caf7db365 100644 --- a/gcloud/config/get +++ b/gcloud/config/get @@ -399,6 +399,9 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud healthcare command group. Defaults to https://healthcare.googleapis.com/ + hypercomputecluster + Overrides API endpoint for gcloud cluster-director command group. + iam Overrides API endpoint for gcloud iam command group. Defaults to https://iam.googleapis.com/ @@ -1240,7 +1243,7 @@ AVAILABLE PROPERTIES Chunk size used for copying to in clouds or on disk. download_chunk_size - Chunk size used for downloadinging to clouds. + Chunk size used for downloading to clouds. exponential_sleep_multiplier Used in exponential backoff for retrying operations. diff --git a/gcloud/config/help b/gcloud/config/help index d3030f671..38816d185 100644 --- a/gcloud/config/help +++ b/gcloud/config/help @@ -431,6 +431,9 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud healthcare command group. Defaults to https://healthcare.googleapis.com/ + hypercomputecluster + Overrides API endpoint for gcloud cluster-director command group. + iam Overrides API endpoint for gcloud iam command group. Defaults to https://iam.googleapis.com/ @@ -1272,7 +1275,7 @@ AVAILABLE PROPERTIES Chunk size used for copying to in clouds or on disk. download_chunk_size - Chunk size used for downloadinging to clouds. + Chunk size used for downloading to clouds. exponential_sleep_multiplier Used in exponential backoff for retrying operations. diff --git a/gcloud/config/list b/gcloud/config/list index 84bb2dfe8..8b07e2025 100644 --- a/gcloud/config/list +++ b/gcloud/config/list @@ -443,6 +443,9 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud healthcare command group. Defaults to https://healthcare.googleapis.com/ + hypercomputecluster + Overrides API endpoint for gcloud cluster-director command group. + iam Overrides API endpoint for gcloud iam command group. Defaults to https://iam.googleapis.com/ @@ -1284,7 +1287,7 @@ AVAILABLE PROPERTIES Chunk size used for copying to in clouds or on disk. download_chunk_size - Chunk size used for downloadinging to clouds. + Chunk size used for downloading to clouds. exponential_sleep_multiplier Used in exponential backoff for retrying operations. diff --git a/gcloud/config/set b/gcloud/config/set index 4f8e0ed9f..7ba991eaa 100644 --- a/gcloud/config/set +++ b/gcloud/config/set @@ -446,6 +446,9 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud healthcare command group. Defaults to https://healthcare.googleapis.com/ + hypercomputecluster + Overrides API endpoint for gcloud cluster-director command group. + iam Overrides API endpoint for gcloud iam command group. Defaults to https://iam.googleapis.com/ @@ -1287,7 +1290,7 @@ AVAILABLE PROPERTIES Chunk size used for copying to in clouds or on disk. download_chunk_size - Chunk size used for downloadinging to clouds. + Chunk size used for downloading to clouds. exponential_sleep_multiplier Used in exponential backoff for retrying operations. diff --git a/gcloud/config/unset b/gcloud/config/unset index 2f42f20f0..bb7602533 100644 --- a/gcloud/config/unset +++ b/gcloud/config/unset @@ -407,6 +407,9 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud healthcare command group. Defaults to https://healthcare.googleapis.com/ + hypercomputecluster + Overrides API endpoint for gcloud cluster-director command group. + iam Overrides API endpoint for gcloud iam command group. Defaults to https://iam.googleapis.com/ @@ -1248,7 +1251,7 @@ AVAILABLE PROPERTIES Chunk size used for copying to in clouds or on disk. download_chunk_size - Chunk size used for downloadinging to clouds. + Chunk size used for downloading to clouds. exponential_sleep_multiplier Used in exponential backoff for retrying operations. diff --git a/gcloud/container/ai/profiles/benchmarks/list b/gcloud/container/ai/profiles/benchmarks/list index 1f234ee86..5ecccdb90 100644 --- a/gcloud/container/ai/profiles/benchmarks/list +++ b/gcloud/container/ai/profiles/benchmarks/list @@ -30,8 +30,8 @@ FLAGS The instance type. If not specified, this defaults to anyinstance type. --model-server-version=MODEL_SERVER_VERSION - The model server version. If not specified, this defaults to latest - model server version. + The model server version. Default is latest. Other options include the + model server version of a profile, all which returns all versions. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/container/ai/profiles/list b/gcloud/container/ai/profiles/list index af050ec92..e1dd9f0f6 100644 --- a/gcloud/container/ai/profiles/list +++ b/gcloud/container/ai/profiles/list @@ -35,7 +35,8 @@ FLAGS The model. --model-server=MODEL_SERVER - The model server. If not specified, this defaults to any model server. + The model server version. Default is latest. Other options include the + model server version of a profile, all which returns all versions. --model-server-version=MODEL_SERVER_VERSION The model server version. If not specified, this defaults to the latest diff --git a/gcloud/container/fleet/config-management/describe b/gcloud/container/fleet/config-management/describe new file mode 100644 index 000000000..998b2f2b9 --- /dev/null +++ b/gcloud/container/fleet/config-management/describe @@ -0,0 +1,25 @@ +NAME + gcloud container fleet config-management describe - describe the Config + Management feature + +SYNOPSIS + gcloud container fleet config-management describe [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe the Config Management feature. + +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: + + $ gcloud alpha container fleet config-management describe + + $ gcloud beta container fleet config-management describe + diff --git a/gcloud/container/fleet/config-management/disable b/gcloud/container/fleet/config-management/disable new file mode 100644 index 000000000..e1a8fa40d --- /dev/null +++ b/gcloud/container/fleet/config-management/disable @@ -0,0 +1,114 @@ +NAME + gcloud container fleet config-management disable - disable the Config + Management feature + +SYNOPSIS + gcloud container fleet config-management disable [--force] + [--fleet-default-member-config | --uninstall --all-memberships + | [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Disable the Config Management feature entirely, or disable specific + configuration on the feature. + + gcloud container fleet config-management disable without flags deletes the + Config Management feature, which unmanages and leaves existing Config Sync + installations on membership clusters. Running the command without flags + exits silently if the feature does not exist. Specify flags to disable + configuration on parts of the feature without deleting it. + +EXAMPLES + To disable the Config Management feature entirely, run: + + $ gcloud container fleet config-management disable + + To unmanage Config Sync only on select memberships, run: + + $ gcloud container fleet config-management disable \ + --memberships=example-membership-1,example-membership-2 + +FLAGS + --force + Force disablement. Bypasses any prompts for confirmation. When + disabling the entire feature, proceeds even if the feature is in use. + Might result in unexpected behavior. + + At most one of these can be specified: + + --fleet-default-member-config + Disable the fleet-default membership configuration + (https://cloud.google.com/kubernetes-engine/fleet-management/docs/manage-features). + Does not change existing membership configurations. Does nothing if + the feature is disabled. + + Membership-specific flags. In the absence of --uninstall, using either + --memberships or --all-memberships removes the entire configuration for + the specified memberships, which unmanages and leaves existing Config + Sync installations on the membership clusters. Unmanagement does not + error if the feature is disabled. + + --uninstall + Uninstall any previously-installed and managed Config Sync on the + specified memberships by setting the enabled field + (https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/reference/gcloud-apply-fields) + to false. Clears all other configuration for each membership. Does + not wait for the uninstallation to complete. To bypass the + confirmation prompt, use --force. Requires the feature to be + enabled. + + To uninstall Config Sync on select memberships, run: + + $ gcloud container fleet config-management disable --uninstall \ + --memberships=example-membership-1,example-membership-2 + + At most one of these can be specified: + + --all-memberships + All memberships in the fleet. + + Membership resource - The group of arguments defining one or more + memberships. 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 --memberships on the command line with a + fully specified name; + ◇ provide the argument --project on the command line; + ◇ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ▹ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ▹ provide the argument --memberships on the command line with + a fully specified name; + ▹ provide the argument --location on the command line; + ▹ set the property gkehub/location. + +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: + + $ gcloud alpha container fleet config-management disable + + $ gcloud beta container fleet config-management disable + diff --git a/gcloud/container/fleet/config-management/help b/gcloud/container/fleet/config-management/help new file mode 100644 index 000000000..b04a05ef0 --- /dev/null +++ b/gcloud/container/fleet/config-management/help @@ -0,0 +1,34 @@ +NAME + gcloud container fleet config-management - use the Config Management + feature + +SYNOPSIS + gcloud container fleet config-management COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Config Sync using the Config Management feature. Policy Controller + users should use the separate command group: gcloud container fleet + policycontroller. Hierarchy Controller users should use + https://github.com/kubernetes-sigs/hierarchical-namespaces instead. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + Describe the Config Management feature. + + disable + Disable the Config Management feature. + +NOTES + These variants are also available: + + $ gcloud alpha container fleet config-management + + $ gcloud beta container fleet config-management + diff --git a/gcloud/container/fleet/help b/gcloud/container/fleet/help index 377962a08..0bc84c3b9 100644 --- a/gcloud/container/fleet/help +++ b/gcloud/container/fleet/help @@ -51,6 +51,9 @@ GROUPS clusterupgrade Configure the Fleet clusterupgrade feature. + config-management + Use the Config Management feature. + dataplane-v2-encryption Manage Dataplane V2 Encryption Feature. diff --git a/gcloud/container/hub/config-management/describe b/gcloud/container/hub/config-management/describe new file mode 100644 index 000000000..b7d6bb25d --- /dev/null +++ b/gcloud/container/hub/config-management/describe @@ -0,0 +1,25 @@ +NAME + gcloud container hub config-management describe - describe the Config + Management feature + +SYNOPSIS + gcloud container hub config-management describe [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe the Config Management feature. + +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: + + $ gcloud alpha container hub config-management describe + + $ gcloud beta container hub config-management describe + diff --git a/gcloud/container/hub/config-management/disable b/gcloud/container/hub/config-management/disable new file mode 100644 index 000000000..ed6b548de --- /dev/null +++ b/gcloud/container/hub/config-management/disable @@ -0,0 +1,114 @@ +NAME + gcloud container hub config-management disable - disable the Config + Management feature + +SYNOPSIS + gcloud container hub config-management disable [--force] + [--fleet-default-member-config | --uninstall --all-memberships + | [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Disable the Config Management feature entirely, or disable specific + configuration on the feature. + + gcloud container hub config-management disable without flags deletes the + Config Management feature, which unmanages and leaves existing Config Sync + installations on membership clusters. Running the command without flags + exits silently if the feature does not exist. Specify flags to disable + configuration on parts of the feature without deleting it. + +EXAMPLES + To disable the Config Management feature entirely, run: + + $ gcloud container hub config-management disable + + To unmanage Config Sync only on select memberships, run: + + $ gcloud container hub config-management disable \ + --memberships=example-membership-1,example-membership-2 + +FLAGS + --force + Force disablement. Bypasses any prompts for confirmation. When + disabling the entire feature, proceeds even if the feature is in use. + Might result in unexpected behavior. + + At most one of these can be specified: + + --fleet-default-member-config + Disable the fleet-default membership configuration + (https://cloud.google.com/kubernetes-engine/fleet-management/docs/manage-features). + Does not change existing membership configurations. Does nothing if + the feature is disabled. + + Membership-specific flags. In the absence of --uninstall, using either + --memberships or --all-memberships removes the entire configuration for + the specified memberships, which unmanages and leaves existing Config + Sync installations on the membership clusters. Unmanagement does not + error if the feature is disabled. + + --uninstall + Uninstall any previously-installed and managed Config Sync on the + specified memberships by setting the enabled field + (https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/reference/gcloud-apply-fields) + to false. Clears all other configuration for each membership. Does + not wait for the uninstallation to complete. To bypass the + confirmation prompt, use --force. Requires the feature to be + enabled. + + To uninstall Config Sync on select memberships, run: + + $ gcloud container hub config-management disable --uninstall \ + --memberships=example-membership-1,example-membership-2 + + At most one of these can be specified: + + --all-memberships + All memberships in the fleet. + + Membership resource - The group of arguments defining one or more + memberships. 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 --memberships on the command line with a + fully specified name; + ◇ provide the argument --project on the command line; + ◇ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ▹ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ▹ provide the argument --memberships on the command line with + a fully specified name; + ▹ provide the argument --location on the command line; + ▹ set the property gkehub/location. + +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: + + $ gcloud alpha container hub config-management disable + + $ gcloud beta container hub config-management disable + diff --git a/gcloud/container/hub/config-management/help b/gcloud/container/hub/config-management/help new file mode 100644 index 000000000..bde4b8c2c --- /dev/null +++ b/gcloud/container/hub/config-management/help @@ -0,0 +1,33 @@ +NAME + gcloud container hub config-management - use the Config Management feature + +SYNOPSIS + gcloud container hub config-management COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Config Sync using the Config Management feature. Policy Controller + users should use the separate command group: gcloud container fleet + policycontroller. Hierarchy Controller users should use + https://github.com/kubernetes-sigs/hierarchical-namespaces instead. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + Describe the Config Management feature. + + disable + Disable the Config Management feature. + +NOTES + These variants are also available: + + $ gcloud alpha container hub config-management + + $ gcloud beta container hub config-management + diff --git a/gcloud/container/hub/help b/gcloud/container/hub/help index c01dcda48..a77af26c5 100644 --- a/gcloud/container/hub/help +++ b/gcloud/container/hub/help @@ -51,6 +51,9 @@ GROUPS clusterupgrade Configure the Fleet clusterupgrade feature. + config-management + Use the Config Management feature. + dataplane-v2-encryption Manage Dataplane V2 Encryption Feature. diff --git a/gcloud/netapp/storage-pools/create b/gcloud/netapp/storage-pools/create index 9e1a03afe..e7184da6a 100644 --- a/gcloud/netapp/storage-pools/create +++ b/gcloud/netapp/storage-pools/create @@ -9,9 +9,9 @@ SYNOPSIS [--custom-performance-enabled=CUSTOM_PERFORMANCE_ENABLED] [--description=DESCRIPTION] [--enable-ldap=ENABLE_LDAP] [--kms-config=KMS_CONFIG] [--labels=[KEY=VALUE,...]] - [--replica-zone=REPLICA_ZONE] [--total-iops=TOTAL_IOPS] - [--total-throughput=TOTAL_THROUGHPUT] [--zone=ZONE] - [GCLOUD_WIDE_FLAG ...] + [--qos-type=QOS_TYPE] [--replica-zone=REPLICA_ZONE] + [--total-iops=TOTAL_IOPS] [--total-throughput=TOTAL_THROUGHPUT] + [--zone=ZONE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION Creates a Storage Pool to contain Volumes with a specified Service Level @@ -187,6 +187,10 @@ OPTIONAL FLAGS contain only hyphens (-), underscores (_), lowercase characters, and numbers. + --qos-type=QOS_TYPE + Quality of service (QoS) type for the Storage Pool. QOS_TYPE must be + one of: auto, manual, qos-type-unspecified. + --replica-zone=REPLICA_ZONE String indicating replica zone for the Storage Pool diff --git a/gcloud/netapp/storage-pools/update b/gcloud/netapp/storage-pools/update index a6cec7859..b81efdb36 100644 --- a/gcloud/netapp/storage-pools/update +++ b/gcloud/netapp/storage-pools/update @@ -5,7 +5,7 @@ SYNOPSIS gcloud netapp storage-pools update (STORAGE_POOL : --location=LOCATION) [--active-directory=ACTIVE_DIRECTORY] [--allow-auto-tiering=ALLOW_AUTO_TIERING] [--async] - [--capacity=CAPACITY] [--description=DESCRIPTION] + [--capacity=CAPACITY] [--description=DESCRIPTION] [--qos-type=QOS_TYPE] [--replica-zone=REPLICA_ZONE] [--total-iops=TOTAL_IOPS] [--total-throughput=TOTAL_THROUGHPUT] [--update-labels=[KEY=VALUE,...]] [--zone=ZONE] [--clear-labels | --remove-labels=[KEY,...]] @@ -94,6 +94,10 @@ FLAGS --description=DESCRIPTION A description of the Cloud NetApp Storage Pool + --qos-type=QOS_TYPE + Quality of service (QoS) type for the Storage Pool. QOS_TYPE must be + one of: auto, manual, qos-type-unspecified. + --replica-zone=REPLICA_ZONE String indicating replica zone for the Storage Pool diff --git a/gcloud/netapp/volumes/create b/gcloud/netapp/volumes/create index 29316bbec..970514834 100644 --- a/gcloud/netapp/volumes/create +++ b/gcloud/netapp/volumes/create @@ -43,6 +43,7 @@ SYNOPSIS [--snapshot-weekly=[day=DAY], [hour=HOUR],[minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP]] [--source-snapshot=SOURCE_SNAPSHOT] + [--throughput-mibps=THROUGHPUT_MIBPS] [--tiering-policy=[tier-action=ENABLED|PAUSED,...]] [--unix-permissions=UNIX_PERMISSIONS] [--source-backup=SOURCE_BACKUP : --backup_vault=BACKUP_VAULT] @@ -290,6 +291,9 @@ OPTIONAL FLAGS To set the snapshot attribute: ▸ provide the argument --source-snapshot on the command line. + --throughput-mibps=THROUGHPUT_MIBPS + The desired throughput of the volume in MiB/s. + --tiering-policy=[tier-action=ENABLED|PAUSED,...] Tiering Policy contains auto tiering policy on a volume. diff --git a/gcloud/netapp/volumes/update b/gcloud/netapp/volumes/update index 1a4891c8c..4c29dd167 100644 --- a/gcloud/netapp/volumes/update +++ b/gcloud/netapp/volumes/update @@ -32,6 +32,7 @@ SYNOPSIS [--snapshot-weekly=[day=DAY], [hour=HOUR],[minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP]] [--source-snapshot=SOURCE_SNAPSHOT] [--storage-pool=STORAGE_POOL] + [--throughput-mibps=THROUGHPUT_MIBPS] [--tiering-policy=[tier-action=ENABLED|PAUSED,...]] [--unix-permissions=UNIX_PERMISSIONS] [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] @@ -221,6 +222,9 @@ FLAGS To set the storage_pool attribute: ▸ provide the argument --storage-pool on the command line. + --throughput-mibps=THROUGHPUT_MIBPS + The desired throughput of the volume in MiB/s. + --tiering-policy=[tier-action=ENABLED|PAUSED,...] Tiering Policy contains auto tiering policy on a volume. diff --git a/gcloud/source-manager/help b/gcloud/source-manager/help new file mode 100644 index 000000000..03d573677 --- /dev/null +++ b/gcloud/source-manager/help @@ -0,0 +1,36 @@ +NAME + gcloud source-manager - manage Secure Source Manager resources + +SYNOPSIS + gcloud source-manager GROUP [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Secure Source Manager resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + instances + Manage Secure Source Manager instances. + + locations + Manage Secure Source Manager locations. + + operations + Manage Secure Source Manager operations. + + repos + Manage Secure Source Manager repositories. + +NOTES + These variants are also available: + + $ gcloud alpha source-manager + + $ gcloud beta source-manager + diff --git a/gcloud/source-manager/instances/add-iam-policy-binding b/gcloud/source-manager/instances/add-iam-policy-binding new file mode 100644 index 000000000..133e6bbab --- /dev/null +++ b/gcloud/source-manager/instances/add-iam-policy-binding @@ -0,0 +1,96 @@ +NAME + gcloud source-manager instances add-iam-policy-binding - add an IAM policy + binding to a Secure Source Manager instance + +SYNOPSIS + gcloud source-manager instances add-iam-policy-binding + (INSTANCE : --region=REGION) --member=PRINCIPAL --role=ROLE + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Add an IAM policy binding to a Secure Source Manager instance. + +EXAMPLES + To add an IAM policy binding for the role of 'roles/editor' for the user + 'test-user@gmail.com' with instance named 'my-instance' and location + 'us-central1', run: + + $ gcloud source-manager instances add-iam-policy-binding \ + my-instance --region='us-central1' \ + --member='user:test-user@gmail.com' --role='roles/editor' + + See https://cloud.google.com/iam/docs/managing-policies for details of + policy role and member types. + +POSITIONAL ARGUMENTS + Instance resource - The instance for which to add the IAM policy binding. + 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 instance on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + INSTANCE + ID of the instance or fully qualified identifier for the instance. + + To set the instance attribute: + ▸ provide the argument instance on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Secure Source Manager location. + + To set the region attribute: + ▸ provide the argument instance on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + +REQUIRED FLAGS + --member=PRINCIPAL + The principal to add the binding for. Should be of the form + user|group|serviceAccount:email or domain:domain. + + Examples: user:test-user@gmail.com, group:admins@example.com, + serviceAccount:test123@example.domain.com, or + domain:example.domain.com. + + Some resources also accept the following special values: + ◆ allUsers - Special identifier that represents anyone who is on the + internet, with or without a Google account. + ◆ allAuthenticatedUsers - Special identifier that represents anyone + who is authenticated with a Google account or a service account. + + --role=ROLE + Role name to assign to the principal. The role name is the complete + path of a predefined role, such as roles/logging.viewer, or the role ID + for a custom role, such as + organizations/{ORGANIZATION_ID}/roles/logging.viewer. + +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. + +API REFERENCE + This command uses the securesourcemanager/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/secure-source-manager + +NOTES + These variants are also available: + + $ gcloud alpha source-manager instances add-iam-policy-binding + + $ gcloud beta source-manager instances add-iam-policy-binding + diff --git a/gcloud/source-manager/instances/create b/gcloud/source-manager/instances/create new file mode 100644 index 000000000..e241626f6 --- /dev/null +++ b/gcloud/source-manager/instances/create @@ -0,0 +1,102 @@ +NAME + gcloud source-manager instances create - create a Secure Source Manager + instance + +SYNOPSIS + gcloud source-manager instances create (INSTANCE : --region=REGION) + [--async] [--enable-workforce-identity-federation] [--kms-key=KMS_KEY] + [--max-wait=MAX_WAIT; default="60m"] [--is-private : --ca-pool=CA_POOL] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create a Secure Source Manager instance. + +EXAMPLES + To create a Secure Source Manager instance named 'my-instance' in location + 'us-central1' asynchronously, run: + + $ gcloud source-manager instances create my-instance \ + --region=us-central1 + + To create a Secure Source Manager instance named 'my-instance' in location + 'us-central1' synchronously, and wait a maximum of 30 minutes for it to + finish being created, run: + + $ gcloud source-manager instances create my-instance \ + --region=us-central1 --no-async --max-wait=30m + +POSITIONAL ARGUMENTS + Instance resource - The Secure Source Manager instance to create. 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 instance on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + INSTANCE + ID of the instance or fully qualified identifier for the instance. + + To set the instance attribute: + ▸ provide the argument instance on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Secure Source Manager location. + + To set the region attribute: + ▸ provide the argument instance on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. The default is True. Enabled by default, use --no-async to + disable. + + --enable-workforce-identity-federation + Bool indicator for workforce identity federation instance. + + --kms-key=KMS_KEY + KMS key used to encrypt instance optionally. + + --max-wait=MAX_WAIT; default="60m" + Time to synchronously wait for the operation to complete, after which + the operation continues asynchronously. Ignored if --no-async isn't + specified. See $ gcloud topic datetimes for information on time + formats. + + Private instance configuration. + + --is-private + Bool indicator for private instance. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --ca-pool=CA_POOL + CA Pool path for private instance. + +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: + + $ gcloud alpha source-manager instances create + + $ gcloud beta source-manager instances create + diff --git a/gcloud/source-manager/instances/delete b/gcloud/source-manager/instances/delete new file mode 100644 index 000000000..d5b13f3a8 --- /dev/null +++ b/gcloud/source-manager/instances/delete @@ -0,0 +1,83 @@ +NAME + gcloud source-manager instances delete - delete a Secure Source Manager + instance + +SYNOPSIS + gcloud source-manager instances delete (INSTANCE : --region=REGION) + [--async] [--max-wait=MAX_WAIT; default="60m"] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete a Secure Source Manager instance. + +EXAMPLES + To delete a Secure Source Manager instance named 'my-instance' in location + 'us-central1' asynchronously, run: + + $ gcloud source-manager instances delete my-instance \ + --region=us-central1 + + To delete a Secure Source Manager instance named 'my-instance' in location + 'us-central1' synchronously, and wait a maximum of 30 minutes for it to + finish being deleted, run: + + $ gcloud source-manager instances delete my-instance \ + --region=us-central1 --no-async --max-wait=30m + +POSITIONAL ARGUMENTS + Instance resource - The Secure Source Manager instance to delete. 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 instance on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + INSTANCE + ID of the instance or fully qualified identifier for the instance. + + To set the instance attribute: + ▸ provide the argument instance on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Secure Source Manager location. + + To set the region attribute: + ▸ provide the argument instance on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. The default is True. Enabled by default, use --no-async to + disable. + + --max-wait=MAX_WAIT; default="60m" + Time to synchronously wait for the operation to complete, after which + the operation continues asynchronously. Ignored if --no-async isn't + specified. See $ gcloud topic datetimes for information on time + formats. + +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: + + $ gcloud alpha source-manager instances delete + + $ gcloud beta source-manager instances delete + diff --git a/gcloud/source-manager/instances/describe b/gcloud/source-manager/instances/describe new file mode 100644 index 000000000..cb21b82f6 --- /dev/null +++ b/gcloud/source-manager/instances/describe @@ -0,0 +1,69 @@ +NAME + gcloud source-manager instances describe - describe a Secure Source Manager + instance + +SYNOPSIS + gcloud source-manager instances describe (INSTANCE : --region=REGION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Get details of a Secure Source Manager instance. + +EXAMPLES + To describe a Secure Source Manager instance named 'my-instance' in + location 'us-central1' under the current project, run: + + $ gcloud source-manager instances describe my-instance \ + --region=us-central1 + +POSITIONAL ARGUMENTS + Instance resource - The instance you want to describe. 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 instance on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + INSTANCE + ID of the instance or fully qualified identifier for the instance. + + To set the instance attribute: + ▸ provide the argument instance on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Secure Source Manager location. + + To set the region attribute: + ▸ provide the argument instance on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + +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. + +API REFERENCE + This command uses the securesourcemanager/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/secure-source-manager + +NOTES + These variants are also available: + + $ gcloud alpha source-manager instances describe + + $ gcloud beta source-manager instances describe + diff --git a/gcloud/source-manager/instances/get-iam-policy b/gcloud/source-manager/instances/get-iam-policy new file mode 100644 index 000000000..f1867c5ca --- /dev/null +++ b/gcloud/source-manager/instances/get-iam-policy @@ -0,0 +1,96 @@ +NAME + gcloud source-manager instances get-iam-policy - get the IAM policy for a + Secure Source Manager instance + +SYNOPSIS + gcloud source-manager instances get-iam-policy (INSTANCE : --region=REGION) + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Get the IAM policy for a Secure Source Manager instance. + +EXAMPLES + To get the IAM policy for an instance named 'my-instance' in location + 'us-central1', run: + + $ gcloud source-manager instances get-iam-policy my-instance \ + --region=us-central1 + +POSITIONAL ARGUMENTS + Instance resource - The Secure Source Manager instance for which to get + the IAM policy. 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 instance on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + INSTANCE + ID of the instance or fully qualified identifier for the instance. + + To set the instance attribute: + ▸ provide the argument instance on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Secure Source Manager location. + + To set the region attribute: + ▸ provide the argument instance on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + +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. + +API REFERENCE + This command uses the securesourcemanager/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/secure-source-manager + +NOTES + These variants are also available: + + $ gcloud alpha source-manager instances get-iam-policy + + $ gcloud beta source-manager instances get-iam-policy + diff --git a/gcloud/source-manager/instances/help b/gcloud/source-manager/instances/help new file mode 100644 index 000000000..d3dd56abb --- /dev/null +++ b/gcloud/source-manager/instances/help @@ -0,0 +1,48 @@ +NAME + gcloud source-manager instances - manage Secure Source Manager instances + +SYNOPSIS + gcloud source-manager instances COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Secure Source Manager instances. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + add-iam-policy-binding + Add an IAM policy binding to a Secure Source Manager instance. + + create + Create a Secure Source Manager instance. + + delete + Delete a Secure Source Manager instance. + + describe + Describe a Secure Source Manager instance. + + get-iam-policy + Get the IAM policy for a Secure Source Manager instance. + + list + List Secure Source Manager instances. + + remove-iam-policy-binding + Remove an IAM policy binding to a Secure Source Manager instance. + + set-iam-policy + Set the IAM policy for a Secure Source Manager instance. + +NOTES + These variants are also available: + + $ gcloud alpha source-manager instances + + $ gcloud beta source-manager instances + diff --git a/gcloud/source-manager/instances/list b/gcloud/source-manager/instances/list new file mode 100644 index 000000000..4340bfe83 --- /dev/null +++ b/gcloud/source-manager/instances/list @@ -0,0 +1,88 @@ +NAME + gcloud source-manager instances list - list Secure Source Manager instances + +SYNOPSIS + gcloud source-manager instances list --region=REGION [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List all instances on your Secure Source Manager. + +EXAMPLES + To list all Secure Source Manager instances in location 'us-central1' under + the current project, run: + + $ gcloud source-manager instances list --region=us-central1 + +REQUIRED FLAGS + Location resource - The location you want to list the instances for. This + represents a Cloud 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 --region on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --region=REGION + ID of the location or fully qualified identifier for the location. + + To set the region attribute: + ▸ provide the argument --region on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +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. + +API REFERENCE + This command uses the securesourcemanager/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/secure-source-manager + +NOTES + These variants are also available: + + $ gcloud alpha source-manager instances list + + $ gcloud beta source-manager instances list + diff --git a/gcloud/source-manager/instances/remove-iam-policy-binding b/gcloud/source-manager/instances/remove-iam-policy-binding new file mode 100644 index 000000000..c2ee3317c --- /dev/null +++ b/gcloud/source-manager/instances/remove-iam-policy-binding @@ -0,0 +1,97 @@ +NAME + gcloud source-manager instances remove-iam-policy-binding - remove an IAM + policy binding to a Secure Source Manager instance + +SYNOPSIS + gcloud source-manager instances remove-iam-policy-binding + (INSTANCE : --region=REGION) --member=PRINCIPAL --role=ROLE + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Remove an IAM policy binding to a Secure Source Manager instance. + +EXAMPLES + To remove an IAM policy binding for the role of 'roles/editor' for the user + 'test-user@gmail.com' with instance named 'my-instance' and location + 'us-central1', run: + + $ gcloud source-manager instances remove-iam-policy-binding \ + my-instance --region='us-central1' \ + --member='user:test-user@gmail.com' --role='roles/editor' + + See https://cloud.google.com/iam/docs/managing-policies for details of + policy role and member types. + +POSITIONAL ARGUMENTS + Instance resource - The instance for which to remove the IAM policy + binding. 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 instance on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + INSTANCE + ID of the instance or fully qualified identifier for the instance. + + To set the instance attribute: + ▸ provide the argument instance on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Secure Source Manager location. + + To set the region attribute: + ▸ provide the argument instance on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + +REQUIRED FLAGS + --member=PRINCIPAL + The principal to remove the binding for. Should be of the form + user|group|serviceAccount:email or domain:domain. + + Examples: user:test-user@gmail.com, group:admins@example.com, + serviceAccount:test123@example.domain.com, or + domain:example.domain.com. + + Deleted principals have an additional deleted: prefix and a ?uid=UID + suffix, where UID is a unique identifier for the principal. Example: + deleted:user:test-user@gmail.com?uid=123456789012345678901. + + Some resources also accept the following special values: + ◆ allUsers - Special identifier that represents anyone who is on the + internet, with or without a Google account. + ◆ allAuthenticatedUsers - Special identifier that represents anyone + who is authenticated with a Google account or a service account. + + --role=ROLE + The role to remove the principal from. + +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. + +API REFERENCE + This command uses the securesourcemanager/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/secure-source-manager + +NOTES + These variants are also available: + + $ gcloud alpha source-manager instances remove-iam-policy-binding + + $ gcloud beta source-manager instances remove-iam-policy-binding + diff --git a/gcloud/source-manager/instances/set-iam-policy b/gcloud/source-manager/instances/set-iam-policy new file mode 100644 index 000000000..c0810e697 --- /dev/null +++ b/gcloud/source-manager/instances/set-iam-policy @@ -0,0 +1,76 @@ +NAME + gcloud source-manager instances set-iam-policy - set the IAM policy for a + Secure Source Manager instance + +SYNOPSIS + gcloud source-manager instances set-iam-policy (INSTANCE : --region=REGION) + POLICY_FILE [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Set the IAM policy for a Secure Source Manager instance. + +EXAMPLES + To set the IAM policy for an instance named 'my-instance' in location + 'us-central' to content of policy.json , run: + + $ gcloud source-manager instances set-iam-policy my-instance \ + --region=us-central1 policy.json + +POSITIONAL ARGUMENTS + Instance resource - The Secure Source Manager instance for which to set + the IAM policy. 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 instance on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + INSTANCE + ID of the instance or fully qualified identifier for the instance. + + To set the instance attribute: + ▸ provide the argument instance on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Secure Source Manager location. + + To set the region attribute: + ▸ provide the argument instance on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + + POLICY_FILE + Path to a local JSON or YAML formatted file containing a valid policy. + + The output of the get-iam-policy command is a valid file, as is any + JSON or YAML file conforming to the structure of a Policy + (https://cloud.google.com/iam/reference/rest/v1/Policy). + +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. + +API REFERENCE + This command uses the securesourcemanager/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/secure-source-manager + +NOTES + These variants are also available: + + $ gcloud alpha source-manager instances set-iam-policy + + $ gcloud beta source-manager instances set-iam-policy + diff --git a/gcloud/source-manager/locations/help b/gcloud/source-manager/locations/help new file mode 100644 index 000000000..9eced7299 --- /dev/null +++ b/gcloud/source-manager/locations/help @@ -0,0 +1,27 @@ +NAME + gcloud source-manager locations - manage Secure Source Manager locations + +SYNOPSIS + gcloud source-manager locations COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Secure Source Manager locations. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + list + List Secure Source Manager locations. + +NOTES + These variants are also available: + + $ gcloud alpha source-manager locations + + $ gcloud beta source-manager locations + diff --git a/gcloud/source-manager/locations/list b/gcloud/source-manager/locations/list new file mode 100644 index 000000000..040f9c34b --- /dev/null +++ b/gcloud/source-manager/locations/list @@ -0,0 +1,69 @@ +NAME + gcloud source-manager locations list - list Secure Source Manager locations + +SYNOPSIS + gcloud source-manager locations list [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List all locations where Secure Source Manager is available. + +EXAMPLES + To list all locations where Secure Source Manager is available for the + current project, run: + + $ gcloud source-manager locations list + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +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. + +API REFERENCE + This command uses the securesourcemanager/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/secure-source-manager + +NOTES + These variants are also available: + + $ gcloud alpha source-manager locations list + + $ gcloud beta source-manager locations list + diff --git a/gcloud/source-manager/operations/describe b/gcloud/source-manager/operations/describe new file mode 100644 index 000000000..c50e50c63 --- /dev/null +++ b/gcloud/source-manager/operations/describe @@ -0,0 +1,69 @@ +NAME + gcloud source-manager operations describe - describe a Secure Source + Manager operation + +SYNOPSIS + gcloud source-manager operations describe (OPERATION : --region=REGION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Get details of a Secure Source Manager operation. + +EXAMPLES + To describe a Secure Source Manager operation named 'my-operation' in + location 'us-central1' under the current project, run: + + $ gcloud source-manager operations describe my-operation \ + --region=us-central1 + +POSITIONAL ARGUMENTS + Operation resource - The operation you want to describe. 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 operation on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + OPERATION + ID of the operation or fully qualified identifier for the operation. + + To set the operation attribute: + ▸ provide the argument operation on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Secure Source Manager location. + + To set the region attribute: + ▸ provide the argument operation on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + +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. + +API REFERENCE + This command uses the securesourcemanager/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/secure-source-manager + +NOTES + These variants are also available: + + $ gcloud alpha source-manager operations describe + + $ gcloud beta source-manager operations describe + diff --git a/gcloud/source-manager/operations/help b/gcloud/source-manager/operations/help new file mode 100644 index 000000000..71abf1bc5 --- /dev/null +++ b/gcloud/source-manager/operations/help @@ -0,0 +1,30 @@ +NAME + gcloud source-manager operations - manage Secure Source Manager operations + +SYNOPSIS + gcloud source-manager operations COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Secure Source Manager operations. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + Describe a Secure Source Manager operation. + + list + List Secure Source Manager operations. + +NOTES + These variants are also available: + + $ gcloud alpha source-manager operations + + $ gcloud beta source-manager operations + diff --git a/gcloud/source-manager/operations/list b/gcloud/source-manager/operations/list new file mode 100644 index 000000000..d3e1023f5 --- /dev/null +++ b/gcloud/source-manager/operations/list @@ -0,0 +1,89 @@ +NAME + gcloud source-manager operations list - list Secure Source Manager + operations + +SYNOPSIS + gcloud source-manager operations list --region=REGION [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List all Secure Source Manager operations. + +EXAMPLES + To list all Secure Source Manager operations in location 'us-central1' + under the current project, run: + + $ gcloud source-manager operations list --region=us-central1 + +REQUIRED FLAGS + Location resource - The location you want to list the operations for. This + represents a Cloud 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 --region on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --region=REGION + ID of the location or fully qualified identifier for the location. + + To set the region attribute: + ▸ provide the argument --region on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +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. + +API REFERENCE + This command uses the securesourcemanager/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/secure-source-manager + +NOTES + These variants are also available: + + $ gcloud alpha source-manager operations list + + $ gcloud beta source-manager operations list + diff --git a/gcloud/source-manager/repos/add-iam-policy-binding b/gcloud/source-manager/repos/add-iam-policy-binding new file mode 100644 index 000000000..f49e46f46 --- /dev/null +++ b/gcloud/source-manager/repos/add-iam-policy-binding @@ -0,0 +1,98 @@ +NAME + gcloud source-manager repos add-iam-policy-binding - add an IAM policy + binding to a Secure Source Manager repository + +SYNOPSIS + gcloud source-manager repos add-iam-policy-binding + (REPOSITORY : --region=REGION) --member=PRINCIPAL --role=ROLE + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Add an IAM policy binding to a Secure Source Manager repository. + +EXAMPLES + To add an IAM policy binding for the Repository Admin role + (roles/securesourcemanager.repoAdmin) for the user test-user@gmail.com in a + repository named my-repo and location us-central1, run the following + command: + + $ gcloud source-manager repos add-iam-policy-binding my-repo \ + --region=us-central1 --member=user:test-user@gmail.com \ + --role=roles/securesourcemanager.repoAdmin + + See https://cloud.google.com/iam/docs/managing-policies for details of + policy role and member types. + +POSITIONAL ARGUMENTS + Repository resource - Secure Source Manager repository to add the IAM + policy binding to. 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 repository on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + REPOSITORY + ID of the repository or fully qualified identifier for the + repository. + + To set the repository attribute: + ▸ provide the argument repository on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Secure Source Manager location. + + To set the region attribute: + ▸ provide the argument repository on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + +REQUIRED FLAGS + --member=PRINCIPAL + The principal to add the binding for. Should be of the form + user|group|serviceAccount:email or domain:domain. + + Examples: user:test-user@gmail.com, group:admins@example.com, + serviceAccount:test123@example.domain.com, or + domain:example.domain.com. + + Some resources also accept the following special values: + ◆ allUsers - Special identifier that represents anyone who is on the + internet, with or without a Google account. + ◆ allAuthenticatedUsers - Special identifier that represents anyone + who is authenticated with a Google account or a service account. + + --role=ROLE + Role name to assign to the principal. The role name is the complete + path of a predefined role, such as roles/logging.viewer, or the role ID + for a custom role, such as + organizations/{ORGANIZATION_ID}/roles/logging.viewer. + +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. + +API REFERENCE + This command uses the securesourcemanager/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/secure-source-manager + +NOTES + These variants are also available: + + $ gcloud alpha source-manager repos add-iam-policy-binding + + $ gcloud beta source-manager repos add-iam-policy-binding + diff --git a/gcloud/source-manager/repos/create b/gcloud/source-manager/repos/create new file mode 100644 index 000000000..a8b98417f --- /dev/null +++ b/gcloud/source-manager/repos/create @@ -0,0 +1,94 @@ +NAME + gcloud source-manager repos create - create a Secure Source Manager + repository + +SYNOPSIS + gcloud source-manager repos create (REPOSITORY : --region=REGION) + --instance=INSTANCE [--description=DESCRIPTION] + [--default-branch=DEFAULT_BRANCH + --gitignores=[GITIGNORES,...] --license=LICENSE --readme=README] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create a Secure Source Manager repository. + +EXAMPLES + To create a repository called 'my-repo' in location 'us-central1' in + instance 'my-instance', run the following command: + + $ gcloud source-manager repos create my-repo --region=us-central1 \ + --instance=my-instance + +POSITIONAL ARGUMENTS + Repository resource - The Secure Source Manager repository to create. 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 repository on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + REPOSITORY + ID of the repository or fully qualified identifier for the + repository. + + To set the repository attribute: + ▸ provide the argument repository on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Secure Source Manager location. + + To set the region attribute: + ▸ provide the argument repository on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + +REQUIRED FLAGS + --instance=INSTANCE + A Secure Source Manager instance ID. + +OPTIONAL FLAGS + --description=DESCRIPTION + Description of the repository. Cannot exceed 500 characters. + + Repository initialization configuration. + + --default-branch=DEFAULT_BRANCH + Default branch name of the repository. + + --gitignores=[GITIGNORES,...] + List of gitignore template names user can choose from. Full list can + be found here: + https://cloud.google.com/secure-source-manager/docs/reference/rest/v1/projects.locations.repositories#InitialConfig + + --license=LICENSE + License template name user can choose from. Full list can be found + here: + https://cloud.google.com/secure-source-manager/docs/reference/rest/v1/projects.locations.repositories#InitialConfig + + --readme=README + README template name. Valid template name(s) are: default. + +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: + + $ gcloud alpha source-manager repos create + + $ gcloud beta source-manager repos create + diff --git a/gcloud/source-manager/repos/delete b/gcloud/source-manager/repos/delete new file mode 100644 index 000000000..095134973 --- /dev/null +++ b/gcloud/source-manager/repos/delete @@ -0,0 +1,69 @@ +NAME + gcloud source-manager repos delete - delete a Secure Source Manager + repository + +SYNOPSIS + gcloud source-manager repos delete (REPOSITORY : --region=REGION) + [--allow-missing] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete a Secure Source Manager repository. + +EXAMPLES + To delete a repository called my-repo in location us-central1, run the + following command: + + $ gcloud source-manager repos delete my-repo --region=us-central1 + +POSITIONAL ARGUMENTS + Repository resource - The Secure Source Manager repository to delete. 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 repository on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + REPOSITORY + ID of the repository or fully qualified identifier for the + repository. + + To set the repository attribute: + ▸ provide the argument repository on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Secure Source Manager location. + + To set the region attribute: + ▸ provide the argument repository on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + +FLAGS + --allow-missing + If set to true, and the resource is not found, the request will succeed + but no action will be taken on the server. + +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: + + $ gcloud alpha source-manager repos delete + + $ gcloud beta source-manager repos delete + diff --git a/gcloud/source-manager/repos/describe b/gcloud/source-manager/repos/describe new file mode 100644 index 000000000..9476b4f9d --- /dev/null +++ b/gcloud/source-manager/repos/describe @@ -0,0 +1,69 @@ +NAME + gcloud source-manager repos describe - describe a Secure Source Manager + repository + +SYNOPSIS + gcloud source-manager repos describe (REPOSITORY : --region=REGION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Get metadata of a Secure Source Manager repository. + +EXAMPLES + To describe a repository called my-repo in location us-central1, run the + following command: + + $ gcloud source-manager repos describe my-repo --region=us-central1 + +POSITIONAL ARGUMENTS + Repository resource - The Secure Source Manager repository to describe. + 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 repository on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + REPOSITORY + ID of the repository or fully qualified identifier for the + repository. + + To set the repository attribute: + ▸ provide the argument repository on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Secure Source Manager location. + + To set the region attribute: + ▸ provide the argument repository on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + +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. + +API REFERENCE + This command uses the securesourcemanager/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/secure-source-manager + +NOTES + These variants are also available: + + $ gcloud alpha source-manager repos describe + + $ gcloud beta source-manager repos describe + diff --git a/gcloud/source-manager/repos/get-iam-policy b/gcloud/source-manager/repos/get-iam-policy new file mode 100644 index 000000000..5ed97fb7d --- /dev/null +++ b/gcloud/source-manager/repos/get-iam-policy @@ -0,0 +1,97 @@ +NAME + gcloud source-manager repos get-iam-policy - get the IAM policy for a + Secure Source Manager repository + +SYNOPSIS + gcloud source-manager repos get-iam-policy (REPOSITORY : --region=REGION) + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Get the IAM policy for a Secure Source Manager repository. + +EXAMPLES + To get the IAM policy for an repository named my-repo in location + us-central1, run the following command: + + $ gcloud source-manager repos get-iam-policy my-repo \ + --region=us-central1 + +POSITIONAL ARGUMENTS + Repository resource - Secure Source Manager repository to get the IAM + policy from. 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 repository on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + REPOSITORY + ID of the repository or fully qualified identifier for the + repository. + + To set the repository attribute: + ▸ provide the argument repository on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Secure Source Manager location. + + To set the region attribute: + ▸ provide the argument repository on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + +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. + +API REFERENCE + This command uses the securesourcemanager/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/secure-source-manager + +NOTES + These variants are also available: + + $ gcloud alpha source-manager repos get-iam-policy + + $ gcloud beta source-manager repos get-iam-policy + diff --git a/gcloud/source-manager/repos/help b/gcloud/source-manager/repos/help new file mode 100644 index 000000000..947428a68 --- /dev/null +++ b/gcloud/source-manager/repos/help @@ -0,0 +1,51 @@ +NAME + gcloud source-manager repos - manage Secure Source Manager repositories + +SYNOPSIS + gcloud source-manager repos COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Secure Source Manager repositories. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + add-iam-policy-binding + Add an IAM policy binding to a Secure Source Manager repository. + + create + Create a Secure Source Manager repository. + + delete + Delete a Secure Source Manager repository. + + describe + Describe a Secure Source Manager repository. + + get-iam-policy + Get the IAM policy for a Secure Source Manager repository. + + list + List all repositories under a Secure Source Manager instance. + + remove-iam-policy-binding + Remove an IAM policy binding from a Secure Source Manager repository. + + set-iam-policy + Set the IAM policy for a Secure Source Manager repository. + + update + Update a Secure Source Manager repository. + +NOTES + These variants are also available: + + $ gcloud alpha source-manager repos + + $ gcloud beta source-manager repos + diff --git a/gcloud/source-manager/repos/list b/gcloud/source-manager/repos/list new file mode 100644 index 000000000..aa8bb190c --- /dev/null +++ b/gcloud/source-manager/repos/list @@ -0,0 +1,68 @@ +NAME + gcloud source-manager repos list - list all repositories under a Secure + Source Manager instance + +SYNOPSIS + gcloud source-manager repos list --instance=INSTANCE --region=REGION + [--limit=LIMIT] [--page-size=PAGE_SIZE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List Secure Source Manager repositories. + +EXAMPLES + To list repositories in location us-central1 under instance my-instance, + run the following command: + + $ gcloud source-manager repos list --region=us-central1 \ + --instance=my-instance + +REQUIRED FLAGS + --instance=INSTANCE + A Secure Source Manager instance ID. + + Location resource - The Secure Source Manager location to list. This + represents a Cloud 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 --region on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --region=REGION + ID of the location or fully qualified identifier for the location. + + To set the region attribute: + ▸ provide the argument --region on the command line. + +LIST COMMAND FLAGS + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + +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: + + $ gcloud alpha source-manager repos list + + $ gcloud beta source-manager repos list + diff --git a/gcloud/source-manager/repos/remove-iam-policy-binding b/gcloud/source-manager/repos/remove-iam-policy-binding new file mode 100644 index 000000000..7c2d808c9 --- /dev/null +++ b/gcloud/source-manager/repos/remove-iam-policy-binding @@ -0,0 +1,99 @@ +NAME + gcloud source-manager repos remove-iam-policy-binding - remove an IAM + policy binding from a Secure Source Manager repository + +SYNOPSIS + gcloud source-manager repos remove-iam-policy-binding + (REPOSITORY : --region=REGION) --member=PRINCIPAL --role=ROLE + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Remove an IAM policy binding to a Secure Source Manager repository. + +EXAMPLES + To remove the Repository Admin IAM role + (roles/securesourcemanager.repoAdmin) binding from the user + test-user@gmail.com in a repository named my-repo and location us-central1, + run the following command: + + $ gcloud source-manager repos remove-iam-policy-binding my-repo \ + --region=us-central1 --member=user:test-user@gmail.com \ + --role=roles/securesourcemanager.repoAdmin + + See https://cloud.google.com/iam/docs/managing-policies for details of + policy role and member types. + +POSITIONAL ARGUMENTS + Repository resource - Secure Source Manager repository to remove the IAM + policy binding from. 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 repository on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + REPOSITORY + ID of the repository or fully qualified identifier for the + repository. + + To set the repository attribute: + ▸ provide the argument repository on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Secure Source Manager location. + + To set the region attribute: + ▸ provide the argument repository on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + +REQUIRED FLAGS + --member=PRINCIPAL + The principal to remove the binding for. Should be of the form + user|group|serviceAccount:email or domain:domain. + + Examples: user:test-user@gmail.com, group:admins@example.com, + serviceAccount:test123@example.domain.com, or + domain:example.domain.com. + + Deleted principals have an additional deleted: prefix and a ?uid=UID + suffix, where UID is a unique identifier for the principal. Example: + deleted:user:test-user@gmail.com?uid=123456789012345678901. + + Some resources also accept the following special values: + ◆ allUsers - Special identifier that represents anyone who is on the + internet, with or without a Google account. + ◆ allAuthenticatedUsers - Special identifier that represents anyone + who is authenticated with a Google account or a service account. + + --role=ROLE + The role to remove the principal from. + +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. + +API REFERENCE + This command uses the securesourcemanager/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/secure-source-manager + +NOTES + These variants are also available: + + $ gcloud alpha source-manager repos remove-iam-policy-binding + + $ gcloud beta source-manager repos remove-iam-policy-binding + diff --git a/gcloud/source-manager/repos/set-iam-policy b/gcloud/source-manager/repos/set-iam-policy new file mode 100644 index 000000000..be793b8d4 --- /dev/null +++ b/gcloud/source-manager/repos/set-iam-policy @@ -0,0 +1,77 @@ +NAME + gcloud source-manager repos set-iam-policy - set the IAM policy for a + Secure Source Manager repository + +SYNOPSIS + gcloud source-manager repos set-iam-policy (REPOSITORY : --region=REGION) + POLICY_FILE [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Set the IAM policy for a Secure Source Manager repository. + +EXAMPLES + To set the IAM policy for a repository named my-repo in location us-central + to the content of policy.json , run the following command: + + $ gcloud source-manager repos set-iam-policy my-repo \ + --region=us-central1 policy.json + +POSITIONAL ARGUMENTS + Repository resource - Secure Source Manager repository to set the IAM + policy on. 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 repository on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + REPOSITORY + ID of the repository or fully qualified identifier for the + repository. + + To set the repository attribute: + ▸ provide the argument repository on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Secure Source Manager location. + + To set the region attribute: + ▸ provide the argument repository on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + + POLICY_FILE + Path to a local JSON or YAML formatted file containing a valid policy. + + The output of the get-iam-policy command is a valid file, as is any + JSON or YAML file conforming to the structure of a Policy + (https://cloud.google.com/iam/reference/rest/v1/Policy). + +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. + +API REFERENCE + This command uses the securesourcemanager/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/secure-source-manager + +NOTES + These variants are also available: + + $ gcloud alpha source-manager repos set-iam-policy + + $ gcloud beta source-manager repos set-iam-policy + diff --git a/gcloud/source-manager/repos/update b/gcloud/source-manager/repos/update new file mode 100644 index 000000000..1cbd0d207 --- /dev/null +++ b/gcloud/source-manager/repos/update @@ -0,0 +1,73 @@ +NAME + gcloud source-manager repos update - update a Secure Source Manager + repository + +SYNOPSIS + gcloud source-manager repos update (REPOSITORY : --region=REGION) + [--description=DESCRIPTION] [--validate-only] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Update a Secure Source Manager repository. + +EXAMPLES + To update the description of a repository called my-repo in location + us-central1, run the following command: + + $ gcloud source-manager repos update my-repo \ + --description="new description" --region=us-central1 + +POSITIONAL ARGUMENTS + Repository resource - The Secure Source Manager repository to update. 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 repository on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + REPOSITORY + ID of the repository or fully qualified identifier for the + repository. + + To set the repository attribute: + ▸ provide the argument repository on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Secure Source Manager location. + + To set the region attribute: + ▸ provide the argument repository on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + +FLAGS + --description=DESCRIPTION + Description of the repository. Cannot exceed 500 characters. + + --validate-only + If set to true, the request is validated and the user is provided with + an expected result, but no actual change is made. + +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: + + $ gcloud alpha source-manager repos update + + $ gcloud beta source-manager repos update + diff --git a/gcloud/storage/restore b/gcloud/storage/restore index eea820a6b..81e05b25e 100644 --- a/gcloud/storage/restore +++ b/gcloud/storage/restore @@ -4,7 +4,9 @@ NAME SYNOPSIS gcloud storage restore [URLS ...] [--all-versions, -a] [--async] [--[no-]preserve-acl, -p] [--read-paths-from-stdin, -I] - [--allow-overwrite --deleted-after-time=DELETED_AFTER_TIME + [--allow-overwrite --created-after-time=CREATED_AFTER_TIME + --created-before-time=CREATED_BEFORE_TIME + --deleted-after-time=DELETED_AFTER_TIME --deleted-before-time=DELETED_BEFORE_TIME] [--if-generation-match=GENERATION --if-metageneration-match=METAGENERATION] [GCLOUD_WIDE_FLAG ...] @@ -19,49 +21,74 @@ EXAMPLES $ gcloud storage restore gs://bucket#123 - Restore several soft-deleted buckets with generations: + Restore several soft-deleted buckets with generations: $ gcloud storage restore gs://bucket1#123 gs://bucket2#456 - Restore latest soft-deleted version of object in a bucket. + Restore latest soft-deleted version of object in a bucket. $ gcloud storage restore gs://bucket/file1.txt - Restore a specific soft-deleted version of object in a bucket by specifying - the generation. + Restore a specific soft-deleted version of object in a bucket by specifying the generation. $ gcloud storage restore gs://bucket/file1.txt#123 - Restore all soft-deleted versions of object in a bucket. + Restore all soft-deleted versions of object in a bucket. $ gcloud storage restore gs://bucket/file1.txt --all-versions - Restore several objects in a bucket (with or without generation): + Restore several objects in a bucket (with or without generation): $ gcloud storage restore gs://bucket/file1.txt \ - gs://bucket/file2.txt#456 + gs://bucket/file2.txt#456 - Restore the latest soft-deleted version of all text objects in a bucket: + Restore the latest soft-deleted version of all text objects in a bucket: $ gcloud storage restore gs://bucket/**.txt - Restore a list of objects read from stdin (with or without generation): + Restore a list of objects read from stdin (with or without generation): $ cat list-of-files.txt | gcloud storage restore \ - --read-paths-from-stdin + --read-paths-from-stdin - Restore object with its original ACL policy: + Restore object with its original ACL policy: $ gcloud storage restore gs://bucket/file1.txt --preserve-acl - Restore all objects in a bucket asynchronously: + Restore all objects in a bucket asynchronously: $ gcloud storage restore gs://bucket/** --async - Restore all text files in a bucket asynchronously: + Restore all text files in a bucket asynchronously: $ gcloud storage restore gs://bucket/**.txt --async + Restore objects created within a specific time range: + + $ gcloud storage restore gs://bucket/** --async \ + --created-after-time="2023-01-01T00:00:00Z" \ + --created-before-time="2023-01-31T23:59:59Z" + + Restore objects soft-deleted within a specific time range: + + $ gcloud storage restore gs://bucket/** --async \ + --deleted-after-time="2023-01-01T00:00:00Z" \ + --deleted-before-time="2023-01-31T23:59:59Z" + + Restore objects using a combination of creation and deletion time filters: + + $ gcloud storage restore gs://bucket/** --async --allow-overwrite \ + --created-after-time="2023-01-01T00:00:00Z" \ + --deleted-after-time="2023-01-01T00:00:00Z" + + This command filters the objects that were live at 2023-01-01T00:00:00Z + and then soft-deleted afterwards. + + This combination of filters is especially helpful if there is a period of + erroneous overwrites. They allow you to go back to the point just before + the overwrites began. You will also need to set the --allow-overwrite + option to true. + POSITIONAL ARGUMENTS [URLS ...] The url of objects to list. @@ -104,6 +131,12 @@ FLAGS enabled, this will result in a noncurrent object. If versioning is not enabled, this will result in a soft-deleted object. + --created-after-time=CREATED_AFTER_TIME + Restores only the objects that were created after this time. + + --created-before-time=CREATED_BEFORE_TIME + Restores only the objects that were created before this time. + --deleted-after-time=DELETED_AFTER_TIME Restores only the objects that were soft-deleted after this time.