From 78d417f9014e20f275cef33af104d53848f7cb9e Mon Sep 17 00:00:00 2001 From: Automated Date: Wed, 10 Sep 2025 11:12:24 +0000 Subject: [PATCH] gcloud: Wed Sep 10 11:12:24 UTC 2025 --- gcloud/_version | 10 +- gcloud/alpha/cluster-director/clusters/create | 1496 +++++++++++------ gcloud/alpha/cluster-director/clusters/update | 195 ++- gcloud/alpha/composer/environments/create | 3 +- gcloud/alpha/compute/commitments/create | 8 +- gcloud/alpha/compute/disks/create | 4 + gcloud/alpha/compute/forwarding-rules/create | 7 - gcloud/alpha/compute/forwarding-rules/update | 8 +- .../compute/instances/network-interfaces/add | 6 +- .../instances/network-interfaces/update | 6 +- .../org-security-policies/associations/create | 6 +- .../org-security-policies/associations/delete | 6 +- .../org-security-policies/associations/list | 2 +- .../compute/org-security-policies/copy-rules | 8 +- .../compute/org-security-policies/create | 10 +- .../compute/org-security-policies/delete | 4 +- .../compute/org-security-policies/describe | 2 +- .../alpha/compute/org-security-policies/list | 6 +- .../compute/org-security-policies/list-rules | 7 +- .../alpha/compute/org-security-policies/move | 6 +- .../org-security-policies/rules/create | 8 +- .../org-security-policies/rules/delete | 8 +- .../org-security-policies/rules/describe | 8 +- .../org-security-policies/rules/update | 10 +- .../compute/org-security-policies/update | 8 +- gcloud/alpha/config/get | 6 + gcloud/alpha/config/help | 6 + gcloud/alpha/config/list | 6 + gcloud/alpha/config/set | 6 + gcloud/alpha/config/unset | 6 + gcloud/alpha/looker/instances/create | 4 +- .../firewall-endpoints/create | 7 +- gcloud/alpha/run/multi-region-services/delete | 4 +- .../alpha/run/multi-region-services/describe | 4 +- gcloud/alpha/run/multi-region-services/help | 4 +- gcloud/alpha/run/multi-region-services/list | 4 +- .../alpha/run/multi-region-services/replace | 4 +- gcloud/alpha/run/multi-region-services/update | 4 +- .../alpha/storage/batch-operations/jobs/list | 7 +- gcloud/alpha/transfer/agents/install | 16 + gcloud/beta/composer/environments/create | 3 +- .../compute/instances/network-interfaces/add | 6 +- .../instances/network-interfaces/update | 6 +- .../org-security-policies/associations/create | 6 +- .../org-security-policies/associations/delete | 6 +- .../org-security-policies/associations/list | 2 +- .../compute/org-security-policies/copy-rules | 8 +- .../beta/compute/org-security-policies/create | 10 +- .../beta/compute/org-security-policies/delete | 4 +- .../compute/org-security-policies/describe | 2 +- .../beta/compute/org-security-policies/list | 6 +- .../compute/org-security-policies/list-rules | 7 +- .../beta/compute/org-security-policies/move | 6 +- .../org-security-policies/rules/create | 6 +- .../org-security-policies/rules/delete | 6 +- .../org-security-policies/rules/describe | 8 +- .../org-security-policies/rules/update | 8 +- .../beta/compute/org-security-policies/update | 8 +- .../beta/compute/service-attachments/describe | 8 +- gcloud/beta/config/get | 6 + gcloud/beta/config/help | 6 + gcloud/beta/config/list | 6 + gcloud/beta/config/set | 6 + gcloud/beta/config/unset | 6 + gcloud/beta/run/multi-region-services/delete | 6 +- .../beta/run/multi-region-services/describe | 6 +- gcloud/beta/run/multi-region-services/help | 6 +- gcloud/beta/run/multi-region-services/list | 6 +- gcloud/beta/run/multi-region-services/replace | 6 +- gcloud/beta/run/multi-region-services/update | 6 +- gcloud/composer/environments/create | 3 +- .../instances/network-interfaces/update | 6 +- gcloud/compute/service-attachments/describe | 8 +- gcloud/config/get | 6 + gcloud/config/help | 6 + gcloud/config/list | 6 + gcloud/config/set | 6 + gcloud/config/unset | 6 + .../database-migration/migration-jobs/create | 67 +- .../database-migration/migration-jobs/update | 63 +- gcloud/looker/instances/create | 4 +- gcloud/run/deploy | 6 +- gcloud/run/help | 3 + gcloud/run/multi-region-services/delete | 69 + gcloud/run/multi-region-services/describe | 76 + gcloud/run/multi-region-services/help | 57 + gcloud/run/multi-region-services/list | 69 + gcloud/run/multi-region-services/replace | 53 + gcloud/run/multi-region-services/update | 590 +++++++ gcloud/storage/batch-operations/jobs/list | 2 +- gcloud/transfer/agents/install | 16 + 91 files changed, 2522 insertions(+), 712 deletions(-) create mode 100644 gcloud/run/multi-region-services/delete create mode 100644 gcloud/run/multi-region-services/describe create mode 100644 gcloud/run/multi-region-services/help create mode 100644 gcloud/run/multi-region-services/list create mode 100644 gcloud/run/multi-region-services/replace create mode 100644 gcloud/run/multi-region-services/update diff --git a/gcloud/_version b/gcloud/_version index 39c9f9c5b..00484b6b9 100644 --- a/gcloud/_version +++ b/gcloud/_version @@ -1,8 +1,8 @@ -Google Cloud SDK 537.0.0 -alpha 2025.08.29 -beta 2025.08.29 -bq 2.1.22 +Google Cloud SDK 538.0.0 +alpha 2025.09.05 +beta 2025.09.05 +bq 2.1.23 bundled-python3-unix 3.12.9 -core 2025.08.29 +core 2025.09.05 gcloud-crc32c 1.0.0 gsutil 5.35 diff --git a/gcloud/alpha/cluster-director/clusters/create b/gcloud/alpha/cluster-director/clusters/create index 98ef380f8..ce425007c 100644 --- a/gcloud/alpha/cluster-director/clusters/create +++ b/gcloud/alpha/cluster-director/clusters/create @@ -5,16 +5,98 @@ NAME 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] + (--config=[compute=COMPUTE],[description=DESCRIPTION],[labels=LABELS], + [name=NAME], + [networks=NETWORKS],[orchestrator=ORCHESTRATOR],[storages=STORAGES] + | [--compute-resource-disks=[boot=BOOT],[computeId=COMPUTEID], + [sizeGb=SIZEGB],[sourceImage=SOURCEIMAGE],[type=TYPE] + --compute-resources=[guestAcceleratorCount=GUESTACCELERATORCOUNT], + [guestAcceleratorType=GUESTACCELERATORTYPE],[machineType=MACHINETYPE], + [maxRunDuration=MAXRUNDURATION],[name=NAME], + [provisioningModel=PROVISIONINGMODEL], + [terminationAction=TERMINATIONACTION],[zone=ZONE] + --slurm-login-node=[count=COUNT],[enableOSLogin=ENABLEOSLOGIN], + [enablePublicIPs=ENABLEPUBLICIPS],[labels=LABELS], + [machineType=MACHINETYPE],[serviceAccountEmail=SERVICEACCOUNTEMAIL], + [serviceAccountScopes=SERVICEACCOUNTSCOPES], + [startupScript=STARTUPSCRIPT],[zone=ZONE] + --slurm-login-node-disks=[boot=BOOT], + [sizeGb=SIZEGB],[sourceImage=SOURCEIMAGE],[type=TYPE] + --slurm-node-sets=[computeId=COMPUTEID], + [enableIPForward=ENABLEIPFORWARD],[enableOSLogin=ENABLEOSLOGIN], + [enablePublicIPs=ENABLEPUBLICIPS],[labels=LABELS], + [maxDynamicNodeCount=MAXDYNAMICNODECOUNT],[name=NAME], + [serviceAccountEmail=SERVICEACCOUNTEMAIL], + [serviceAccountScopes=SERVICEACCOUNTSCOPES], + [startupScript=STARTUPSCRIPT],[staticNodeCount=STATICNODECOUNT] + --slurm-partitions=[exclusive=EXCLUSIVE], + [name=NAME],[nodesetIds=NODESETIDS] (--create-network=CREATE_NETWORK + | --network=NETWORK --subnet=SUBNET) + : --compute-resource-reservations=[computeId=COMPUTEID], + [key=KEY],[type=TYPE],[values=VALUES] + --create-filestores=[description=DESCRIPTION],[fileshare=FILESHARE], + [name=NAME],[protocol=PROTOCOL],[sizeGb=SIZEGB],[tier=TIER] + --create-gcs-buckets=[enableAutoclass=ENABLEAUTOCLASS], + [enableHNS=ENABLEHNS],[name=NAME],[storageClass=STORAGECLASS] + --create-lustres=[description=DESCRIPTION], + [filesystem=FILESYSTEM],[name=NAME],[sizeGb=SIZEGB] + --description=DESCRIPTION --filestores=[FILESTORES,...] + --gcs-buckets=[GCS_BUCKETS,...] --labels=[LABELS,...] + --lustres=[LUSTRES,...] + --slurm-config=[jobEpilogBashScripts=JOBEPILOGBASHSCRIPTS], + [jobPrologBashScripts=JOBPROLOGBASHSCRIPTS], + [prologEpilogTimeout=PROLOGEPILOGTIMEOUT],[prologFlags=PROLOGFLAGS], + [requeueExitCodes=REQUEUEEXITCODES], + [requeueHoldExitCodes=REQUEUEHOLDEXITCODES], + [taskEpilogBashScripts=TASKEPILOGBASHSCRIPTS], + [taskPrologBashScripts=TASKPROLOGBASHSCRIPTS] + --slurm-default-partition=SLURM_DEFAULT_PARTITION]) [--async] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Creates a Cluster Director resource. + (ALPHA) gcloud alpha cluster-director clusters create facilitates the + creation of a cluster resource. + + There are following ways to create a cluster: + ▪ Using granular flags to define cluster specs. + ▪ Using --config flag with cluster specs in JSON format. + + Please refer to the examples below for more details. EXAMPLES + To create a cluster my-cluster in location us-central1-a with granular + flags, run the following example: + + $ gcloud alpha cluster-director clusters create my-cluster \ + --location us-central1-a \ + --description "My cluster description" \ + --labels env=prod,client=gcloud-cli --create-network network0 \ + --create-filestores \ + name=locations/us-central1-a/instances/filestore0,\ + tier=TIER_BASIC_HDD,sizeGb={filestoreSize},fileshare={fileshare} \ + --filestores locations/us-central1-a/instances/filestore1 \ + --create-gcs-buckets name=bucket0 --gcs-buckets bucket1 \ + --create-lustres \ + name=locations/us-central1-a/instances/lustre0,\ + sizeGb={lustreSize},filesystem={filesystem} \ + --lustres locations/us-central1-a/instances/lustre1 \ + --compute-resources \ + name=compute0,zone=us-central1-a,machineType={machineType} \ + --compute-resource-disks \ + computeId=compute0,type={diskType},sizeGb={diskSize},boot=true,\ + sourceImage={family/image} \ + --compute-resource-reservations \ + computeId=compute0,type=RESERVATION_TYPE_SPECIFIC_RESERVATION,\ + values=zones/us-central1-a/reservations/{reservation} \ + --slurm-login-node \ + machineType={machineType},zone=us-central1-a \ + --slurm-login-node-disks \ + type={diskType},sizeGb={diskSize},boot=true,\ + sourceImage={family/image} \ + --slurm-node-sets name=nodeset0,computeId=compute0 \ + --slurm-partitions name=partition0,nodesetIds=[nodeset0] \ + --slurm-default-partition partition0 --format json + To create a cluster my-cluster in location us-central1-a with config in JSON string format run the following example: @@ -28,7 +110,7 @@ EXAMPLES --location=us-central1-a --config=my-cluster-config.json POSITIONAL ARGUMENTS - Cluster resource - Identifier. Name of the cluster. Formats: cluster | + Cluster resource - Name of the cluster resource. 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 @@ -60,543 +142,1000 @@ POSITIONAL ARGUMENTS ▸ 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. + Cluster configuration for provisioning. - compute - Sets compute value. + Exactly one of these must be specified: - resourceRequests - Sets resourceRequests value. + --config=[compute=COMPUTE],[description=DESCRIPTION],[labels=LABELS],[name=NAME],[networks=NETWORKS],[orchestrator=ORCHESTRATOR],[storages=STORAGES] + Configuration of the cluster specs in the form of a JSON object. Sets + config value. - disks - Sets disks value. + compute + Sets compute value. - boot - Sets boot value. + resourceRequests + Sets resourceRequests value. - sizeGb - Sets sizeGb value. + disks + Sets disks value. - sourceImage - Sets sourceImage value. + boot + Sets boot value. - type - Sets type value. + sizeGb + Required, sets sizeGb value. - guestAccelerators - Sets guestAccelerators value. + sourceImage + Sets sourceImage value. - acceleratorType - Sets acceleratorType value. + type + Required, sets type value. - count - Sets count value. + guestAccelerators + Sets guestAccelerators value. - id - Sets id value. + acceleratorType + Sets acceleratorType value. - machineType - Sets machineType value. + count + Sets count value. - maxRunDuration - Sets maxRunDuration value. + id + Sets id value. - provisioningModel - Sets provisioningModel value. + machineType + Sets machineType value. - reservationAffinity - Sets reservationAffinity value. + maxRunDuration + Sets maxRunDuration value. - key - Sets key value. + provisioningModel + Sets provisioningModel value. - type - Sets type value. + reservationAffinity + Sets reservationAffinity value. - values - Sets values value. + key + Sets key value. - terminationAction - Sets terminationAction value. + type + Sets type value. - zone - Sets zone value. + values + Sets values value. - description - Sets description value. + terminationAction + Sets terminationAction value. + + zone + Sets zone value. + + description + Sets description value. + + labels + Sets labels value. + + KEY + Sets KEY value. + + VALUE + Sets VALUE value. + + name + Sets name value. + + networks + Sets networks value. + + initializeParams + Sets initializeParams value. + + description + Sets description value. + + network + Sets network value. + + networkSource + Sets networkSource value. + + network + Sets network 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 + Required, sets sizeGb value. + + sourceImage + Sets sourceImage value. + + type + Required, sets type value. + + enableOsLogin + Sets enableOsLogin value. + + enablePublicIps + Sets enablePublicIps value. + + labels + Sets labels value. + + KEY + Sets KEY value. + + VALUE + Sets VALUE value. + + 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 + Sets KEY value. + + VALUE + Sets VALUE value. + + 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. + + 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. + + 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},terminationAction=string,zone=string}]},description=string,labels={string=string},name=string,networks=[{initializeParams={description=string,network=string},networkSource={network=string,subnetwork=string}}],orchestrator={slurm={config={prologEpilogTimeout=string,prologFlags,requeueExitCodes,requeueHoldExitCodes},defaultPartition=string,epilogBashScripts,loginNodes={count=int,disks=[{boot=boolean,sizeGb=int,sourceImage=string,type=string}],enableOsLogin=boolean,enablePublicIps=boolean,labels={string=string},machineType=string,serviceAccount={email=string,scopes},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},startupScript=string,staticNodeCount=int,storageConfigs=[{id=string,localMount=string}]}],partitions=[{exclusive=boolean,id=string,nodeSetIds=[string]}],prologBashScripts,taskEpilogBashScripts,taskPrologBashScripts}},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}},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"}, "terminationAction": "string", "zone": "string"}]}, "description": "string", "labels": {"string": "string"}, "name": "string", "networks": [{"initializeParams": {"description": "string", "network": "string"}, "networkSource": {"network": "string", "subnetwork": "string"}}], "orchestrator": {"slurm": {"config": {"prologEpilogTimeout": "string", "prologFlags", "requeueExitCodes", "requeueHoldExitCodes"}, "defaultPartition": "string", "epilogBashScripts", "loginNodes": {"count": int, "disks": [{"boot": boolean, "sizeGb": int, "sourceImage": "string", "type": "string"}], "enableOsLogin": boolean, "enablePublicIps": boolean, "labels": {"string": "string"}, "machineType": "string", "serviceAccount": {"email": "string", "scopes"}, "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"}, "startupScript": "string", "staticNodeCount": int, "storageConfigs": [{"id": "string", "localMount": "string"}]}], "partitions": [{"exclusive": boolean, "id": "string", "nodeSetIds": ["string"]}], "prologBashScripts", "taskEpilogBashScripts", "taskPrologBashScripts"}}, "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"}}, "storageSource": {"bucket": "string", "filestore": "string", "lustre": "string"}}]}' + + File Example: + + --config=path_to_file.(yaml|json) + + Flag Configurations to define cluster spec. + + --compute-resource-disks=[boot=BOOT],[computeId=COMPUTEID],[sizeGb=SIZEGB],[sourceImage=SOURCEIMAGE],[type=TYPE] + Parameters to define disk config for compute resource. + + For e.g. --compute-resource-disks + computeId={computeId},type={diskType},boot=true,sizeGb={diskSize},sourceImage={family/{image-family} + | {image}} + + Note: + ▫ for boot disk, all fields are required. + ▫ for non-boot disk, only computeId, type and sizeGb are + required. + + Required, sets compute_resource_disks value. + + boot + Sets boot value. + + computeId + Required, sets computeId value. + + sizeGb + Required, sets sizeGb value. + + sourceImage + Sets sourceImage value. + + type + Required, sets type value. + + Shorthand Example: + + --compute-resource-disks=boot=boolean,computeId=string,sizeGb=int,sourceImage=string,type=string --compute-resource-disks=boot=boolean,computeId=string,sizeGb=int,sourceImage=string,type=string + + JSON Example: + + --compute-resource-disks='[{"boot": boolean, "computeId": "string", "sizeGb": int, "sourceImage": "string", "type": "string"}]' + + File Example: + + --compute-resource-disks=path_to_file.(yaml|json) + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --compute-resources=[guestAcceleratorCount=GUESTACCELERATORCOUNT],[guestAcceleratorType=GUESTACCELERATORTYPE],[machineType=MACHINETYPE],[maxRunDuration=MAXRUNDURATION],[name=NAME],[provisioningModel=PROVISIONINGMODEL],[terminationAction=TERMINATIONACTION],[zone=ZONE] + Parameters to define cluster compute resource. + + For e.g. --compute-resources + name={computeId},zone={zone},machineType={machineType} + + Supported provisioningModel values: + ▫ PROVISIONING_MODEL_STANDARD + ▫ PROVISIONING_MODEL_SPOT + ▫ PROVISIONING_MODEL_FLEX_START + ▫ PROVISIONING_MODEL_RESERVATION_BOUND + + Supported terminationAction values: + ▫ TERMINATION_ACTION_DELETE + ▫ TERMINATION_ACTION_STOP. + + Required, sets compute_resources value. + + guestAcceleratorCount + Sets guestAcceleratorCount value. + + guestAcceleratorType + Sets guestAcceleratorType value. + + machineType + Required, sets machineType value. + + maxRunDuration + Sets maxRunDuration value. + + name + Required, sets name value. + + provisioningModel + Sets provisioningModel value. + + terminationAction + Sets terminationAction value. + + zone + Required, sets zone value. + + Shorthand Example: + + --compute-resources=guestAcceleratorCount=int,guestAcceleratorType=string,machineType=string,maxRunDuration=int,name=string,provisioningModel=string,terminationAction=string,zone=string --compute-resources=guestAcceleratorCount=int,guestAcceleratorType=string,machineType=string,maxRunDuration=int,name=string,provisioningModel=string,terminationAction=string,zone=string + + JSON Example: + + --compute-resources='[{"guestAcceleratorCount": int, "guestAcceleratorType": "string", "machineType": "string", "maxRunDuration": int, "name": "string", "provisioningModel": "string", "terminationAction": "string", "zone": "string"}]' + + File Example: + + --compute-resources=path_to_file.(yaml|json) + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --slurm-login-node=[count=COUNT],[enableOSLogin=ENABLEOSLOGIN],[enablePublicIPs=ENABLEPUBLICIPS],[labels=LABELS],[machineType=MACHINETYPE],[serviceAccountEmail=SERVICEACCOUNTEMAIL],[serviceAccountScopes=SERVICEACCOUNTSCOPES],[startupScript=STARTUPSCRIPT],[zone=ZONE] + Parameters to define slurm cluster login node. + + For e.g. --slurm-login-node + machineType={machineType},zone={zone},count={count},enableOSLogin=true,enablePublicIPs=true,serviceAccountEmail={serviceAccountEmail},serviceAccountScopes=[scope1,scope2],startupScript="echo + hello",labels="{key1=value1,key2=value2}" + + Defaults: + ▫ count: 1 + ▫ enableOSLogin: true + ▫ enablePublicIPs: true + + Note: + ▫ startupScript: + ◇ Either str or file_path + ◇ For file_path, only bash file format (.sh or .bash) is + supported. + ◇ For file_path, absolute or relative path to current work + directory is supported. + + Required, sets slurm_login_node value. + + count + Sets count value. + + enableOSLogin + Sets enableOSLogin value. + + enablePublicIPs + Sets enablePublicIPs value. + + labels + Sets labels value. + + KEY + Sets KEY value. + + VALUE + Sets VALUE value. + + machineType + Required, sets machineType value. + + serviceAccountEmail + Sets serviceAccountEmail value. + + serviceAccountScopes + Sets serviceAccountScopes value. + + startupScript + Sets startupScript value. + + zone + Required, sets zone value. + + Shorthand Example: + + --slurm-login-node=count=int,enableOSLogin=boolean,enablePublicIPs=boolean,labels={string=string},machineType=string,serviceAccountEmail=string,serviceAccountScopes,startupScript=string,zone=string + + JSON Example: + + --slurm-login-node='{"count": int, "enableOSLogin": boolean, "enablePublicIPs": boolean, "labels": {"string": "string"}, "machineType": "string", "serviceAccountEmail": "string", "serviceAccountScopes", "startupScript": "string", "zone": "string"}' + + File Example: + + --slurm-login-node=path_to_file.(yaml|json) + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --slurm-login-node-disks=[boot=BOOT],[sizeGb=SIZEGB],[sourceImage=SOURCEIMAGE],[type=TYPE] + Parameters to define disk config for slurm cluster login node. + + For e.g. --slurm-login-node-disks + type={diskType},boot=true,sizeGb={diskSize},sourceImage={family/{image-family} + | {image}} + + Note: + ▫ for boot disk, all fields are required. + ▫ for non-boot disk, only type and sizeGb are required. + + Required, sets slurm_login_node_disks value. + + boot + Sets boot value. + + sizeGb + Required, sets sizeGb value. + + sourceImage + Sets sourceImage value. + + type + Required, sets type value. + + Shorthand Example: + + --slurm-login-node-disks=[{boot=boolean,sizeGb=int,sourceImage=string,type=string}] --slurm-login-node-disks=[{boot=boolean,sizeGb=int,sourceImage=string,type=string}] + + JSON Example: + + --slurm-login-node-disks='[{"boot": boolean, "sizeGb": int, "sourceImage": "string", "type": "string"}]' + + File Example: + + --slurm-login-node-disks=path_to_file.(yaml|json) + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --slurm-node-sets=[computeId=COMPUTEID],[enableIPForward=ENABLEIPFORWARD],[enableOSLogin=ENABLEOSLOGIN],[enablePublicIPs=ENABLEPUBLICIPS],[labels=LABELS],[maxDynamicNodeCount=MAXDYNAMICNODECOUNT],[name=NAME],[serviceAccountEmail=SERVICEACCOUNTEMAIL],[serviceAccountScopes=SERVICEACCOUNTSCOPES],[startupScript=STARTUPSCRIPT],[staticNodeCount=STATICNODECOUNT] + Parameters to define slurm cluster nodeset config. + + For e.g. --slurm-node-sets + name={nodesetId},computeId={computeId},staticNodeCount={staticNodeCount},maxDynamicNodeCount={maxDynamicNodeCount},enableOSLogin=true,enableIPForward=false,enablePublicIPs=false,serviceAccountEmail={serviceAccountEmail},serviceAccountScopes=[scope1,scope2],startupScript="echo + hello",labels="{key1=value1,key2=value2}" + + Defaults: + ▫ staticNodeCount: 1 + ▫ enableOSLogin: true + + Note: + ▫ startupScript: + ◇ Either str or file_path + ◇ For file_path, only bash file format (.sh or .bash) is + supported. + ◇ For file_path, absolute or relative path to current work + directory is supported. + + Required, sets slurm_node_sets value. + + computeId + Required, sets computeId value. + + enableIPForward + Sets enableIPForward value. + + enableOSLogin + Sets enableOSLogin value. + + enablePublicIPs + Sets enablePublicIPs value. + + labels + Sets labels value. + + KEY + Sets KEY value. + + VALUE + Sets VALUE value. + + maxDynamicNodeCount + Sets maxDynamicNodeCount value. + + name + Required, sets name value. + + serviceAccountEmail + Sets serviceAccountEmail value. + + serviceAccountScopes + Sets serviceAccountScopes value. + + startupScript + Sets startupScript value. + + staticNodeCount + Sets staticNodeCount value. + + Shorthand Example: + + --slurm-node-sets=computeId=string,enableIPForward=boolean,enableOSLogin=boolean,enablePublicIPs=boolean,labels={string=string},maxDynamicNodeCount=int,name=string,serviceAccountEmail=string,serviceAccountScopes=[string],startupScript=string,staticNodeCount=int --slurm-node-sets=computeId=string,enableIPForward=boolean,enableOSLogin=boolean,enablePublicIPs=boolean,labels={string=string},maxDynamicNodeCount=int,name=string,serviceAccountEmail=string,serviceAccountScopes=[string],startupScript=string,staticNodeCount=int + + JSON Example: + + --slurm-node-sets='[{"computeId": "string", "enableIPForward": boolean, "enableOSLogin": boolean, "enablePublicIPs": boolean, "labels": {"string": "string"}, "maxDynamicNodeCount": int, "name": "string", "serviceAccountEmail": "string", "serviceAccountScopes": ["string"], "startupScript": "string", "staticNodeCount": int}]' + + File Example: + + --slurm-node-sets=path_to_file.(yaml|json) + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --slurm-partitions=[exclusive=EXCLUSIVE],[name=NAME],[nodesetIds=NODESETIDS] + Parameters to define slurm cluster partitions. + + For e.g. --slurm-partitions + name={partitionId},nodesetIds=[{nodesetId1},{nodesetId2}],exclusive=false. + + Required, sets slurm_partitions value. + + exclusive + Sets exclusive value. + + name + Required, sets name value. + + nodesetIds + Required, sets nodesetIds value. + + Shorthand Example: + + --slurm-partitions=exclusive=boolean,name=string,nodesetIds=[string] --slurm-partitions=exclusive=boolean,name=string,nodesetIds=[string] + + JSON Example: + + --slurm-partitions='[{"exclusive": boolean, "name": "string", "nodesetIds": ["string"]}]' + + File Example: + + --slurm-partitions=path_to_file.(yaml|json) + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --compute-resource-reservations=[computeId=COMPUTEID],[key=KEY],[type=TYPE],[values=VALUES] + Parameters to define reservation for compute resource. + + For e.g. --compute-resource-reservations + computeId={computeId},type=RESERVATION_TYPE_SPECIFIC_RESERVATION,values=zones/{zone}/reservations/{reservation} + + Supported type values: + ▫ RESERVATION_TYPE_NO_RESERVATION + ▫ RESERVATION_TYPE_ANY_RESERVATION + ▫ RESERVATION_TYPE_SPECIFIC_RESERVATION + + Defaults: + ▫ key: compute.googleapis.com/reservation-name (if type is + RESERVATION_TYPE_SPECIFIC_RESERVATION or + RESERVATION_TYPE_ANY_RESERVATION). + + Sets compute_resource_reservations value. + + computeId + Required, sets computeId value. + + key + Sets key value. + + type + Required, sets type value. + + values + Sets values value. + + Shorthand Example: + + --compute-resource-reservations=computeId=string,key=string,type=string,values --compute-resource-reservations=computeId=string,key=string,type=string,values + + JSON Example: + + --compute-resource-reservations='[{"computeId": "string", "key": "string", "type": "string", "values"}]' + + File Example: + + --compute-resource-reservations=path_to_file.(yaml|json) + + --create-filestores=[description=DESCRIPTION],[fileshare=FILESHARE],[name=NAME],[protocol=PROTOCOL],[sizeGb=SIZEGB],[tier=TIER] + Parameters to create a filestore instance. + + For e.g. --create-filestores + name=locations/{location}/instances/{filestore},tier=TIER_BASIC_HDD,sizeGb=100,fileshare=nfsshare + + Supported tier values: + ▫ TIER_BASIC_HDD + ▫ TIER_BASIC_SSD + ▫ TIER_HIGH_SCALE_SSD + ▫ TIER_ZONAL + ▫ TIER_ENTERPRISE + ▫ TIER_REGIONAL + + Supported protocol values: + ▫ PROTOCOL_NFSV3 + ▫ PROTOCOL_NFSV41 + ▫ If not specified, defaults to PROTOCOL_NFSV3 + + Defaults: + ▫ protocol: PROTOCOL_NFSV3. + + Sets create_filestores value. + + description + Sets description value. + + fileshare + Required, sets fileshare value. + + name + Required, sets name value. + + protocol + Sets protocol value. + + sizeGb + Required, sets sizeGb value. + + tier + Required, sets tier value. + + Shorthand Example: + + --create-filestores=description=string,fileshare=string,name=string,protocol=string,sizeGb=int,tier=string --create-filestores=description=string,fileshare=string,name=string,protocol=string,sizeGb=int,tier=string + + JSON Example: + + --create-filestores='[{"description": "string", "fileshare": "string", "name": "string", "protocol": "string", "sizeGb": int, "tier": "string"}]' + + File Example: + + --create-filestores=path_to_file.(yaml|json) + + --create-gcs-buckets=[enableAutoclass=ENABLEAUTOCLASS],[enableHNS=ENABLEHNS],[name=NAME],[storageClass=STORAGECLASS] + Parameters to create a Google Cloud Storage bucket. + + For e.g. --create-gcs-buckets name={bucket-path} + + Supported storageClass values: + ▫ STORAGE_CLASS_STANDARD + ▫ STORAGE_CLASS_NEARLINE + ▫ STORAGE_CLASS_COLDLINE + ▫ STORAGE_CLASS_ARCHIVE + + Defaults: + ▫ storageClass: STORAGE_CLASS_STANDARD + + Note: + ▫ Either storageClass or enableAutoclass can be set. + ▫ if enableAutoclass is set, enableHNS should not be set. + ▫ HNS: Hierarchical namespace. + + Sets create_gcs_buckets value. + + enableAutoclass + Sets enableAutoclass value. + + enableHNS + Sets enableHNS value. + + name + Required, sets name value. + + storageClass + Sets storageClass value. + + Shorthand Example: + + --create-gcs-buckets=enableAutoclass=boolean,enableHNS=boolean,name=string,storageClass=string --create-gcs-buckets=enableAutoclass=boolean,enableHNS=boolean,name=string,storageClass=string + + JSON Example: + + --create-gcs-buckets='[{"enableAutoclass": boolean, "enableHNS": boolean, "name": "string", "storageClass": "string"}]' + + File Example: + + --create-gcs-buckets=path_to_file.(yaml|json) + + --create-lustres=[description=DESCRIPTION],[filesystem=FILESYSTEM],[name=NAME],[sizeGb=SIZEGB] + Parameters to create a Lustre instance. + + For e.g. --create-lustres + name=locations/{location}/instances/{lustre},sizeGb={lustreSize},filesystem={filesystem}. + + Sets create_lustres value. + + description + Sets description value. + + filesystem + Required, sets filesystem value. + + name + Required, sets name value. + + sizeGb + Required, sets sizeGb value. + + Shorthand Example: + + --create-lustres=description=string,filesystem=string,name=string,sizeGb=int --create-lustres=description=string,filesystem=string,name=string,sizeGb=int + + JSON Example: + + --create-lustres='[{"description": "string", "filesystem": "string", "name": "string", "sizeGb": int}]' + + File Example: + + --create-lustres=path_to_file.(yaml|json) + + --description=DESCRIPTION + Description of the cluster. + + For e.g. --description (ALPHA) Creates a Cluster Director resource. + + --filestores=[FILESTORES,...] + Reference of existing filestore instance. + + For e.g. --filestores locations/{location}/instances/{filestore} + + --gcs-buckets=[GCS_BUCKETS,...] + Reference of existing Google Cloud Storage bucket. + + For e.g. --gcs-buckets {bucket-path} + + --labels=[LABELS,...] + Cluster labels as key value pairs. + + For e.g. --labels key1=value1,key2=value2. - 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. + Shorthand Example: - network - Sets network value. + --labels={string=string} - subnetwork - Sets subnetwork value. + JSON Example: - config - Sets config value. + --labels='{"string": "string"}' - existingComputeNetwork - Sets existingComputeNetwork value. + File Example: - network - Sets network value. + --labels=path_to_file.(yaml|json) - subnetwork - Sets subnetwork value. + --lustres=[LUSTRES,...] + Reference of existing Lustre instance. - newComputeNetwork - Sets newComputeNetwork value. + For e.g. --lustres locations/{location}/instances/{lustre} - description - Sets description value. + --slurm-config=[jobEpilogBashScripts=JOBEPILOGBASHSCRIPTS],[jobPrologBashScripts=JOBPROLOGBASHSCRIPTS],[prologEpilogTimeout=PROLOGEPILOGTIMEOUT],[prologFlags=PROLOGFLAGS],[requeueExitCodes=REQUEUEEXITCODES],[requeueHoldExitCodes=REQUEUEHOLDEXITCODES],[taskEpilogBashScripts=TASKEPILOGBASHSCRIPTS],[taskPrologBashScripts=TASKPROLOGBASHSCRIPTS] + Parameters to define slurm cluster config. - network - Sets network value. + For e.g. --slurm-config + requeueExitCodes=[1,2,3],requeueHoldExitCodes=[4,5,6],prologFlags=[ALLOC,CONTAIN,NO_HOLD],prologEpilogTimeout=10000s,jobPrologBashScripts=["echo + hello",...],jobEpilogBashScripts=["echo + goodbye",...],taskPrologBashScripts=["echo + hi",...],taskEpilogBashScripts=["echo bye",...] - networks - Sets networks value. + Supported prologFlags values: + ▫ ALLOC + ▫ CONTAIN + ▫ DEFER_BATCH + ▫ NO_HOLD + ▫ FORCE_REQUEUE_ON_FAIL + ▫ RUN_IN_JOB + ▫ SERIAL + ▫ X11 - initializeParams - Sets initializeParams value. + Note: + ▫ jobPrologBashScripts, jobEpilogBashScripts, + taskPrologBashScripts, taskEpilogBashScripts: + ◇ Either str or file_path + ◇ For file_path, only bash file format (.sh or .bash) is + supported. + ◇ For file_path, absolute or relative path to current work + directory is supported. - description - Sets description value. + Sets slurm_config value. - network - Sets network value. + jobEpilogBashScripts + Sets jobEpilogBashScripts value. - network - Sets network value. + jobPrologBashScripts + Sets jobPrologBashScripts value. - networkSource - Sets networkSource value. + prologEpilogTimeout + Sets prologEpilogTimeout value. - network - Sets network value. + prologFlags + Sets prologFlags value. - subnetwork - Sets subnetwork value. + requeueExitCodes + Sets requeueExitCodes value. - subnetwork - Sets subnetwork value. + requeueHoldExitCodes + Sets requeueHoldExitCodes value. - orchestrator - Sets orchestrator value. + taskEpilogBashScripts + Sets taskEpilogBashScripts value. - slurm - Sets slurm value. + taskPrologBashScripts + Sets taskPrologBashScripts value. - config - Sets config value. + Shorthand Example: - prologEpilogTimeout - Sets prologEpilogTimeout value. + --slurm-config=jobEpilogBashScripts=[string],jobPrologBashScripts=[string],prologEpilogTimeout=string,prologFlags=[string],requeueExitCodes=[int],requeueHoldExitCodes=[int],taskEpilogBashScripts=[string],taskPrologBashScripts=[string] - prologFlags - Sets prologFlags value. + JSON Example: - requeueExitCodes - Sets requeueExitCodes value. + --slurm-config='{"jobEpilogBashScripts": ["string"], "jobPrologBashScripts": ["string"], "prologEpilogTimeout": "string", "prologFlags": ["string"], "requeueExitCodes": [int], "requeueHoldExitCodes": [int], "taskEpilogBashScripts": ["string"], "taskPrologBashScripts": ["string"]}' - requeueHoldExitCodes - Sets requeueHoldExitCodes value. + File Example: - defaultPartition - Sets defaultPartition value. + --slurm-config=path_to_file.(yaml|json) - epilogBashScripts - Sets epilogBashScripts value. + --slurm-default-partition=SLURM_DEFAULT_PARTITION + Parameters to define slurm cluster default partition. - loginNodes - Sets loginNodes value. + For e.g. --slurm-default-partition {partitionId} - count - Sets count value. + Network configuration for the cluster. - disks - Sets disks value. + Exactly one of these must be specified: - boot - Sets boot value. + --create-network=CREATE_NETWORK + Name of the network to be created. - sizeGb - Sets sizeGb value. + For e.g. --create-network {network} - sourceImage - Sets sourceImage value. + Use an existing network source for the cluster. - type - Sets type value. + --network=NETWORK + Reference of existing network name. - enableOsLogin - Sets enableOsLogin value. + For e.g. --network {network} - enablePublicIps - Sets enablePublicIps value. + --subnet=SUBNET + Reference of existing subnetwork name. - 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) + For e.g. --subnet regions/{region}/subnetworks/{subnetwork} OPTIONAL FLAGS --async @@ -611,11 +1150,6 @@ GCLOUD WIDE FLAGS 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 diff --git a/gcloud/alpha/cluster-director/clusters/update b/gcloud/alpha/cluster-director/clusters/update index 18ac55e1d..450b7199e 100644 --- a/gcloud/alpha/cluster-director/clusters/update +++ b/gcloud/alpha/cluster-director/clusters/update @@ -5,8 +5,9 @@ NAME SYNOPSIS gcloud alpha cluster-director clusters update (CLUSTER : --location=LOCATION) - --config=[compute=COMPUTE],[description=DESCRIPTION],[labels=LABELS], - [name=NAME],[networkResources=NETWORKRESOURCES],[networks=NETWORKS], + --config=[compute=COMPUTE],[computeResources=COMPUTERESOURCES], + [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 ...] @@ -70,13 +71,22 @@ POSITIONAL ARGUMENTS ▸ 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] + --config=[compute=COMPUTE],[computeResources=COMPUTERESOURCES],[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. + atmTags + Sets atmTags value. + + key + Sets key value. + + value + Sets value value. + resourceRequests Sets resourceRequests value. @@ -134,6 +144,87 @@ REQUIRED FLAGS zone Sets zone value. + computeResources + Sets computeResources value. + + KEY + Sets KEY value. + + VALUE + Sets VALUE value. + + newDwsFlexInstances + Sets newDwsFlexInstances value. + + atmTags + Sets atmTags value. + + KEY + Sets KEY value. + + VALUE + Sets VALUE value. + + machineType + Sets machineType value. + + maxDuration + Sets maxDuration value. + + zone + Sets zone value. + + newOnDemandInstances + Sets newOnDemandInstances value. + + atmTags + Sets atmTags value. + + KEY + Sets KEY value. + + VALUE + Sets VALUE value. + + machineType + Sets machineType value. + + zone + Sets zone value. + + newReservedInstances + Sets newReservedInstances value. + + atmTags + Sets atmTags value. + + KEY + Sets KEY value. + + VALUE + Sets VALUE value. + + reservation + Sets reservation value. + + newSpotInstances + Sets newSpotInstances value. + + atmTags + Sets atmTags value. + + KEY + Sets KEY value. + + VALUE + Sets VALUE value. + + machineType + Sets machineType value. + + zone + Sets zone value. + description Sets description value. @@ -182,6 +273,15 @@ REQUIRED FLAGS subnetwork Sets subnetwork value. + existingNetwork + Sets existingNetwork value. + + network + Sets network value. + + subnetwork + Sets subnetwork value. + newComputeNetwork Sets newComputeNetwork value. @@ -191,6 +291,15 @@ REQUIRED FLAGS network Sets network value. + newNetwork + Sets newNetwork value. + + description + Sets description value. + + network + Sets network value. + networks Sets networks value. @@ -227,6 +336,42 @@ REQUIRED FLAGS config Sets config value. + accountingStorageEnforceFlags + Sets accountingStorageEnforceFlags value. + + preemptExemptTime + Sets preemptExemptTime value. + + preemptMode + Sets preemptMode value. + + preemptType + Sets preemptType value. + + priorityType + Sets priorityType value. + + priorityWeightAge + Sets priorityWeightAge value. + + priorityWeightAssoc + Sets priorityWeightAssoc value. + + priorityWeightFairshare + Sets priorityWeightFairshare value. + + priorityWeightJobSize + Sets priorityWeightJobSize value. + + priorityWeightPartition + Sets priorityWeightPartition value. + + priorityWeightQos + Sets priorityWeightQos value. + + priorityWeightTres + Sets priorityWeightTres value. + prologEpilogTimeout Sets prologEpilogTimeout value. @@ -320,9 +465,49 @@ REQUIRED FLAGS nodeSets Sets nodeSets value. + bootDisk + Sets bootDisk value. + + boot + Sets boot value. + + sizeGb + Sets sizeGb value. + + sourceImage + Sets sourceImage value. + + type + Sets type value. + canIpForward Sets canIpForward value. + computeId + Sets computeId value. + + computeInstance + Sets computeInstance 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. + + startupScript + Sets startupScript value. + + containerNodePool + Sets containerNodePool value. + enableOsLogin Sets enableOsLogin value. @@ -598,11 +783,11 @@ REQUIRED FLAGS 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}}] + --config=compute={atmTags=[{key=string,value=string}],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}]},computeResources={string={newDwsFlexInstances={atmTags={string=string},machineType=string,maxDuration=string,zone=string},newOnDemandInstances={atmTags={string=string},machineType=string,zone=string},newReservedInstances={atmTags={string=string},reservation=string},newSpotInstances={atmTags={string=string},machineType=string,zone=string}}},description=string,labels={string=string},name=string,networkResources={string={computeNetwork={network=string,subnetwork=string},config={existingComputeNetwork={network=string,subnetwork=string},existingNetwork={network=string,subnetwork=string},newComputeNetwork={description=string,network=string},newNetwork={description=string,network=string}}}},networks=[{initializeParams={description=string,network=string},network=string,networkSource={network=string,subnetwork=string},subnetwork=string}],orchestrator={slurm={config={accountingStorageEnforceFlags=[string],preemptExemptTime=string,preemptMode=[string],preemptType=string,priorityType=string,priorityWeightAge=int,priorityWeightAssoc=int,priorityWeightFairshare=int,priorityWeightJobSize=int,priorityWeightPartition=int,priorityWeightQos=int,priorityWeightTres=string,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=[{bootDisk={boot=boolean,sizeGb=int,sourceImage=string,type=string},canIpForward=boolean,computeId=string,computeInstance={labels={string=string},startupScript=string},containerNodePool,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"}}]}' + --config='{"compute": {"atmTags": [{"key": "string", "value": "string"}], "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"}]}, "computeResources": {"string": {"newDwsFlexInstances": {"atmTags": {"string": "string"}, "machineType": "string", "maxDuration": "string", "zone": "string"}, "newOnDemandInstances": {"atmTags": {"string": "string"}, "machineType": "string", "zone": "string"}, "newReservedInstances": {"atmTags": {"string": "string"}, "reservation": "string"}, "newSpotInstances": {"atmTags": {"string": "string"}, "machineType": "string", "zone": "string"}}}, "description": "string", "labels": {"string": "string"}, "name": "string", "networkResources": {"string": {"computeNetwork": {"network": "string", "subnetwork": "string"}, "config": {"existingComputeNetwork": {"network": "string", "subnetwork": "string"}, "existingNetwork": {"network": "string", "subnetwork": "string"}, "newComputeNetwork": {"description": "string", "network": "string"}, "newNetwork": {"description": "string", "network": "string"}}}}, "networks": [{"initializeParams": {"description": "string", "network": "string"}, "network": "string", "networkSource": {"network": "string", "subnetwork": "string"}, "subnetwork": "string"}], "orchestrator": {"slurm": {"config": {"accountingStorageEnforceFlags": ["string"], "preemptExemptTime": "string", "preemptMode": ["string"], "preemptType": "string", "priorityType": "string", "priorityWeightAge": int, "priorityWeightAssoc": int, "priorityWeightFairshare": int, "priorityWeightJobSize": int, "priorityWeightPartition": int, "priorityWeightQos": int, "priorityWeightTres": "string", "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": [{"bootDisk": {"boot": boolean, "sizeGb": int, "sourceImage": "string", "type": "string"}, "canIpForward": boolean, "computeId": "string", "computeInstance": {"labels": {"string": "string"}, "startupScript": "string"}, "containerNodePool": {}, "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: diff --git a/gcloud/alpha/composer/environments/create b/gcloud/alpha/composer/environments/create index e52c0e5f0..ec94a3efa 100644 --- a/gcloud/alpha/composer/environments/create +++ b/gcloud/alpha/composer/environments/create @@ -212,8 +212,7 @@ FLAGS --service-account=SERVICE_ACCOUNT The Google Cloud Platform service account to be used by the node VMs. - If a service account is not specified, the "default" Compute Engine - service account for the project is used. Cannot be updated. + You must explicitly specify a service account. Cannot be updated. --storage-bucket=STORAGE_BUCKET Name of an exisiting Cloud Storage bucket to be used by the diff --git a/gcloud/alpha/compute/commitments/create b/gcloud/alpha/compute/commitments/create index 8772f08f0..e4c9f214d 100644 --- a/gcloud/alpha/compute/commitments/create +++ b/gcloud/alpha/compute/commitments/create @@ -115,10 +115,10 @@ OPTIONAL FLAGS general-purpose-c4a, general-purpose-c4d, general-purpose-e2, general-purpose-n2, general-purpose-n2d, general-purpose-n4, general-purpose-n4d, general-purpose-t2d, graphics-optimized, - memory-optimized, memory-optimized-m3, memory-optimized-m4, - memory-optimized-m4-6tb, memory-optimized-x4, memory-optimized-x4-16tb, - memory-optimized-x4-24tb, memory-optimized-x4-32tb, - storage-optimized-z3. + graphics-optimized-g4, memory-optimized, memory-optimized-m3, + memory-optimized-m4, memory-optimized-m4-6tb, memory-optimized-x4, + memory-optimized-x4-16tb, memory-optimized-x4-24tb, + memory-optimized-x4-32tb, storage-optimized-z3. Manage the reservations to be created with the commitment. diff --git a/gcloud/alpha/compute/disks/create b/gcloud/alpha/compute/disks/create index 803110350..4222928e1 100644 --- a/gcloud/alpha/compute/disks/create +++ b/gcloud/alpha/compute/disks/create @@ -14,6 +14,7 @@ SYNOPSIS [--provisioned-throughput=PROVISIONED_THROUGHPUT] [--replica-zones=ZONE,ZONE] [--no-require-csek-key-create] [--resource-policies=[RESOURCE_POLICY,...]] [--size=SIZE] + [--source-instant-snapshot-project=SOURCE_INSTANT_SNAPSHOT_PROJECT] [--storage-pool=STORAGE_POOL] [--type=TYPE] [--user-licenses=[LICENSE,...]] [--global-source-snapshot @@ -179,6 +180,9 @@ FLAGS will be used. For details about disk size limits, refer to: https://cloud.google.com/compute/docs/disks + --source-instant-snapshot-project=SOURCE_INSTANT_SNAPSHOT_PROJECT + The project containing the instant snapshot used to create the disks. + --storage-pool=STORAGE_POOL Specifies the URI of the storage pool in which the disk is created. diff --git a/gcloud/alpha/compute/forwarding-rules/create b/gcloud/alpha/compute/forwarding-rules/create index 16d206fff..e874e238a 100644 --- a/gcloud/alpha/compute/forwarding-rules/create +++ b/gcloud/alpha/compute/forwarding-rules/create @@ -30,7 +30,6 @@ SYNOPSIS [--target-pool-region=TARGET_POOL_REGION] [--target-service-attachment-region=TARGET_SERVICE_ATTACHMENT_REGION] [--target-vpn-gateway-region=TARGET_VPN_GATEWAY_REGION] - [--traffic-disabled] [--address-region=ADDRESS_REGION | --global-address] [--backend-service-region=BACKEND_SERVICE_REGION | --global-backend-service] [--global | --region=REGION] @@ -356,12 +355,6 @@ OPTIONAL FLAGS is set to the region of the forwarding rule. Overrides the default compute/region property value for this command invocation. - --traffic-disabled - If set to true, disables traffic from flowing through Private Service - Connect forwarding rule from consumer to producer. This can only be - specified if the forwarding rule's target is a service attachment - (--target-service-attachment). - At most one of these can be specified: --address-region=ADDRESS_REGION diff --git a/gcloud/alpha/compute/forwarding-rules/update b/gcloud/alpha/compute/forwarding-rules/update index 43f412fa1..7f4b53390 100644 --- a/gcloud/alpha/compute/forwarding-rules/update +++ b/gcloud/alpha/compute/forwarding-rules/update @@ -8,7 +8,7 @@ SYNOPSIS [--external-managed-backend-bucket-migration-testing-percentage=EXTERNAL_MANAGED_BACKEND_BUCKET_MIGRATION_TESTING_PERCENTAGE] [--load-balancing-scheme=LOAD_BALANCING_SCHEME] [--network-tier=NETWORK_TIER] - [--source-ip-ranges=SOURCE_IP_RANGE,[...]] [--traffic-disabled] + [--source-ip-ranges=SOURCE_IP_RANGE,[...]] [--update-labels=[KEY=VALUE,...]] [--clear-external-managed-backend-bucket-migration-state | --external-managed-backend-bucket-migration-state=EXTERNAL_MANAGED_BACKEND_BUCKET_MIGRATION_STATE] @@ -80,12 +80,6 @@ FLAGS forwarding rule only forwards traffic when the packet's source IP address matches one of the IP ranges set here. - --traffic-disabled - If set to true, disables traffic from flowing through Private Service - Connect forwarding rule from consumer to producer. This can only be - specified if the forwarding rule's target is a service attachment - (--target-service-attachment). - --update-labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to update. If a label exists, its value is modified. Otherwise, a new label is created. diff --git a/gcloud/alpha/compute/instances/network-interfaces/add b/gcloud/alpha/compute/instances/network-interfaces/add index bcfbd9e97..0a28e5404 100644 --- a/gcloud/alpha/compute/instances/network-interfaces/add +++ b/gcloud/alpha/compute/instances/network-interfaces/add @@ -131,13 +131,15 @@ FLAGS should be in the subnet IP range. --stack-type=STACK_TYPE - The stack type for the default network interface. Determines if IPv6 is - enabled on the default network interface. STACK_TYPE must be one of: + The stack type for the network interface. Determines if IPv6 is enabled + on the network interface. STACK_TYPE must be one of: IPV4_IPV6 The network interface can have both IPv4 and IPv6 addresses. IPV4_ONLY The network interface will be assigned IPv4 addresses. + IPV6_ONLY + The network interface will be assigned IPv6 addresses. --subnetwork=SUBNETWORK Specifies the subnetwork this network interface belongs to. diff --git a/gcloud/alpha/compute/instances/network-interfaces/update b/gcloud/alpha/compute/instances/network-interfaces/update index 10f77da21..d653f57ac 100644 --- a/gcloud/alpha/compute/instances/network-interfaces/update +++ b/gcloud/alpha/compute/instances/network-interfaces/update @@ -126,13 +126,15 @@ FLAGS compute/region property value for this command invocation. --stack-type=STACK_TYPE - The stack type for the default network interface. Determines if IPv6 is - enabled on the default network interface. STACK_TYPE must be one of: + The stack type for the network interface. Determines if IPv6 is enabled + on the network interface. STACK_TYPE must be one of: IPV4_IPV6 The network interface can have both IPv4 and IPv6 addresses. IPV4_ONLY The network interface will be assigned IPv4 addresses. + IPV6_ONLY + The network interface will be assigned IPv6 addresses. --subnetwork=SUBNETWORK Specifies the subnetwork this network interface belongs to. diff --git a/gcloud/alpha/compute/org-security-policies/associations/create b/gcloud/alpha/compute/org-security-policies/associations/create index 4fa39087f..ef8c98178 100644 --- a/gcloud/alpha/compute/org-security-policies/associations/create +++ b/gcloud/alpha/compute/org-security-policies/associations/create @@ -23,11 +23,11 @@ DESCRIPTION into Cloud Armor Enterprise if not already enrolled. EXAMPLES - To associate an organization security policy under folder with ID - ``123456789" to folder ``987654321", run: + To associate an organization security policy under folder with ID 123456789 + to folder 987654321, run: $ gcloud alpha compute org-security-policies associations create \ - create --security-policy=123456789 --folder=987654321 + --security-policy=123456789 --folder=987654321 REQUIRED FLAGS --security-policy=SECURITY_POLICY diff --git a/gcloud/alpha/compute/org-security-policies/associations/delete b/gcloud/alpha/compute/org-security-policies/associations/delete index 19116dba2..c9aa95ce9 100644 --- a/gcloud/alpha/compute/org-security-policies/associations/delete +++ b/gcloud/alpha/compute/org-security-policies/associations/delete @@ -12,11 +12,11 @@ DESCRIPTION used to delete organization security policy association. EXAMPLES - To delete an association with name ``example-association" of an - organization security policy with ID ``123456789", run: + To delete an association with name example-association of an organization + security policy with ID 123456789, run: $ gcloud alpha compute org-security-policies associations delete \ - delete example-association --security-policy=123456789 + example-association --security-policy=123456789 POSITIONAL ARGUMENTS NAME diff --git a/gcloud/alpha/compute/org-security-policies/associations/list b/gcloud/alpha/compute/org-security-policies/associations/list index a71b90544..c8c4f30e2 100644 --- a/gcloud/alpha/compute/org-security-policies/associations/list +++ b/gcloud/alpha/compute/org-security-policies/associations/list @@ -13,7 +13,7 @@ DESCRIPTION used to list the associations of an organization or folder resource. EXAMPLES - To list the associations of the folder with ID ``987654321", run: + To list the associations of the folder with ID 987654321, run: $ gcloud alpha compute org-security-policies associations list \ --folder=987654321 diff --git a/gcloud/alpha/compute/org-security-policies/copy-rules b/gcloud/alpha/compute/org-security-policies/copy-rules index f2760f8de..dd5267d0c 100644 --- a/gcloud/alpha/compute/org-security-policies/copy-rules +++ b/gcloud/alpha/compute/org-security-policies/copy-rules @@ -15,11 +15,11 @@ DESCRIPTION resources. EXAMPLES - To copy the rules of an organization security policy with ID "123456789", - from another organization security policy with ID "987654321", run: + To copy the rules of an organization security policy with ID 123456789, + from another organization security policy with ID 987654321, run: - $ gcloud alpha compute org-security-policies copy-rules copy-rules \ - 123456789 --source-security-policy=987654321 + $ gcloud alpha compute org-security-policies copy-rules 123456789 \ + --source-security-policy=987654321 POSITIONAL ARGUMENTS SECURITY_POLICY diff --git a/gcloud/alpha/compute/org-security-policies/create b/gcloud/alpha/compute/org-security-policies/create index 955e0aac7..64d032d4d 100644 --- a/gcloud/alpha/compute/org-security-policies/create +++ b/gcloud/alpha/compute/org-security-policies/create @@ -16,16 +16,16 @@ DESCRIPTION rules that controls access to various resources. EXAMPLES - To create an organization security policy under folder with ID "123456789", + To create an organization security policy under folder with ID 123456789, run: - $ gcloud alpha compute org-security-policies create create \ + $ gcloud alpha compute org-security-policies create \ --short-name=my-policy --folder=123456789 - To create an organization security under organization with ID "12345" from - an input file, run: + To create an organization security under organization with ID 12345 from an + input file, run: - $ gcloud alpha compute org-security-policies create create \ + $ gcloud alpha compute org-security-policies create \ --file-name=my-file-name --organization=12345 REQUIRED FLAGS diff --git a/gcloud/alpha/compute/org-security-policies/delete b/gcloud/alpha/compute/org-security-policies/delete index 6eba7d36f..7f8e08fed 100644 --- a/gcloud/alpha/compute/org-security-policies/delete +++ b/gcloud/alpha/compute/org-security-policies/delete @@ -12,9 +12,9 @@ DESCRIPTION rules that controls access to various resources. EXAMPLES - To delete an organization security policy with ID "123456789", run: + To delete an organization security policy with ID 123456789, run: - $ gcloud alpha compute org-security-policies delete delete 123456789 + $ gcloud alpha compute org-security-policies delete 123456789 POSITIONAL ARGUMENTS SECURITY_POLICY diff --git a/gcloud/alpha/compute/org-security-policies/describe b/gcloud/alpha/compute/org-security-policies/describe index ecc8412a7..b73afc37a 100644 --- a/gcloud/alpha/compute/org-security-policies/describe +++ b/gcloud/alpha/compute/org-security-policies/describe @@ -12,7 +12,7 @@ DESCRIPTION a set of rules that controls access to various resources. EXAMPLES - To describe an organization security policy with ID "123456789", run: + To describe an organization security policy with ID 123456789, run: $ gcloud alpha compute org-security-policies describe 123456789 diff --git a/gcloud/alpha/compute/org-security-policies/list b/gcloud/alpha/compute/org-security-policies/list index 07e185cda..c0c990eaa 100644 --- a/gcloud/alpha/compute/org-security-policies/list +++ b/gcloud/alpha/compute/org-security-policies/list @@ -15,11 +15,9 @@ DESCRIPTION rules that controls access to various resources. EXAMPLES - To list organization security policies under folder with ID "123456789", - run: + To list organization security policies under folder with ID 123456789, run: - $ gcloud alpha compute org-security-policies list list \ - --folder=123456789 + $ gcloud alpha compute org-security-policies list --folder=123456789 POSITIONAL ARGUMENTS [NAME ...] diff --git a/gcloud/alpha/compute/org-security-policies/list-rules b/gcloud/alpha/compute/org-security-policies/list-rules index 7d893d86f..e87be42eb 100644 --- a/gcloud/alpha/compute/org-security-policies/list-rules +++ b/gcloud/alpha/compute/org-security-policies/list-rules @@ -13,14 +13,13 @@ DESCRIPTION list the rules of an organization security policy. EXAMPLES - To list the rules of an organization security policy with ID "123456789", + To list the rules of an organization security policy with ID 123456789, run: - $ gcloud alpha compute org-security-policies list-rules list-rules \ - 123456789 + $ gcloud alpha compute org-security-policies list-rules 123456789 To list all the fields of the rules of an organization security policy with - ID "123456789", run: + ID 123456789, run: $ gcloud alpha compute org-security-policies list-rules list-rules \ 123456789 --format="table( diff --git a/gcloud/alpha/compute/org-security-policies/move b/gcloud/alpha/compute/org-security-policies/move index ae3dca090..aaad31517 100644 --- a/gcloud/alpha/compute/org-security-policies/move +++ b/gcloud/alpha/compute/org-security-policies/move @@ -11,10 +11,10 @@ DESCRIPTION used to move organization security policies to new parent nodes. EXAMPLES - To move an organization security policy under folder with ID "123456789" to - folder "987654321", run: + To move an organization security policy under folder with ID 123456789 to + folder 987654321, run: - $ gcloud alpha compute org-security-policies move move 123456789 \ + $ gcloud alpha compute org-security-policies move 123456789 \ --folder=987654321 POSITIONAL ARGUMENTS diff --git a/gcloud/alpha/compute/org-security-policies/rules/create b/gcloud/alpha/compute/org-security-policies/rules/create index 4cbff18e5..683555ed4 100644 --- a/gcloud/alpha/compute/org-security-policies/rules/create +++ b/gcloud/alpha/compute/org-security-policies/rules/create @@ -19,11 +19,11 @@ DESCRIPTION create organization security policy rules. EXAMPLES - To create a rule with priority "10" in an organization security policy with - ID "123456789", run: + To create a rule with priority 10 in an organization security policy with + ID 123456789, run: - $ gcloud alpha compute org-security-policies rules create create \ - 10 --security-policy=123456789 --action=allow \ + $ gcloud alpha compute org-security-policies rules create 10 \ + --security-policy=123456789 --action=allow \ --description=example-rule --cloud-armor POSITIONAL ARGUMENTS diff --git a/gcloud/alpha/compute/org-security-policies/rules/delete b/gcloud/alpha/compute/org-security-policies/rules/delete index 1aa48b6d6..15a475a5c 100644 --- a/gcloud/alpha/compute/org-security-policies/rules/delete +++ b/gcloud/alpha/compute/org-security-policies/rules/delete @@ -12,11 +12,11 @@ DESCRIPTION delete organization security policy rule. EXAMPLES - To delete a rule with priority ``10" in an organization security policy - with ID ``123456789", run: + To delete a rule with priority 10 in an organization security policy with + ID 123456789, run: - $ gcloud alpha compute org-security-policies rules delete delete \ - 10 --security-policy=123456789 + $ gcloud alpha compute org-security-policies rules delete 10 \ + --security-policy=123456789 POSITIONAL ARGUMENTS PRIORITY diff --git a/gcloud/alpha/compute/org-security-policies/rules/describe b/gcloud/alpha/compute/org-security-policies/rules/describe index 226e122a3..bb9f85cae 100644 --- a/gcloud/alpha/compute/org-security-policies/rules/describe +++ b/gcloud/alpha/compute/org-security-policies/rules/describe @@ -12,11 +12,11 @@ DESCRIPTION to describe organization security policy rule. EXAMPLES - To describe a rule with priority ``10" in an organization security policy - with ID ``123456789", run: + To describe a rule with priority 10 in an organization security policy with + ID 123456789, run: - $ gcloud alpha compute org-security-policies rules describe \ - describe 10 --security-policy=123456789 + $ gcloud alpha compute org-security-policies rules describe 10 \ + --security-policy=123456789 POSITIONAL ARGUMENTS PRIORITY diff --git a/gcloud/alpha/compute/org-security-policies/rules/update b/gcloud/alpha/compute/org-security-policies/rules/update index ab2c0d878..b66b9959d 100644 --- a/gcloud/alpha/compute/org-security-policies/rules/update +++ b/gcloud/alpha/compute/org-security-policies/rules/update @@ -19,12 +19,12 @@ DESCRIPTION update organization security policy rules. EXAMPLES - To update a rule with priority ``10" in an organization security policy - with ID ``123456789" to change the action to ``allow" and description to - ``new-example-rule", run: + To update a rule with priority 10 in an organization security policy with + ID 123456789 to change the action to allow and description to + new-example-rule, run: - $ gcloud alpha compute org-security-policies rules update create \ - 10 --security-policy=123456789 --action=allow \ + $ gcloud alpha compute org-security-policies rules update 10 \ + --security-policy=123456789 --action=allow \ --description=new-example-rule POSITIONAL ARGUMENTS diff --git a/gcloud/alpha/compute/org-security-policies/update b/gcloud/alpha/compute/org-security-policies/update index 0f324a612..8258a33ad 100644 --- a/gcloud/alpha/compute/org-security-policies/update +++ b/gcloud/alpha/compute/org-security-policies/update @@ -17,11 +17,11 @@ DESCRIPTION rules that controls access to various resources. EXAMPLES - To update an organization security policy with ID "123456789" to change the - description to "New description", run: + To update an organization security policy with ID 123456789 to change the + description to New description, run: - $ gcloud alpha compute org-security-policies update update \ - 123456789 --description='New description' + $ gcloud alpha compute org-security-policies update 123456789 \ + --description='New description' POSITIONAL ARGUMENTS SECURITY_POLICY diff --git a/gcloud/alpha/config/get b/gcloud/alpha/config/get index a85e69df8..35e10b530 100644 --- a/gcloud/alpha/config/get +++ b/gcloud/alpha/config/get @@ -1393,6 +1393,12 @@ AVAILABLE PROPERTIES If True, use the deprecated upload implementation which uses gsutil. + use_gsutil_rsync_delete_unmatched_destination_objects_behavior + If True, rsync will preserve unmatched destination objects while + using --delete-unmatched-destination-objects flag along with other + flags such as --no-clobber, --skip-unsupported and + --skip-if-dest-has-newer-mtime just as it would with gsutil. + use_magicfile If True, uses the file --mime command to guess content types instead of the default filename extension-based mechanism. diff --git a/gcloud/alpha/config/help b/gcloud/alpha/config/help index 78f9d6682..462540049 100644 --- a/gcloud/alpha/config/help +++ b/gcloud/alpha/config/help @@ -1425,6 +1425,12 @@ AVAILABLE PROPERTIES If True, use the deprecated upload implementation which uses gsutil. + use_gsutil_rsync_delete_unmatched_destination_objects_behavior + If True, rsync will preserve unmatched destination objects while + using --delete-unmatched-destination-objects flag along with other + flags such as --no-clobber, --skip-unsupported and + --skip-if-dest-has-newer-mtime just as it would with gsutil. + use_magicfile If True, uses the file --mime command to guess content types instead of the default filename extension-based mechanism. diff --git a/gcloud/alpha/config/list b/gcloud/alpha/config/list index 6f7b2dd6b..8731ab9b7 100644 --- a/gcloud/alpha/config/list +++ b/gcloud/alpha/config/list @@ -1437,6 +1437,12 @@ AVAILABLE PROPERTIES If True, use the deprecated upload implementation which uses gsutil. + use_gsutil_rsync_delete_unmatched_destination_objects_behavior + If True, rsync will preserve unmatched destination objects while + using --delete-unmatched-destination-objects flag along with other + flags such as --no-clobber, --skip-unsupported and + --skip-if-dest-has-newer-mtime just as it would with gsutil. + use_magicfile If True, uses the file --mime command to guess content types instead of the default filename extension-based mechanism. diff --git a/gcloud/alpha/config/set b/gcloud/alpha/config/set index 97cdc3397..b1cc1022e 100644 --- a/gcloud/alpha/config/set +++ b/gcloud/alpha/config/set @@ -1440,6 +1440,12 @@ AVAILABLE PROPERTIES If True, use the deprecated upload implementation which uses gsutil. + use_gsutil_rsync_delete_unmatched_destination_objects_behavior + If True, rsync will preserve unmatched destination objects while + using --delete-unmatched-destination-objects flag along with other + flags such as --no-clobber, --skip-unsupported and + --skip-if-dest-has-newer-mtime just as it would with gsutil. + use_magicfile If True, uses the file --mime command to guess content types instead of the default filename extension-based mechanism. diff --git a/gcloud/alpha/config/unset b/gcloud/alpha/config/unset index 18e4b8807..d50d05b24 100644 --- a/gcloud/alpha/config/unset +++ b/gcloud/alpha/config/unset @@ -1401,6 +1401,12 @@ AVAILABLE PROPERTIES If True, use the deprecated upload implementation which uses gsutil. + use_gsutil_rsync_delete_unmatched_destination_objects_behavior + If True, rsync will preserve unmatched destination objects while + using --delete-unmatched-destination-objects flag along with other + flags such as --no-clobber, --skip-unsupported and + --skip-if-dest-has-newer-mtime just as it would with gsutil. + use_magicfile If True, uses the file --mime command to guess content types instead of the default filename extension-based mechanism. diff --git a/gcloud/alpha/looker/instances/create b/gcloud/alpha/looker/instances/create index 116887683..50986371f 100644 --- a/gcloud/alpha/looker/instances/create +++ b/gcloud/alpha/looker/instances/create @@ -179,7 +179,9 @@ OPTIONAL FLAGS this group are specified. --private-ip-enabled - This specifies whether private IP is enabled on the Looker instance. + This specifies whether private IP (PSA) is enabled on the Looker + instance. This flag is for creating a PSA (Private Service Access) + instance. This flag argument must be specified if any of the other arguments in this group are specified. diff --git a/gcloud/alpha/network-security/firewall-endpoints/create b/gcloud/alpha/network-security/firewall-endpoints/create index f87295be4..3ad4edb5c 100644 --- a/gcloud/alpha/network-security/firewall-endpoints/create +++ b/gcloud/alpha/network-security/firewall-endpoints/create @@ -6,7 +6,8 @@ SYNOPSIS gcloud alpha network-security firewall-endpoints create (FIREWALL_ENDPOINT : --organization=ORGANIZATION --zone=ZONE) --billing-project=BILLING_PROJECT [--async] [--description=DESCRIPTION] - [--labels=[KEY=VALUE,...]] [--max-wait=MAX_WAIT; default="60m"] + [--enable-jumbo-frames] [--labels=[KEY=VALUE,...]] + [--max-wait=MAX_WAIT; default="60m"] [--target-firewall-attachment=TARGET_FIREWALL_ATTACHMENT] [GCLOUD_WIDE_FLAG ...] @@ -71,6 +72,10 @@ OPTIONAL FLAGS --description=DESCRIPTION Description of the endpoint + --enable-jumbo-frames + Enable jumbo frames for the firewall endpoint. To disable jumbo frames, + use --no-enable-jumbo-frames. + --labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to add. diff --git a/gcloud/alpha/run/multi-region-services/delete b/gcloud/alpha/run/multi-region-services/delete index dcdfb74bd..816fd5f26 100644 --- a/gcloud/alpha/run/multi-region-services/delete +++ b/gcloud/alpha/run/multi-region-services/delete @@ -66,7 +66,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 run multi-region-services delete $ gcloud beta run multi-region-services delete diff --git a/gcloud/alpha/run/multi-region-services/describe b/gcloud/alpha/run/multi-region-services/describe index c22ab83ca..a3c6d3d69 100644 --- a/gcloud/alpha/run/multi-region-services/describe +++ b/gcloud/alpha/run/multi-region-services/describe @@ -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 run multi-region-services describe $ gcloud beta run multi-region-services describe diff --git a/gcloud/alpha/run/multi-region-services/help b/gcloud/alpha/run/multi-region-services/help index a0b6af9d8..da28aaaf3 100644 --- a/gcloud/alpha/run/multi-region-services/help +++ b/gcloud/alpha/run/multi-region-services/help @@ -52,7 +52,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 run multi-region-services $ gcloud beta run multi-region-services diff --git a/gcloud/alpha/run/multi-region-services/list b/gcloud/alpha/run/multi-region-services/list index d10cee7c9..260399d8b 100644 --- a/gcloud/alpha/run/multi-region-services/list +++ b/gcloud/alpha/run/multi-region-services/list @@ -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 run multi-region-services list $ gcloud beta run multi-region-services list diff --git a/gcloud/alpha/run/multi-region-services/replace b/gcloud/alpha/run/multi-region-services/replace index c5873e752..357aaefab 100644 --- a/gcloud/alpha/run/multi-region-services/replace +++ b/gcloud/alpha/run/multi-region-services/replace @@ -48,7 +48,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 run multi-region-services replace $ gcloud beta run multi-region-services replace diff --git a/gcloud/alpha/run/multi-region-services/update b/gcloud/alpha/run/multi-region-services/update index 2e851a9a1..2616c1cc3 100644 --- a/gcloud/alpha/run/multi-region-services/update +++ b/gcloud/alpha/run/multi-region-services/update @@ -633,7 +633,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 run multi-region-services update $ gcloud beta run multi-region-services update diff --git a/gcloud/alpha/storage/batch-operations/jobs/list b/gcloud/alpha/storage/batch-operations/jobs/list index 5e7542c62..62887fcad 100644 --- a/gcloud/alpha/storage/batch-operations/jobs/list +++ b/gcloud/alpha/storage/batch-operations/jobs/list @@ -11,10 +11,15 @@ DESCRIPTION (ALPHA) List batch operation jobs. EXAMPLES - To list all batch jobs in all locations: + To list all batch jobs: $ gcloud alpha storage batch-operations jobs list + To list all batch jobs that are not dry run: + + $ gcloud alpha storage batch-operations jobs list \ + --filter="dry_run=false" + To list all batch jobs with a page size of 10: $ gcloud alpha storage batch-operations jobs list --page-size=10 diff --git a/gcloud/alpha/transfer/agents/install b/gcloud/alpha/transfer/agents/install index b5f3e4c0e..56fcafbda 100644 --- a/gcloud/alpha/transfer/agents/install +++ b/gcloud/alpha/transfer/agents/install @@ -43,6 +43,22 @@ EXAMPLES $ gcloud alpha transfer agents install \ --creds-file=/example/path.json --pool=AGENT_POOL + To install an agent using service account impersonation, run: + + $ gcloud alpha transfer agents install \ + --creds-file=/example/path.json --pool=CUSTOM_AGENT_POOL \ + --impersonate-service-account=impersonated-account@project-id.ia\ + m.gserviceaccount.com + + Note : The --impersonate-service-account flag only applies to the API calls + made by gcloud during the agent installation and authorization process. The + impersonated credentials are not passed to the transfer agent's runtime + environment. The agent itself does not support impersonation and will use + the credentials provided via the --creds-file flag or the default gcloud + authenticated account for all of its operations. To grant the agent + permissions, you must provide a service account key with the required + direct roles (e.g., Storage Transfer Agent, Storage Object User) + REQUIRED FLAGS --pool=POOL The agent pool to associate with the newly installed agent. When diff --git a/gcloud/beta/composer/environments/create b/gcloud/beta/composer/environments/create index 0a0f7fb01..428d8603d 100644 --- a/gcloud/beta/composer/environments/create +++ b/gcloud/beta/composer/environments/create @@ -212,8 +212,7 @@ FLAGS --service-account=SERVICE_ACCOUNT The Google Cloud Platform service account to be used by the node VMs. - If a service account is not specified, the "default" Compute Engine - service account for the project is used. Cannot be updated. + You must explicitly specify a service account. Cannot be updated. --storage-bucket=STORAGE_BUCKET Name of an exisiting Cloud Storage bucket to be used by the diff --git a/gcloud/beta/compute/instances/network-interfaces/add b/gcloud/beta/compute/instances/network-interfaces/add index b40fbb779..c74a4c99e 100644 --- a/gcloud/beta/compute/instances/network-interfaces/add +++ b/gcloud/beta/compute/instances/network-interfaces/add @@ -109,13 +109,15 @@ FLAGS should be in the subnet IP range. --stack-type=STACK_TYPE - The stack type for the default network interface. Determines if IPv6 is - enabled on the default network interface. STACK_TYPE must be one of: + The stack type for the network interface. Determines if IPv6 is enabled + on the network interface. STACK_TYPE must be one of: IPV4_IPV6 The network interface can have both IPv4 and IPv6 addresses. IPV4_ONLY The network interface will be assigned IPv4 addresses. + IPV6_ONLY + The network interface will be assigned IPv6 addresses. --subnetwork=SUBNETWORK Specifies the subnetwork this network interface belongs to. diff --git a/gcloud/beta/compute/instances/network-interfaces/update b/gcloud/beta/compute/instances/network-interfaces/update index 1fb74dd71..ec1af67de 100644 --- a/gcloud/beta/compute/instances/network-interfaces/update +++ b/gcloud/beta/compute/instances/network-interfaces/update @@ -115,13 +115,15 @@ FLAGS compute/region property value for this command invocation. --stack-type=STACK_TYPE - The stack type for the default network interface. Determines if IPv6 is - enabled on the default network interface. STACK_TYPE must be one of: + The stack type for the network interface. Determines if IPv6 is enabled + on the network interface. STACK_TYPE must be one of: IPV4_IPV6 The network interface can have both IPv4 and IPv6 addresses. IPV4_ONLY The network interface will be assigned IPv4 addresses. + IPV6_ONLY + The network interface will be assigned IPv6 addresses. --subnetwork=SUBNETWORK Specifies the subnetwork this network interface belongs to. diff --git a/gcloud/beta/compute/org-security-policies/associations/create b/gcloud/beta/compute/org-security-policies/associations/create index beef1ec2b..dafdf4846 100644 --- a/gcloud/beta/compute/org-security-policies/associations/create +++ b/gcloud/beta/compute/org-security-policies/associations/create @@ -23,11 +23,11 @@ DESCRIPTION into Cloud Armor Enterprise if not already enrolled. EXAMPLES - To associate an organization security policy under folder with ID - ``123456789" to folder ``987654321", run: + To associate an organization security policy under folder with ID 123456789 + to folder 987654321, run: $ gcloud beta compute org-security-policies associations create \ - create --security-policy=123456789 --folder=987654321 + --security-policy=123456789 --folder=987654321 REQUIRED FLAGS --security-policy=SECURITY_POLICY diff --git a/gcloud/beta/compute/org-security-policies/associations/delete b/gcloud/beta/compute/org-security-policies/associations/delete index c985ba1a9..061fb41c9 100644 --- a/gcloud/beta/compute/org-security-policies/associations/delete +++ b/gcloud/beta/compute/org-security-policies/associations/delete @@ -12,11 +12,11 @@ DESCRIPTION used to delete organization security policy association. EXAMPLES - To delete an association with name ``example-association" of an - organization security policy with ID ``123456789", run: + To delete an association with name example-association of an organization + security policy with ID 123456789, run: $ gcloud beta compute org-security-policies associations delete \ - delete example-association --security-policy=123456789 + example-association --security-policy=123456789 POSITIONAL ARGUMENTS NAME diff --git a/gcloud/beta/compute/org-security-policies/associations/list b/gcloud/beta/compute/org-security-policies/associations/list index 225ef0cd2..2cb640225 100644 --- a/gcloud/beta/compute/org-security-policies/associations/list +++ b/gcloud/beta/compute/org-security-policies/associations/list @@ -13,7 +13,7 @@ DESCRIPTION to list the associations of an organization or folder resource. EXAMPLES - To list the associations of the folder with ID ``987654321", run: + To list the associations of the folder with ID 987654321, run: $ gcloud beta compute org-security-policies associations list \ --folder=987654321 diff --git a/gcloud/beta/compute/org-security-policies/copy-rules b/gcloud/beta/compute/org-security-policies/copy-rules index 8761d95cb..e7faf5e17 100644 --- a/gcloud/beta/compute/org-security-policies/copy-rules +++ b/gcloud/beta/compute/org-security-policies/copy-rules @@ -15,11 +15,11 @@ DESCRIPTION resources. EXAMPLES - To copy the rules of an organization security policy with ID "123456789", - from another organization security policy with ID "987654321", run: + To copy the rules of an organization security policy with ID 123456789, + from another organization security policy with ID 987654321, run: - $ gcloud beta compute org-security-policies copy-rules copy-rules \ - 123456789 --source-security-policy=987654321 + $ gcloud beta compute org-security-policies copy-rules 123456789 \ + --source-security-policy=987654321 POSITIONAL ARGUMENTS SECURITY_POLICY diff --git a/gcloud/beta/compute/org-security-policies/create b/gcloud/beta/compute/org-security-policies/create index 2e1630554..b738bf8ce 100644 --- a/gcloud/beta/compute/org-security-policies/create +++ b/gcloud/beta/compute/org-security-policies/create @@ -16,16 +16,16 @@ DESCRIPTION rules that controls access to various resources. EXAMPLES - To create an organization security policy under folder with ID "123456789", + To create an organization security policy under folder with ID 123456789, run: - $ gcloud beta compute org-security-policies create create \ + $ gcloud beta compute org-security-policies create \ --short-name=my-policy --folder=123456789 - To create an organization security under organization with ID "12345" from - an input file, run: + To create an organization security under organization with ID 12345 from an + input file, run: - $ gcloud beta compute org-security-policies create create \ + $ gcloud beta compute org-security-policies create \ --file-name=my-file-name --organization=12345 REQUIRED FLAGS diff --git a/gcloud/beta/compute/org-security-policies/delete b/gcloud/beta/compute/org-security-policies/delete index d2e6d843f..f2806fa00 100644 --- a/gcloud/beta/compute/org-security-policies/delete +++ b/gcloud/beta/compute/org-security-policies/delete @@ -12,9 +12,9 @@ DESCRIPTION rules that controls access to various resources. EXAMPLES - To delete an organization security policy with ID "123456789", run: + To delete an organization security policy with ID 123456789, run: - $ gcloud beta compute org-security-policies delete delete 123456789 + $ gcloud beta compute org-security-policies delete 123456789 POSITIONAL ARGUMENTS SECURITY_POLICY diff --git a/gcloud/beta/compute/org-security-policies/describe b/gcloud/beta/compute/org-security-policies/describe index cc1d9f788..785fa7f96 100644 --- a/gcloud/beta/compute/org-security-policies/describe +++ b/gcloud/beta/compute/org-security-policies/describe @@ -12,7 +12,7 @@ DESCRIPTION a set of rules that controls access to various resources. EXAMPLES - To describe an organization security policy with ID "123456789", run: + To describe an organization security policy with ID 123456789, run: $ gcloud beta compute org-security-policies describe 123456789 diff --git a/gcloud/beta/compute/org-security-policies/list b/gcloud/beta/compute/org-security-policies/list index a2f98c1c1..c2bcef973 100644 --- a/gcloud/beta/compute/org-security-policies/list +++ b/gcloud/beta/compute/org-security-policies/list @@ -15,11 +15,9 @@ DESCRIPTION rules that controls access to various resources. EXAMPLES - To list organization security policies under folder with ID "123456789", - run: + To list organization security policies under folder with ID 123456789, run: - $ gcloud beta compute org-security-policies list list \ - --folder=123456789 + $ gcloud beta compute org-security-policies list --folder=123456789 POSITIONAL ARGUMENTS [NAME ...] diff --git a/gcloud/beta/compute/org-security-policies/list-rules b/gcloud/beta/compute/org-security-policies/list-rules index 042ececfb..c23391571 100644 --- a/gcloud/beta/compute/org-security-policies/list-rules +++ b/gcloud/beta/compute/org-security-policies/list-rules @@ -13,14 +13,13 @@ DESCRIPTION the rules of an organization security policy. EXAMPLES - To list the rules of an organization security policy with ID "123456789", + To list the rules of an organization security policy with ID 123456789, run: - $ gcloud beta compute org-security-policies list-rules list-rules \ - 123456789 + $ gcloud beta compute org-security-policies list-rules 123456789 To list all the fields of the rules of an organization security policy with - ID "123456789", run: + ID 123456789, run: $ gcloud beta compute org-security-policies list-rules list-rules \ 123456789 --format="table( diff --git a/gcloud/beta/compute/org-security-policies/move b/gcloud/beta/compute/org-security-policies/move index 6a7ebdbcc..d415f3823 100644 --- a/gcloud/beta/compute/org-security-policies/move +++ b/gcloud/beta/compute/org-security-policies/move @@ -11,10 +11,10 @@ DESCRIPTION used to move organization security policies to new parent nodes. EXAMPLES - To move an organization security policy under folder with ID "123456789" to - folder "987654321", run: + To move an organization security policy under folder with ID 123456789 to + folder 987654321, run: - $ gcloud beta compute org-security-policies move move 123456789 \ + $ gcloud beta compute org-security-policies move 123456789 \ --folder=987654321 POSITIONAL ARGUMENTS diff --git a/gcloud/beta/compute/org-security-policies/rules/create b/gcloud/beta/compute/org-security-policies/rules/create index e18dcdabd..e1a5696f6 100644 --- a/gcloud/beta/compute/org-security-policies/rules/create +++ b/gcloud/beta/compute/org-security-policies/rules/create @@ -18,10 +18,10 @@ DESCRIPTION create organization security policy rules. EXAMPLES - To create a rule with priority "10" in an organization security policy with - ID "123456789", run: + To create a rule with priority 10 in an organization security policy with + ID 123456789, run: - $ gcloud beta compute org-security-policies rules create create 10 \ + $ gcloud beta compute org-security-policies rules create 10 \ --security-policy=123456789 --action=allow \ --description=example-rule --cloud-armor diff --git a/gcloud/beta/compute/org-security-policies/rules/delete b/gcloud/beta/compute/org-security-policies/rules/delete index 6b3fb5faa..ad64c5392 100644 --- a/gcloud/beta/compute/org-security-policies/rules/delete +++ b/gcloud/beta/compute/org-security-policies/rules/delete @@ -12,10 +12,10 @@ DESCRIPTION delete organization security policy rule. EXAMPLES - To delete a rule with priority ``10" in an organization security policy - with ID ``123456789", run: + To delete a rule with priority 10 in an organization security policy with + ID 123456789, run: - $ gcloud beta compute org-security-policies rules delete delete 10 \ + $ gcloud beta compute org-security-policies rules delete 10 \ --security-policy=123456789 POSITIONAL ARGUMENTS diff --git a/gcloud/beta/compute/org-security-policies/rules/describe b/gcloud/beta/compute/org-security-policies/rules/describe index 414b9fb07..1a1bb09d4 100644 --- a/gcloud/beta/compute/org-security-policies/rules/describe +++ b/gcloud/beta/compute/org-security-policies/rules/describe @@ -12,11 +12,11 @@ DESCRIPTION describe organization security policy rule. EXAMPLES - To describe a rule with priority ``10" in an organization security policy - with ID ``123456789", run: + To describe a rule with priority 10 in an organization security policy with + ID 123456789, run: - $ gcloud beta compute org-security-policies rules describe \ - describe 10 --security-policy=123456789 + $ gcloud beta compute org-security-policies rules describe 10 \ + --security-policy=123456789 POSITIONAL ARGUMENTS PRIORITY diff --git a/gcloud/beta/compute/org-security-policies/rules/update b/gcloud/beta/compute/org-security-policies/rules/update index 868edacbf..37fe7df7a 100644 --- a/gcloud/beta/compute/org-security-policies/rules/update +++ b/gcloud/beta/compute/org-security-policies/rules/update @@ -19,11 +19,11 @@ DESCRIPTION update organization security policy rules. EXAMPLES - To update a rule with priority ``10" in an organization security policy - with ID ``123456789" to change the action to ``allow" and description to - ``new-example-rule", run: + To update a rule with priority 10 in an organization security policy with + ID 123456789 to change the action to allow and description to + new-example-rule, run: - $ gcloud beta compute org-security-policies rules update create 10 \ + $ gcloud beta compute org-security-policies rules update 10 \ --security-policy=123456789 --action=allow \ --description=new-example-rule diff --git a/gcloud/beta/compute/org-security-policies/update b/gcloud/beta/compute/org-security-policies/update index 1180f2d22..7738a12f1 100644 --- a/gcloud/beta/compute/org-security-policies/update +++ b/gcloud/beta/compute/org-security-policies/update @@ -17,11 +17,11 @@ DESCRIPTION rules that controls access to various resources. EXAMPLES - To update an organization security policy with ID "123456789" to change the - description to "New description", run: + To update an organization security policy with ID 123456789 to change the + description to New description, run: - $ gcloud beta compute org-security-policies update update \ - 123456789 --description='New description' + $ gcloud beta compute org-security-policies update 123456789 \ + --description='New description' POSITIONAL ARGUMENTS SECURITY_POLICY diff --git a/gcloud/beta/compute/service-attachments/describe b/gcloud/beta/compute/service-attachments/describe index b0637cd95..faab6e5e2 100644 --- a/gcloud/beta/compute/service-attachments/describe +++ b/gcloud/beta/compute/service-attachments/describe @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud beta compute service-attachments describe NAME [--region=REGION] - [GCLOUD_WIDE_FLAG ...] + [--show-nat-ips] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Display details about a Google Compute Engine service attachment. @@ -40,6 +40,12 @@ FLAGS Alternatively, the region can be stored in the environment variable CLOUDSDK_COMPUTE_REGION. + --show-nat-ips + Determines whether to include the NAT IPs of connected endpoints in the + service attachment output. If enabled (--show-nat-ips), the output will + include the list of NAT IPs for each connected PSC endpoint and any + endpoints propagated from them. + 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/beta/config/get b/gcloud/beta/config/get index b786c60a8..8251e9e16 100644 --- a/gcloud/beta/config/get +++ b/gcloud/beta/config/get @@ -1393,6 +1393,12 @@ AVAILABLE PROPERTIES If True, use the deprecated upload implementation which uses gsutil. + use_gsutil_rsync_delete_unmatched_destination_objects_behavior + If True, rsync will preserve unmatched destination objects while + using --delete-unmatched-destination-objects flag along with other + flags such as --no-clobber, --skip-unsupported and + --skip-if-dest-has-newer-mtime just as it would with gsutil. + use_magicfile If True, uses the file --mime command to guess content types instead of the default filename extension-based mechanism. diff --git a/gcloud/beta/config/help b/gcloud/beta/config/help index 2ae3aa6e3..c89ee6f0a 100644 --- a/gcloud/beta/config/help +++ b/gcloud/beta/config/help @@ -1425,6 +1425,12 @@ AVAILABLE PROPERTIES If True, use the deprecated upload implementation which uses gsutil. + use_gsutil_rsync_delete_unmatched_destination_objects_behavior + If True, rsync will preserve unmatched destination objects while + using --delete-unmatched-destination-objects flag along with other + flags such as --no-clobber, --skip-unsupported and + --skip-if-dest-has-newer-mtime just as it would with gsutil. + use_magicfile If True, uses the file --mime command to guess content types instead of the default filename extension-based mechanism. diff --git a/gcloud/beta/config/list b/gcloud/beta/config/list index b5487a3d5..23e5f4c52 100644 --- a/gcloud/beta/config/list +++ b/gcloud/beta/config/list @@ -1437,6 +1437,12 @@ AVAILABLE PROPERTIES If True, use the deprecated upload implementation which uses gsutil. + use_gsutil_rsync_delete_unmatched_destination_objects_behavior + If True, rsync will preserve unmatched destination objects while + using --delete-unmatched-destination-objects flag along with other + flags such as --no-clobber, --skip-unsupported and + --skip-if-dest-has-newer-mtime just as it would with gsutil. + use_magicfile If True, uses the file --mime command to guess content types instead of the default filename extension-based mechanism. diff --git a/gcloud/beta/config/set b/gcloud/beta/config/set index 8dc0cf2c0..c80567d00 100644 --- a/gcloud/beta/config/set +++ b/gcloud/beta/config/set @@ -1440,6 +1440,12 @@ AVAILABLE PROPERTIES If True, use the deprecated upload implementation which uses gsutil. + use_gsutil_rsync_delete_unmatched_destination_objects_behavior + If True, rsync will preserve unmatched destination objects while + using --delete-unmatched-destination-objects flag along with other + flags such as --no-clobber, --skip-unsupported and + --skip-if-dest-has-newer-mtime just as it would with gsutil. + use_magicfile If True, uses the file --mime command to guess content types instead of the default filename extension-based mechanism. diff --git a/gcloud/beta/config/unset b/gcloud/beta/config/unset index 5ec6a5cfe..d5ecf2cff 100644 --- a/gcloud/beta/config/unset +++ b/gcloud/beta/config/unset @@ -1401,6 +1401,12 @@ AVAILABLE PROPERTIES If True, use the deprecated upload implementation which uses gsutil. + use_gsutil_rsync_delete_unmatched_destination_objects_behavior + If True, rsync will preserve unmatched destination objects while + using --delete-unmatched-destination-objects flag along with other + flags such as --no-clobber, --skip-unsupported and + --skip-if-dest-has-newer-mtime just as it would with gsutil. + use_magicfile If True, uses the file --mime command to guess content types instead of the default filename extension-based mechanism. diff --git a/gcloud/beta/run/multi-region-services/delete b/gcloud/beta/run/multi-region-services/delete index 14470c254..bf383adc5 100644 --- a/gcloud/beta/run/multi-region-services/delete +++ b/gcloud/beta/run/multi-region-services/delete @@ -63,8 +63,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 run multi-region-services delete $ gcloud alpha run multi-region-services delete diff --git a/gcloud/beta/run/multi-region-services/describe b/gcloud/beta/run/multi-region-services/describe index a5493ba02..b76b508fc 100644 --- a/gcloud/beta/run/multi-region-services/describe +++ b/gcloud/beta/run/multi-region-services/describe @@ -69,8 +69,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 run multi-region-services describe $ gcloud alpha run multi-region-services describe diff --git a/gcloud/beta/run/multi-region-services/help b/gcloud/beta/run/multi-region-services/help index d44c43895..e5e0874b3 100644 --- a/gcloud/beta/run/multi-region-services/help +++ b/gcloud/beta/run/multi-region-services/help @@ -49,8 +49,10 @@ COMMANDS configuration settings in Multi-Region Services. 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 run multi-region-services $ gcloud alpha run multi-region-services diff --git a/gcloud/beta/run/multi-region-services/list b/gcloud/beta/run/multi-region-services/list index d4df2d3c9..de13103ac 100644 --- a/gcloud/beta/run/multi-region-services/list +++ b/gcloud/beta/run/multi-region-services/list @@ -61,8 +61,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 run multi-region-services list $ gcloud alpha run multi-region-services list diff --git a/gcloud/beta/run/multi-region-services/replace b/gcloud/beta/run/multi-region-services/replace index 444a3688a..09727de47 100644 --- a/gcloud/beta/run/multi-region-services/replace +++ b/gcloud/beta/run/multi-region-services/replace @@ -45,8 +45,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 run multi-region-services replace $ gcloud alpha run multi-region-services replace diff --git a/gcloud/beta/run/multi-region-services/update b/gcloud/beta/run/multi-region-services/update index fc4377019..798bc5edf 100644 --- a/gcloud/beta/run/multi-region-services/update +++ b/gcloud/beta/run/multi-region-services/update @@ -609,8 +609,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 run multi-region-services update $ gcloud alpha run multi-region-services update diff --git a/gcloud/composer/environments/create b/gcloud/composer/environments/create index c4c8c8459..28b568f6e 100644 --- a/gcloud/composer/environments/create +++ b/gcloud/composer/environments/create @@ -210,8 +210,7 @@ FLAGS --service-account=SERVICE_ACCOUNT The Google Cloud Platform service account to be used by the node VMs. - If a service account is not specified, the "default" Compute Engine - service account for the project is used. Cannot be updated. + You must explicitly specify a service account. Cannot be updated. --storage-bucket=STORAGE_BUCKET Name of an exisiting Cloud Storage bucket to be used by the diff --git a/gcloud/compute/instances/network-interfaces/update b/gcloud/compute/instances/network-interfaces/update index f9e98f4a7..60346692f 100644 --- a/gcloud/compute/instances/network-interfaces/update +++ b/gcloud/compute/instances/network-interfaces/update @@ -104,13 +104,15 @@ FLAGS compute/region property value for this command invocation. --stack-type=STACK_TYPE - The stack type for the default network interface. Determines if IPv6 is - enabled on the default network interface. STACK_TYPE must be one of: + The stack type for the network interface. Determines if IPv6 is enabled + on the network interface. STACK_TYPE must be one of: IPV4_IPV6 The network interface can have both IPv4 and IPv6 addresses. IPV4_ONLY The network interface will be assigned IPv4 addresses. + IPV6_ONLY + The network interface will be assigned IPv6 addresses. --subnetwork=SUBNETWORK Specifies the subnetwork this network interface belongs to. diff --git a/gcloud/compute/service-attachments/describe b/gcloud/compute/service-attachments/describe index 95441c825..58f79a392 100644 --- a/gcloud/compute/service-attachments/describe +++ b/gcloud/compute/service-attachments/describe @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud compute service-attachments describe NAME [--region=REGION] - [GCLOUD_WIDE_FLAG ...] + [--show-nat-ips] [GCLOUD_WIDE_FLAG ...] DESCRIPTION Display details about a Google Compute Engine service attachment. @@ -40,6 +40,12 @@ FLAGS Alternatively, the region can be stored in the environment variable CLOUDSDK_COMPUTE_REGION. + --show-nat-ips + Determines whether to include the NAT IPs of connected endpoints in the + service attachment output. If enabled (--show-nat-ips), the output will + include the list of NAT IPs for each connected PSC endpoint and any + endpoints propagated from them. + 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 f63075b88..d78f56ddd 100644 --- a/gcloud/config/get +++ b/gcloud/config/get @@ -1393,6 +1393,12 @@ AVAILABLE PROPERTIES If True, use the deprecated upload implementation which uses gsutil. + use_gsutil_rsync_delete_unmatched_destination_objects_behavior + If True, rsync will preserve unmatched destination objects while + using --delete-unmatched-destination-objects flag along with other + flags such as --no-clobber, --skip-unsupported and + --skip-if-dest-has-newer-mtime just as it would with gsutil. + use_magicfile If True, uses the file --mime command to guess content types instead of the default filename extension-based mechanism. diff --git a/gcloud/config/help b/gcloud/config/help index 514a182c4..d1ebe3d6b 100644 --- a/gcloud/config/help +++ b/gcloud/config/help @@ -1425,6 +1425,12 @@ AVAILABLE PROPERTIES If True, use the deprecated upload implementation which uses gsutil. + use_gsutil_rsync_delete_unmatched_destination_objects_behavior + If True, rsync will preserve unmatched destination objects while + using --delete-unmatched-destination-objects flag along with other + flags such as --no-clobber, --skip-unsupported and + --skip-if-dest-has-newer-mtime just as it would with gsutil. + use_magicfile If True, uses the file --mime command to guess content types instead of the default filename extension-based mechanism. diff --git a/gcloud/config/list b/gcloud/config/list index d7eabcc85..2946d701b 100644 --- a/gcloud/config/list +++ b/gcloud/config/list @@ -1437,6 +1437,12 @@ AVAILABLE PROPERTIES If True, use the deprecated upload implementation which uses gsutil. + use_gsutil_rsync_delete_unmatched_destination_objects_behavior + If True, rsync will preserve unmatched destination objects while + using --delete-unmatched-destination-objects flag along with other + flags such as --no-clobber, --skip-unsupported and + --skip-if-dest-has-newer-mtime just as it would with gsutil. + use_magicfile If True, uses the file --mime command to guess content types instead of the default filename extension-based mechanism. diff --git a/gcloud/config/set b/gcloud/config/set index 480b973d4..21bfe2ce5 100644 --- a/gcloud/config/set +++ b/gcloud/config/set @@ -1440,6 +1440,12 @@ AVAILABLE PROPERTIES If True, use the deprecated upload implementation which uses gsutil. + use_gsutil_rsync_delete_unmatched_destination_objects_behavior + If True, rsync will preserve unmatched destination objects while + using --delete-unmatched-destination-objects flag along with other + flags such as --no-clobber, --skip-unsupported and + --skip-if-dest-has-newer-mtime just as it would with gsutil. + use_magicfile If True, uses the file --mime command to guess content types instead of the default filename extension-based mechanism. diff --git a/gcloud/config/unset b/gcloud/config/unset index c43c6230e..04ef8011b 100644 --- a/gcloud/config/unset +++ b/gcloud/config/unset @@ -1401,6 +1401,12 @@ AVAILABLE PROPERTIES If True, use the deprecated upload implementation which uses gsutil. + use_gsutil_rsync_delete_unmatched_destination_objects_behavior + If True, rsync will preserve unmatched destination objects while + using --delete-unmatched-destination-objects flag along with other + flags such as --no-clobber, --skip-unsupported and + --skip-if-dest-has-newer-mtime just as it would with gsutil. + use_magicfile If True, uses the file --mime command to guess content types instead of the default filename extension-based mechanism. diff --git a/gcloud/database-migration/migration-jobs/create b/gcloud/database-migration/migration-jobs/create index ce2a28021..7dc828779 100644 --- a/gcloud/database-migration/migration-jobs/create +++ b/gcloud/database-migration/migration-jobs/create @@ -352,44 +352,47 @@ OPTIONAL FLAGS --vm=VM Name of VM that will host the SSH tunnel bastion. - The SQL Server homogeneous migration config. This is used only for SQL - Server to CloudSQL SQL Server migrations. + At most one of these can be specified: - --sqlserver-databases=databaseName,[...] - A list of databases to be migrated to the destination Cloud SQL - instance. Provide databases as a comma separated list. This list - should contain all encrypted and non-encrypted database names. This - flag is used only for SQL Server to Cloud SQL migrations. + The SQL Server homogeneous migration config. This is used only for SQL + Server to CloudSQL SQL Server migrations. - This flag argument must be specified if any of the other arguments in - this group are specified. + --sqlserver-databases=databaseName,[...] + A list of databases to be migrated to the destination Cloud SQL + instance. Provide databases as a comma separated list. This list + should contain all encrypted and non-encrypted database names. This + flag is used only for SQL Server to Cloud SQL migrations. - --sqlserver-diff-backup - Enable differential backups. If not specified, differential backups - are disabled by default. Use --sqlserver-diff-backup to enable and - --no-sqlserver-diff-backup to disable. This flag is used only for - homogeneous SQL Server to Cloud SQL for SQL Server migrations. + This flag argument must be specified if any of the other arguments + in this group are specified. - --sqlserver-encrypted-databases=SQLSERVER_ENCRYPTED_DATABASES - A JSON/YAML file describing the encryption settings per database for - all encrytped databases. Note: Path to the Certificate (.cer) and - Private Key (.pvk) in Cloud Storage, should be in the form of - gs://bucketName/fileName. The instance must have write permissions to - the bucket and read access to the file. An example of a JSON request: - [{ "database": "db1", "encryptionOptions": { "certPath": "Path to - certificate 1", "pvkPath": "Path to certificate private key 1", - "pvkPassword": "Private key password 1" } }, { "database": "db2", - "encryptionOptions": { "certPath": "Path to certificate 2", - "pvkPath": "Path to certificate private key 2", "pvkPassword": - "Private key password 2" } }] + --sqlserver-diff-backup + Enable differential backups. If not specified, differential backups + are disabled by default. Use --sqlserver-diff-backup to enable and + --no-sqlserver-diff-backup to disable. This flag is used only for + homogeneous SQL Server to Cloud SQL for SQL Server migrations. - This flag accepts "-" for stdin. This flag is used only for SQL Server to Cloud SQL migrations. + --sqlserver-encrypted-databases=SQLSERVER_ENCRYPTED_DATABASES + A JSON/YAML file describing the encryption settings per database + for all encrytped databases. Note: Path to the Certificate (.cer) + and Private Key (.pvk) in Cloud Storage, should be in the form of + gs://bucketName/fileName. The instance must have write permissions + to the bucket and read access to the file. An example of a JSON + request: [{ "database": "db1", "encryptionOptions": { "certPath": + "Path to certificate 1", "pvkPath": "Path to certificate private + key 1", "pvkPassword": "Private key password 1" } }, { "database": + "db2", "encryptionOptions": { "certPath": "Path to certificate 2", + "pvkPath": "Path to certificate private key 2", "pvkPassword": + "Private key password 2" } }] - --sqlserver-promote-when-ready - Promote the database when it is ready. Use - --sqlserver-promote-when-ready to enable and - --no-sqlserver-promote-when-ready to disable. This flag is used only - for homogeneous SQL Server to Cloud SQL for SQL Server migrations. + This flag accepts "-" for stdin. This flag is used only for SQL Server to Cloud SQL migrations. + + --sqlserver-promote-when-ready + Promote the database when it is ready. Use + --sqlserver-promote-when-ready to enable and + --no-sqlserver-promote-when-ready to disable. This flag is used + only for homogeneous SQL Server to Cloud SQL for SQL Server + migrations. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/database-migration/migration-jobs/update b/gcloud/database-migration/migration-jobs/update index 580088443..adc05a836 100644 --- a/gcloud/database-migration/migration-jobs/update +++ b/gcloud/database-migration/migration-jobs/update @@ -249,41 +249,44 @@ FLAGS --vpc=VPC Name of the VPC network where the VM is hosted. - The SQL Server homogeneous migration config. This is used only for SQL - Server to CloudSQL SQL Server migrations. + At most one of these can be specified: - --sqlserver-databases=databaseName,[...] - A list of databases to be migrated to the destination Cloud SQL - instance. Provide databases as a comma separated list. This list - should contain all encrypted and non-encrypted database names. This - flag is used only for SQL Server to Cloud SQL migrations. + The SQL Server homogeneous migration config. This is used only for SQL + Server to CloudSQL SQL Server migrations. - --sqlserver-diff-backup - Enable differential backups. If not specified, differential backups - are disabled by default. Use --sqlserver-diff-backup to enable and - --no-sqlserver-diff-backup to disable. This flag is used only for - homogeneous SQL Server to Cloud SQL for SQL Server migrations. + --sqlserver-databases=databaseName,[...] + A list of databases to be migrated to the destination Cloud SQL + instance. Provide databases as a comma separated list. This list + should contain all encrypted and non-encrypted database names. This + flag is used only for SQL Server to Cloud SQL migrations. - --sqlserver-encrypted-databases=SQLSERVER_ENCRYPTED_DATABASES - A JSON/YAML file describing the encryption settings per database for - all encrytped databases. Note: Path to the Certificate (.cer) and - Private Key (.pvk) in Cloud Storage, should be in the form of - gs://bucketName/fileName. The instance must have write permissions to - the bucket and read access to the file. An example of a JSON request: - [{ "database": "db1", "encryptionOptions": { "certPath": "Path to - certificate 1", "pvkPath": "Path to certificate private key 1", - "pvkPassword": "Private key password 1" } }, { "database": "db2", - "encryptionOptions": { "certPath": "Path to certificate 2", - "pvkPath": "Path to certificate private key 2", "pvkPassword": - "Private key password 2" } }] + --sqlserver-diff-backup + Enable differential backups. If not specified, differential backups + are disabled by default. Use --sqlserver-diff-backup to enable and + --no-sqlserver-diff-backup to disable. This flag is used only for + homogeneous SQL Server to Cloud SQL for SQL Server migrations. - This flag accepts "-" for stdin. This flag is used only for SQL Server to Cloud SQL migrations. + --sqlserver-encrypted-databases=SQLSERVER_ENCRYPTED_DATABASES + A JSON/YAML file describing the encryption settings per database + for all encrytped databases. Note: Path to the Certificate (.cer) + and Private Key (.pvk) in Cloud Storage, should be in the form of + gs://bucketName/fileName. The instance must have write permissions + to the bucket and read access to the file. An example of a JSON + request: [{ "database": "db1", "encryptionOptions": { "certPath": + "Path to certificate 1", "pvkPath": "Path to certificate private + key 1", "pvkPassword": "Private key password 1" } }, { "database": + "db2", "encryptionOptions": { "certPath": "Path to certificate 2", + "pvkPath": "Path to certificate private key 2", "pvkPassword": + "Private key password 2" } }] - --sqlserver-promote-when-ready - Promote the database when it is ready. Use - --sqlserver-promote-when-ready to enable and - --no-sqlserver-promote-when-ready to disable. This flag is used only - for homogeneous SQL Server to Cloud SQL for SQL Server migrations. + This flag accepts "-" for stdin. This flag is used only for SQL Server to Cloud SQL migrations. + + --sqlserver-promote-when-ready + Promote the database when it is ready. Use + --sqlserver-promote-when-ready to enable and + --no-sqlserver-promote-when-ready to disable. This flag is used + only for homogeneous SQL Server to Cloud SQL for SQL Server + migrations. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/looker/instances/create b/gcloud/looker/instances/create index 34652eb08..9cad241e5 100644 --- a/gcloud/looker/instances/create +++ b/gcloud/looker/instances/create @@ -177,7 +177,9 @@ OPTIONAL FLAGS this group are specified. --private-ip-enabled - This specifies whether private IP is enabled on the Looker instance. + This specifies whether private IP (PSA) is enabled on the Looker + instance. This flag is for creating a PSA (Private Service Access) + instance. This flag argument must be specified if any of the other arguments in this group are specified. diff --git a/gcloud/run/deploy b/gcloud/run/deploy index 72905ea4a..ddf66ca1e 100644 --- a/gcloud/run/deploy +++ b/gcloud/run/deploy @@ -11,7 +11,7 @@ SYNOPSIS [--execution-environment=EXECUTION_ENVIRONMENT] [--gpu-type=GPU_TYPE] [--[no-]gpu-zonal-redundancy] [--ingress=INGRESS; default="all"] [--[no-]invoker-iam-check] [--max-instances=MAX_INSTANCES] [--min=MIN] - [--min-instances=MIN_INSTANCES] [--region=REGION] + [--min-instances=MIN_INSTANCES] [--region=REGION] [--regions=REGIONS] [--remove-containers=[CONTAINER,...]] [--revision-suffix=REVISION_SUFFIX] [--scaling=SCALING] [--service-account=SERVICE_ACCOUNT] [--[no-]session-affinity] @@ -232,6 +232,10 @@ FLAGS Region in which the resource can be found. Alternatively, set the property [run/region]. + --regions=REGIONS + Comma-separated list of regions in which the multi-region Service can + be found. + --remove-containers=[CONTAINER,...] List of containers to remove. diff --git a/gcloud/run/help b/gcloud/run/help index c3e121128..3875d6e26 100644 --- a/gcloud/run/help +++ b/gcloud/run/help @@ -29,6 +29,9 @@ GROUPS jobs View and manage your Cloud Run jobs. + multi-region-services + Manage your Cloud Run multi-region services. + regions View available Cloud Run (fully managed) regions. diff --git a/gcloud/run/multi-region-services/delete b/gcloud/run/multi-region-services/delete new file mode 100644 index 000000000..cb429e365 --- /dev/null +++ b/gcloud/run/multi-region-services/delete @@ -0,0 +1,69 @@ +NAME + gcloud run multi-region-services delete - deletes a multi-region service + +SYNOPSIS + gcloud run multi-region-services delete (SERVICE : --namespace=NAMESPACE) + [--[no-]async] [--region=REGION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Deletes a multi-region service. + +EXAMPLES + To delete a service: + + $ gcloud run multi-region-services delete + +POSITIONAL ARGUMENTS + Service resource - Service to delete. The arguments in this group can be + used to specify the attributes of this resource. + + This must be specified. + + SERVICE + ID of the service or fully qualified identifier for the service. + + To set the service attribute: + ▸ provide the argument SERVICE on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --namespace=NAMESPACE + Specific to Cloud Run for Anthos: Kubernetes namespace for the + service. + + To set the namespace attribute: + ▸ provide the argument SERVICE on the command line with a fully + specified name; + ▸ provide the argument --namespace on the command line; + ▸ set the property run/namespace; + ▸ For Cloud Run on Kubernetes Engine, defaults to "default". + Otherwise, defaults to project ID.; + ▸ provide the argument project on the command line; + ▸ set the property core/project. + +FLAGS + --[no-]async + Return immediately, without waiting for the operation in progress to + complete. Defaults to --no-async. Use --async to enable and --no-async + to disable. + + --region=REGION + Region in which the resource can be found. Alternatively, set the + property [run/region]. + +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 run multi-region-services delete + + $ gcloud beta run multi-region-services delete + diff --git a/gcloud/run/multi-region-services/describe b/gcloud/run/multi-region-services/describe new file mode 100644 index 000000000..5bf183463 --- /dev/null +++ b/gcloud/run/multi-region-services/describe @@ -0,0 +1,76 @@ +NAME + gcloud run multi-region-services describe - command to describe a + multi-region service + +SYNOPSIS + gcloud run multi-region-services describe (SERVICE : --namespace=NAMESPACE) + [--region=REGION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Command to describe a multi-region service. + +EXAMPLES + To obtain details about a given service: + + $ gcloud run multi-region-services describe + + To get those details in the YAML format: + + $ gcloud run multi-region-services describe \ + --format=yaml + + To get them in YAML format suited to export (omitting metadata specific to + this deployment and status info): + + $ gcloud run multi-region-services describe \ + --format=export + +POSITIONAL ARGUMENTS + Service resource - Service to describe. The arguments in this group can be + used to specify the attributes of this resource. + + This must be specified. + + SERVICE + ID of the service or fully qualified identifier for the service. + + To set the service attribute: + ▸ provide the argument SERVICE on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --namespace=NAMESPACE + Specific to Cloud Run for Anthos: Kubernetes namespace for the + service. + + To set the namespace attribute: + ▸ provide the argument SERVICE on the command line with a fully + specified name; + ▸ provide the argument --namespace on the command line; + ▸ set the property run/namespace; + ▸ For Cloud Run on Kubernetes Engine, defaults to "default". + Otherwise, defaults to project ID.; + ▸ provide the argument project on the command line; + ▸ set the property core/project. + +FLAGS + --region=REGION + Region in which the resource can be found. Alternatively, set the + property [run/region]. + +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 run multi-region-services describe + + $ gcloud beta run multi-region-services describe + diff --git a/gcloud/run/multi-region-services/help b/gcloud/run/multi-region-services/help new file mode 100644 index 000000000..753103250 --- /dev/null +++ b/gcloud/run/multi-region-services/help @@ -0,0 +1,57 @@ +NAME + gcloud run multi-region-services - manage your Cloud Run multi-region + services + +SYNOPSIS + gcloud run multi-region-services COMMAND [--region=REGION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + The gcloud run multi-region-services command group lets you deploy + container images to Google Cloud Run across multiple regions at once. + +EXAMPLES + To deploy your container, use the gcloud run multi-region-services deploy + command: + + $ gcloud run multi-region-services deploy \ + --image --regions [region-list] For more \ + information, run: + $ gcloud run deploy --help + +FLAGS + --region=REGION + Region in which the resource can be found. Alternatively, set the + property [run/region]. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + delete + Deletes a multi-region service. + + describe + Command to describe a multi-region service. + + list + List available multi-region services. + + replace + Create or Update multi-region service from YAML. + + update + Update environment variables, add/remove regions, and other + configuration settings in Multi-Region Services. + +NOTES + These variants are also available: + + $ gcloud alpha run multi-region-services + + $ gcloud beta run multi-region-services + diff --git a/gcloud/run/multi-region-services/list b/gcloud/run/multi-region-services/list new file mode 100644 index 000000000..47b2d4ff0 --- /dev/null +++ b/gcloud/run/multi-region-services/list @@ -0,0 +1,69 @@ +NAME + gcloud run multi-region-services list - list available multi-region + services + +SYNOPSIS + gcloud run multi-region-services list [--region=REGION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List available multi-region services. + +EXAMPLES + To list available services: + + $ gcloud run multi-region-services list + +FLAGS + --region=REGION + Region in which the resource can be found. Alternatively, set the + property [run/region]. + +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. + +NOTES + These variants are also available: + + $ gcloud alpha run multi-region-services list + + $ gcloud beta run multi-region-services list + diff --git a/gcloud/run/multi-region-services/replace b/gcloud/run/multi-region-services/replace new file mode 100644 index 000000000..3d9bc1ed8 --- /dev/null +++ b/gcloud/run/multi-region-services/replace @@ -0,0 +1,53 @@ +NAME + gcloud run multi-region-services replace - create or Update multi-region + service from YAML + +SYNOPSIS + gcloud run multi-region-services replace FILE [--async] [--dry-run] + [--region=REGION] [--regions=REGIONS] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Creates or replaces a service from a YAML service specification. + +EXAMPLES + To replace the specification for a service defined in myservice.yaml + + $ gcloud run multi-region-services replace myservice.yaml + +POSITIONAL ARGUMENTS + FILE + The absolute path to the YAML file with a Knative service definition + for the service to update or deploy. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --dry-run + If set to true, only validates the configuration. The configuration + will not be applied. + + --region=REGION + Region in which the resource can be found. Alternatively, set the + property [run/region]. + + --regions=REGIONS + Comma-separated list of regions in which the multi-region Service can + be found. + +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 run multi-region-services replace + + $ gcloud beta run multi-region-services replace + diff --git a/gcloud/run/multi-region-services/update b/gcloud/run/multi-region-services/update new file mode 100644 index 000000000..110219cfd --- /dev/null +++ b/gcloud/run/multi-region-services/update @@ -0,0 +1,590 @@ +NAME + gcloud run multi-region-services update - update environment variables, + add/remove regions, and other configuration settings in Multi-Region + Services + +SYNOPSIS + gcloud run multi-region-services update [[SERVICE] --namespace=NAMESPACE] + [--async] [--breakglass=JUSTIFICATION] [--clear-vpc-connector] + [--concurrency=CONCURRENCY] [--container=CONTAINER] [--[no-]cpu-boost] + [--[no-]cpu-throttling] [--[no-]default-url] + [--execution-environment=EXECUTION_ENVIRONMENT] [--gpu-type=GPU_TYPE] + [--[no-]gpu-zonal-redundancy] [--ingress=INGRESS; default="all"] + [--[no-]invoker-iam-check] [--max-instances=MAX_INSTANCES] [--min=MIN] + [--min-instances=MIN_INSTANCES] [--region=REGION] + [--remove-containers=[CONTAINER,...]] + [--revision-suffix=REVISION_SUFFIX] [--scaling=SCALING] + [--service-account=SERVICE_ACCOUNT] [--[no-]session-affinity] + [--tag=TAG] [--timeout=TIMEOUT] [--no-traffic] + [--vpc-connector=VPC_CONNECTOR] [--vpc-egress=VPC_EGRESS] + [--add-cloudsql-instances=[CLOUDSQL-INSTANCES,...] + | --clear-cloudsql-instances + | --remove-cloudsql-instances=[CLOUDSQL-INSTANCES,...] + | --set-cloudsql-instances=[CLOUDSQL-INSTANCES,...]] + [--add-custom-audiences=[CUSTOM-AUDIENCES,...] + | --clear-custom-audiences + | --remove-custom-audiences=[CUSTOM-AUDIENCES,...] + | --set-custom-audiences=[CUSTOM-AUDIENCES,...]] + [--add-volume=[KEY=VALUE,...] + --clear-volumes --remove-volume=[VOLUME,...]] + [--add-volume-mount=[volume=NAME,mount-path=MOUNT_PATH,...] + --args=[ARG,...] --clear-volume-mounts --command=[COMMAND,...] + --cpu=CPU --depends-on=[CONTAINER,...] --gpu=GPU --image=IMAGE + --liveness-probe=[KEY=VALUE,...] --memory=MEMORY --port=PORT + --remove-volume-mount=[MOUNT_PATH,...] + --startup-probe=[KEY=VALUE,...] --[no-]use-http2 --clear-env-vars + | --env-vars-file=FILE_PATH | --set-env-vars=[KEY=VALUE,...] + | --remove-env-vars=[KEY,...] + --update-env-vars=[KEY=VALUE,...] --clear-secrets + | --set-secrets=[KEY=VALUE,...] + | --remove-secrets=[KEY,...] --update-secrets=[KEY=VALUE,...]] + [--binary-authorization=POLICY | --clear-binary-authorization] + [--clear-encryption-key-shutdown-hours + | --encryption-key-shutdown-hours=ENCRYPTION_KEY_SHUTDOWN_HOURS] + [--clear-key | --key=KEY] + [--clear-labels | --remove-labels=[KEY,...] --labels=[KEY=VALUE,...] + | --update-labels=[KEY=VALUE,...]] + [--clear-network + | --network=NETWORK --subnet=SUBNET --clear-network-tags + | --network-tags=[TAG,...]] + [--clear-post-key-revocation-action-type + | --post-key-revocation-action-type=POST_KEY_REVOCATION_ACTION_TYPE] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Update environment variables, add/remove regions, and other configuration + settings in Multi-Region Services. + +EXAMPLES + To update one or more env vars: + + $ gcloud run multi-region-services update myservice \ + --update-env-vars=KEY1=VALUE1,KEY2=VALUE2 + +POSITIONAL ARGUMENTS + Service resource - Service to update the configuration of. The arguments + in this group can be used to specify the attributes of this resource. + + [SERVICE] + ID of the service or fully qualified identifier for the service. + + To set the service attribute: + ▸ provide the argument SERVICE on the command line; + ▸ specify the service name from an interactive prompt. + + --namespace=NAMESPACE + Specific to Cloud Run for Anthos: Kubernetes namespace for the + service. + + To set the namespace attribute: + ▸ provide the argument SERVICE on the command line with a fully + specified name; + ▸ specify the service name from an interactive prompt with a fully + specified name; + ▸ provide the argument --namespace on the command line; + ▸ set the property run/namespace; + ▸ For Cloud Run on Kubernetes Engine, defaults to "default". + Otherwise, defaults to project ID.; + ▸ provide the argument project on the command line; + ▸ set the property core/project. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --breakglass=JUSTIFICATION + Justification to bypass Binary Authorization policy constraints and + allow the operation. See + https://cloud.google.com/binary-authorization/docs/using-breakglass for + more information. Next update or deploy command will automatically + clear existing breakglass justification. + + --clear-vpc-connector + Remove the VPC connector for this resource. + + --concurrency=CONCURRENCY + Set the maximum number of concurrent requests allowed per container + instance. Leave concurrency unspecified or provide the special value + 'default' to receive the server default value. + + --container=CONTAINER + Specifies a container by name. Flags following --container will apply + to the specified container. + + Flags that are not container-specific must be specified before + --container. + + --[no-]cpu-boost + Whether to allocate extra CPU to containers on startup to reduce the + perceived latency of a cold start request. Enabled by default when + unspecified on new services. Use --cpu-boost to enable and + --no-cpu-boost to disable. + + --[no-]cpu-throttling + Whether to throttle the CPU when the container is not actively serving + requests. Use --cpu-throttling to enable and --no-cpu-throttling to + disable. + + --[no-]default-url + Toggles the default url for a run service. This is enabled by default + if not specified. Use --default-url to enable and --no-default-url to + disable. + + --execution-environment=EXECUTION_ENVIRONMENT + Selects the execution environment where the application will run. + EXECUTION_ENVIRONMENT must be one of: + + gen1 + Run the application in a first generation execution environment. + gen2 + Run the application in a second generation execution environment. + + --gpu-type=GPU_TYPE + The GPU type to use. + + --[no-]gpu-zonal-redundancy + Set GPU zonal redundancy. Use --gpu-zonal-redundancy to enable and + --no-gpu-zonal-redundancy to disable. + + --ingress=INGRESS; default="all" + Set the ingress traffic sources allowed to call the service. For Cloud + Run the --[no-]allow-unauthenticated flag separately controls the + identities allowed to call the service. INGRESS must be one of: + + all + Inbound requests from all sources are allowed. + internal + For Cloud Run, only inbound requests from VPC networks in the same + project or VPC Service Controls perimeter, as well as Pub/Sub + subscriptions and Eventarc events in the same project or VPC + Service Controls perimeter are allowed. All other requests are + rejected. See https://cloud.google.com/run/docs/securing/ingress + for full details on the definition of internal traffic for Cloud + Run. + + internal-and-cloud-load-balancing + Only inbound requests from Google Cloud Load Balancing or a traffic + source allowed by the internal option are allowed. + + --[no-]invoker-iam-check + Optionally disable invoker IAM checks. This feature is available by + invitation only. More info at + https://cloud.google.com/run/docs/securing/managing-access#invoker_check. + Use --invoker-iam-check to enable and --no-invoker-iam-check to + disable. + + --max-instances=MAX_INSTANCES + The maximum number of container instances for this Revision to run or + 'default' to remove. This setting is immutably set on each new Revision + and modifying its value will deploy another Revision. + + --min=MIN + The minimum number of container instances to run for this Service or + 'default' to remove. These instances will be divided among all + Revisions receiving a percentage of traffic and can be modified without + deploying a new Revision. + + --min-instances=MIN_INSTANCES + The minimum number of container instances to run for this Revision or + 'default' to remove. This setting is immutably set on each new Revision + and modifying its value will deploy a another Revision. Consider using + --min to set the minimum number of instances across all revisions of + the Service which may be modified dynamically. + + --region=REGION + Region in which the resource can be found. Alternatively, set the + property [run/region]. + + --remove-containers=[CONTAINER,...] + List of containers to remove. + + --revision-suffix=REVISION_SUFFIX + Specify the suffix of the revision name. Revision names always start + with the service name automatically. For example, specifying + [--revision-suffix=v1] for a service named 'helloworld', would lead to + a revision named 'helloworld-v1'. Set empty string to clear the suffix + and resume server-assigned naming. + + --scaling=SCALING + The scaling mode to use for this resource. Flag value could be either + "auto" for automatic scaling, or a positive integer to configure manual + scaling with the given integer as a fixed instance count. + + --service-account=SERVICE_ACCOUNT + the email address of an IAM service account associated with the + revision of the service. The service account represents the identity of + the running revision, and determines what permissions the revision has. + + --[no-]session-affinity + Whether to enable session affinity for connections to the service. Use + --session-affinity to enable and --no-session-affinity to disable. + + --tag=TAG + Traffic tag to assign to the newly created revision. + + --timeout=TIMEOUT + Set the maximum request execution time (timeout). It is specified as a + duration; for example, "10m5s" is ten minutes, and five seconds. If you + don't specify a unit, seconds is assumed. For example, "10" is 10 + seconds. + + --no-traffic + True to avoid sending traffic to the revision being deployed. Setting + this flag assigns any traffic assigned to the LATEST revision to the + specific revision bound to LATEST before the deployment. The effect is + that the revision being deployed will not receive traffic. + + After a deployment with this flag the LATEST revision will not receive + traffic on future deployments. To restore sending traffic to the LATEST + revision by default, run the gcloud run services update-traffic command + with --to-latest. + + --vpc-connector=VPC_CONNECTOR + Set a VPC connector for this resource. + + --vpc-egress=VPC_EGRESS + Specify which of the outbound traffic to send through Direct VPC egress + or the VPC connector for this resource. This resource must have Direct + VPC egress enabled or a VPC connector to set this flag. VPC_EGRESS must + be one of: + + all + (DEPRECATED) Sends all outbound traffic through Direct VPC egress + or the VPC connector. Provides the same functionality as + 'all-traffic'. Prefer to use 'all-traffic' instead. + all-traffic + Sends all outbound traffic through Direct VPC egress or the VPC + connector. + private-ranges-only + Default option. Sends outbound traffic to private IP addresses (RFC + 1918 and Private Google Access IPs) through Direct VPC egress or + the VPC connector. + + Traffic to other Cloud Run services might require additional + configuration. See + https://cloud.google.com/run/docs/securing/private-networking#send_requests_to_other_services_and_services + for more information. + + These flags modify the Cloud SQL instances this Service connects to. You + can specify a name of a Cloud SQL instance if it's in the same project and + region as your Cloud Run service; otherwise specify + :: for the instance. + + At most one of these can be specified: + + --add-cloudsql-instances=[CLOUDSQL-INSTANCES,...] + Append the given values to the current Cloud SQL instances. + + --clear-cloudsql-instances + Empty the current Cloud SQL instances. + + --remove-cloudsql-instances=[CLOUDSQL-INSTANCES,...] + Remove the given values from the current Cloud SQL instances. + + --set-cloudsql-instances=[CLOUDSQL-INSTANCES,...] + Completely replace the current Cloud SQL instances with the given + values. + + These flags modify the custom audiences that can be used in the audience + field of ID token for authenticated requests. + + At most one of these can be specified: + + --add-custom-audiences=[CUSTOM-AUDIENCES,...] + Append the given values to the current custom audiences. + + --clear-custom-audiences + Empty the current custom audiences. + + --remove-custom-audiences=[CUSTOM-AUDIENCES,...] + Remove the given values from the current custom audiences. + + --set-custom-audiences=[CUSTOM-AUDIENCES,...] + Completely replace the current custom audiences with the given + values. + + --add-volume=[KEY=VALUE,...] + Adds a volume to the Cloud Run resource. To add more than one volume, + specify this flag multiple times. Volumes must have a name and type + key. Only certain values are supported for type. Depending on the + provided type, other keys will be required. The following types are + supported with the specified additional keys: + + --clear-volumes + Remove all existing volumes from the Cloud Run resource, including + volumes mounted as secrets + + --remove-volume=[VOLUME,...] + Removes volumes from the Cloud Run resource. + + Container Flags + + If the --container or --remove-containers flag is specified the following + arguments may only be specified after a --container flag. + + --add-volume-mount=[volume=NAME,mount-path=MOUNT_PATH,...] + Adds a mount to the current container. Must contain the keys + volume=NAME and mount-path=/PATH where NAME is the name of a volume + on this resource and PATH is the path within the container's + filesystem to mount this volume. + + --args=[ARG,...] + Comma-separated arguments passed to the command run by the + container image. If not specified and no '--command' is provided, + the container image's default Cmd is used. Otherwise, if not + specified, no arguments are passed. To reset this field to its + default, pass an empty string. + + --clear-volume-mounts + Remove all existing mounts from the current container. + + --command=[COMMAND,...] + Entrypoint for the container image. If not specified, the container + image's default Entrypoint is run. To reset this field to its + default, pass an empty string. + + --cpu=CPU + Set a CPU limit in Kubernetes cpu units. + + Cloud Run supports values fractional values below 1, 1, 2, 4, and + 8. Some CPU values requires a minimum Memory --memory value. + + --depends-on=[CONTAINER,...] + List of container dependencies to add to the current container. + + --gpu=GPU + Cloud Run supports values 0 or 1. 1 gpu also requires a minimum 4 + --cpu value and a minimum 16Gi --memory value. + + --image=IMAGE + Name of the container image to deploy (e.g. + us-docker.pkg.dev/cloudrun/container/hello:latest). + + --liveness-probe=[KEY=VALUE,...] + Comma separated settings for liveness probe in the form KEY=VALUE. + Each key stands for a field of the probe described in + https://cloud.google.com/run/docs/reference/rest/v1/Container#Probe. + Currently supported keys are: initialDelaySeconds, timeoutSeconds, + periodSeconds, failureThreshold, httpGet.port, httpGet.path, + grpc.port, grpc.service. + + For example, to set a probe with 10s timeout and HTTP probe + requests sent to 8080 port of the container: + + $ --liveness-probe=timeoutSeconds=10,httpGet.port=8080 + + To remove existing probe: + + $ --liveness-probe="" + + --memory=MEMORY + Set a memory limit. Ex: 1024Mi, 4Gi. + + --port=PORT + Container port to receive requests at. Also sets the $PORT + environment variable. Must be a number between 1 and 65535, + inclusive. To unset this field, pass the special value "default". + If updating an existing service with a TCP startup probe pointing + to the previous container port, this will also update the probe + port. + + --remove-volume-mount=[MOUNT_PATH,...] + Removes the volume mounted at the specified path from the current + container. + + --startup-probe=[KEY=VALUE,...] + Comma separated settings for startup probe in the form KEY=VALUE. + Each key stands for a field of the probe described in + https://cloud.google.com/run/docs/reference/rest/v1/Container#Probe. + Currently supported keys are: initialDelaySeconds, timeoutSeconds, + periodSeconds, failureThreshold, httpGet.port, httpGet.path, + grpc.port, grpc.service, tcpSocket.port. + + For example, to set a probe with 10s timeout and HTTP probe + requests sent to 8080 port of the container: + + $ --startup-probe=timeoutSeconds=10,httpGet.port=8080 + + To remove existing probe: + + $ --startup-probe="" + + --[no-]use-http2 + Whether to use HTTP/2 for connections to the service. Use + --use-http2 to enable and --no-use-http2 to disable. + + At most one of these can be specified: + + --clear-env-vars + Remove all environment variables. + + --env-vars-file=FILE_PATH + Path to a local YAML file with definitions for all environment + variables. All existing environment variables will be removed + before the new environment variables are added. Example YAML + content: + + KEY_1: "value1" + KEY_2: "value 2" + + --set-env-vars=[KEY=VALUE,...] + List of key-value pairs to set as environment variables. All + existing environment variables will be removed first. + + Only --update-env-vars and --remove-env-vars can be used together. + If both are specified, --remove-env-vars will be applied first. + + --remove-env-vars=[KEY,...] + List of environment variables to be removed. + + --update-env-vars=[KEY=VALUE,...] + List of key-value pairs to set as environment variables. + + Specify secrets to mount or provide as environment variables. Keys + starting with a forward slash '/' are mount paths. All other keys + correspond to environment variables. Values should be in the form + SECRET_NAME:SECRET_VERSION. For example: + '--update-secrets=/secrets/api/key=mysecret:latest,ENV=othersecret:1' + will mount a volume at '/secrets/api' containing a file 'key' with the + latest version of secret 'mysecret'. An environment variable named ENV + will also be created whose value is version 1 of secret 'othersecret'. + + At most one of these can be specified: + + --clear-secrets + Remove all secrets. + + --set-secrets=[KEY=VALUE,...] + List of key-value pairs to set as secrets. All existing secrets + will be removed first. + + Only --update-secrets and --remove-secrets can be used together. If + both are specified, --remove-secrets will be applied first. + + --remove-secrets=[KEY,...] + List of secrets to be removed. + + --update-secrets=[KEY=VALUE,...] + List of key-value pairs to set as secrets. + + At most one of these can be specified: + + --binary-authorization=POLICY + Binary Authorization policy to check against. This must be set to + "default". + + --clear-binary-authorization + Remove any previously set Binary Authorization policy. + + At most one of these can be specified: + + --clear-encryption-key-shutdown-hours + Remove any previously set CMEK key shutdown hours setting. + + --encryption-key-shutdown-hours=ENCRYPTION_KEY_SHUTDOWN_HOURS + The number of hours to wait before an automatic shutdown server after + CMEK key revocation is detected. + + At most one of these can be specified: + + --clear-key + Remove any previously set CMEK key reference. + + --key=KEY + CMEK key reference to encrypt the container with. + + At most one of these can be specified: + + --clear-labels + Remove all labels. If --update-labels is also specified then + --clear-labels is applied first. + + For example, to remove all labels: + + $ gcloud run multi-region-services update --clear-labels + + To remove all existing labels and create two new labels, foo and baz: + + $ gcloud run multi-region-services update --clear-labels \ + --update-labels foo=bar,baz=qux + + --remove-labels=[KEY,...] + List of label keys to remove. If a label does not exist it is + silently ignored. If --update-labels is also specified then + --update-labels is applied first. + + At most one of these can be specified: + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + An alias to --update-labels. + + --update-labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to update. If a label exists, its value + is modified. Otherwise, a new label is created. + + At most one of these can be specified: + + --clear-network + Disconnect this Cloud Run service from the VPC network it is + connected to. + + Direct VPC egress setting flags group. + + --network=NETWORK + The VPC network that the Cloud Run service will be able to send + traffic to. If --subnet is also specified, subnet must be a + subnetwork of the network specified by this --network flag. To + clear existing VPC network settings, use --clear-network. + + --subnet=SUBNET + The VPC subnetwork that the Cloud Run service will get IPs from. + The subnetwork must be /26 or larger. If --network is also + specified, subnet must be a subnetwork of the network specified by + the --network flag. If --network is not specified, network will be + looked up from this subnetwork. To clear existing VPC network + settings, use --clear-network. + + At most one of these can be specified: + + --clear-network-tags + Clears all existing Compute Engine tags from the Cloud Run + service. + + --network-tags=[TAG,...] + Applies the given Compute Engine tags (comma separated) to the + Cloud Run service. To clear existing tags, use + --clear-network-tags. + + At most one of these can be specified: + + --clear-post-key-revocation-action-type + Remove any previously set post CMEK key revocation action type. + + --post-key-revocation-action-type=POST_KEY_REVOCATION_ACTION_TYPE + Action type after CMEK key revocation. + POST_KEY_REVOCATION_ACTION_TYPE must be one of: + + prevent-new + No new instances will be started after CMEK key revocation. + shut-down + No new instances will be started and the existing instances will + be shut down after CMEK key revocation. + +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 run multi-region-services update + + $ gcloud beta run multi-region-services update + diff --git a/gcloud/storage/batch-operations/jobs/list b/gcloud/storage/batch-operations/jobs/list index 4c2735965..097638596 100644 --- a/gcloud/storage/batch-operations/jobs/list +++ b/gcloud/storage/batch-operations/jobs/list @@ -10,7 +10,7 @@ DESCRIPTION List batch operation jobs. EXAMPLES - To list all batch jobs in all locations: + To list all batch jobs: $ gcloud storage batch-operations jobs list diff --git a/gcloud/transfer/agents/install b/gcloud/transfer/agents/install index 2a5efb622..759a6770f 100644 --- a/gcloud/transfer/agents/install +++ b/gcloud/transfer/agents/install @@ -40,6 +40,22 @@ EXAMPLES $ gcloud transfer agents install --creds-file=/example/path.json \ --pool=AGENT_POOL + To install an agent using service account impersonation, run: + + $ gcloud transfer agents install --creds-file=/example/path.json \ + --pool=CUSTOM_AGENT_POOL \ + --impersonate-service-account=impersonated-account@project-id.ia\ + m.gserviceaccount.com + + Note : The --impersonate-service-account flag only applies to the API calls + made by gcloud during the agent installation and authorization process. The + impersonated credentials are not passed to the transfer agent's runtime + environment. The agent itself does not support impersonation and will use + the credentials provided via the --creds-file flag or the default gcloud + authenticated account for all of its operations. To grant the agent + permissions, you must provide a service account key with the required + direct roles (e.g., Storage Transfer Agent, Storage Object User) + REQUIRED FLAGS --pool=POOL The agent pool to associate with the newly installed agent. When