From c0febd2be156a2389c0f71e3c9e5c7058e894903 Mon Sep 17 00:00:00 2001 From: Automated Date: Fri, 20 Feb 2026 11:39:38 +0000 Subject: [PATCH] gcloud: Fri Feb 20 11:39:38 UTC 2026 --- gcloud/_version | 8 +- .../backup-dr/backup-plan-associations/create | 7 +- .../fetch-for-resource-type | 4 + gcloud/alpha/backup-dr/backup-plans/create | 28 +- gcloud/alpha/backup-dr/service-config/init | 9 +- gcloud/alpha/cluster-director/clusters/create | 89 +- gcloud/alpha/cluster-director/clusters/delete | 4 +- .../alpha/cluster-director/clusters/describe | 4 +- gcloud/alpha/cluster-director/clusters/help | 4 +- gcloud/alpha/cluster-director/clusters/list | 4 +- gcloud/alpha/cluster-director/clusters/update | 103 +- gcloud/alpha/cluster-director/help | 4 +- .../alpha/cluster-director/locations/describe | 4 +- gcloud/alpha/cluster-director/locations/help | 4 +- gcloud/alpha/cluster-director/locations/list | 4 +- .../cluster-director/operations/describe | 4 +- gcloud/alpha/cluster-director/operations/help | 4 +- .../compute/backend-services/add-backend | 7 +- gcloud/alpha/compute/backend-services/create | 18 +- .../compute/backend-services/remove-backend | 7 +- gcloud/alpha/compute/backend-services/update | 18 +- .../compute/backend-services/update-backend | 7 +- .../compute/firewall-policies/rules/create | 12 +- .../compute/firewall-policies/rules/update | 12 +- .../compute/instance-groups/managed/create | 12 +- .../compute/instance-groups/managed/update | 21 +- .../alpha/compute/instances/update-from-file | 8 +- .../compute/instant-snapshot-groups/create | 17 +- .../compute/instant-snapshot-groups/delete | 4 +- .../compute/instant-snapshot-groups/describe | 14 +- .../compute/instant-snapshot-groups/help | 4 +- .../compute/instant-snapshot-groups/list | 4 +- gcloud/alpha/compute/instant-snapshots/create | 5 + gcloud/alpha/compute/interconnects/create | 6 +- gcloud/alpha/compute/interconnects/update | 8 +- .../network-firewall-policies/rules/create | 12 +- .../network-firewall-policies/rules/update | 12 +- gcloud/alpha/compute/rollouts/cancel | 4 +- gcloud/alpha/compute/rollouts/delete | 4 +- gcloud/alpha/compute/rollouts/describe | 4 +- gcloud/alpha/compute/rollouts/help | 4 +- gcloud/alpha/compute/rollouts/list | 4 +- gcloud/alpha/container/clusters/create | 5 +- gcloud/alpha/container/clusters/create-auto | 5 +- gcloud/alpha/container/clusters/update | 6 +- gcloud/alpha/looker/instances/create | 12 +- gcloud/alpha/looker/instances/update | 10 +- gcloud/alpha/netapp/volumes/create | 4 +- gcloud/alpha/netapp/volumes/update | 4 +- .../firewall-endpoints/create | 48 +- .../network-security/firewall-endpoints/help | 2 +- .../network-services/multicast-domains/create | 6 +- gcloud/alpha/resource-manager/help | 3 + .../resource-manager/semantics-catalog/help | 28 + .../resource-manager/semantics-catalog/list | 63 + gcloud/alpha/run/compose/up | 14 +- gcloud/alpha/run/instances/create | 8 +- gcloud/alpha/storage/buckets/relocate | 9 + .../backup-dr/backup-plan-associations/create | 7 +- .../fetch-for-resource-type | 4 + gcloud/backup-dr/backup-plans/create | 28 +- gcloud/backup-dr/service-config/init | 9 +- gcloud/beta/cluster-director/clusters/create | 1036 +++++++++++++++ gcloud/beta/cluster-director/clusters/delete | 73 + .../beta/cluster-director/clusters/describe | 68 + gcloud/beta/cluster-director/clusters/help | 39 + gcloud/beta/cluster-director/clusters/list | 88 ++ gcloud/beta/cluster-director/clusters/update | 1181 +++++++++++++++++ gcloud/beta/cluster-director/help | 32 + .../beta/cluster-director/locations/describe | 53 + gcloud/beta/cluster-director/locations/help | 29 + gcloud/beta/cluster-director/locations/list | 61 + .../beta/cluster-director/operations/describe | 66 + gcloud/beta/cluster-director/operations/help | 26 + .../compute/firewall-policies/rules/create | 12 +- .../compute/firewall-policies/rules/update | 12 +- gcloud/beta/compute/help | 6 + .../compute/instance-groups/managed/create | 12 +- .../compute/instance-groups/managed/update | 21 +- .../compute/instant-snapshot-groups/create | 91 ++ .../compute/instant-snapshot-groups/delete | 74 ++ .../compute/instant-snapshot-groups/describe | 82 ++ .../beta/compute/instant-snapshot-groups/help | 36 + .../beta/compute/instant-snapshot-groups/list | 96 ++ gcloud/beta/compute/interconnects/create | 6 +- .../network-firewall-policies/rules/create | 12 +- .../network-firewall-policies/rules/update | 12 +- .../beta/compute/os-config/patch-jobs/execute | 27 +- gcloud/beta/compute/rollouts/cancel | 54 + gcloud/beta/compute/rollouts/delete | 48 + gcloud/beta/compute/rollouts/describe | 52 + gcloud/beta/compute/rollouts/help | 35 + gcloud/beta/compute/rollouts/list | 66 + gcloud/beta/netapp/volumes/create | 4 +- gcloud/beta/netapp/volumes/update | 4 +- gcloud/beta/run/compose/up | 14 +- gcloud/beta/workbench/executions/create | 5 +- gcloud/beta/workbench/executions/delete | 5 +- gcloud/beta/workbench/executions/describe | 5 +- gcloud/beta/workbench/executions/help | 5 +- gcloud/beta/workbench/executions/list | 5 +- gcloud/beta/workbench/schedules/create | 5 +- gcloud/beta/workbench/schedules/delete | 5 +- gcloud/beta/workbench/schedules/describe | 5 +- gcloud/beta/workbench/schedules/help | 5 +- gcloud/beta/workbench/schedules/list | 5 +- gcloud/beta/workbench/schedules/pause | 5 +- gcloud/beta/workbench/schedules/resume | 5 +- gcloud/beta/workbench/schedules/update | 5 +- gcloud/compute/firewall-policies/rules/create | 36 +- gcloud/compute/firewall-policies/rules/update | 36 +- gcloud/compute/instance-groups/managed/update | 9 +- gcloud/compute/interconnects/create | 6 +- .../network-firewall-policies/rules/create | 36 +- .../network-firewall-policies/rules/update | 21 + gcloud/compute/os-config/patch-jobs/execute | 27 +- gcloud/container/ai/profiles/manifests/create | 5 +- gcloud/eventarc/triggers/create | 4 +- gcloud/eventarc/triggers/update | 19 +- gcloud/feedback | 1 - gcloud/netapp/volumes/create | 4 +- gcloud/netapp/volumes/update | 4 +- gcloud/sql/flags/list | 4 +- gcloud/sql/instances/create | 4 +- gcloud/sql/instances/patch | 4 +- gcloud/workbench/executions/create | 246 ++++ gcloud/workbench/executions/delete | 66 + gcloud/workbench/executions/describe | 62 + gcloud/workbench/executions/help | 34 + gcloud/workbench/executions/list | 80 ++ gcloud/workbench/help | 6 + gcloud/workbench/schedules/create | 304 +++++ gcloud/workbench/schedules/delete | 65 + gcloud/workbench/schedules/describe | 61 + gcloud/workbench/schedules/help | 43 + gcloud/workbench/schedules/list | 82 ++ gcloud/workbench/schedules/pause | 60 + gcloud/workbench/schedules/resume | 67 + gcloud/workbench/schedules/update | 112 ++ 139 files changed, 5534 insertions(+), 358 deletions(-) create mode 100644 gcloud/alpha/resource-manager/semantics-catalog/help create mode 100644 gcloud/alpha/resource-manager/semantics-catalog/list create mode 100644 gcloud/beta/cluster-director/clusters/create create mode 100644 gcloud/beta/cluster-director/clusters/delete create mode 100644 gcloud/beta/cluster-director/clusters/describe create mode 100644 gcloud/beta/cluster-director/clusters/help create mode 100644 gcloud/beta/cluster-director/clusters/list create mode 100644 gcloud/beta/cluster-director/clusters/update create mode 100644 gcloud/beta/cluster-director/help create mode 100644 gcloud/beta/cluster-director/locations/describe create mode 100644 gcloud/beta/cluster-director/locations/help create mode 100644 gcloud/beta/cluster-director/locations/list create mode 100644 gcloud/beta/cluster-director/operations/describe create mode 100644 gcloud/beta/cluster-director/operations/help create mode 100644 gcloud/beta/compute/instant-snapshot-groups/create create mode 100644 gcloud/beta/compute/instant-snapshot-groups/delete create mode 100644 gcloud/beta/compute/instant-snapshot-groups/describe create mode 100644 gcloud/beta/compute/instant-snapshot-groups/help create mode 100644 gcloud/beta/compute/instant-snapshot-groups/list create mode 100644 gcloud/beta/compute/rollouts/cancel create mode 100644 gcloud/beta/compute/rollouts/delete create mode 100644 gcloud/beta/compute/rollouts/describe create mode 100644 gcloud/beta/compute/rollouts/help create mode 100644 gcloud/beta/compute/rollouts/list create mode 100644 gcloud/workbench/executions/create create mode 100644 gcloud/workbench/executions/delete create mode 100644 gcloud/workbench/executions/describe create mode 100644 gcloud/workbench/executions/help create mode 100644 gcloud/workbench/executions/list create mode 100644 gcloud/workbench/schedules/create create mode 100644 gcloud/workbench/schedules/delete create mode 100644 gcloud/workbench/schedules/describe create mode 100644 gcloud/workbench/schedules/help create mode 100644 gcloud/workbench/schedules/list create mode 100644 gcloud/workbench/schedules/pause create mode 100644 gcloud/workbench/schedules/resume create mode 100644 gcloud/workbench/schedules/update diff --git a/gcloud/_version b/gcloud/_version index a15430562..6981c5085 100644 --- a/gcloud/_version +++ b/gcloud/_version @@ -1,8 +1,8 @@ -Google Cloud SDK 556.0.0 -alpha 2026.02.09 -beta 2026.02.09 +Google Cloud SDK 557.0.0 +alpha 2026.02.17 +beta 2026.02.17 bq 2.1.28 bundled-python3-unix 3.13.10 -core 2026.02.09 +core 2026.02.17 gcloud-crc32c 1.0.0 gsutil 5.35 diff --git a/gcloud/alpha/backup-dr/backup-plan-associations/create b/gcloud/alpha/backup-dr/backup-plan-associations/create index 2503095b8..0bbb7feca 100644 --- a/gcloud/alpha/backup-dr/backup-plan-associations/create +++ b/gcloud/alpha/backup-dr/backup-plan-associations/create @@ -92,8 +92,11 @@ REQUIRED FLAGS projects/sample-project/zones/us-central1-a/instances/sample-instance --resource-type=RESOURCE_TYPE - Type of resource to which the backup plan should be applied. E.g., - compute..com/Instance + Type of resource to which the backup plan should be applied. + + For example: + ◆ compute./Instance for Compute Engine instances. + ◆ file./Instance for Filestore instances. OPTIONAL FLAGS --async diff --git a/gcloud/alpha/backup-dr/backup-plan-associations/fetch-for-resource-type b/gcloud/alpha/backup-dr/backup-plan-associations/fetch-for-resource-type index ffd7905b3..8dea21774 100644 --- a/gcloud/alpha/backup-dr/backup-plan-associations/fetch-for-resource-type +++ b/gcloud/alpha/backup-dr/backup-plan-associations/fetch-for-resource-type @@ -25,6 +25,10 @@ POSITIONAL ARGUMENTS RESOURCE_TYPE Resource type for which backup plan associations should be fetched. + For example: + ◆ compute./Instance for Compute Engine instances. + ◆ file./Instance for Filestore instances. + REQUIRED FLAGS --location=LOCATION Location for which backup plan associations should be fetched. diff --git a/gcloud/alpha/backup-dr/backup-plans/create b/gcloud/alpha/backup-dr/backup-plans/create index 2c5fa7f5b..60c02d44a 100644 --- a/gcloud/alpha/backup-dr/backup-plans/create +++ b/gcloud/alpha/backup-dr/backup-plans/create @@ -15,19 +15,32 @@ DESCRIPTION locations where Backup and DR is available. EXAMPLES - To create a new backup plan sample-backup-plan in project sample-project, - at location us-central1, with resource-type - compute..com/Instance and backup-vault backup-vault with 2 + To create a new backup plan sample-backup-plan for Compute Engine instances + in project sample-project, at location us-central1, with resource-type + compute./Instance and backup-vault backup-vault with 2 backup-rules: run: $ gcloud alpha backup-dr backup-plans create sample-backup-plan \ --project=sample-project --location=us-central1 \ - --resource-type 'compute..com/Instance' \ + --resource-type 'compute./Instance' \ --backup-vault --backup-rule \ --backup-rule + To create a new backup plan sample-filestore-backup-plan for Filestore + instances in project sample-project, at location us-central1, with + resource-type file./Instance and backup-vault backup-vault + with 1 backup-rule: + + run: + + $ gcloud alpha backup-dr backup-plans create \ + sample-filestore-backup-plan --project=sample-project \ + --location=us-central1 \ + --resource-type 'file./Instance' \ + --backup-vault --backup-rule + Backup Rule Examples: 1. Hourly backup rule with hourly backup frequency of 6 hours and store it @@ -133,8 +146,11 @@ REQUIRED FLAGS ▸ provide the argument --backup-vault on the command line. --resource-type=RESOURCE_TYPE - Type of resource to which the backup plan should be applied. E.g., - compute..com/Instance + Type of resource to which the backup plan should be applied. + + For example: + ◆ compute./Instance for Compute Engine instances. + ◆ file./Instance for Filestore instances. OPTIONAL FLAGS --async diff --git a/gcloud/alpha/backup-dr/service-config/init b/gcloud/alpha/backup-dr/service-config/init index 5fe3ab880..c8ff4628f 100644 --- a/gcloud/alpha/backup-dr/service-config/init +++ b/gcloud/alpha/backup-dr/service-config/init @@ -4,7 +4,8 @@ NAME SYNOPSIS gcloud alpha backup-dr service-config init --location=LOCATION - --resource-type=RESOURCE_TYPE [--no-async] [GCLOUD_WIDE_FLAG ...] + --resource-type=RESOURCE_TYPE [--no-async] + [--cloudsql-edition=CLOUDSQL_EDITION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Initialize a Backup and DR Service configuration. @@ -44,6 +45,12 @@ OPTIONAL FLAGS --no-async Wait for the operation in progress to complete. + --cloudsql-edition=CLOUDSQL_EDITION + Cloud SQL Edition: (Required only for Cloud SQL instances, ignored + otherwise). The edition of the Cloud SQL instance. Possible values: + "ENTERPRISE" - Enterprise edition. "ENTERPRISE_PLUS" - Enterprise Plus + edition. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/cluster-director/clusters/create b/gcloud/alpha/cluster-director/clusters/create index 60e6c5e3a..44493c3c1 100644 --- a/gcloud/alpha/cluster-director/clusters/create +++ b/gcloud/alpha/cluster-director/clusters/create @@ -16,9 +16,9 @@ SYNOPSIS (--create-network=[description=DESCRIPTION],[name=NAME] | [--network=NETWORK --subnet=SUBNET : --network-project=NETWORK_PROJECT]) : --buckets=[BUCKETS,...] - --create-buckets=[autoclassTerminalStorageClass=AUTOCLASSTERMINALSTORAGECLASS], - [enableAutoclass=ENABLEAUTOCLASS], - [enableHNS=ENABLEHNS],[name=NAME],[storageClass=STORAGECLASS] + --create-buckets=[enableAutoclass=ENABLEAUTOCLASS], + [enableHNS=ENABLEHNS],[name=NAME],[storageClass=STORAGECLASS], + [terminalStorageClass=TERMINALSTORAGECLASS] --create-filestores=[capacityGb=CAPACITYGB],[description=DESCRIPTION], [fileshare=FILESHARE],[name=NAME],[protocol=PROTOCOL],[tier=TIER] --create-lustres=[capacityGb=CAPACITYGB],[description=DESCRIPTION], @@ -58,7 +58,7 @@ SYNOPSIS [labels=LABELS],[maxDynamicNodeCount=MAXDYNAMICNODECOUNT], [serviceAccount=SERVICEACCOUNT],[startupScript=STARTUPSCRIPT], [startupScriptTimeout=STARTUPSCRIPTTIMEOUT], - [staticNodeCount=STATICNODECOUNT] + [staticNodeCount=STATICNODECOUNT],[type=TYPE] --slurm-partitions=[exclusive=EXCLUSIVE], [id=ID],[nodesetIds=NODESETIDS] --slurm-prolog-scripts=[SLURM_PROLOG_SCRIPTS,...] @@ -96,8 +96,8 @@ EXAMPLES capacityGb={lustreSize},filesystem={filesystem} \ --lustres locations/us-central1-a/instances/lustre1 \ --reserved-instances \ - id=compute0,machineType={machineType},reservation=zones/\ - us-central1-a/reservations/{reservation} \ + id=compute0,reservation=zones/us-central1-a/reservations/\ + {reservation} \ --slurm-login-node \ machineType={machineType},zone=us-central1-a \ --slurm-node-sets id=nodeset0,computeId=compute0 \ @@ -517,6 +517,9 @@ REQUIRED FLAGS startupScript Sets startupScript value. + startupScriptTimeout + Sets startupScriptTimeout value. + containerNodePool Sets containerNodePool value. @@ -666,11 +669,11 @@ REQUIRED FLAGS Shorthand Example: - --config=computeResources={string={config={newDwsFlexInstances={atmTags={string=string},machineType=string,maxDuration=string,terminationAction=string,zone=string},newFlexStartInstances={atmTags={string=string},machineType=string,maxDuration=string,terminationAction=string,zone=string},newOnDemandInstances={atmTags={string=string},machineType=string,zone=string},newReservedInstances={atmTags={string=string},machineType=string,reservation=string,reservationBlock=string,reservationSubBlock=string,type=string,zone=string},newSpotInstances={atmTags={string=string},machineType=string,terminationAction=string,zone=string}}}},description=string,labels={string=string},name=string,networkResources={string={config={existingComputeNetwork={network=string,subnetwork=string},existingNetwork={network=string,subnetwork=string},newComputeNetwork={description=string,network=string},newNetwork={description=string,network=string}}}},orchestrator={slurm={config={accountingStorageEnforceFlags,healthCheckInterval=int,healthCheckNodeState=string,healthCheckProgram=string,preemptExemptTime=string,preemptMode,preemptType=string,priorityType=string,priorityWeightAge=int,priorityWeightAssoc=int,priorityWeightFairshare=int,priorityWeightJobSize=int,priorityWeightPartition=int,priorityWeightQos=int,priorityWeightTres=string,prologEpilogTimeout=string,prologFlags,requeueExitCodes,requeueHoldExitCodes},defaultPartition=string,disableHealthCheckProgram=boolean,epilogBashScripts,loginNodes={bootDisk={image=string,sizeGb=int,type=string},count=int,enableOsLogin=boolean,enablePublicIps=boolean,labels={string=string},machineType=string,serviceAccount={email=string,scopes},startupScript=string,storageConfigs=[{id=string,localMount=string}],zone=string},nodeSets=[{computeId=string,computeInstance={bootDisk={image=string,sizeGb=int,type=string},labels={string=string},startupScript=string},containerNodePool,id=string,maxDynamicNodeCount=int,serviceAccount={email=string,scopes},staticNodeCount=int,storageConfigs=[{id=string,localMount=string}]}],partitions=[{exclusive=boolean,id=string,nodeSetIds=[string]}],prologBashScripts,taskEpilogBashScripts,taskPrologBashScripts}},storageResources={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,perUnitStorageThroughput=int}}}} + --config=computeResources={string={config={newDwsFlexInstances={atmTags={string=string},machineType=string,maxDuration=string,terminationAction=string,zone=string},newFlexStartInstances={atmTags={string=string},machineType=string,maxDuration=string,terminationAction=string,zone=string},newOnDemandInstances={atmTags={string=string},machineType=string,zone=string},newReservedInstances={atmTags={string=string},machineType=string,reservation=string,reservationBlock=string,reservationSubBlock=string,type=string,zone=string},newSpotInstances={atmTags={string=string},machineType=string,terminationAction=string,zone=string}}}},description=string,labels={string=string},name=string,networkResources={string={config={existingComputeNetwork={network=string,subnetwork=string},existingNetwork={network=string,subnetwork=string},newComputeNetwork={description=string,network=string},newNetwork={description=string,network=string}}}},orchestrator={slurm={config={accountingStorageEnforceFlags,healthCheckInterval=int,healthCheckNodeState=string,healthCheckProgram=string,preemptExemptTime=string,preemptMode,preemptType=string,priorityType=string,priorityWeightAge=int,priorityWeightAssoc=int,priorityWeightFairshare=int,priorityWeightJobSize=int,priorityWeightPartition=int,priorityWeightQos=int,priorityWeightTres=string,prologEpilogTimeout=string,prologFlags,requeueExitCodes,requeueHoldExitCodes},defaultPartition=string,disableHealthCheckProgram=boolean,epilogBashScripts,loginNodes={bootDisk={image=string,sizeGb=int,type=string},count=int,enableOsLogin=boolean,enablePublicIps=boolean,labels={string=string},machineType=string,serviceAccount={email=string,scopes},startupScript=string,storageConfigs=[{id=string,localMount=string}],zone=string},nodeSets=[{computeId=string,computeInstance={bootDisk={image=string,sizeGb=int,type=string},labels={string=string},startupScript=string,startupScriptTimeout=string},containerNodePool,id=string,maxDynamicNodeCount=int,serviceAccount={email=string,scopes},staticNodeCount=int,storageConfigs=[{id=string,localMount=string}]}],partitions=[{exclusive=boolean,id=string,nodeSetIds=[string]}],prologBashScripts,taskEpilogBashScripts,taskPrologBashScripts}},storageResources={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,perUnitStorageThroughput=int}}}} JSON Example: - --config='{"computeResources": {"string": {"config": {"newDwsFlexInstances": {"atmTags": {"string": "string"}, "machineType": "string", "maxDuration": "string", "terminationAction": "string", "zone": "string"}, "newFlexStartInstances": {"atmTags": {"string": "string"}, "machineType": "string", "maxDuration": "string", "terminationAction": "string", "zone": "string"}, "newOnDemandInstances": {"atmTags": {"string": "string"}, "machineType": "string", "zone": "string"}, "newReservedInstances": {"atmTags": {"string": "string"}, "machineType": "string", "reservation": "string", "reservationBlock": "string", "reservationSubBlock": "string", "type": "string", "zone": "string"}, "newSpotInstances": {"atmTags": {"string": "string"}, "machineType": "string", "terminationAction": "string", "zone": "string"}}}}, "description": "string", "labels": {"string": "string"}, "name": "string", "networkResources": {"string": {"config": {"existingComputeNetwork": {"network": "string", "subnetwork": "string"}, "existingNetwork": {"network": "string", "subnetwork": "string"}, "newComputeNetwork": {"description": "string", "network": "string"}, "newNetwork": {"description": "string", "network": "string"}}}}, "orchestrator": {"slurm": {"config": {"accountingStorageEnforceFlags", "healthCheckInterval": int, "healthCheckNodeState": "string", "healthCheckProgram": "string", "preemptExemptTime": "string", "preemptMode", "preemptType": "string", "priorityType": "string", "priorityWeightAge": int, "priorityWeightAssoc": int, "priorityWeightFairshare": int, "priorityWeightJobSize": int, "priorityWeightPartition": int, "priorityWeightQos": int, "priorityWeightTres": "string", "prologEpilogTimeout": "string", "prologFlags", "requeueExitCodes", "requeueHoldExitCodes"}, "defaultPartition": "string", "disableHealthCheckProgram": boolean, "epilogBashScripts", "loginNodes": {"bootDisk": {"image": "string", "sizeGb": int, "type": "string"}, "count": int, "enableOsLogin": boolean, "enablePublicIps": boolean, "labels": {"string": "string"}, "machineType": "string", "serviceAccount": {"email": "string", "scopes"}, "startupScript": "string", "storageConfigs": [{"id": "string", "localMount": "string"}], "zone": "string"}, "nodeSets": [{"computeId": "string", "computeInstance": {"bootDisk": {"image": "string", "sizeGb": int, "type": "string"}, "labels": {"string": "string"}, "startupScript": "string"}, "containerNodePool": {}, "id": "string", "maxDynamicNodeCount": int, "serviceAccount": {"email": "string", "scopes"}, "staticNodeCount": int, "storageConfigs": [{"id": "string", "localMount": "string"}]}], "partitions": [{"exclusive": boolean, "id": "string", "nodeSetIds": ["string"]}], "prologBashScripts", "taskEpilogBashScripts", "taskPrologBashScripts"}}, "storageResources": {"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", "perUnitStorageThroughput": int}}}}}' + --config='{"computeResources": {"string": {"config": {"newDwsFlexInstances": {"atmTags": {"string": "string"}, "machineType": "string", "maxDuration": "string", "terminationAction": "string", "zone": "string"}, "newFlexStartInstances": {"atmTags": {"string": "string"}, "machineType": "string", "maxDuration": "string", "terminationAction": "string", "zone": "string"}, "newOnDemandInstances": {"atmTags": {"string": "string"}, "machineType": "string", "zone": "string"}, "newReservedInstances": {"atmTags": {"string": "string"}, "machineType": "string", "reservation": "string", "reservationBlock": "string", "reservationSubBlock": "string", "type": "string", "zone": "string"}, "newSpotInstances": {"atmTags": {"string": "string"}, "machineType": "string", "terminationAction": "string", "zone": "string"}}}}, "description": "string", "labels": {"string": "string"}, "name": "string", "networkResources": {"string": {"config": {"existingComputeNetwork": {"network": "string", "subnetwork": "string"}, "existingNetwork": {"network": "string", "subnetwork": "string"}, "newComputeNetwork": {"description": "string", "network": "string"}, "newNetwork": {"description": "string", "network": "string"}}}}, "orchestrator": {"slurm": {"config": {"accountingStorageEnforceFlags", "healthCheckInterval": int, "healthCheckNodeState": "string", "healthCheckProgram": "string", "preemptExemptTime": "string", "preemptMode", "preemptType": "string", "priorityType": "string", "priorityWeightAge": int, "priorityWeightAssoc": int, "priorityWeightFairshare": int, "priorityWeightJobSize": int, "priorityWeightPartition": int, "priorityWeightQos": int, "priorityWeightTres": "string", "prologEpilogTimeout": "string", "prologFlags", "requeueExitCodes", "requeueHoldExitCodes"}, "defaultPartition": "string", "disableHealthCheckProgram": boolean, "epilogBashScripts", "loginNodes": {"bootDisk": {"image": "string", "sizeGb": int, "type": "string"}, "count": int, "enableOsLogin": boolean, "enablePublicIps": boolean, "labels": {"string": "string"}, "machineType": "string", "serviceAccount": {"email": "string", "scopes"}, "startupScript": "string", "storageConfigs": [{"id": "string", "localMount": "string"}], "zone": "string"}, "nodeSets": [{"computeId": "string", "computeInstance": {"bootDisk": {"image": "string", "sizeGb": int, "type": "string"}, "labels": {"string": "string"}, "startupScript": "string", "startupScriptTimeout": "string"}, "containerNodePool": {}, "id": "string", "maxDynamicNodeCount": int, "serviceAccount": {"email": "string", "scopes"}, "staticNodeCount": int, "storageConfigs": [{"id": "string", "localMount": "string"}]}], "partitions": [{"exclusive": boolean, "id": "string", "nodeSetIds": ["string"]}], "prologBashScripts", "taskEpilogBashScripts", "taskPrologBashScripts"}}, "storageResources": {"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", "perUnitStorageThroughput": int}}}}}' File Example: @@ -685,7 +688,7 @@ REQUIRED FLAGS For e.g. --slurm-login-node machineType={machineType},zone={zone},count={count},enableOSLogin=true,enablePublicIPs=true,startupScript="echo - hello",labels="{key1=value1,key2=value2}",bootDisk={type=pd-standard,sizeGb=100} + hello",labels="{key1=value1,key2=value2}" If bootDisk is specified, sizeGb must be greater than 50. @@ -772,11 +775,11 @@ REQUIRED FLAGS For e.g. --buckets {existing-bucket-name eg. my-bucket} - --create-buckets=[autoclassTerminalStorageClass=AUTOCLASSTERMINALSTORAGECLASS],[enableAutoclass=ENABLEAUTOCLASS],[enableHNS=ENABLEHNS],[name=NAME],[storageClass=STORAGECLASS] + --create-buckets=[enableAutoclass=ENABLEAUTOCLASS],[enableHNS=ENABLEHNS],[name=NAME],[storageClass=STORAGECLASS],[terminalStorageClass=TERMINALSTORAGECLASS] Parameters to create a Google Cloud Storage bucket. For e.g. --create-buckets - name={bucket-path},storageClass=STANDARD,autoclassTerminalStorageClass=TERMINAL_STORAGE_CLASS_NEARLINE,enableHNS=true + name={bucket-path},storageClass=STANDARD,terminalStorageClass=TERMINAL_STORAGE_CLASS_NEARLINE,enableHNS=true Supported storageClass values: ▫ STANDARD @@ -784,7 +787,7 @@ REQUIRED FLAGS ▫ COLDLINE ▫ ARCHIVE - Supported autoclassTerminalStorageClass values: + Supported terminalStorageClass values: ▫ TERMINAL_STORAGE_CLASS_NEARLINE ▫ TERMINAL_STORAGE_CLASS_ARCHIVE @@ -797,9 +800,6 @@ REQUIRED FLAGS Sets create_buckets value. - autoclassTerminalStorageClass - Sets autoclassTerminalStorageClass value. - enableAutoclass Sets enableAutoclass value. @@ -812,13 +812,16 @@ REQUIRED FLAGS storageClass Sets storageClass value. + terminalStorageClass + Sets terminalStorageClass value. + Shorthand Example: - --create-buckets=autoclassTerminalStorageClass=string,enableAutoclass=boolean,enableHNS=boolean,name=string,storageClass=string --create-buckets=autoclassTerminalStorageClass=string,enableAutoclass=boolean,enableHNS=boolean,name=string,storageClass=string + --create-buckets=enableAutoclass=boolean,enableHNS=boolean,name=string,storageClass=string,terminalStorageClass=string --create-buckets=enableAutoclass=boolean,enableHNS=boolean,name=string,storageClass=string,terminalStorageClass=string JSON Example: - --create-buckets='[{"autoclassTerminalStorageClass": "string", "enableAutoclass": boolean, "enableHNS": boolean, "name": "string", "storageClass": "string"}]' + --create-buckets='[{"enableAutoclass": boolean, "enableHNS": boolean, "name": "string", "storageClass": "string", "terminalStorageClass": "string"}]' File Example: @@ -885,7 +888,9 @@ REQUIRED FLAGS Parameters to create a Lustre instance. For e.g. --create-lustres - name=locations/{location}/instances/{lustre},capacityGb={lustreSize},filesystem={filesystem}. + name=locations/{location}/instances/{lustre},capacityGb={lustreSize},filesystem={filesystem},perUnitStorageThroughput=1000 + + Values for perUnitStorageThroughput: 125, 250, 500, 1000. Sets create_lustres value. @@ -930,7 +935,7 @@ REQUIRED FLAGS Parameters to define cluster Flex Start instances. For e.g. --flex-start-instances - id={computeId},zone={zone},machineType={machineType},maxDuration=10000s. + id={computeId},zone={zone},machineType={machineType},maxDuration=10000s,atmTags="tag1=val1". Sets flex_start_instances value. @@ -1001,7 +1006,7 @@ REQUIRED FLAGS Parameters to define cluster on demand instances. For e.g. --on-demand-instances - id={computeId},zone={zone},machineType={machineType}. + id={computeId},zone={zone},machineType={machineType},atmTags="tag1=val1". Sets on_demand_instances value. @@ -1039,7 +1044,17 @@ REQUIRED FLAGS Parameters to define cluster reserved instances. For e.g. --reserved-instances - id={computeId},reservation=zones/{zone}/reservations/{reservation}. + id={computeId},reservation=zones/{zone}/reservations/{reservation} + + Exactly one of reservation, reservation-block, or + reservation-sub-block must be provided. reservation: The name of + the reservation to use, in the format + zones/{zone}/reservations/{reservation}. reservationBlock: The name + of the reservation block to use, in the format + zones/{zone}/reservations/{reservation}/reservationBlocks/{reservation_block}. + reservationSubBlock: The name of the reservation sub-block to use, + in the format + zones/{zone}/reservations/{reservation}/reservationBlocks/{reservation_block}/reservationSubBlocks/{reservation_sub_block}. Sets reserved_instances value. @@ -1056,7 +1071,7 @@ REQUIRED FLAGS Required, sets id value. reservation - Required, sets reservation value. + Sets reservation value. reservationBlock Sets reservationBlock value. @@ -1170,21 +1185,26 @@ REQUIRED FLAGS For e.g. --slurm-epilog-scripts script1.sh,script2.sh - --slurm-node-sets=[bootDisk=BOOTDISK],[computeId=COMPUTEID],[container-resource-labels=CONTAINER-RESOURCE-LABELS],[container-startup-script=CONTAINER-STARTUP-SCRIPT],[id=ID],[labels=LABELS],[maxDynamicNodeCount=MAXDYNAMICNODECOUNT],[serviceAccount=SERVICEACCOUNT],[startupScript=STARTUPSCRIPT],[startupScriptTimeout=STARTUPSCRIPTTIMEOUT],[staticNodeCount=STATICNODECOUNT] + --slurm-node-sets=[bootDisk=BOOTDISK],[computeId=COMPUTEID],[container-resource-labels=CONTAINER-RESOURCE-LABELS],[container-startup-script=CONTAINER-STARTUP-SCRIPT],[id=ID],[labels=LABELS],[maxDynamicNodeCount=MAXDYNAMICNODECOUNT],[serviceAccount=SERVICEACCOUNT],[startupScript=STARTUPSCRIPT],[startupScriptTimeout=STARTUPSCRIPTTIMEOUT],[staticNodeCount=STATICNODECOUNT],[type=TYPE] Parameters to define slurm cluster nodeset config. For e.g. --slurm-node-sets - id={nodesetId},computeId={computeId},staticNodeCount={staticNodeCount},maxDynamicNodeCount={maxDynamicNodeCount},startupScript="echo + id={nodesetId},computeId={computeId},type=gce,staticNodeCount={staticNodeCount},maxDynamicNodeCount={maxDynamicNodeCount},startupScript="echo hello",labels="{key1=value1,key2=value2}" - To configure a node set backed by GKE, use - container-resource-labels or container-startup-script. For e.g. + To configure a node set backed by Google Kubernetes Engine, use + type=gke. If type=gke is specified, Compute Engine specific fields + (labels, startupScript, bootDisk, startupScriptTimeout) cannot be + used, but container-specific fields (container-resource-labels, + container-startup-script) may be used. For e.g. --slurm-node-sets + id={nodesetId},computeId={computeId},type=gke For e.g. --slurm-node-sets - id={nodesetId},container-resource-labels="key1=val1",container-startup-script="echo + id={nodesetId},computeId={computeId},type=gke,container-resource-labels="key1=val1",container-startup-script="echo hello" Defaults: ▫ staticNodeCount: 1 + ▫ type: gce Note: ▫ startupScript: @@ -1255,13 +1275,16 @@ REQUIRED FLAGS staticNodeCount Sets staticNodeCount value. + type + Sets type value. + Shorthand Example: - --slurm-node-sets=bootDisk={image=string,sizeGb=int,type=string},computeId=string,container-resource-labels={string=string},container-startup-script=string,id=string,labels={string=string},maxDynamicNodeCount=int,serviceAccount={email=string,scopes},startupScript=string,startupScriptTimeout=string,staticNodeCount=int --slurm-node-sets=bootDisk={image=string,sizeGb=int,type=string},computeId=string,container-resource-labels={string=string},container-startup-script=string,id=string,labels={string=string},maxDynamicNodeCount=int,serviceAccount={email=string,scopes},startupScript=string,startupScriptTimeout=string,staticNodeCount=int + --slurm-node-sets=bootDisk={image=string,sizeGb=int,type=string},computeId=string,container-resource-labels={string=string},container-startup-script=string,id=string,labels={string=string},maxDynamicNodeCount=int,serviceAccount={email=string,scopes},startupScript=string,startupScriptTimeout=string,staticNodeCount=int,type=string --slurm-node-sets=bootDisk={image=string,sizeGb=int,type=string},computeId=string,container-resource-labels={string=string},container-startup-script=string,id=string,labels={string=string},maxDynamicNodeCount=int,serviceAccount={email=string,scopes},startupScript=string,startupScriptTimeout=string,staticNodeCount=int,type=string JSON Example: - --slurm-node-sets='[{"bootDisk": {"image": "string", "sizeGb": int, "type": "string"}, "computeId": "string", "container-resource-labels": {"string": "string"}, "container-startup-script": "string", "id": "string", "labels": {"string": "string"}, "maxDynamicNodeCount": int, "serviceAccount": {"email": "string", "scopes"}, "startupScript": "string", "startupScriptTimeout": "string", "staticNodeCount": int}]' + --slurm-node-sets='[{"bootDisk": {"image": "string", "sizeGb": int, "type": "string"}, "computeId": "string", "container-resource-labels": {"string": "string"}, "container-startup-script": "string", "id": "string", "labels": {"string": "string"}, "maxDynamicNodeCount": int, "serviceAccount": {"email": "string", "scopes"}, "startupScript": "string", "startupScriptTimeout": "string", "staticNodeCount": int, "type": "string"}]' File Example: @@ -1271,7 +1294,7 @@ REQUIRED FLAGS Parameters to define slurm cluster partitions. For e.g. --slurm-partitions - id={partitionId},nodesetIds=[{nodesetId1},{nodesetId2}],exclusive=false. + id=p1,nodesetIds=[ns1,ns2],exclusive=false. Sets slurm_partitions value. @@ -1315,7 +1338,7 @@ REQUIRED FLAGS Parameters to define cluster spot instances. For e.g. --spot-instances - id={computeId},zone={zone},machineType={machineType}. + id={computeId},zone={zone},machineType={machineType},atmTags="tag1=val1". Sets spot_instances value. @@ -1433,5 +1456,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta cluster-director clusters create diff --git a/gcloud/alpha/cluster-director/clusters/delete b/gcloud/alpha/cluster-director/clusters/delete index 14b33f56b..df6a35639 100644 --- a/gcloud/alpha/cluster-director/clusters/delete +++ b/gcloud/alpha/cluster-director/clusters/delete @@ -69,5 +69,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta cluster-director clusters delete diff --git a/gcloud/alpha/cluster-director/clusters/describe b/gcloud/alpha/cluster-director/clusters/describe index 9424f9d7c..cfefcef6c 100644 --- a/gcloud/alpha/cluster-director/clusters/describe +++ b/gcloud/alpha/cluster-director/clusters/describe @@ -64,5 +64,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta cluster-director clusters describe diff --git a/gcloud/alpha/cluster-director/clusters/help b/gcloud/alpha/cluster-director/clusters/help index 6ad31f86c..bdc2ba2dd 100644 --- a/gcloud/alpha/cluster-director/clusters/help +++ b/gcloud/alpha/cluster-director/clusters/help @@ -35,5 +35,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta cluster-director clusters diff --git a/gcloud/alpha/cluster-director/clusters/list b/gcloud/alpha/cluster-director/clusters/list index 0b8698b62..61fd2daa0 100644 --- a/gcloud/alpha/cluster-director/clusters/list +++ b/gcloud/alpha/cluster-director/clusters/list @@ -85,5 +85,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta cluster-director clusters list diff --git a/gcloud/alpha/cluster-director/clusters/update b/gcloud/alpha/cluster-director/clusters/update index 9184e5c8e..eafe97cac 100644 --- a/gcloud/alpha/cluster-director/clusters/update +++ b/gcloud/alpha/cluster-director/clusters/update @@ -16,9 +16,9 @@ SYNOPSIS --add-new-lustre-instances=[capacityGb=CAPACITYGB], [description=DESCRIPTION],[filesystem=FILESYSTEM], [name=NAME],[perUnitStorageThroughput=PERUNITSTORAGETHROUGHPUT] - --add-new-storage-buckets=[autoclassTerminalStorageClass=AUTOCLASSTERMINALSTORAGECLASS], - [enableAutoclass=ENABLEAUTOCLASS], - [enableHNS=ENABLEHNS],[name=NAME],[storageClass=STORAGECLASS] + --add-new-storage-buckets=[enableAutoclass=ENABLEAUTOCLASS], + [enableHNS=ENABLEHNS],[name=NAME],[storageClass=STORAGECLASS], + [terminalStorageClass=TERMINALSTORAGECLASS] --add-on-demand-instances=[atmTags=ATMTAGS], [id=ID],[machineType=MACHINETYPE],[zone=ZONE] --add-reserved-instances=[atmTags=ATMTAGS],[id=ID], @@ -31,7 +31,7 @@ SYNOPSIS [labels=LABELS],[maxDynamicNodeCount=MAXDYNAMICNODECOUNT], [serviceAccount=SERVICEACCOUNT],[startupScript=STARTUPSCRIPT], [startupScriptTimeout=STARTUPSCRIPTTIMEOUT], - [staticNodeCount=STATICNODECOUNT] + [staticNodeCount=STATICNODECOUNT],[type=TYPE] --add-slurm-partitions=[exclusive=EXCLUSIVE], [id=ID],[nodesetIds=NODESETIDS] --add-slurm-prolog-scripts=[ADD_SLURM_PROLOG_SCRIPTS,...] @@ -83,7 +83,7 @@ SYNOPSIS [labels=LABELS],[maxDynamicNodeCount=MAXDYNAMICNODECOUNT], [serviceAccount=SERVICEACCOUNT],[startupScript=STARTUPSCRIPT], [startupScriptTimeout=STARTUPSCRIPTTIMEOUT], - [staticNodeCount=STATICNODECOUNT] + [staticNodeCount=STATICNODECOUNT],[type=TYPE] --update-slurm-partitions=[exclusive=EXCLUSIVE], [id=ID],[nodesetIds=NODESETIDS] | --config=[computeResources=COMPUTERESOURCES], @@ -127,7 +127,7 @@ EXAMPLES id=compute1,zone=us-central1-a,machineType=n2-standard-2 \ --add-reserved-instances \ id=compute2,reservation=zones/us-central1-a/reservations/\ - {reservation},machineType={machineType} \ + {reservation} \ --add-spot-instances \ id=compute3,zone=us-central1-a,machineType=n2-standard-2 \ --add-dws-flex-instances \ @@ -252,7 +252,7 @@ REQUIRED FLAGS Parameters to define cluster Flex Start instances. For e.g. --add-flex-start-instances - id={computeId},zone={zone},machineType={machineType},maxDuration=10000s. + id={computeId},zone={zone},machineType={machineType},maxDuration=10000s,atmTags="tag1=val1". Sets add_flex_start_instances value. @@ -381,7 +381,9 @@ REQUIRED FLAGS Parameters to create a Lustre instance. For e.g. --add-new-lustre-instances - name=locations/{location}/instances/{lustre},capacityGb={lustreSize},filesystem={filesystem}. + name=locations/{location}/instances/{lustre},capacityGb={lustreSize},filesystem={filesystem},perUnitStorageThroughput=1000 + + Values for perUnitStorageThroughput: 125, 250, 500, 1000. Sets add_new_lustre_instances value. @@ -412,11 +414,11 @@ REQUIRED FLAGS --add-new-lustre-instances=path_to_file.(yaml|json) - --add-new-storage-buckets=[autoclassTerminalStorageClass=AUTOCLASSTERMINALSTORAGECLASS],[enableAutoclass=ENABLEAUTOCLASS],[enableHNS=ENABLEHNS],[name=NAME],[storageClass=STORAGECLASS] + --add-new-storage-buckets=[enableAutoclass=ENABLEAUTOCLASS],[enableHNS=ENABLEHNS],[name=NAME],[storageClass=STORAGECLASS],[terminalStorageClass=TERMINALSTORAGECLASS] Parameters to create a Google Cloud Storage bucket. For e.g. --add-new-storage-buckets - name={bucket-path},storageClass=STANDARD,autoclassTerminalStorageClass=TERMINAL_STORAGE_CLASS_NEARLINE,enableHNS=true + name={bucket-path},storageClass=STANDARD,terminalStorageClass=TERMINAL_STORAGE_CLASS_NEARLINE,enableHNS=true Supported storageClass values: ▸ STANDARD @@ -424,7 +426,7 @@ REQUIRED FLAGS ▸ COLDLINE ▸ ARCHIVE - Supported autoclassTerminalStorageClass values: + Supported terminalStorageClass values: ▸ TERMINAL_STORAGE_CLASS_NEARLINE ▸ TERMINAL_STORAGE_CLASS_ARCHIVE @@ -437,9 +439,6 @@ REQUIRED FLAGS Sets add_new_storage_buckets value. - autoclassTerminalStorageClass - Sets autoclassTerminalStorageClass value. - enableAutoclass Sets enableAutoclass value. @@ -452,13 +451,16 @@ REQUIRED FLAGS storageClass Sets storageClass value. + terminalStorageClass + Sets terminalStorageClass value. + Shorthand Example: - --add-new-storage-buckets=autoclassTerminalStorageClass=string,enableAutoclass=boolean,enableHNS=boolean,name=string,storageClass=string --add-new-storage-buckets=autoclassTerminalStorageClass=string,enableAutoclass=boolean,enableHNS=boolean,name=string,storageClass=string + --add-new-storage-buckets=enableAutoclass=boolean,enableHNS=boolean,name=string,storageClass=string,terminalStorageClass=string --add-new-storage-buckets=enableAutoclass=boolean,enableHNS=boolean,name=string,storageClass=string,terminalStorageClass=string JSON Example: - --add-new-storage-buckets='[{"autoclassTerminalStorageClass": "string", "enableAutoclass": boolean, "enableHNS": boolean, "name": "string", "storageClass": "string"}]' + --add-new-storage-buckets='[{"enableAutoclass": boolean, "enableHNS": boolean, "name": "string", "storageClass": "string", "terminalStorageClass": "string"}]' File Example: @@ -468,7 +470,7 @@ REQUIRED FLAGS Parameters to define cluster on demand instances. For e.g. --add-on-demand-instances - id={computeId},zone={zone},machineType={machineType}. + id={computeId},zone={zone},machineType={machineType},atmTags="tag1=val1". Sets add_on_demand_instances value. @@ -506,7 +508,17 @@ REQUIRED FLAGS Parameters to define cluster reserved instances. For e.g. --add-reserved-instances - id={computeId},reservation=zones/{zone}/reservations/{reservation}. + id={computeId},reservation=zones/{zone}/reservations/{reservation} + + Exactly one of reservation, reservation-block, or + reservation-sub-block must be provided. reservation: The name of the + reservation to use, in the format + zones/{zone}/reservations/{reservation}. reservationBlock: The name + of the reservation block to use, in the format + zones/{zone}/reservations/{reservation}/reservationBlocks/{reservation_block}. + reservationSubBlock: The name of the reservation sub-block to use, in + the format + zones/{zone}/reservations/{reservation}/reservationBlocks/{reservation_block}/reservationSubBlocks/{reservation_sub_block}. Sets add_reserved_instances value. @@ -523,7 +535,7 @@ REQUIRED FLAGS Required, sets id value. reservation - Required, sets reservation value. + Sets reservation value. reservationBlock Sets reservationBlock value. @@ -548,20 +560,26 @@ REQUIRED FLAGS For e.g. --add-slurm-epilog-scripts script1.sh,script2.sh - --add-slurm-node-sets=[bootDisk=BOOTDISK],[computeId=COMPUTEID],[container-resource-labels=CONTAINER-RESOURCE-LABELS],[container-startup-script=CONTAINER-STARTUP-SCRIPT],[id=ID],[labels=LABELS],[maxDynamicNodeCount=MAXDYNAMICNODECOUNT],[serviceAccount=SERVICEACCOUNT],[startupScript=STARTUPSCRIPT],[startupScriptTimeout=STARTUPSCRIPTTIMEOUT],[staticNodeCount=STATICNODECOUNT] + --add-slurm-node-sets=[bootDisk=BOOTDISK],[computeId=COMPUTEID],[container-resource-labels=CONTAINER-RESOURCE-LABELS],[container-startup-script=CONTAINER-STARTUP-SCRIPT],[id=ID],[labels=LABELS],[maxDynamicNodeCount=MAXDYNAMICNODECOUNT],[serviceAccount=SERVICEACCOUNT],[startupScript=STARTUPSCRIPT],[startupScriptTimeout=STARTUPSCRIPTTIMEOUT],[staticNodeCount=STATICNODECOUNT],[type=TYPE] Parameters to define slurm cluster nodeset config. For e.g. --add-slurm-node-sets - id={nodesetId},computeId={computeId},staticNodeCount={staticNodeCount},maxDynamicNodeCount={maxDynamicNodeCount},startupScript="echo + id={nodesetId},computeId={computeId},type=gce,staticNodeCount={staticNodeCount},maxDynamicNodeCount={maxDynamicNodeCount},startupScript="echo hello",labels="{key1=value1,key2=value2}" - To configure a node set backed by GKE, use container-resource-labels - or container-startup-script. For e.g. --add-slurm-node-sets - id={nodesetId},container-resource-labels="key1=val1",container-startup-script="echo + To configure a node set backed by Google Kubernetes Engine, use + type=gke. If type=gke is specified, Compute Engine specific fields + (labels, startupScript, bootDisk, startupScriptTimeout) cannot be + used, but container-specific fields (container-resource-labels, + container-startup-script) may be used. For e.g. --add-slurm-node-sets + id={nodesetId},computeId={computeId},type=gke For e.g. + --add-slurm-node-sets + id={nodesetId},computeId={computeId},type=gke,container-resource-labels="key1=val1",container-startup-script="echo hello" Defaults: ▸ staticNodeCount: 1 + ▸ type: gce Note: ▸ startupScript: @@ -632,13 +650,16 @@ REQUIRED FLAGS staticNodeCount Sets staticNodeCount value. + type + Sets type value. + Shorthand Example: - --add-slurm-node-sets=bootDisk={image=string,sizeGb=int,type=string},computeId=string,container-resource-labels={string=string},container-startup-script=string,id=string,labels={string=string},maxDynamicNodeCount=int,serviceAccount={email=string,scopes},startupScript=string,startupScriptTimeout=string,staticNodeCount=int --add-slurm-node-sets=bootDisk={image=string,sizeGb=int,type=string},computeId=string,container-resource-labels={string=string},container-startup-script=string,id=string,labels={string=string},maxDynamicNodeCount=int,serviceAccount={email=string,scopes},startupScript=string,startupScriptTimeout=string,staticNodeCount=int + --add-slurm-node-sets=bootDisk={image=string,sizeGb=int,type=string},computeId=string,container-resource-labels={string=string},container-startup-script=string,id=string,labels={string=string},maxDynamicNodeCount=int,serviceAccount={email=string,scopes},startupScript=string,startupScriptTimeout=string,staticNodeCount=int,type=string --add-slurm-node-sets=bootDisk={image=string,sizeGb=int,type=string},computeId=string,container-resource-labels={string=string},container-startup-script=string,id=string,labels={string=string},maxDynamicNodeCount=int,serviceAccount={email=string,scopes},startupScript=string,startupScriptTimeout=string,staticNodeCount=int,type=string JSON Example: - --add-slurm-node-sets='[{"bootDisk": {"image": "string", "sizeGb": int, "type": "string"}, "computeId": "string", "container-resource-labels": {"string": "string"}, "container-startup-script": "string", "id": "string", "labels": {"string": "string"}, "maxDynamicNodeCount": int, "serviceAccount": {"email": "string", "scopes"}, "startupScript": "string", "startupScriptTimeout": "string", "staticNodeCount": int}]' + --add-slurm-node-sets='[{"bootDisk": {"image": "string", "sizeGb": int, "type": "string"}, "computeId": "string", "container-resource-labels": {"string": "string"}, "container-startup-script": "string", "id": "string", "labels": {"string": "string"}, "maxDynamicNodeCount": int, "serviceAccount": {"email": "string", "scopes"}, "startupScript": "string", "startupScriptTimeout": "string", "staticNodeCount": int, "type": "string"}]' File Example: @@ -648,7 +669,7 @@ REQUIRED FLAGS Parameters to define slurm cluster partitions. For e.g. --add-slurm-partitions - id={partitionId},nodesetIds=[{nodesetId1},{nodesetId2}],exclusive=false. + id=p1,nodesetIds=[ns1,ns2],exclusive=false. Sets add_slurm_partitions value. @@ -692,7 +713,7 @@ REQUIRED FLAGS Parameters to define cluster spot instances. For e.g. --add-spot-instances - id={computeId},zone={zone},machineType={machineType}. + id={computeId},zone={zone},machineType={machineType},atmTags="tag1=val1". Sets add_spot_instances value. @@ -784,7 +805,7 @@ REQUIRED FLAGS --remove-slurm-partitions=[REMOVE_SLURM_PARTITIONS,...] Parameters to remove slurm partition config by partition id. - For e.g. --remove-slurm-partitions {partitionId1},{partitionId2},... + For e.g. --remove-slurm-partitions p1,p2,... --remove-slurm-prolog-scripts=[REMOVE_SLURM_PROLOG_SCRIPTS,...] Scripts to remove from Slurm prolog bash scripts. @@ -948,7 +969,7 @@ REQUIRED FLAGS --update-slurm-login-node=path_to_file.(yaml|json) - --update-slurm-node-sets=[bootDisk=BOOTDISK],[computeId=COMPUTEID],[container-resource-labels=CONTAINER-RESOURCE-LABELS],[container-startup-script=CONTAINER-STARTUP-SCRIPT],[id=ID],[labels=LABELS],[maxDynamicNodeCount=MAXDYNAMICNODECOUNT],[serviceAccount=SERVICEACCOUNT],[startupScript=STARTUPSCRIPT],[startupScriptTimeout=STARTUPSCRIPTTIMEOUT],[staticNodeCount=STATICNODECOUNT] + --update-slurm-node-sets=[bootDisk=BOOTDISK],[computeId=COMPUTEID],[container-resource-labels=CONTAINER-RESOURCE-LABELS],[container-startup-script=CONTAINER-STARTUP-SCRIPT],[id=ID],[labels=LABELS],[maxDynamicNodeCount=MAXDYNAMICNODECOUNT],[serviceAccount=SERVICEACCOUNT],[startupScript=STARTUPSCRIPT],[startupScriptTimeout=STARTUPSCRIPTTIMEOUT],[staticNodeCount=STATICNODECOUNT],[type=TYPE] Parameters to define and update slurm cluster nodeset config. For e.g. --update-slurm-node-sets @@ -956,7 +977,7 @@ REQUIRED FLAGS To update a node set backed by GKE, use container-resource-labels or container-startup-script. For e.g. --update-slurm-node-sets - id={nodesetId},container-resource-labels="key1=val1",container-startup-script="echo + id={nodesetId},type=gke,container-resource-labels="key1=val1",container-startup-script="echo hello". Sets update_slurm_node_sets value. @@ -1021,13 +1042,16 @@ REQUIRED FLAGS staticNodeCount Sets staticNodeCount value. + type + Sets type value. + Shorthand Example: - --update-slurm-node-sets=bootDisk={image=string,sizeGb=int,type=string},computeId=string,container-resource-labels={string=string},container-startup-script=string,id=string,labels={string=string},maxDynamicNodeCount=int,serviceAccount={email=string,scopes},startupScript=string,startupScriptTimeout=string,staticNodeCount=int --update-slurm-node-sets=bootDisk={image=string,sizeGb=int,type=string},computeId=string,container-resource-labels={string=string},container-startup-script=string,id=string,labels={string=string},maxDynamicNodeCount=int,serviceAccount={email=string,scopes},startupScript=string,startupScriptTimeout=string,staticNodeCount=int + --update-slurm-node-sets=bootDisk={image=string,sizeGb=int,type=string},computeId=string,container-resource-labels={string=string},container-startup-script=string,id=string,labels={string=string},maxDynamicNodeCount=int,serviceAccount={email=string,scopes},startupScript=string,startupScriptTimeout=string,staticNodeCount=int,type=string --update-slurm-node-sets=bootDisk={image=string,sizeGb=int,type=string},computeId=string,container-resource-labels={string=string},container-startup-script=string,id=string,labels={string=string},maxDynamicNodeCount=int,serviceAccount={email=string,scopes},startupScript=string,startupScriptTimeout=string,staticNodeCount=int,type=string JSON Example: - --update-slurm-node-sets='[{"bootDisk": {"image": "string", "sizeGb": int, "type": "string"}, "computeId": "string", "container-resource-labels": {"string": "string"}, "container-startup-script": "string", "id": "string", "labels": {"string": "string"}, "maxDynamicNodeCount": int, "serviceAccount": {"email": "string", "scopes"}, "startupScript": "string", "startupScriptTimeout": "string", "staticNodeCount": int}]' + --update-slurm-node-sets='[{"bootDisk": {"image": "string", "sizeGb": int, "type": "string"}, "computeId": "string", "container-resource-labels": {"string": "string"}, "container-startup-script": "string", "id": "string", "labels": {"string": "string"}, "maxDynamicNodeCount": int, "serviceAccount": {"email": "string", "scopes"}, "startupScript": "string", "startupScriptTimeout": "string", "staticNodeCount": int, "type": "string"}]' File Example: @@ -1037,7 +1061,7 @@ REQUIRED FLAGS Parameters to define and update slurm cluster partition config. For e.g. --update-slurm-partitions - id={partitionId},nodesetIds=[{nodesetId1},{nodesetId2}],exclusive=false. + id=p1,nodesetIds=[ns1,ns2],exclusive=false. Sets update_slurm_partitions value. @@ -1428,6 +1452,9 @@ REQUIRED FLAGS startupScript Sets startupScript value. + startupScriptTimeout + Sets startupScriptTimeout value. + containerNodePool Sets containerNodePool value. @@ -1577,11 +1604,11 @@ REQUIRED FLAGS Shorthand Example: - --config=computeResources={string={config={newDwsFlexInstances={atmTags={string=string},machineType=string,maxDuration=string,terminationAction=string,zone=string},newFlexStartInstances={atmTags={string=string},machineType=string,maxDuration=string,terminationAction=string,zone=string},newOnDemandInstances={atmTags={string=string},machineType=string,zone=string},newReservedInstances={atmTags={string=string},machineType=string,reservation=string,reservationBlock=string,reservationSubBlock=string,type=string,zone=string},newSpotInstances={atmTags={string=string},machineType=string,terminationAction=string,zone=string}}}},description=string,labels={string=string},name=string,networkResources={string={config={existingComputeNetwork={network=string,subnetwork=string},existingNetwork={network=string,subnetwork=string},newComputeNetwork={description=string,network=string},newNetwork={description=string,network=string}}}},orchestrator={slurm={config={accountingStorageEnforceFlags,healthCheckInterval=int,healthCheckNodeState=string,healthCheckProgram=string,preemptExemptTime=string,preemptMode,preemptType=string,priorityType=string,priorityWeightAge=int,priorityWeightAssoc=int,priorityWeightFairshare=int,priorityWeightJobSize=int,priorityWeightPartition=int,priorityWeightQos=int,priorityWeightTres=string,prologEpilogTimeout=string,prologFlags,requeueExitCodes,requeueHoldExitCodes},defaultPartition=string,disableHealthCheckProgram=boolean,epilogBashScripts,loginNodes={bootDisk={image=string,sizeGb=int,type=string},count=int,enableOsLogin=boolean,enablePublicIps=boolean,labels={string=string},machineType=string,serviceAccount={email=string,scopes},startupScript=string,storageConfigs=[{id=string,localMount=string}],zone=string},nodeSets=[{computeId=string,computeInstance={bootDisk={image=string,sizeGb=int,type=string},labels={string=string},startupScript=string},containerNodePool,id=string,maxDynamicNodeCount=int,serviceAccount={email=string,scopes},staticNodeCount=int,storageConfigs=[{id=string,localMount=string}]}],partitions=[{exclusive=boolean,id=string,nodeSetIds=[string]}],prologBashScripts,taskEpilogBashScripts,taskPrologBashScripts}},storageResources={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,perUnitStorageThroughput=int}}}} + --config=computeResources={string={config={newDwsFlexInstances={atmTags={string=string},machineType=string,maxDuration=string,terminationAction=string,zone=string},newFlexStartInstances={atmTags={string=string},machineType=string,maxDuration=string,terminationAction=string,zone=string},newOnDemandInstances={atmTags={string=string},machineType=string,zone=string},newReservedInstances={atmTags={string=string},machineType=string,reservation=string,reservationBlock=string,reservationSubBlock=string,type=string,zone=string},newSpotInstances={atmTags={string=string},machineType=string,terminationAction=string,zone=string}}}},description=string,labels={string=string},name=string,networkResources={string={config={existingComputeNetwork={network=string,subnetwork=string},existingNetwork={network=string,subnetwork=string},newComputeNetwork={description=string,network=string},newNetwork={description=string,network=string}}}},orchestrator={slurm={config={accountingStorageEnforceFlags,healthCheckInterval=int,healthCheckNodeState=string,healthCheckProgram=string,preemptExemptTime=string,preemptMode,preemptType=string,priorityType=string,priorityWeightAge=int,priorityWeightAssoc=int,priorityWeightFairshare=int,priorityWeightJobSize=int,priorityWeightPartition=int,priorityWeightQos=int,priorityWeightTres=string,prologEpilogTimeout=string,prologFlags,requeueExitCodes,requeueHoldExitCodes},defaultPartition=string,disableHealthCheckProgram=boolean,epilogBashScripts,loginNodes={bootDisk={image=string,sizeGb=int,type=string},count=int,enableOsLogin=boolean,enablePublicIps=boolean,labels={string=string},machineType=string,serviceAccount={email=string,scopes},startupScript=string,storageConfigs=[{id=string,localMount=string}],zone=string},nodeSets=[{computeId=string,computeInstance={bootDisk={image=string,sizeGb=int,type=string},labels={string=string},startupScript=string,startupScriptTimeout=string},containerNodePool,id=string,maxDynamicNodeCount=int,serviceAccount={email=string,scopes},staticNodeCount=int,storageConfigs=[{id=string,localMount=string}]}],partitions=[{exclusive=boolean,id=string,nodeSetIds=[string]}],prologBashScripts,taskEpilogBashScripts,taskPrologBashScripts}},storageResources={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,perUnitStorageThroughput=int}}}} JSON Example: - --config='{"computeResources": {"string": {"config": {"newDwsFlexInstances": {"atmTags": {"string": "string"}, "machineType": "string", "maxDuration": "string", "terminationAction": "string", "zone": "string"}, "newFlexStartInstances": {"atmTags": {"string": "string"}, "machineType": "string", "maxDuration": "string", "terminationAction": "string", "zone": "string"}, "newOnDemandInstances": {"atmTags": {"string": "string"}, "machineType": "string", "zone": "string"}, "newReservedInstances": {"atmTags": {"string": "string"}, "machineType": "string", "reservation": "string", "reservationBlock": "string", "reservationSubBlock": "string", "type": "string", "zone": "string"}, "newSpotInstances": {"atmTags": {"string": "string"}, "machineType": "string", "terminationAction": "string", "zone": "string"}}}}, "description": "string", "labels": {"string": "string"}, "name": "string", "networkResources": {"string": {"config": {"existingComputeNetwork": {"network": "string", "subnetwork": "string"}, "existingNetwork": {"network": "string", "subnetwork": "string"}, "newComputeNetwork": {"description": "string", "network": "string"}, "newNetwork": {"description": "string", "network": "string"}}}}, "orchestrator": {"slurm": {"config": {"accountingStorageEnforceFlags", "healthCheckInterval": int, "healthCheckNodeState": "string", "healthCheckProgram": "string", "preemptExemptTime": "string", "preemptMode", "preemptType": "string", "priorityType": "string", "priorityWeightAge": int, "priorityWeightAssoc": int, "priorityWeightFairshare": int, "priorityWeightJobSize": int, "priorityWeightPartition": int, "priorityWeightQos": int, "priorityWeightTres": "string", "prologEpilogTimeout": "string", "prologFlags", "requeueExitCodes", "requeueHoldExitCodes"}, "defaultPartition": "string", "disableHealthCheckProgram": boolean, "epilogBashScripts", "loginNodes": {"bootDisk": {"image": "string", "sizeGb": int, "type": "string"}, "count": int, "enableOsLogin": boolean, "enablePublicIps": boolean, "labels": {"string": "string"}, "machineType": "string", "serviceAccount": {"email": "string", "scopes"}, "startupScript": "string", "storageConfigs": [{"id": "string", "localMount": "string"}], "zone": "string"}, "nodeSets": [{"computeId": "string", "computeInstance": {"bootDisk": {"image": "string", "sizeGb": int, "type": "string"}, "labels": {"string": "string"}, "startupScript": "string"}, "containerNodePool": {}, "id": "string", "maxDynamicNodeCount": int, "serviceAccount": {"email": "string", "scopes"}, "staticNodeCount": int, "storageConfigs": [{"id": "string", "localMount": "string"}]}], "partitions": [{"exclusive": boolean, "id": "string", "nodeSetIds": ["string"]}], "prologBashScripts", "taskEpilogBashScripts", "taskPrologBashScripts"}}, "storageResources": {"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", "perUnitStorageThroughput": int}}}}}' + --config='{"computeResources": {"string": {"config": {"newDwsFlexInstances": {"atmTags": {"string": "string"}, "machineType": "string", "maxDuration": "string", "terminationAction": "string", "zone": "string"}, "newFlexStartInstances": {"atmTags": {"string": "string"}, "machineType": "string", "maxDuration": "string", "terminationAction": "string", "zone": "string"}, "newOnDemandInstances": {"atmTags": {"string": "string"}, "machineType": "string", "zone": "string"}, "newReservedInstances": {"atmTags": {"string": "string"}, "machineType": "string", "reservation": "string", "reservationBlock": "string", "reservationSubBlock": "string", "type": "string", "zone": "string"}, "newSpotInstances": {"atmTags": {"string": "string"}, "machineType": "string", "terminationAction": "string", "zone": "string"}}}}, "description": "string", "labels": {"string": "string"}, "name": "string", "networkResources": {"string": {"config": {"existingComputeNetwork": {"network": "string", "subnetwork": "string"}, "existingNetwork": {"network": "string", "subnetwork": "string"}, "newComputeNetwork": {"description": "string", "network": "string"}, "newNetwork": {"description": "string", "network": "string"}}}}, "orchestrator": {"slurm": {"config": {"accountingStorageEnforceFlags", "healthCheckInterval": int, "healthCheckNodeState": "string", "healthCheckProgram": "string", "preemptExemptTime": "string", "preemptMode", "preemptType": "string", "priorityType": "string", "priorityWeightAge": int, "priorityWeightAssoc": int, "priorityWeightFairshare": int, "priorityWeightJobSize": int, "priorityWeightPartition": int, "priorityWeightQos": int, "priorityWeightTres": "string", "prologEpilogTimeout": "string", "prologFlags", "requeueExitCodes", "requeueHoldExitCodes"}, "defaultPartition": "string", "disableHealthCheckProgram": boolean, "epilogBashScripts", "loginNodes": {"bootDisk": {"image": "string", "sizeGb": int, "type": "string"}, "count": int, "enableOsLogin": boolean, "enablePublicIps": boolean, "labels": {"string": "string"}, "machineType": "string", "serviceAccount": {"email": "string", "scopes"}, "startupScript": "string", "storageConfigs": [{"id": "string", "localMount": "string"}], "zone": "string"}, "nodeSets": [{"computeId": "string", "computeInstance": {"bootDisk": {"image": "string", "sizeGb": int, "type": "string"}, "labels": {"string": "string"}, "startupScript": "string", "startupScriptTimeout": "string"}, "containerNodePool": {}, "id": "string", "maxDynamicNodeCount": int, "serviceAccount": {"email": "string", "scopes"}, "staticNodeCount": int, "storageConfigs": [{"id": "string", "localMount": "string"}]}], "partitions": [{"exclusive": boolean, "id": "string", "nodeSetIds": ["string"]}], "prologBashScripts", "taskEpilogBashScripts", "taskPrologBashScripts"}}, "storageResources": {"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", "perUnitStorageThroughput": int}}}}}' File Example: @@ -1625,5 +1652,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta cluster-director clusters update diff --git a/gcloud/alpha/cluster-director/help b/gcloud/alpha/cluster-director/help index de46f8e4d..3d4a412cd 100644 --- a/gcloud/alpha/cluster-director/help +++ b/gcloud/alpha/cluster-director/help @@ -28,5 +28,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta cluster-director diff --git a/gcloud/alpha/cluster-director/locations/describe b/gcloud/alpha/cluster-director/locations/describe index 8580221e1..d48bc0956 100644 --- a/gcloud/alpha/cluster-director/locations/describe +++ b/gcloud/alpha/cluster-director/locations/describe @@ -49,5 +49,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta cluster-director locations describe diff --git a/gcloud/alpha/cluster-director/locations/help b/gcloud/alpha/cluster-director/locations/help index ad30c4982..d19d08103 100644 --- a/gcloud/alpha/cluster-director/locations/help +++ b/gcloud/alpha/cluster-director/locations/help @@ -25,5 +25,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta cluster-director locations diff --git a/gcloud/alpha/cluster-director/locations/list b/gcloud/alpha/cluster-director/locations/list index fd28f14ee..ac7cec47f 100644 --- a/gcloud/alpha/cluster-director/locations/list +++ b/gcloud/alpha/cluster-director/locations/list @@ -57,5 +57,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta cluster-director locations list diff --git a/gcloud/alpha/cluster-director/operations/describe b/gcloud/alpha/cluster-director/operations/describe index df09d6e45..3e214bef5 100644 --- a/gcloud/alpha/cluster-director/operations/describe +++ b/gcloud/alpha/cluster-director/operations/describe @@ -62,5 +62,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta cluster-director operations describe diff --git a/gcloud/alpha/cluster-director/operations/help b/gcloud/alpha/cluster-director/operations/help index c227fce56..41d13776b 100644 --- a/gcloud/alpha/cluster-director/operations/help +++ b/gcloud/alpha/cluster-director/operations/help @@ -22,5 +22,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta cluster-director operations diff --git a/gcloud/alpha/compute/backend-services/add-backend b/gcloud/alpha/compute/backend-services/add-backend index 5ed5bfde1..b130b200b 100644 --- a/gcloud/alpha/compute/backend-services/add-backend +++ b/gcloud/alpha/compute/backend-services/add-backend @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud alpha compute backend-services add-backend BACKEND_SERVICE_NAME - ([--instance-group=INSTANCE_GROUP + (--service=SERVICE | [--instance-group=INSTANCE_GROUP : --instance-group-region=INSTANCE_GROUP_REGION | --instance-group-zone=INSTANCE_GROUP_ZONE] | [--network-endpoint-group=NETWORK_ENDPOINT_GROUP @@ -49,6 +49,11 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS Exactly one of these must be specified: + Service Group + + --service=SERVICE + The name or URI of a Google Cloud service to use as a backend. + Instance Group --instance-group=INSTANCE_GROUP diff --git a/gcloud/alpha/compute/backend-services/create b/gcloud/alpha/compute/backend-services/create index a36d42596..500ab76be 100644 --- a/gcloud/alpha/compute/backend-services/create +++ b/gcloud/alpha/compute/backend-services/create @@ -27,7 +27,6 @@ SYNOPSIS oauth2-client-secret=OAUTH2-CLIENT-SECRET]] [--idle-timeout-sec=IDLE_TIMEOUT_SEC] [--ip-address-selection-policy=IP_ADDRESS_SELECTION_POLICY] - [--ip-port-dynamic-forwarding] [--load-balancing-scheme=LOAD_BALANCING_SCHEME; default="EXTERNAL"] [--locality-lb-policy=LOCALITY_LB_POLICY] [--logging-optional=LOGGING_OPTIONAL] @@ -50,7 +49,8 @@ SYNOPSIS | --cache-key-query-string-whitelist=QUERY_STRING,[...]] [--custom-metrics=[CUSTOM_METRICS,...] | --custom-metrics-file=[CUSTOM_METRICS,...]] - [--global | --region=REGION] + [--forward-proxy-cloud-run | --forward-proxy-direct-forwarding + | --ip-port-dynamic-forwarding] [--global | --region=REGION] [--global-health-checks | --health-checks-region=HEALTH_CHECKS_REGION] [--identity=IDENTITY | --tls-settings=[authenticationConfig=AUTHENTICATIONCONFIG], @@ -391,9 +391,6 @@ FLAGS IP_ADDRESS_SELECTION_POLICY must be one of: IPV4_ONLY, PREFER_IPV6, IPV6_ONLY. - --ip-port-dynamic-forwarding - Enables Dynamic Forwarding in IpPort selection mode. - --load-balancing-scheme=LOAD_BALANCING_SCHEME; default="EXTERNAL" Specifies the load balancer type. Choose EXTERNAL for the classic Application Load Balancers, the external passthrough Network Load @@ -896,6 +893,17 @@ FLAGS --custom-metrics-file=path_to_file.(yaml|json) + At most one of these can be specified: + + --forward-proxy-cloud-run + Enables Cloud Run in Forward Proxy mode. + + --forward-proxy-direct-forwarding + Enables Direct Forwarding in Forward Proxy mode. + + --ip-port-dynamic-forwarding + Enables Dynamic Forwarding in IpPort selection mode. + At most one of these can be specified: --global diff --git a/gcloud/alpha/compute/backend-services/remove-backend b/gcloud/alpha/compute/backend-services/remove-backend index edbc8ff7b..8895f719b 100644 --- a/gcloud/alpha/compute/backend-services/remove-backend +++ b/gcloud/alpha/compute/backend-services/remove-backend @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud alpha compute backend-services remove-backend BACKEND_SERVICE_NAME - ([--instance-group=INSTANCE_GROUP + (--service=SERVICE | [--instance-group=INSTANCE_GROUP : --instance-group-region=INSTANCE_GROUP_REGION | --instance-group-zone=INSTANCE_GROUP_ZONE] | [--network-endpoint-group=NETWORK_ENDPOINT_GROUP @@ -28,6 +28,11 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS Exactly one of these must be specified: + Service Group + + --service=SERVICE + The name or URI of a Google Cloud service to use as a backend. + Instance Group --instance-group=INSTANCE_GROUP diff --git a/gcloud/alpha/compute/backend-services/update b/gcloud/alpha/compute/backend-services/update index 00e9f94a2..c43f23dae 100644 --- a/gcloud/alpha/compute/backend-services/update +++ b/gcloud/alpha/compute/backend-services/update @@ -25,7 +25,6 @@ SYNOPSIS oauth2-client-secret=OAUTH2-CLIENT-SECRET]] [--idle-timeout-sec=IDLE_TIMEOUT_SEC] [--ip-address-selection-policy=IP_ADDRESS_SELECTION_POLICY] - [--ip-port-dynamic-forwarding] [--load-balancing-scheme=LOAD_BALANCING_SCHEME] [--logging-optional=LOGGING_OPTIONAL] [--logging-optional-fields=[LOGGING_OPTIONAL_FIELDS,...]] @@ -53,7 +52,8 @@ SYNOPSIS [--custom-response-header=CUSTOM_RESPONSE_HEADER | --no-custom-response-headers] [--default-ttl=DEFAULT_TTL | --no-default-ttl] - [--global | --region=REGION] + [--forward-proxy-cloud-run | --forward-proxy-direct-forwarding + | --ip-port-dynamic-forwarding] [--global | --region=REGION] [--global-health-checks | --health-checks-region=HEALTH_CHECKS_REGION] [--locality-lb-policy=LOCALITY_LB_POLICY | --no-locality-lb-policy] [--max-ttl=MAX_TTL | --no-max-ttl] @@ -320,9 +320,6 @@ FLAGS IP_ADDRESS_SELECTION_POLICY must be one of: IPV4_ONLY, PREFER_IPV6, IPV6_ONLY. - --ip-port-dynamic-forwarding - Enables Dynamic Forwarding in IpPort selection mode. - --load-balancing-scheme=LOAD_BALANCING_SCHEME Only for the Global external Application Load Balancer migration. @@ -835,6 +832,17 @@ FLAGS --no-default-ttl Clears default TTL value. + At most one of these can be specified: + + --forward-proxy-cloud-run + Enables Cloud Run in Forward Proxy mode. + + --forward-proxy-direct-forwarding + Enables Direct Forwarding in Forward Proxy mode. + + --ip-port-dynamic-forwarding + Enables Dynamic Forwarding in IpPort selection mode. + At most one of these can be specified: --global diff --git a/gcloud/alpha/compute/backend-services/update-backend b/gcloud/alpha/compute/backend-services/update-backend index a0b1e116d..d9cca91e3 100644 --- a/gcloud/alpha/compute/backend-services/update-backend +++ b/gcloud/alpha/compute/backend-services/update-backend @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud alpha compute backend-services update-backend BACKEND_SERVICE_NAME - ([--instance-group=INSTANCE_GROUP + (--service=SERVICE | [--instance-group=INSTANCE_GROUP : --instance-group-region=INSTANCE_GROUP_REGION | --instance-group-zone=INSTANCE_GROUP_ZONE] | [--network-endpoint-group=NETWORK_ENDPOINT_GROUP @@ -50,6 +50,11 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS Exactly one of these must be specified: + Service Group + + --service=SERVICE + The name or URI of a Google Cloud service to use as a backend. + Instance Group --instance-group=INSTANCE_GROUP diff --git a/gcloud/alpha/compute/firewall-policies/rules/create b/gcloud/alpha/compute/firewall-policies/rules/create index 1378a3390..b15a32d72 100644 --- a/gcloud/alpha/compute/firewall-policies/rules/create +++ b/gcloud/alpha/compute/firewall-policies/rules/create @@ -87,12 +87,12 @@ OPTIONAL FLAGS --dest-region-codes=[DEST_REGION_CODES,...] Destination Region Code to match for this rule. Can only be specified if DIRECTION is egress. Cannot be specified when the source network - type is NON_INTERNET. + context is NON_INTERNET. --dest-threat-intelligence=[DEST_THREAT_INTELLIGENCE_LISTS,...] Destination Threat Intelligence lists to match for this rule. Can only be specified if DIRECTION is egress. Cannot be specified when source - network type is NON_INTERNET. The available lists can be found here: + network context is NON_INTERNET. The available lists can be found here: https://cloud.google.com/vpc/docs/firewall-policies-rule-details#threat-intelligence-fw-policy. --direction=DIRECTION @@ -156,8 +156,8 @@ OPTIONAL FLAGS --src-region-codes=[SOURCE_REGION_CODES,...] Source Region Code to match for this rule. Can only be specified if - DIRECTION is ingress. Cannot be specified when the source network type - is NON_INTERNET, VPC_NETWORK or INTRA_VPC. + DIRECTION is ingress. Cannot be specified when the source network + context is NON_INTERNET, VPC_NETWORK or INTRA_VPC. --src-secure-tags=[SOURCE_SECURE_TAGS,...] A list of instance secure tags indicating the set of instances on the @@ -172,8 +172,8 @@ OPTIONAL FLAGS --src-threat-intelligence=[SOURCE_THREAT_INTELLIGENCE_LISTS,...] Source Threat Intelligence lists to match for this rule. Can only be specified if DIRECTION is ingress. Cannot be specified when the source - network type is NON_INTERNET, VPC_NETWORK or INTRA_VPC. The available - lists can be found here: + network context is NON_INTERNET, VPC_NETWORK or INTRA_VPC. The + available lists can be found here: https://cloud.google.com/vpc/docs/firewall-policies-rule-details#threat-intelligence-fw-policy. --target-resources=[TARGET_RESOURCES,...] diff --git a/gcloud/alpha/compute/firewall-policies/rules/update b/gcloud/alpha/compute/firewall-policies/rules/update index a7c5f0cb8..02f36f5d8 100644 --- a/gcloud/alpha/compute/firewall-policies/rules/update +++ b/gcloud/alpha/compute/firewall-policies/rules/update @@ -85,12 +85,12 @@ OPTIONAL FLAGS --dest-region-codes=[DEST_REGION_CODES,...] Destination Region Code to match for this rule. Can only be specified if DIRECTION is egress. Cannot be specified when the source network - type is NON_INTERNET. + context is NON_INTERNET. --dest-threat-intelligence=[DEST_THREAT_INTELLIGENCE_LISTS,...] Destination Threat Intelligence lists to match for this rule. Can only be specified if DIRECTION is egress. Cannot be specified when source - network type is NON_INTERNET. The available lists can be found here: + network context is NON_INTERNET. The available lists can be found here: https://cloud.google.com/vpc/docs/firewall-policies-rule-details#threat-intelligence-fw-policy. --direction=DIRECTION @@ -161,8 +161,8 @@ OPTIONAL FLAGS --src-region-codes=[SOURCE_REGION_CODES,...] Source Region Code to match for this rule. Can only be specified if - DIRECTION is ingress. Cannot be specified when the source network type - is NON_INTERNET, VPC_NETWORK or INTRA_VPC. + DIRECTION is ingress. Cannot be specified when the source network + context is NON_INTERNET, VPC_NETWORK or INTRA_VPC. --src-secure-tags=[SOURCE_SECURE_TAGS,...] A list of instance secure tags indicating the set of instances on the @@ -177,8 +177,8 @@ OPTIONAL FLAGS --src-threat-intelligence=[SOURCE_THREAT_INTELLIGENCE_LISTS,...] Source Threat Intelligence lists to match for this rule. Can only be specified if DIRECTION is ingress. Cannot be specified when the source - network type is NON_INTERNET, VPC_NETWORK or INTRA_VPC. The available - lists can be found here: + network context is NON_INTERNET, VPC_NETWORK or INTRA_VPC. The + available lists can be found here: https://cloud.google.com/vpc/docs/firewall-policies-rule-details#threat-intelligence-fw-policy. --target-resources=[TARGET_RESOURCES,...] diff --git a/gcloud/alpha/compute/instance-groups/managed/create b/gcloud/alpha/compute/instance-groups/managed/create index cf47a124e..81443d7e0 100644 --- a/gcloud/alpha/compute/instance-groups/managed/create +++ b/gcloud/alpha/compute/instance-groups/managed/create @@ -10,8 +10,9 @@ SYNOPSIS [--default-action-on-vm-failure=ACTION_ON_VM_FAILURE] [--description=DESCRIPTION] [--[no-]force-update-on-repair] [--initial-delay=INITIAL_DELAY] [--instance-redistribution-type=TYPE] - [--instance-selection=name=NAME, - machine-type=MACHINE_TYPE[,machine-type=MACHINE_TYPE...][,rank=RANK]] + [--instance-selection=name=NAME,machine-type=MACHINE_TYPE[, + machine-type=MACHINE_TYPE...][, + rank=RANK][,min-cpu-platform=MIN_CPU_PLATFORM]] [--instance-selection-machine-types=[MACHINE_TYPE,...]] [--list-managed-instances-results=MODE] [--on-repair-allow-changing-zone=ON_REPAIR_ALLOW_CHANGING_ZONE] @@ -156,9 +157,10 @@ OPTIONAL FLAGS The managed instance group proactively redistributes instances to meet its target distribution. - --instance-selection=name=NAME,machine-type=MACHINE_TYPE[,machine-type=MACHINE_TYPE...][,rank=RANK] - Named selection of machine types with an optional rank. For example, - --instance-selection="name=instance-selection-1,machine-type=e2-standard-8,machine-type=t2d-standard-8,rank=0" + --instance-selection=name=NAME,machine-type=MACHINE_TYPE[,machine-type=MACHINE_TYPE...][,rank=RANK][,min-cpu-platform=MIN_CPU_PLATFORM] + Named selection of machine types with an optional rank and minimum CPU + platform. For example, + --instance-selection="name=instance-selection-1,machine-type=e2-standard-8,machine-type=t2d-standard-8,rank=0,min-cpu-platform=MIN_CPU_PLATFORM" --instance-selection-machine-types=[MACHINE_TYPE,...] Machine types that are used to create VMs. If not provided, the machine diff --git a/gcloud/alpha/compute/instance-groups/managed/update b/gcloud/alpha/compute/instance-groups/managed/update index 5beadc8ba..9eac0e885 100644 --- a/gcloud/alpha/compute/instance-groups/managed/update +++ b/gcloud/alpha/compute/instance-groups/managed/update @@ -8,8 +8,9 @@ SYNOPSIS [--default-action-on-vm-failure=ACTION_ON_VM_FAILURE] [--description=DESCRIPTION] [--[no-]force-update-on-repair] [--instance-redistribution-type=TYPE] - [--instance-selection=name=NAME, - machine-type=MACHINE_TYPE[,machine-type=MACHINE_TYPE...][,rank=RANK]] + [--instance-selection=name=NAME,machine-type=MACHINE_TYPE[, + machine-type=MACHINE_TYPE...][, + rank=RANK][,min-cpu-platform=MIN_CPU_PLATFORM]] [--instance-selection-machine-types=[MACHINE_TYPE,...]] [--list-managed-instances-results=MODE] [--on-repair-allow-changing-zone=ON_REPAIR_ALLOW_CHANGING_ZONE] @@ -26,7 +27,7 @@ SYNOPSIS [--stateful-internal-ip=[enabled], [auto-delete=AUTO-DELETE],[interface-name=INTERFACE-NAME]] [--stopped-size=STOPPED_SIZE] [--suspended-size=SUSPENDED_SIZE] - [--target-distribution-shape=SHAPE] + [--target-distribution-shape=SHAPE] [--template=TEMPLATE] [--clear-autohealing | --initial-delay=INITIAL_DELAY --health-check=HEALTH_CHECK | --http-health-check=HTTP_HEALTH_CHECK @@ -135,9 +136,10 @@ FLAGS The managed instance group proactively redistributes instances to meet its target distribution. - --instance-selection=name=NAME,machine-type=MACHINE_TYPE[,machine-type=MACHINE_TYPE...][,rank=RANK] - Named selection of machine types with an optional rank. For example, - --instance-selection="name=instance-selection-1,machine-type=e2-standard-8,machine-type=t2d-standard-8,rank=0" + --instance-selection=name=NAME,machine-type=MACHINE_TYPE[,machine-type=MACHINE_TYPE...][,rank=RANK][,min-cpu-platform=MIN_CPU_PLATFORM] + Named selection of machine types with an optional rank and minimum CPU + platform. For example, + --instance-selection="name=instance-selection-1,machine-type=e2-standard-8,machine-type=t2d-standard-8,rank=0,min-cpu-platform=MIN_CPU_PLATFORM" --instance-selection-machine-types=[MACHINE_TYPE,...] Machine types that are used to create VMs. If not provided, the machine @@ -342,6 +344,13 @@ FLAGS instances does not differ by more than 1 between any two zones. Recommended for highly available serving workloads. + --template=TEMPLATE + Specifies the instance template that will replace the existing template + used by the MIG. The MIG then uses this new template to create + instances. Specifying the new template overrides any template versions + that you've set for the MIG. Specify either a global or a regional + instance template. + At most one of these can be specified: --clear-autohealing diff --git a/gcloud/alpha/compute/instances/update-from-file b/gcloud/alpha/compute/instances/update-from-file index 888baadaa..bbc2c75d5 100644 --- a/gcloud/alpha/compute/instances/update-from-file +++ b/gcloud/alpha/compute/instances/update-from-file @@ -4,7 +4,8 @@ NAME SYNOPSIS gcloud alpha compute instances update-from-file INSTANCE_NAME - [--clear-secure-tag] [--minimal-action=MINIMAL_ACTION] + [--clear-secure-tag] [--discard-local-ssd] + [--minimal-action=MINIMAL_ACTION] [--most-disruptive-allowed-action=MOST_DISRUPTIVE_ALLOWED_ACTION] [--source=SOURCE] [--zone=ZONE] [GCLOUD_WIDE_FLAG ...] @@ -29,6 +30,11 @@ FLAGS --clear-secure-tag If specified, all secure tags bound to this instance will be removed. + --discard-local-ssd + If specified, all local SSDs data attached to this instance will be + discarded. This is only used with most-disruptive-allowed-action set to + RESTART. + --minimal-action=MINIMAL_ACTION If specified, this action or higher level action is performed on the instance irrespective of what action is required for the update to take diff --git a/gcloud/alpha/compute/instant-snapshot-groups/create b/gcloud/alpha/compute/instant-snapshot-groups/create index 932d46a85..505b336db 100644 --- a/gcloud/alpha/compute/instant-snapshot-groups/create +++ b/gcloud/alpha/compute/instant-snapshot-groups/create @@ -9,7 +9,18 @@ SYNOPSIS [--region=REGION | --zone=ZONE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Create a Compute Engine instant snapshot group. + (ALPHA) gcloud alpha compute instant-snapshot-groups create creates an + instant snapshot group of the consistency group. An Instant Snapshot Group + is a Point In Time view of the constituent disks of a Consistency Group, + they are stored in-place as Instant Snapshots on the corresponding disks. + +EXAMPLES + To create an instant snapshot group 'my-instant-snapshot-group' in zone + 'us-east1-a' from a consistency group 'my-consistency-group' in region + 'us-east1', run: $ gcloud alpha compute instant-snapshot-groups create \ + my-instant-snapshot-group --zone us-east1-a \ + --source-consistency-group=regions/us-east1/resourcePolicies/\ + policy1 POSITIONAL ARGUMENTS INSTANT_SNAPSHOT_GROUP_NAME @@ -76,5 +87,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta compute instant-snapshot-groups create diff --git a/gcloud/alpha/compute/instant-snapshot-groups/delete b/gcloud/alpha/compute/instant-snapshot-groups/delete index e4a7c32a4..f1e270cda 100644 --- a/gcloud/alpha/compute/instant-snapshot-groups/delete +++ b/gcloud/alpha/compute/instant-snapshot-groups/delete @@ -70,5 +70,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta compute instant-snapshot-groups delete diff --git a/gcloud/alpha/compute/instant-snapshot-groups/describe b/gcloud/alpha/compute/instant-snapshot-groups/describe index 9e855d87a..831c76827 100644 --- a/gcloud/alpha/compute/instant-snapshot-groups/describe +++ b/gcloud/alpha/compute/instant-snapshot-groups/describe @@ -8,7 +8,15 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Describe a Compute Engine instant snapshot group. + (ALPHA) gcloud alpha compute instant-snapshot-groups describe displays all + data associated with a Compute Engine instant snapshot group in a project. + +EXAMPLES + To describe the instant snapshot group 'instant-snapshot-group-1' in zone + 'us-east1-a', run: + + $ gcloud alpha compute instant-snapshot-groups describe \ + instant-snapshot-group-1 --zone=us-east1-a POSITIONAL ARGUMENTS INSTANT_SNAPSHOT_GROUP_NAME @@ -70,5 +78,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta compute instant-snapshot-groups describe diff --git a/gcloud/alpha/compute/instant-snapshot-groups/help b/gcloud/alpha/compute/instant-snapshot-groups/help index 62992c8e9..6321d0975 100644 --- a/gcloud/alpha/compute/instant-snapshot-groups/help +++ b/gcloud/alpha/compute/instant-snapshot-groups/help @@ -32,5 +32,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta compute instant-snapshot-groups diff --git a/gcloud/alpha/compute/instant-snapshot-groups/list b/gcloud/alpha/compute/instant-snapshot-groups/list index 15fd7ed9c..9ccdc95ca 100644 --- a/gcloud/alpha/compute/instant-snapshot-groups/list +++ b/gcloud/alpha/compute/instant-snapshot-groups/list @@ -92,5 +92,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta compute instant-snapshot-groups list diff --git a/gcloud/alpha/compute/instant-snapshots/create b/gcloud/alpha/compute/instant-snapshots/create index 57ffe5a54..85163c4a1 100644 --- a/gcloud/alpha/compute/instant-snapshots/create +++ b/gcloud/alpha/compute/instant-snapshots/create @@ -5,6 +5,7 @@ NAME SYNOPSIS gcloud alpha compute instant-snapshots create INSTANT_SNAPSHOT_NAME --source-disk=SOURCE_DISK [--labels=[KEY=VALUE,...]] + [--resource-manager-tags=[KEY=VALUE,...]] [--region=REGION | --zone=ZONE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -40,6 +41,10 @@ OPTIONAL FLAGS contain only hyphens (-), underscores (_), lowercase characters, and numbers. + --resource-manager-tags=[KEY=VALUE,...] + A comma-separated list of Resource Manager tags to apply to the + snapshot. + At most one of these can be specified: --region=REGION diff --git a/gcloud/alpha/compute/interconnects/create b/gcloud/alpha/compute/interconnects/create index 7537e6039..be6b89ec3 100644 --- a/gcloud/alpha/compute/interconnects/create +++ b/gcloud/alpha/compute/interconnects/create @@ -125,8 +125,10 @@ OPTIONAL FLAGS interconnect. --subzone=SUBZONE - Subzone in the LOCATION specified by the --location flag. SUBZONE must - be one of: + (DEPRECATED) Subzone in the LOCATION specified by the --location flag. + + The --subzone flag is deprecated and will be removed in a future + release. SUBZONE must be one of: a Subzone a. diff --git a/gcloud/alpha/compute/interconnects/update b/gcloud/alpha/compute/interconnects/update index 2bd2d05a0..a6a89a752 100644 --- a/gcloud/alpha/compute/interconnects/update +++ b/gcloud/alpha/compute/interconnects/update @@ -4,7 +4,8 @@ NAME SYNOPSIS gcloud alpha compute interconnects update NAME [--admin-enabled] - [--description=DESCRIPTION] [--noc-contact-email=NOC_CONTACT_EMAIL] + [--description=DESCRIPTION] [--location=LOCATION] + [--noc-contact-email=NOC_CONTACT_EMAIL] [--requested-link-count=REQUESTED_LINK_COUNT] [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] @@ -28,6 +29,11 @@ FLAGS --description=DESCRIPTION An optional, textual description for the interconnect. + --location=LOCATION + The location for the interconnect. The locations can be listed by using + the gcloud alpha compute interconnects locations list command to find + the appropriate location to use when creating an interconnect. + --noc-contact-email=NOC_CONTACT_EMAIL Email address to contact the customer NOC for operations and maintenance notifications regarding this interconnect. diff --git a/gcloud/alpha/compute/network-firewall-policies/rules/create b/gcloud/alpha/compute/network-firewall-policies/rules/create index e3e46e5b1..4db62905c 100644 --- a/gcloud/alpha/compute/network-firewall-policies/rules/create +++ b/gcloud/alpha/compute/network-firewall-policies/rules/create @@ -95,12 +95,12 @@ OPTIONAL FLAGS --dest-region-codes=[DEST_REGION_CODES,...] Destination Region Code to match for this rule. Can only be specified if DIRECTION is egress. Cannot be specified when the source network - type is NON_INTERNET. + context is NON_INTERNET. --dest-threat-intelligence=[DEST_THREAT_INTELLIGENCE_LISTS,...] Destination Threat Intelligence lists to match for this rule. Can only be specified if DIRECTION is egress. Cannot be specified when source - network type is NON_INTERNET. The available lists can be found here: + network context is NON_INTERNET. The available lists can be found here: https://cloud.google.com/vpc/docs/firewall-policies-rule-details#threat-intelligence-fw-policy. --direction=DIRECTION @@ -161,8 +161,8 @@ OPTIONAL FLAGS --src-region-codes=[SOURCE_REGION_CODES,...] Source Region Code to match for this rule. Can only be specified if - DIRECTION is ingress. Cannot be specified when the source network type - is NON_INTERNET, VPC_NETWORK or INTRA_VPC. + DIRECTION is ingress. Cannot be specified when the source network + context is NON_INTERNET, VPC_NETWORK or INTRA_VPC. --src-secure-tags=[SOURCE_SECURE_TAGS,...] A list of instance secure tags indicating the set of instances on the @@ -178,8 +178,8 @@ OPTIONAL FLAGS --src-threat-intelligence=[SOURCE_THREAT_INTELLIGENCE_LISTS,...] Source Threat Intelligence lists to match for this rule. Can only be specified if DIRECTION is ingress. Cannot be specified when the source - network type is NON_INTERNET, VPC_NETWORK or INTRA_VPC. The available - lists can be found here: + network context is NON_INTERNET, VPC_NETWORK or INTRA_VPC. The + available lists can be found here: https://cloud.google.com/vpc/docs/firewall-policies-rule-details#threat-intelligence-fw-policy. --target-forwarding-rules=[TARGET_FORWARDING_RULES,...] diff --git a/gcloud/alpha/compute/network-firewall-policies/rules/update b/gcloud/alpha/compute/network-firewall-policies/rules/update index ebbc47da7..5b36db4c3 100644 --- a/gcloud/alpha/compute/network-firewall-policies/rules/update +++ b/gcloud/alpha/compute/network-firewall-policies/rules/update @@ -85,12 +85,12 @@ OPTIONAL FLAGS --dest-region-codes=[DEST_REGION_CODES,...] Destination Region Code to match for this rule. Can only be specified if DIRECTION is egress. Cannot be specified when the source network - type is NON_INTERNET. + context is NON_INTERNET. --dest-threat-intelligence=[DEST_THREAT_INTELLIGENCE_LISTS,...] Destination Threat Intelligence lists to match for this rule. Can only be specified if DIRECTION is egress. Cannot be specified when source - network type is NON_INTERNET. The available lists can be found here: + network context is NON_INTERNET. The available lists can be found here: https://cloud.google.com/vpc/docs/firewall-policies-rule-details#threat-intelligence-fw-policy. --direction=DIRECTION @@ -158,8 +158,8 @@ OPTIONAL FLAGS --src-region-codes=[SOURCE_REGION_CODES,...] Source Region Code to match for this rule. Can only be specified if - DIRECTION is ingress. Cannot be specified when the source network type - is NON_INTERNET, VPC_NETWORK or INTRA_VPC. + DIRECTION is ingress. Cannot be specified when the source network + context is NON_INTERNET, VPC_NETWORK or INTRA_VPC. --src-secure-tags=[SOURCE_SECURE_TAGS,...] A list of instance secure tags indicating the set of instances on the @@ -175,8 +175,8 @@ OPTIONAL FLAGS --src-threat-intelligence=[SOURCE_THREAT_INTELLIGENCE_LISTS,...] Source Threat Intelligence lists to match for this rule. Can only be specified if DIRECTION is ingress. Cannot be specified when the source - network type is NON_INTERNET, VPC_NETWORK or INTRA_VPC. The available - lists can be found here: + network context is NON_INTERNET, VPC_NETWORK or INTRA_VPC. The + available lists can be found here: https://cloud.google.com/vpc/docs/firewall-policies-rule-details#threat-intelligence-fw-policy. --target-forwarding-rules=[TARGET_FORWARDING_RULES,...] diff --git a/gcloud/alpha/compute/rollouts/cancel b/gcloud/alpha/compute/rollouts/cancel index 3458b2fa0..30a3c501f 100644 --- a/gcloud/alpha/compute/rollouts/cancel +++ b/gcloud/alpha/compute/rollouts/cancel @@ -50,5 +50,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta compute rollouts cancel diff --git a/gcloud/alpha/compute/rollouts/delete b/gcloud/alpha/compute/rollouts/delete index 79f75194a..f443698be 100644 --- a/gcloud/alpha/compute/rollouts/delete +++ b/gcloud/alpha/compute/rollouts/delete @@ -44,5 +44,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta compute rollouts delete diff --git a/gcloud/alpha/compute/rollouts/describe b/gcloud/alpha/compute/rollouts/describe index b29ca791e..c1821d73c 100644 --- a/gcloud/alpha/compute/rollouts/describe +++ b/gcloud/alpha/compute/rollouts/describe @@ -48,5 +48,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta compute rollouts describe diff --git a/gcloud/alpha/compute/rollouts/help b/gcloud/alpha/compute/rollouts/help index 7c0178e12..a3dcb9c00 100644 --- a/gcloud/alpha/compute/rollouts/help +++ b/gcloud/alpha/compute/rollouts/help @@ -31,5 +31,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta compute rollouts diff --git a/gcloud/alpha/compute/rollouts/list b/gcloud/alpha/compute/rollouts/list index cdc9a5575..85d51ba73 100644 --- a/gcloud/alpha/compute/rollouts/list +++ b/gcloud/alpha/compute/rollouts/list @@ -62,5 +62,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta compute rollouts list diff --git a/gcloud/alpha/container/clusters/create b/gcloud/alpha/container/clusters/create index 8c3a1eb70..9bfd7c2c6 100644 --- a/gcloud/alpha/container/clusters/create +++ b/gcloud/alpha/container/clusters/create @@ -32,7 +32,7 @@ SYNOPSIS [--default-max-pods-per-node=DEFAULT_MAX_PODS_PER_NODE] [--disable-default-snat] [--disable-l4-lb-firewall-reconciliation] [--disable-pod-cidr-overprovision] [--disk-size=DISK_SIZE] - [--disk-type=DISK_TYPE] + [--disk-type=DISK_TYPE] [--enable-ambient] [--enable-authorized-networks-on-private-endpoint] [--enable-auto-ipam] [--enable-autorepair] [--no-enable-autoupgrade] [--enable-cilium-clusterwide-network-policy] [--enable-cloud-logging] @@ -528,6 +528,9 @@ FLAGS DISK_TYPE must be one of: pd-standard, pd-ssd, pd-balanced, hyperdisk-balanced, hyperdisk-extreme, hyperdisk-throughput. + --enable-ambient + Enable Ambient Networking on the cluster. + --enable-authorized-networks-on-private-endpoint Enable enforcement of --master-authorized-networks CIDR ranges for traffic reaching cluster's control plane via private IP. diff --git a/gcloud/alpha/container/clusters/create-auto b/gcloud/alpha/container/clusters/create-auto index 9b1828aaa..5d560c5dc 100644 --- a/gcloud/alpha/container/clusters/create-auto +++ b/gcloud/alpha/container/clusters/create-auto @@ -17,7 +17,7 @@ SYNOPSIS [--containerd-config-from-file=PATH_TO_FILE] [--create-subnetwork=[KEY=VALUE,...]] [--database-encryption-key=DATABASE_ENCRYPTION_KEY] - [--disable-l4-lb-firewall-reconciliation] + [--disable-l4-lb-firewall-reconciliation] [--enable-ambient] [--enable-authorized-networks-on-private-endpoint] [--enable-auto-ipam] [--enable-backup-restore] [--enable-cilium-clusterwide-network-policy] [--enable-confidential-nodes] [--enable-default-compute-class] @@ -274,6 +274,9 @@ FLAGS Disable reconciliation on the cluster for L4 Load Balancer VPC firewalls targeting ingress traffic. + --enable-ambient + Enable Ambient Networking on the cluster. + --enable-authorized-networks-on-private-endpoint Enable enforcement of --master-authorized-networks CIDR ranges for traffic reaching cluster's control plane via private IP. diff --git a/gcloud/alpha/container/clusters/update b/gcloud/alpha/container/clusters/update index 5c897cc89..60ce02817 100644 --- a/gcloud/alpha/container/clusters/update +++ b/gcloud/alpha/container/clusters/update @@ -16,7 +16,7 @@ SYNOPSIS | --containerd-config-from-file=PATH_TO_FILE | --database-encryption-key=DATABASE_ENCRYPTION_KEY | --disable-database-encryption | --disable-default-snat - | --disable-workload-identity + | --disable-workload-identity | --[no-]enable-ambient | --[no-]enable-autopilot-compatibility-auditing | --enable-autoscaling | --[no-]enable-cilium-clusterwide-network-policy @@ -356,6 +356,10 @@ REQUIRED FLAGS https://cloud.google.com/kubernetes-engine/docs/how-to/workload-identity + --[no-]enable-ambient + Enable Ambient Networking on the cluster. Use --enable-ambient to + enable and --no-enable-ambient to disable. + --[no-]enable-autopilot-compatibility-auditing Lets you run the gcloud container clusters check-autopilot-compatibility diff --git a/gcloud/alpha/looker/instances/create b/gcloud/alpha/looker/instances/create index 079e2f877..849031ef3 100644 --- a/gcloud/alpha/looker/instances/create +++ b/gcloud/alpha/looker/instances/create @@ -5,8 +5,8 @@ SYNOPSIS gcloud alpha looker instances create (INSTANCE : --region=REGION) --edition=EDITION --oauth-client-id=OAUTH_CLIENT_ID --oauth-client-secret=OAUTH_CLIENT_SECRET [--async] - [--class-type=CLASS_TYPE] [--fips-enabled] [--kms-key=KMS_KEY] - [--no-public-ip-enabled] + [--no-catalog-integration-enabled] [--class-type=CLASS_TYPE] + [--fips-enabled] [--kms-key=KMS_KEY] [--no-public-ip-enabled] [--consumer-network=CONSUMER_NETWORK --private-ip-enabled : --reserved-range=RESERVED_RANGE] [--deny-maintenance-period-end-date=DENY_MAINTENANCE_PERIOD_END_DATE @@ -144,6 +144,14 @@ OPTIONAL FLAGS Return immediately, without waiting for the operation in progress to complete. + Catalog Integration - Catalog Integration is a feature that allows Looker + to integrate with Universal Dataplex Catalog. + + --catalog-integration-enabled + This specifies whether Catalog Integration is enabled on the Looker + instance. Enabled by default, use --no-catalog-integration-enabled to + disable. + --class-type=CLASS_TYPE The class type of the Looker instance. CLASS_TYPE must be one of: p1, r1. diff --git a/gcloud/alpha/looker/instances/update b/gcloud/alpha/looker/instances/update index d67841666..023957737 100644 --- a/gcloud/alpha/looker/instances/update +++ b/gcloud/alpha/looker/instances/update @@ -4,7 +4,8 @@ NAME SYNOPSIS gcloud alpha looker instances update (INSTANCE : --region=REGION) [--allowed-email-domains=[ALLOWED_EMAIL_DOMAINS,...]] [--async] - [--class-type=CLASS_TYPE] [--custom-domain=CUSTOM_DOMAIN] + [--catalog-integration-enabled] [--class-type=CLASS_TYPE] + [--custom-domain=CUSTOM_DOMAIN] [--linked-lsp-project-number=LINKED_LSP_PROJECT_NUMBER] [--public-ip-enabled] [--add-developer-users=ADD_DEVELOPER_USERS @@ -90,6 +91,13 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + Catalog Integration - Catalog Integration is a feature that allows Looker + to integrate with Universal Dataplex Catalog. + + --catalog-integration-enabled + This specifies whether Catalog Integration is enabled on the Looker + instance. + --class-type=CLASS_TYPE The class type of the Looker instance. CLASS_TYPE must be one of: p1, r1. diff --git a/gcloud/alpha/netapp/volumes/create b/gcloud/alpha/netapp/volumes/create index e189e8106..1ac647706 100644 --- a/gcloud/alpha/netapp/volumes/create +++ b/gcloud/alpha/netapp/volumes/create @@ -112,8 +112,8 @@ REQUIRED FLAGS unit is specified, GiB is assumed. --protocols=PROTOCOL,[PROTOCOL,...] - Type of File System protocols for the Cloud NetApp Files Volume. Valid - component values are: NFSV3, NFSV4, SMB. + Type of File System protocols for the Cloud NetApp Volume. Valid + component values are: NFSV3, NFSV4, SMB, ISCSI. Storage pool resource - The Storage Pool to associate with Volume. This represents a Cloud resource. (NOTE) Some attributes are not given diff --git a/gcloud/alpha/netapp/volumes/update b/gcloud/alpha/netapp/volumes/update index 51c2b8a6e..acd57fb59 100644 --- a/gcloud/alpha/netapp/volumes/update +++ b/gcloud/alpha/netapp/volumes/update @@ -168,8 +168,8 @@ FLAGS squash-mode=SQUASH_MODE,anon-uid=ANON_UID --protocols=PROTOCOL,[PROTOCOL,...] - Type of File System protocols for the Cloud NetApp Files Volume. Valid - component values are: NFSV3, NFSV4, SMB. + Type of File System protocols for the Cloud NetApp Volume. Valid + component values are: NFSV3, NFSV4, SMB, ISCSI. --restricted-actions=RESTRICTED_ACTION,[...] Actions to be restricted for a volume. Valid restricted action options diff --git a/gcloud/alpha/network-security/firewall-endpoints/create b/gcloud/alpha/network-security/firewall-endpoints/create index 0c6db71e1..dad3aeb3b 100644 --- a/gcloud/alpha/network-security/firewall-endpoints/create +++ b/gcloud/alpha/network-security/firewall-endpoints/create @@ -5,17 +5,11 @@ NAME SYNOPSIS gcloud alpha network-security firewall-endpoints create (FIREWALL_ENDPOINT : --organization=ORGANIZATION --zone=ZONE) [--async] - [--billing-project=BILLING_PROJECT] [--block-partial-http] - [--content-cloud-region=CONTENT_CLOUD_REGION] - [--description=DESCRIPTION] [--enable-jumbo-frames] [--enable-wildfire] - [--enable-wildfire-analysis-logging] [--labels=[KEY=VALUE,...]] + [--billing-project=BILLING_PROJECT] [--description=DESCRIPTION] + [--enable-jumbo-frames] [--labels=[KEY=VALUE,...]] [--max-wait=MAX_WAIT; default="60m"] [--target-firewall-attachment=TARGET_FIREWALL_ATTACHMENT] - [--wildfire-analysis-action=WILDFIRE_ANALYSIS_ACTION] - [--wildfire-analysis-timeout=WILDFIRE_ANALYSIS_TIMEOUT] - [--wildfire-lookup-action=WILDFIRE_LOOKUP_ACTION] - [--wildfire-lookup-timeout=WILDFIRE_LOOKUP_TIMEOUT] - [--wildfire-region=WILDFIRE_REGION] [GCLOUD_WIDE_FLAG ...] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Create a firewall endpoint. Successful creation of an endpoint @@ -86,14 +80,6 @@ FLAGS endpoint uptime billing. Overrides the default billing/quota_project property value for this command invocation. - --block-partial-http - Whether the endpoint will block HTTP partial responses. Defaults to - false. - - --content-cloud-region=CONTENT_CLOUD_REGION - The content cloud region the endpoint will use. Defaults to the nearest - available region. - --description=DESCRIPTION Description of the endpoint @@ -101,14 +87,6 @@ FLAGS Enable jumbo frames for the firewall endpoint. To disable jumbo frames, use --no-enable-jumbo-frames. - --enable-wildfire - If set to true, enable WildFire functionality on the endpoint. Use - --enable-wildfire to enable. To disable, use --no-enable-wildfire. - - --enable-wildfire-analysis-logging - Whether to disable WildFire submission log generation for files that - timeout during WildFire inline cloud analysis. Defaults to false. - --labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to add. @@ -126,26 +104,6 @@ FLAGS --target-firewall-attachment=TARGET_FIREWALL_ATTACHMENT Target firewall attachment where third party endpoint forwards traffic. - --wildfire-analysis-action=WILDFIRE_ANALYSIS_ACTION - The action to take on WildFire inline cloud analysis timeout. - WILDFIRE_ANALYSIS_ACTION must be one of: ALLOW, DENY. - - --wildfire-analysis-timeout=WILDFIRE_ANALYSIS_TIMEOUT - The timeout (in milliseconds) on a file being held while WildFire - inline cloud analysis is performed. - - --wildfire-lookup-action=WILDFIRE_LOOKUP_ACTION - The action to take on WildFire real time signature lookup timeout. - WILDFIRE_LOOKUP_ACTION must be one of: ALLOW, DENY. - - --wildfire-lookup-timeout=WILDFIRE_LOOKUP_TIMEOUT - The timeout (in milliseconds) to hold a file while the WildFire real - time signature cloud performs a signature lookup. - - --wildfire-region=WILDFIRE_REGION - The region WildFire submissions from this endpoint will be sent to for - analysis by WildFire. Defaults to the nearest available region. - GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/network-security/firewall-endpoints/help b/gcloud/alpha/network-security/firewall-endpoints/help index 638ddd24a..20125b3d5 100644 --- a/gcloud/alpha/network-security/firewall-endpoints/help +++ b/gcloud/alpha/network-security/firewall-endpoints/help @@ -3,7 +3,7 @@ NAME Firewall Plus endpoints SYNOPSIS - gcloud alpha network-security firewall-endpoints COMMAND + gcloud alpha network-security firewall-endpoints GROUP | COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION diff --git a/gcloud/alpha/network-services/multicast-domains/create b/gcloud/alpha/network-services/multicast-domains/create index 91710571b..0080606b8 100644 --- a/gcloud/alpha/network-services/multicast-domains/create +++ b/gcloud/alpha/network-services/multicast-domains/create @@ -9,7 +9,7 @@ SYNOPSIS default="CONNECTION_TYPE_UNSPECIFIED" --ncc-hub=NCC_HUB) [--async] [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] [--multicast-domain-group=MULTICAST_DOMAIN_GROUP] - [--ull-multicast-domain=ULL_MULTICAST_DOMAIN] [GCLOUD_WIDE_FLAG ...] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Create a multicast domain in the specified location of the current @@ -98,10 +98,6 @@ OPTIONAL FLAGS --multicast-domain-group=MULTICAST_DOMAIN_GROUP The URI of the multicast domain group to be used. - --ull-multicast-domain=ULL_MULTICAST_DOMAIN - The name of the ULL multicast feed to be used. This is for ULL - multicast service only. - GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/resource-manager/help b/gcloud/alpha/resource-manager/help index 550d925b0..2cedb5790 100644 --- a/gcloud/alpha/resource-manager/help +++ b/gcloud/alpha/resource-manager/help @@ -31,6 +31,9 @@ GROUPS org-policies (ALPHA) Manage Org Policies. + semantics-catalog + (ALPHA) View semantic catalog entries. + tags (ALPHA) Create and manipulate tag keys, values and bindings. diff --git a/gcloud/alpha/resource-manager/semantics-catalog/help b/gcloud/alpha/resource-manager/semantics-catalog/help new file mode 100644 index 000000000..2e91b24de --- /dev/null +++ b/gcloud/alpha/resource-manager/semantics-catalog/help @@ -0,0 +1,28 @@ +NAME + gcloud alpha resource-manager semantics-catalog - view semantic catalog + entries + +SYNOPSIS + gcloud alpha resource-manager semantics-catalog COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) View semantic catalog entries. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + list + (ALPHA) Lists all Semantics Catalog entries. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/resource-manager/semantics-catalog/list b/gcloud/alpha/resource-manager/semantics-catalog/list new file mode 100644 index 000000000..4338afb16 --- /dev/null +++ b/gcloud/alpha/resource-manager/semantics-catalog/list @@ -0,0 +1,63 @@ +NAME + gcloud alpha resource-manager semantics-catalog list - lists all Semantics + Catalog entries + +SYNOPSIS + gcloud alpha resource-manager semantics-catalog list [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Lists all Semantics Catalog entries. + +EXAMPLES + To list all semantics catalog entries, run: + + $ gcloud alpha resource-manager semantics-catalog list + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/run/compose/up b/gcloud/alpha/run/compose/up index 732ea62c8..049153b8b 100644 --- a/gcloud/alpha/run/compose/up +++ b/gcloud/alpha/run/compose/up @@ -4,7 +4,8 @@ NAME SYNOPSIS gcloud alpha run compose up [COMPOSE_FILE] [--[no-]allow-unauthenticated] - [--no-build] [--dry-run] [--region=REGION] [GCLOUD_WIDE_FLAG ...] + [--dry-run] [--region=REGION] [--build | --no-build] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Deploy to Cloud Run from compose specification. @@ -28,9 +29,6 @@ FLAGS may take a few moments to take effect. Use --allow-unauthenticated to enable and --no-allow-unauthenticated to disable. - --no-build - Skip building from source if applicable. - --dry-run If set to true, only validates the configuration. The configuration will not be applied. @@ -39,6 +37,14 @@ FLAGS Region in which the resource can be found. Alternatively, set the property [run/region]. + At most one of these can be specified: + + --build + Force build of images. + + --no-build + Skip building from source if applicable. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/run/instances/create b/gcloud/alpha/run/instances/create index 66b3a73c6..5be30cbf7 100644 --- a/gcloud/alpha/run/instances/create +++ b/gcloud/alpha/run/instances/create @@ -8,7 +8,7 @@ SYNOPSIS [--[no-]gpu-zonal-redundancy] [--ingress=INGRESS; default="all"] [--[no-]invoker-iam-check] [--key=KEY] [--labels=[KEY=VALUE,...]] [--region=REGION] [--service-account=SERVICE_ACCOUNT] - [--set-cloudsql-instances=[CLOUDSQL-INSTANCES,...]] + [--set-cloudsql-instances=[CLOUDSQL-INSTANCES,...]] [--timeout=TIMEOUT] [--vpc-connector=VPC_CONNECTOR] [--vpc-egress=VPC_EGRESS] [--add-volume=[KEY=VALUE,...] --clear-volumes --remove-volume=[VOLUME,...]] @@ -136,6 +136,12 @@ FLAGS project and region as your Cloud Run resource; otherwise specify :: for the instance. + --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. + --vpc-connector=VPC_CONNECTOR Set a VPC connector for this resource. diff --git a/gcloud/alpha/storage/buckets/relocate b/gcloud/alpha/storage/buckets/relocate index d102c312b..d6139595b 100644 --- a/gcloud/alpha/storage/buckets/relocate +++ b/gcloud/alpha/storage/buckets/relocate @@ -5,6 +5,7 @@ NAME SYNOPSIS gcloud alpha storage buckets relocate ([URL --location=LOCATION : --placement=[REGION,...] + --destination-kms-key-name=DESTINATION_KMS_KEY_NAME --dry-run] [--operation=OPERATION --finalize : --ttl=TTL]) [GCLOUD_WIDE_FLAG ...] @@ -63,6 +64,14 @@ POSITIONAL ARGUMENTS location pairs (such as mixed-continent, or with unsupported regions) will return an error. + --destination-kms-key-name=DESTINATION_KMS_KEY_NAME + This is only required when relocating a bucket that uses + Customer-Managed Encryption Keys (CMEK). The full resource name of + the Cloud KMS key to use for encrypting objects in the destination + bucket. This key will be set as the default bucket encryption key. + The key must exist in the destination location. Format: + projects/PROJECT/locations/LOCATION/keyRings/RING/cryptoKeys/KEY + --dry-run Prints the operations that the relocate command would perform without actually performing relocation. This is helpful to identify any diff --git a/gcloud/backup-dr/backup-plan-associations/create b/gcloud/backup-dr/backup-plan-associations/create index 40dee5e7a..c0dceca94 100644 --- a/gcloud/backup-dr/backup-plan-associations/create +++ b/gcloud/backup-dr/backup-plan-associations/create @@ -92,8 +92,11 @@ REQUIRED FLAGS projects/sample-project/zones/us-central1-a/instances/sample-instance --resource-type=RESOURCE_TYPE - Type of resource to which the backup plan should be applied. E.g., - compute..com/Instance + Type of resource to which the backup plan should be applied. + + For example: + ◆ compute./Instance for Compute Engine instances. + ◆ file./Instance for Filestore instances. OPTIONAL FLAGS --async diff --git a/gcloud/backup-dr/backup-plan-associations/fetch-for-resource-type b/gcloud/backup-dr/backup-plan-associations/fetch-for-resource-type index 7608e7592..ed336bfc9 100644 --- a/gcloud/backup-dr/backup-plan-associations/fetch-for-resource-type +++ b/gcloud/backup-dr/backup-plan-associations/fetch-for-resource-type @@ -25,6 +25,10 @@ POSITIONAL ARGUMENTS RESOURCE_TYPE Resource type for which backup plan associations should be fetched. + For example: + ◆ compute./Instance for Compute Engine instances. + ◆ file./Instance for Filestore instances. + REQUIRED FLAGS --location=LOCATION Location for which backup plan associations should be fetched. diff --git a/gcloud/backup-dr/backup-plans/create b/gcloud/backup-dr/backup-plans/create index c871d3e15..a398e3c2f 100644 --- a/gcloud/backup-dr/backup-plans/create +++ b/gcloud/backup-dr/backup-plans/create @@ -14,19 +14,32 @@ DESCRIPTION locations where Backup and DR is available. EXAMPLES - To create a new backup plan sample-backup-plan in project sample-project, - at location us-central1, with resource-type - compute..com/Instance and backup-vault backup-vault with 2 + To create a new backup plan sample-backup-plan for Compute Engine instances + in project sample-project, at location us-central1, with resource-type + compute./Instance and backup-vault backup-vault with 2 backup-rules: run: $ gcloud backup-dr backup-plans create sample-backup-plan \ --project=sample-project --location=us-central1 \ - --resource-type 'compute..com/Instance' \ + --resource-type 'compute./Instance' \ --backup-vault --backup-rule \ --backup-rule + To create a new backup plan sample-filestore-backup-plan for Filestore + instances in project sample-project, at location us-central1, with + resource-type file./Instance and backup-vault backup-vault + with 1 backup-rule: + + run: + + $ gcloud backup-dr backup-plans create \ + sample-filestore-backup-plan --project=sample-project \ + --location=us-central1 \ + --resource-type 'file./Instance' \ + --backup-vault --backup-rule + Backup Rule Examples: 1. Hourly backup rule with hourly backup frequency of 6 hours and store it @@ -132,8 +145,11 @@ REQUIRED FLAGS ▸ provide the argument --backup-vault on the command line. --resource-type=RESOURCE_TYPE - Type of resource to which the backup plan should be applied. E.g., - compute..com/Instance + Type of resource to which the backup plan should be applied. + + For example: + ◆ compute./Instance for Compute Engine instances. + ◆ file./Instance for Filestore instances. OPTIONAL FLAGS --async diff --git a/gcloud/backup-dr/service-config/init b/gcloud/backup-dr/service-config/init index 4986e385b..0a82697ea 100644 --- a/gcloud/backup-dr/service-config/init +++ b/gcloud/backup-dr/service-config/init @@ -4,7 +4,8 @@ NAME SYNOPSIS gcloud backup-dr service-config init --location=LOCATION - --resource-type=RESOURCE_TYPE [--no-async] [GCLOUD_WIDE_FLAG ...] + --resource-type=RESOURCE_TYPE [--no-async] + [--cloudsql-edition=CLOUDSQL_EDITION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION Initialize a Backup and DR Service configuration. @@ -44,6 +45,12 @@ OPTIONAL FLAGS --no-async Wait for the operation in progress to complete. + --cloudsql-edition=CLOUDSQL_EDITION + Cloud SQL Edition: (Required only for Cloud SQL instances, ignored + otherwise). The edition of the Cloud SQL instance. Possible values: + "ENTERPRISE" - Enterprise edition. "ENTERPRISE_PLUS" - Enterprise Plus + edition. + 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/cluster-director/clusters/create b/gcloud/beta/cluster-director/clusters/create new file mode 100644 index 000000000..d9d849d13 --- /dev/null +++ b/gcloud/beta/cluster-director/clusters/create @@ -0,0 +1,1036 @@ +NAME + gcloud beta cluster-director clusters create - creates a Cluster Director + resource + +SYNOPSIS + gcloud beta cluster-director clusters create + (CLUSTER : --location=LOCATION) + (--config=[computeResources=COMPUTERESOURCES],[description=DESCRIPTION], + [labels=LABELS],[name=NAME],[networkResources=NETWORKRESOURCES], + [orchestrator=ORCHESTRATOR],[storageResources=STORAGERESOURCES] + | [--slurm-login-node=[bootDisk=BOOTDISK],[count=COUNT], + [enableOSLogin=ENABLEOSLOGIN],[enablePublicIPs=ENABLEPUBLICIPS], + [labels=LABELS], + [machineType=MACHINETYPE],[startupScript=STARTUPSCRIPT],[zone=ZONE] + (--create-network=[description=DESCRIPTION],[name=NAME] + | [--network=NETWORK --subnet=SUBNET + : --network-project=NETWORK_PROJECT]) : --buckets=[BUCKETS,...] + --create-buckets=[enableAutoclass=ENABLEAUTOCLASS], + [enableHNS=ENABLEHNS],[name=NAME],[storageClass=STORAGECLASS] + --create-filestores=[capacityGb=CAPACITYGB],[description=DESCRIPTION], + [fileshare=FILESHARE],[name=NAME],[protocol=PROTOCOL],[tier=TIER] + --create-lustres=[capacityGb=CAPACITYGB],[description=DESCRIPTION], + [filesystem=FILESYSTEM], + [name=NAME],[perUnitStorageThroughput=PERUNITSTORAGETHROUGHPUT] + --description=DESCRIPTION --filestores=[FILESTORES,...] + --flex-start-instances=[id=ID], + [machineType=MACHINETYPE],[maxDuration=MAXDURATION],[zone=ZONE] + --labels=[LABELS,...] --lustres=[LUSTRES,...] + --on-demand-instances=[id=ID],[machineType=MACHINETYPE],[zone=ZONE] + --reserved-instances=[id=ID],[reservation=RESERVATION] + --slurm-default-partition=SLURM_DEFAULT_PARTITION + --slurm-epilog-scripts=[SLURM_EPILOG_SCRIPTS,...] + --slurm-node-sets=[computeId=COMPUTEID], + [computeInstance=COMPUTEINSTANCE],[id=ID], + [maxDynamicNodeCount=MAXDYNAMICNODECOUNT], + [staticNodeCount=STATICNODECOUNT] + --slurm-partitions=[id=ID],[nodesetIds=NODESETIDS] + --slurm-prolog-scripts=[SLURM_PROLOG_SCRIPTS,...] + --spot-instances=[id=ID],[machineType=MACHINETYPE], + [terminationAction=TERMINATIONACTION],[zone=ZONE]]) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) gcloud beta cluster-director clusters create facilitates the + creation of a cluster resource. + + There are following ways to create a cluster: + ▪ [Preferred] Use granular flags to define cluster specs. + ▪ Use --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 with granular flags, + run the following example: + + $ gcloud beta cluster-director clusters create my-cluster \ + --location us-central1 --description "My cluster description" \ + --labels env=prod,client=gcloud-cli \ + --create-network name=network0 \ + --create-filestores \ + name=locations/us-central1-a/instances/filestore0,tier=ZONAL,\ + capacityGb={filestoreSize},fileshare={fileshare} \ + --filestores locations/us-central1-a/instances/filestore1 \ + --create-buckets name=bucket0 --buckets bucket1 \ + --create-lustres \ + name=locations/us-central1-a/instances/lustre0,\ + capacityGb={lustreSize},filesystem={filesystem} \ + --lustres locations/us-central1-a/instances/lustre1 \ + --reserved-instances \ + id=compute0,reservation=zones/us-central1-a/reservations/\ + {reservation} \ + --slurm-login-node \ + machineType={machineType},zone=us-central1-a \ + --slurm-node-sets id=nodeset0,computeId=compute0 \ + --slurm-partitions id=partition0,nodesetIds=[nodeset0] \ + --slurm-default-partition partition0 --format json + + To create a cluster my-cluster in location us-central1 with config in JSON + string format run the following example: + + $ gcloud beta cluster-director clusters create my-cluster \ + --location=us-central1 --config='{"key": "value"}' + + Or create a JSON file my-cluster-config.json with the cluster specs and run + the following file example: + + $ gcloud beta cluster-director clusters create my-cluster \ + --location=us-central1 --config=my-cluster-config.json + +POSITIONAL ARGUMENTS + 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 + set in other ways. + + To set the project attribute: + ◆ provide the argument cluster on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + CLUSTER + ID of the cluster or fully qualified identifier for the cluster. + + To set the cluster attribute: + ▸ provide the argument cluster on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the cluster resource. + + To set the location attribute: + ▸ provide the argument cluster on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + Cluster configuration for provisioning. + + Exactly one of these must be specified: + + --config=[computeResources=COMPUTERESOURCES],[description=DESCRIPTION],[labels=LABELS],[name=NAME],[networkResources=NETWORKRESOURCES],[orchestrator=ORCHESTRATOR],[storageResources=STORAGERESOURCES] + Configuration of the cluster specs in the form of a JSON object. Sets + config value. + + computeResources + Sets computeResources value. + + KEY + Sets KEY value. + + VALUE + Sets VALUE value. + + config + Sets config value. + + newDwsFlexInstances + Sets newDwsFlexInstances value. + + machineType + Sets machineType value. + + maxDuration + Sets maxDuration value. + + zone + Sets zone value. + + newFlexStartInstances + Sets newFlexStartInstances value. + + machineType + Sets machineType value. + + maxDuration + Sets maxDuration value. + + zone + Sets zone value. + + newOnDemandInstances + Sets newOnDemandInstances value. + + machineType + Sets machineType value. + + zone + Sets zone value. + + newReservedInstances + Sets newReservedInstances value. + + reservation + Sets reservation value. + + newSpotInstances + Sets newSpotInstances value. + + machineType + Sets machineType 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. + + networkResources + Sets networkResources value. + + KEY + Sets KEY value. + + VALUE + Sets VALUE value. + + config + Sets config value. + + existingComputeNetwork + Sets existingComputeNetwork value. + + network + Sets network value. + + subnetwork + Sets subnetwork value. + + existingNetwork + Sets existingNetwork value. + + network + Sets network value. + + subnetwork + Sets subnetwork value. + + newComputeNetwork + Sets newComputeNetwork value. + + description + Sets description value. + + network + Sets network value. + + newNetwork + Sets newNetwork value. + + description + Sets description value. + + network + Sets network value. + + orchestrator + Sets orchestrator value. + + slurm + Sets slurm value. + + defaultPartition + Sets defaultPartition value. + + epilogBashScripts + Sets epilogBashScripts value. + + loginNodes + Sets loginNodes value. + + bootDisk + Sets bootDisk value. + + sizeGb + Required, sets sizeGb value. + + type + Required, sets type 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. + + startupScript + Sets startupScript value. + + zone + Required, sets zone value. + + nodeSets + Sets nodeSets value. + + computeId + Sets computeId value. + + computeInstance + Sets computeInstance value. + + bootDisk + Sets bootDisk value. + + sizeGb + Required, sets sizeGb value. + + type + Required, sets type value. + + labels + Sets labels value. + + KEY + Sets KEY value. + + VALUE + Sets VALUE value. + + startupScript + Sets startupScript value. + + id + Required, sets id value. + + maxDynamicNodeCount + Sets maxDynamicNodeCount value. + + staticNodeCount + Sets staticNodeCount value. + + partitions + Sets partitions value. + + id + Required, sets id value. + + nodesetIds + Required, sets nodesetIds value. + + prologBashScripts + Sets prologBashScripts value. + + storageResources + Sets storageResources value. + + KEY + Sets KEY value. + + VALUE + Sets VALUE 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. + + 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. + + perUnitStorageThroughput + Sets perUnitStorageThroughput value. + + Shorthand Example: + + --config=computeResources={string={config={newDwsFlexInstances={machineType=string,maxDuration=string,zone=string},newFlexStartInstances={machineType=string,maxDuration=string,zone=string},newOnDemandInstances={machineType=string,zone=string},newReservedInstances={reservation=string},newSpotInstances={machineType=string,terminationAction=string,zone=string}}}},description=string,labels={string=string},name=string,networkResources={string={config={existingComputeNetwork={network=string,subnetwork=string},existingNetwork={network=string,subnetwork=string},newComputeNetwork={description=string,network=string},newNetwork={description=string,network=string}}}},orchestrator={slurm={defaultPartition=string,epilogBashScripts,loginNodes={bootDisk={sizeGb=int,type=string},count=int,enableOSLogin=boolean,enablePublicIPs=boolean,labels={string=string},machineType=string,startupScript=string,zone=string},nodeSets=[{computeId=string,computeInstance={bootDisk={sizeGb=int,type=string},labels={string=string},startupScript=string},id=string,maxDynamicNodeCount=int,staticNodeCount=int}],partitions=[{id=string,nodesetIds=[string]}],prologBashScripts}},storageResources={string={config={existingBucket={bucket=string},existingFilestore={filestore=string},existingLustre={lustre=string},newBucket={autoclass={enabled=boolean},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,perUnitStorageThroughput=int}}}} + + JSON Example: + + --config='{"computeResources": {"string": {"config": {"newDwsFlexInstances": {"machineType": "string", "maxDuration": "string", "zone": "string"}, "newFlexStartInstances": {"machineType": "string", "maxDuration": "string", "zone": "string"}, "newOnDemandInstances": {"machineType": "string", "zone": "string"}, "newReservedInstances": {"reservation": "string"}, "newSpotInstances": {"machineType": "string", "terminationAction": "string", "zone": "string"}}}}, "description": "string", "labels": {"string": "string"}, "name": "string", "networkResources": {"string": {"config": {"existingComputeNetwork": {"network": "string", "subnetwork": "string"}, "existingNetwork": {"network": "string", "subnetwork": "string"}, "newComputeNetwork": {"description": "string", "network": "string"}, "newNetwork": {"description": "string", "network": "string"}}}}, "orchestrator": {"slurm": {"defaultPartition": "string", "epilogBashScripts", "loginNodes": {"bootDisk": {"sizeGb": int, "type": "string"}, "count": int, "enableOSLogin": boolean, "enablePublicIPs": boolean, "labels": {"string": "string"}, "machineType": "string", "startupScript": "string", "zone": "string"}, "nodeSets": [{"computeId": "string", "computeInstance": {"bootDisk": {"sizeGb": int, "type": "string"}, "labels": {"string": "string"}, "startupScript": "string"}, "id": "string", "maxDynamicNodeCount": int, "staticNodeCount": int}], "partitions": [{"id": "string", "nodesetIds": ["string"]}], "prologBashScripts"}}, "storageResources": {"string": {"config": {"existingBucket": {"bucket": "string"}, "existingFilestore": {"filestore": "string"}, "existingLustre": {"lustre": "string"}, "newBucket": {"autoclass": {"enabled": boolean}, "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", "perUnitStorageThroughput": int}}}}}' + + File Example: + + --config=path_to_file.(yaml|json) + + Or at least one of these can be specified: + + Flag Configurations to define cluster spec. + + --slurm-login-node=[bootDisk=BOOTDISK],[count=COUNT],[enableOSLogin=ENABLEOSLOGIN],[enablePublicIPs=ENABLEPUBLICIPS],[labels=LABELS],[machineType=MACHINETYPE],[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,startupScript="echo + hello",bootDisk={type=pd-standard,sizeGb=100} + + If bootDisk is specified, sizeGb must be greater than 50. + + Defaults: + ▫ count: 1 + ▫ enableOSLogin: true + ▫ enablePublicIPs: true + ▫ bootDisk.sizeGb: 100 + + Note: + ▫ startupScript: + ◇ Either str or file_path + ◇ For file_path, only bash file format (.sh or .bash) is + supported. + ◇ For file_path, only absolute path is supported. + + Required, sets slurm_login_node value. + + bootDisk + Sets bootDisk value. + + sizeGb + Required, sets sizeGb value. + + type + Required, sets type 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. + + startupScript + Sets startupScript value. + + zone + Required, sets zone value. + + Shorthand Example: + + --slurm-login-node=bootDisk={sizeGb=int,type=string},count=int,enableOSLogin=boolean,enablePublicIPs=boolean,labels={string=string},machineType=string,startupScript=string,zone=string + + JSON Example: + + --slurm-login-node='{"bootDisk": {"sizeGb": int, "type": "string"}, "count": int, "enableOSLogin": boolean, "enablePublicIPs": boolean, "labels": {"string": "string"}, "machineType": "string", "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. + + --buckets=[BUCKETS,...] + Reference of existing Google Cloud Storage bucket. + + For e.g. --buckets {existing-bucket-name eg. my-bucket} + + --create-buckets=[enableAutoclass=ENABLEAUTOCLASS],[enableHNS=ENABLEHNS],[name=NAME],[storageClass=STORAGECLASS] + Parameters to create a Google Cloud Storage bucket. + + For e.g. --create-buckets + name={bucket-path},storageClass=STANDARD,enableHNS=true + + Supported storageClass values: + ▫ STANDARD + ▫ NEARLINE + ▫ COLDLINE + ▫ ARCHIVE + + Defaults: + ▫ storageClass: STANDARD + + Note: + ▫ Either storageClass or enableAutoclass can be set. + ▫ HNS: Hierarchical namespace. + + Sets create_buckets value. + + enableAutoclass + Sets enableAutoclass value. + + enableHNS + Sets enableHNS value. + + name + Required, sets name value. + + storageClass + Sets storageClass value. + + Shorthand Example: + + --create-buckets=enableAutoclass=boolean,enableHNS=boolean,name=string,storageClass=string --create-buckets=enableAutoclass=boolean,enableHNS=boolean,name=string,storageClass=string + + JSON Example: + + --create-buckets='[{"enableAutoclass": boolean, "enableHNS": boolean, "name": "string", "storageClass": "string"}]' + + File Example: + + --create-buckets=path_to_file.(yaml|json) + + --create-filestores=[capacityGb=CAPACITYGB],[description=DESCRIPTION],[fileshare=FILESHARE],[name=NAME],[protocol=PROTOCOL],[tier=TIER] + Parameters to create a filestore instance. + + For e.g. --create-filestores + name=locations/{location}/instances/{filestore},tier=REGIONAL,capacityGb={filestoreSize},fileshare={fileshare} + + capacityGb: Size of the filestore in GB. Must be between 1024 and + 102400, and must meet scalability requirements described at + https://cloud.google.com/filestore/docs/service-tiers. + + fileshare: The directory on a Filestore instance where all shared + files are stored. Must match the regex [a-z]([-a-z0-9]*[a-z0-9])?, + be 1-63 characters in length, and comply with RFC1035. Supported + tier values: + ▫ ZONAL + ▫ REGIONAL + + Supported protocol values: + ▫ NFSV3 + ▫ NFSV41 + ▫ If not specified, defaults to NFSV3 + + Defaults: + ▫ protocol: NFSV3. + + Sets create_filestores value. + + capacityGb + Required, sets capacityGb value. + + description + Sets description value. + + fileshare + Required, sets fileshare value. + + name + Required, sets name value. + + protocol + Sets protocol value. + + tier + Required, sets tier value. + + Shorthand Example: + + --create-filestores=capacityGb=int,description=string,fileshare=string,name=string,protocol=string,tier=string --create-filestores=capacityGb=int,description=string,fileshare=string,name=string,protocol=string,tier=string + + JSON Example: + + --create-filestores='[{"capacityGb": int, "description": "string", "fileshare": "string", "name": "string", "protocol": "string", "tier": "string"}]' + + File Example: + + --create-filestores=path_to_file.(yaml|json) + + --create-lustres=[capacityGb=CAPACITYGB],[description=DESCRIPTION],[filesystem=FILESYSTEM],[name=NAME],[perUnitStorageThroughput=PERUNITSTORAGETHROUGHPUT] + Parameters to create a Lustre instance. + + For e.g. --create-lustres + name=locations/{location}/instances/{lustre},capacityGb={lustreSize},filesystem={filesystem},perUnitStorageThroughput=1000 + + Values for perUnitStorageThroughput: 125, 250, 500, 1000. + + Sets create_lustres value. + + capacityGb + Required, sets capacityGb value. + + description + Sets description value. + + filesystem + Required, sets filesystem value. + + name + Required, sets name value. + + perUnitStorageThroughput + Sets perUnitStorageThroughput value. + + Shorthand Example: + + --create-lustres=capacityGb=int,description=string,filesystem=string,name=string,perUnitStorageThroughput=int --create-lustres=capacityGb=int,description=string,filesystem=string,name=string,perUnitStorageThroughput=int + + JSON Example: + + --create-lustres='[{"capacityGb": int, "description": "string", "filesystem": "string", "name": "string", "perUnitStorageThroughput": int}]' + + File Example: + + --create-lustres=path_to_file.(yaml|json) + + --description=DESCRIPTION + Description of the cluster. + + For e.g. --description (BETA) Creates a Cluster Director resource. + + --filestores=[FILESTORES,...] + Reference of existing filestore instance. + + For e.g. --filestores locations/{location}/instances/{filestore} + + --flex-start-instances=[id=ID],[machineType=MACHINETYPE],[maxDuration=MAXDURATION],[zone=ZONE] + Parameters to define cluster Flex Start instances. + + For e.g. --flex-start-instances + id={computeId},zone={zone},machineType={machineType},maxDuration=10000s. + + Sets flex_start_instances value. + + id + Required, sets id value. + + machineType + Required, sets machineType value. + + maxDuration + Required, sets maxDuration value. + + zone + Required, sets zone value. + + Shorthand Example: + + --flex-start-instances=id=string,machineType=string,maxDuration=string,zone=string --flex-start-instances=id=string,machineType=string,maxDuration=string,zone=string + + JSON Example: + + --flex-start-instances='[{"id": "string", "machineType": "string", "maxDuration": "string", "zone": "string"}]' + + File Example: + + --flex-start-instances=path_to_file.(yaml|json) + + --labels=[LABELS,...] + Cluster labels as key value pairs. + + For e.g. --labels key1=value1,key2=value2. + + Sets labels value. + + KEY + Sets KEY value. + + VALUE + Sets VALUE value. + + Shorthand Example: + + --labels={string=string} + + JSON Example: + + --labels='{"string": "string"}' + + File Example: + + --labels=path_to_file.(yaml|json) + + --lustres=[LUSTRES,...] + Reference of existing Lustre instance. + + For e.g. --lustres locations/{location}/instances/{lustre} + + --on-demand-instances=[id=ID],[machineType=MACHINETYPE],[zone=ZONE] + Parameters to define cluster on demand instances. + + For e.g. --on-demand-instances + id={computeId},zone={zone},machineType={machineType}. + + Sets on_demand_instances value. + + id + Required, sets id value. + + machineType + Required, sets machineType value. + + zone + Required, sets zone value. + + Shorthand Example: + + --on-demand-instances=id=string,machineType=string,zone=string --on-demand-instances=id=string,machineType=string,zone=string + + JSON Example: + + --on-demand-instances='[{"id": "string", "machineType": "string", "zone": "string"}]' + + File Example: + + --on-demand-instances=path_to_file.(yaml|json) + + --reserved-instances=[id=ID],[reservation=RESERVATION] + Parameters to define cluster reserved instances. + + For e.g. --reserved-instances + id={computeId},reservation=zones/{zone}/reservations/{reservation}. + + Sets reserved_instances value. + + id + Required, sets id value. + + reservation + Sets reservation value. + + Shorthand Example: + + --reserved-instances=id=string,reservation=string --reserved-instances=id=string,reservation=string + + JSON Example: + + --reserved-instances='[{"id": "string", "reservation": "string"}]' + + File Example: + + --reserved-instances=path_to_file.(yaml|json) + + --slurm-default-partition=SLURM_DEFAULT_PARTITION + Parameters to define slurm cluster default partition. + + For e.g. --slurm-default-partition {partitionId} + + --slurm-epilog-scripts=[SLURM_EPILOG_SCRIPTS,...] + Slurm epilog bash scripts. + + For e.g. --slurm-epilog-scripts script1.sh,script2.sh + + --slurm-node-sets=[computeId=COMPUTEID],[computeInstance=COMPUTEINSTANCE],[id=ID],[maxDynamicNodeCount=MAXDYNAMICNODECOUNT],[staticNodeCount=STATICNODECOUNT] + Parameters to define slurm cluster nodeset config. + + For e.g. --slurm-node-sets + id={nodesetId},computeId={computeId},staticNodeCount={staticNodeCount},maxDynamicNodeCount={maxDynamicNodeCount},computeInstance=[startupScript="echo + hello",labels="key1=value1,key2=value2"] + + Defaults: + ▫ staticNodeCount: 1 + + Note: + ▫ startupScript: + ◇ Either str or file_path + ◇ For file_path, only bash file format (.sh or .bash) is + supported. + ◇ For file_path, only absolute path is supported. + + Sets slurm_node_sets value. + + computeId + Sets computeId value. + + computeInstance + Sets computeInstance value. + + bootDisk + Sets bootDisk value. + + sizeGb + Required, sets sizeGb value. + + type + Required, sets type value. + + labels + Sets labels value. + + KEY + Sets KEY value. + + VALUE + Sets VALUE value. + + startupScript + Sets startupScript value. + + id + Required, sets id value. + + maxDynamicNodeCount + Sets maxDynamicNodeCount value. + + staticNodeCount + Sets staticNodeCount value. + + Shorthand Example: + + --slurm-node-sets=computeId=string,computeInstance={bootDisk={sizeGb=int,type=string},labels={string=string},startupScript=string},id=string,maxDynamicNodeCount=int,staticNodeCount=int --slurm-node-sets=computeId=string,computeInstance={bootDisk={sizeGb=int,type=string},labels={string=string},startupScript=string},id=string,maxDynamicNodeCount=int,staticNodeCount=int + + JSON Example: + + --slurm-node-sets='[{"computeId": "string", "computeInstance": {"bootDisk": {"sizeGb": int, "type": "string"}, "labels": {"string": "string"}, "startupScript": "string"}, "id": "string", "maxDynamicNodeCount": int, "staticNodeCount": int}]' + + File Example: + + --slurm-node-sets=path_to_file.(yaml|json) + + --slurm-partitions=[id=ID],[nodesetIds=NODESETIDS] + Parameters to define slurm cluster partitions. + + For e.g. --slurm-partitions id=p1,nodesetIds=[ns1,ns2]. + + Sets slurm_partitions value. + + id + Required, sets id value. + + nodesetIds + Required, sets nodesetIds value. + + Shorthand Example: + + --slurm-partitions=id=string,nodesetIds=[string] --slurm-partitions=id=string,nodesetIds=[string] + + JSON Example: + + --slurm-partitions='[{"id": "string", "nodesetIds": ["string"]}]' + + File Example: + + --slurm-partitions=path_to_file.(yaml|json) + + --slurm-prolog-scripts=[SLURM_PROLOG_SCRIPTS,...] + Slurm prolog bash scripts. + + For e.g. --slurm-prolog-scripts script1.sh,script2.sh + + --spot-instances=[id=ID],[machineType=MACHINETYPE],[terminationAction=TERMINATIONACTION],[zone=ZONE] + Parameters to define cluster spot instances. + + For e.g. --spot-instances + id={computeId},zone={zone},machineType={machineType}. + + Sets spot_instances value. + + id + Required, sets id value. + + machineType + Required, sets machineType value. + + terminationAction + Sets terminationAction value. + + zone + Required, sets zone value. + + Shorthand Example: + + --spot-instances=id=string,machineType=string,terminationAction=string,zone=string --spot-instances=id=string,machineType=string,terminationAction=string,zone=string + + JSON Example: + + --spot-instances='[{"id": "string", "machineType": "string", "terminationAction": "string", "zone": "string"}]' + + File Example: + + --spot-instances=path_to_file.(yaml|json) + + Network configuration for the cluster. + + Exactly one of these must be specified: + + --create-network=[description=DESCRIPTION],[name=NAME] + Parameters to create a network. Name: Must match the regex + [a-z]([-a-z0-9]*[a-z0-9])?, be 1-63 characters in length, and + comply with RFC1035. + + Description: A description of the network. Maximum of 2048 + characters. + + For e.g. --create-network name={network},description=(BETA) + Creates a Cluster Director resource.. + + Sets create_network value. + + description + Sets description value. + + name + Required, sets name value. + + Shorthand Example: + + --create-network=description=string,name=string + + JSON Example: + + --create-network='{"description": "string", "name": "string"}' + + File Example: + + --create-network=path_to_file.(yaml|json) + + Or at least one of these can be specified: + + Use an existing network source for the cluster. + + --network=NETWORK + Reference of existing network name. If the network is in a + different project (Shared VPC), specify the project ID using + --network-project. + + For e.g. --network {network} + + This flag argument must be specified if any of the other + arguments in this group are specified. + + --subnet=SUBNET + Reference of existing subnetwork name. If the subnetwork is in + a different project (Shared VPC), specify the project ID using + --network-project. + + For e.g. --subnet regions/{region}/subnetworks/{subnetwork} + + This flag argument must be specified if any of the other + arguments in this group are specified. + + --network-project=NETWORK_PROJECT + Project ID of the project containing the network and subnetwork + resources, if different from the cluster project (e.g. for + Shared VPC). + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha cluster-director clusters create + diff --git a/gcloud/beta/cluster-director/clusters/delete b/gcloud/beta/cluster-director/clusters/delete new file mode 100644 index 000000000..cf160e795 --- /dev/null +++ b/gcloud/beta/cluster-director/clusters/delete @@ -0,0 +1,73 @@ +NAME + gcloud beta cluster-director clusters delete - deletes a Cluster Director + resource + +SYNOPSIS + gcloud beta cluster-director clusters delete + (CLUSTER : --location=LOCATION) [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Deletes a Cluster Director resource. + +EXAMPLES + To delete a cluster my-cluster in location us-central1-a run: + + $ gcloud beta cluster-director clusters delete my-cluster \ + --location=us-central1-a + +POSITIONAL ARGUMENTS + Cluster resource - Identifier. Name of the cluster to delete. Formats: + cluster | projects/{project}/locations/{locations}/clusters/{cluster} The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument cluster on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + CLUSTER + ID of the cluster or fully qualified identifier for the cluster. + + To set the cluster attribute: + ▸ provide the argument cluster on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the cluster resource. + + To set the location attribute: + ▸ provide the argument cluster on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the hypercomputecluster/v1beta API. The full + documentation for this API can be found at: + https://docs.cloud.google.com/cluster-director/docs + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha cluster-director clusters delete + diff --git a/gcloud/beta/cluster-director/clusters/describe b/gcloud/beta/cluster-director/clusters/describe new file mode 100644 index 000000000..2a2f2fefe --- /dev/null +++ b/gcloud/beta/cluster-director/clusters/describe @@ -0,0 +1,68 @@ +NAME + gcloud beta cluster-director clusters describe - gets details of a Cluster + Director resource + +SYNOPSIS + gcloud beta cluster-director clusters describe + (CLUSTER : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Gets details of a Cluster Director resource. + +EXAMPLES + To get the details of a cluster my-cluster in location us-central1-a run: + + $ gcloud beta cluster-director clusters describe my-cluster \ + --location=us-central1-a + +POSITIONAL ARGUMENTS + Cluster resource - Identifier. Name of the cluster to retrieve. Format: + cluster | projects/{project}/locations/{location}/clusters/{cluster} The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument cluster on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + CLUSTER + ID of the cluster or fully qualified identifier for the cluster. + + To set the cluster attribute: + ▸ provide the argument cluster on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the cluster resource. + + To set the location attribute: + ▸ provide the argument cluster on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the hypercomputecluster/v1beta API. The full + documentation for this API can be found at: + https://docs.cloud.google.com/cluster-director/docs + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha cluster-director clusters describe + diff --git a/gcloud/beta/cluster-director/clusters/help b/gcloud/beta/cluster-director/clusters/help new file mode 100644 index 000000000..094ab44d9 --- /dev/null +++ b/gcloud/beta/cluster-director/clusters/help @@ -0,0 +1,39 @@ +NAME + gcloud beta cluster-director clusters - manage Cluster Director cluster + resources + +SYNOPSIS + gcloud beta cluster-director clusters COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Manage Cluster Director cluster resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (BETA) Creates a Cluster Director resource. + + delete + (BETA) Deletes a Cluster Director resource. + + describe + (BETA) Gets details of a Cluster Director resource. + + list + (BETA) List Cluster Director resources. + + update + (BETA) Updates a Cluster Director resource. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha cluster-director clusters + diff --git a/gcloud/beta/cluster-director/clusters/list b/gcloud/beta/cluster-director/clusters/list new file mode 100644 index 000000000..2e07d13c5 --- /dev/null +++ b/gcloud/beta/cluster-director/clusters/list @@ -0,0 +1,88 @@ +NAME + gcloud beta cluster-director clusters list - list Cluster Director + resources + +SYNOPSIS + gcloud beta cluster-director clusters list --location=LOCATION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) List Cluster Director resources. + +EXAMPLES + To list all clusters in particular location us-central1-a run: + + $ gcloud beta cluster-director clusters list --location=us-central1-a + +REQUIRED FLAGS + Location resource - Identifier. Parent collection which own list of + clusters. Format: location | projects/{project}/locations/{location} This + represents a Cloud resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the hypercomputecluster/v1beta API. The full + documentation for this API can be found at: + https://docs.cloud.google.com/cluster-director/docs + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha cluster-director clusters list + diff --git a/gcloud/beta/cluster-director/clusters/update b/gcloud/beta/cluster-director/clusters/update new file mode 100644 index 000000000..f94a6f977 --- /dev/null +++ b/gcloud/beta/cluster-director/clusters/update @@ -0,0 +1,1181 @@ +NAME + gcloud beta cluster-director clusters update - updates a Cluster Director + resource + +SYNOPSIS + gcloud beta cluster-director clusters update + (CLUSTER : --location=LOCATION) + (--add-filestore-instances=[ADD_FILESTORE_INSTANCES,...] + --add-flex-start-instances=[id=ID], + [machineType=MACHINETYPE],[maxDuration=MAXDURATION],[zone=ZONE] + --add-labels=[ADD_LABELS,...] + --add-lustre-instances=[ADD_LUSTRE_INSTANCES,...] + --add-new-filestore-instances=[capacityGb=CAPACITYGB], + [description=DESCRIPTION], + [fileshare=FILESHARE],[name=NAME],[protocol=PROTOCOL],[tier=TIER] + --add-new-lustre-instances=[capacityGb=CAPACITYGB], + [description=DESCRIPTION],[filesystem=FILESYSTEM], + [name=NAME],[perUnitStorageThroughput=PERUNITSTORAGETHROUGHPUT] + --add-new-storage-buckets=[enableAutoclass=ENABLEAUTOCLASS], + [enableHNS=ENABLEHNS],[name=NAME],[storageClass=STORAGECLASS] + --add-on-demand-instances=[id=ID], + [machineType=MACHINETYPE],[zone=ZONE] + --add-reserved-instances=[id=ID],[reservation=RESERVATION] + --add-slurm-epilog-scripts=[ADD_SLURM_EPILOG_SCRIPTS,...] + --add-slurm-node-sets=[computeId=COMPUTEID], + [computeInstance=COMPUTEINSTANCE],[id=ID], + [maxDynamicNodeCount=MAXDYNAMICNODECOUNT], + [staticNodeCount=STATICNODECOUNT] + --add-slurm-partitions=[id=ID],[nodesetIds=NODESETIDS] + --add-slurm-prolog-scripts=[ADD_SLURM_PROLOG_SCRIPTS,...] + --add-spot-instances=[id=ID],[machineType=MACHINETYPE], + [terminationAction=TERMINATIONACTION],[zone=ZONE] + --add-storage-buckets=[ADD_STORAGE_BUCKETS,...] + --description=DESCRIPTION + --remove-filestore-instances=[REMOVE_FILESTORE_INSTANCES,...] + --remove-flex-start-instances=[REMOVE_FLEX_START_INSTANCES,...] + --remove-labels=[REMOVE_LABELS,...] + --remove-lustre-instances=[REMOVE_LUSTRE_INSTANCES,...] + --remove-on-demand-instances=[REMOVE_ON_DEMAND_INSTANCES,...] + --remove-reserved-instances=[REMOVE_RESERVED_INSTANCES,...] + --remove-slurm-epilog-scripts=[REMOVE_SLURM_EPILOG_SCRIPTS,...] + --remove-slurm-node-sets=[REMOVE_SLURM_NODE_SETS,...] + --remove-slurm-partitions=[REMOVE_SLURM_PARTITIONS,...] + --remove-slurm-prolog-scripts=[REMOVE_SLURM_PROLOG_SCRIPTS,...] + --remove-spot-instances=[REMOVE_SPOT_INSTANCES,...] + --remove-storage-buckets=[REMOVE_STORAGE_BUCKETS,...] + --slurm-default-partition=SLURM_DEFAULT_PARTITION + --update-slurm-login-node=[bootDisk=BOOTDISK], + [count=COUNT],[startupScript=STARTUPSCRIPT] + --update-slurm-node-sets=[computeId=COMPUTEID], + [computeInstance=COMPUTEINSTANCE],[id=ID], + [maxDynamicNodeCount=MAXDYNAMICNODECOUNT], + [staticNodeCount=STATICNODECOUNT] + --update-slurm-partitions=[id=ID],[nodesetIds=NODESETIDS] + | --config=[computeResources=COMPUTERESOURCES], + [description=DESCRIPTION],[labels=LABELS],[name=NAME], + [networkResources=NETWORKRESOURCES], + [orchestrator=ORCHESTRATOR],[storageResources=STORAGERESOURCES] + --update-mask=UPDATE_MASK) [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) gcloud beta cluster-director clusters update facilitates the + updation of a cluster resource. + + There are following ways to update a cluster: + ▪ [Preferred] Use granular flags to update cluster specs, based on + read-modify-update pattern. + ◆ Read the existing cluster specs through get cluster request. + ◆ Modify the cluster specs through granular flags. + ◆ Update the cluster specs through patch cluster request. + ▪ Use --config with cluster specs and --update-mask flags, both in JSON + format. + ◆ Map and repeated fields update requires existing and new values. + ◆ For e.g. if we want to update a cluster to add a new nodeset, then + we will use the update_mask "orchestrator.slurm.node_sets", and the + patch cluster must include all the existing nodesets as well as the + new one. + + Please refer to the examples below for more details. + +EXAMPLES + To update a cluster my-cluster in location us-central1-a with granular + flags, run the following example: + + Add labels, compute instances, slurm node sets, slurm partitions and update + description and default partition: + + $ gcloud beta cluster-director clusters update my-cluster \ + --location us-central1-a \ + --description "My updated cluster description" \ + --add-labels env=prod,client=gcloud-cli \ + --add-on-demand-instances \ + id=compute1,zone=us-central1-a,machineType=n2-standard-2 \ + --add-reserved-instances \ + id=compute2,reservation=zones/us-central1-a/reservations/\ + {reservation} \ + --add-spot-instances \ + id=compute3,zone=us-central1-a,machineType=n2-standard-2 \ + --add-dws-flex-instances \ + id=compute4,zone=us-central1-a,machineType=a4-highgpu-8g,\ + maxDuration=10000s \ + --add-new-lustre-instances \ + lustre=locations/us-central1-a/instances/lustre1,\ + capacityGb=1024,filesystem=lustre1 \ + --add-lustre-instances \ + locations/us-central1-a/instances/lustre0 \ + --add-slurm-node-sets id=nodeset1,computeId=compute1 \ + --add-slurm-node-sets id=nodeset2,computeId=compute2 \ + --add-slurm-node-sets id=nodeset3,computeId=compute3 \ + --add-slurm-node-sets id=nodeset4,computeId=compute4 \ + --add-slurm-partitions id=partition1,nodesetIds=[nodeset1] \ + --add-slurm-partitions \ + id=partition2,nodesetIds=[nodeset2,nodeset3,nodeset4] \ + --slurm-default-partition partition1 + + Update slurm node sets and slurm partitions: + + $ gcloud beta cluster-director clusters update my-cluster \ + --location us-central1-a \ + --update-slurm-node-sets \ + id=nodeset1,staticNodeCount=2,maxDynamicNodeCount=10 \ + --update-slurm-partitions \ + id=partition1,nodesetIds=[nodeset0],exclusive=true + + Remove slurm node sets, slurm partitions and compute instances and update + default partition: + + $ gcloud beta cluster-director clusters update my-cluster \ + --location us-central1-a --slurm-default-partition partition0 \ + --remove-labels env,client \ + --remove-lustre-instances \ + locations/us-central1-a/instances/lustre0 \ + --remove-slurm-partitions partition1 \ + --remove-slurm-partitions partition2 \ + --remove-slurm-node-sets nodeset1 \ + --remove-slurm-node-sets nodeset2 \ + --remove-slurm-node-sets nodeset3 \ + --remove-slurm-node-sets nodeset4 \ + --remove-on-demand-instances compute1 \ + --remove-reserved-instances compute2 \ + --remove-spot-instances compute3 \ + --remove-dws-flex-instances compute4 + + Add and remove slurm prolog/epilog scripts: + + $ gcloud beta cluster-director clusters update my-cluster \ + --location us-central1-a --add-slurm-prolog-scripts script1.sh \ + --remove-slurm-epilog-scripts script2.sh + + Or cluster my-cluster in location us-central1-a with config JSON run the + following JSON example: + + $ gcloud beta cluster-director clusters update my-cluster \ + --location=us-central1-a --update-mask=labels \ + --config='{"key": "value"}' + + Or create a JSON file my-cluster-config.json with the cluster specs and run + the following file example: + + $ gcloud beta cluster-director clusters update my-cluster \ + --location=us-central1-a --update-mask=labels \ + --config-from-file=my-cluster-config.json + + Or create a JSON file with the update mask and run the following file + example: + + $ gcloud beta cluster-director clusters update my-cluster \ + --location=us-central1-a \ + --update-mask-from-file=my-update-mask.json \ + --config-from-file=my-cluster-config.json + +POSITIONAL ARGUMENTS + Cluster resource - 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 + set in other ways. + + To set the project attribute: + ◆ provide the argument cluster on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + CLUSTER + ID of the cluster or fully qualified identifier for the cluster. + + To set the cluster attribute: + ▸ provide the argument cluster on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the cluster resource. + + To set the location attribute: + ▸ provide the argument cluster on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + Cluster configuration for provisioning with updates. + + Exactly one of these must be specified: + + Flag Configurations to define cluster updates. + + --add-filestore-instances=[ADD_FILESTORE_INSTANCES,...] + Reference of existing filestore instance. + + For e.g. --add-filestore-instances + locations/{location}/instances/{filestore} + + --add-flex-start-instances=[id=ID],[machineType=MACHINETYPE],[maxDuration=MAXDURATION],[zone=ZONE] + Parameters to define cluster Flex Start instances. + + For e.g. --add-flex-start-instances + id={computeId},zone={zone},machineType={machineType},maxDuration=10000s. + + Sets add_flex_start_instances value. + + id + Required, sets id value. + + machineType + Required, sets machineType value. + + maxDuration + Required, sets maxDuration value. + + zone + Required, sets zone value. + + Shorthand Example: + + --add-flex-start-instances=id=string,machineType=string,maxDuration=string,zone=string --add-flex-start-instances=id=string,machineType=string,maxDuration=string,zone=string + + JSON Example: + + --add-flex-start-instances='[{"id": "string", "machineType": "string", "maxDuration": "string", "zone": "string"}]' + + File Example: + + --add-flex-start-instances=path_to_file.(yaml|json) + + --add-labels=[ADD_LABELS,...] + Cluster labels as key value pairs. + + For e.g. --add-labels key1=value1,key2=value2. + + Sets add_labels value. + + KEY + Sets KEY value. + + VALUE + Sets VALUE value. + + Shorthand Example: + + --add-labels={string=string} + + JSON Example: + + --add-labels='{"string": "string"}' + + File Example: + + --add-labels=path_to_file.(yaml|json) + + --add-lustre-instances=[ADD_LUSTRE_INSTANCES,...] + Reference of existing Lustre instance. + + For e.g. --add-lustre-instances + locations/{location}/instances/{lustre} + + --add-new-filestore-instances=[capacityGb=CAPACITYGB],[description=DESCRIPTION],[fileshare=FILESHARE],[name=NAME],[protocol=PROTOCOL],[tier=TIER] + Parameters to create a filestore instance. + + For e.g. --create-filestores + name=locations/{location}/instances/{filestore},tier=REGIONAL,capacityGb={filestoreSize},fileshare={fileshare} + + capacityGb: Size of the filestore in GB. Must be between 1024 and + 102400, and must meet scalability requirements described at + https://cloud.google.com/filestore/docs/service-tiers. + + fileshare: The directory on a Filestore instance where all shared + files are stored. Must match the regex [a-z]([-a-z0-9]*[a-z0-9])?, be + 1-63 characters in length, and comply with RFC1035. Supported tier + values: + ▸ ZONAL + ▸ REGIONAL + + Supported protocol values: + ▸ NFSV3 + ▸ NFSV41 + ▸ If not specified, defaults to NFSV3 + + Defaults: + ▸ protocol: NFSV3. + + Sets add_new_filestore_instances value. + + capacityGb + Required, sets capacityGb value. + + description + Sets description value. + + fileshare + Required, sets fileshare value. + + name + Required, sets name value. + + protocol + Sets protocol value. + + tier + Required, sets tier value. + + Shorthand Example: + + --add-new-filestore-instances=capacityGb=int,description=string,fileshare=string,name=string,protocol=string,tier=string --add-new-filestore-instances=capacityGb=int,description=string,fileshare=string,name=string,protocol=string,tier=string + + JSON Example: + + --add-new-filestore-instances='[{"capacityGb": int, "description": "string", "fileshare": "string", "name": "string", "protocol": "string", "tier": "string"}]' + + File Example: + + --add-new-filestore-instances=path_to_file.(yaml|json) + + --add-new-lustre-instances=[capacityGb=CAPACITYGB],[description=DESCRIPTION],[filesystem=FILESYSTEM],[name=NAME],[perUnitStorageThroughput=PERUNITSTORAGETHROUGHPUT] + Parameters to create a Lustre instance. + + For e.g. --add-new-lustre-instances + name=locations/{location}/instances/{lustre},capacityGb={lustreSize},filesystem={filesystem},perUnitStorageThroughput=1000 + + Values for perUnitStorageThroughput: 125, 250, 500, 1000. + + Sets add_new_lustre_instances value. + + capacityGb + Required, sets capacityGb value. + + description + Sets description value. + + filesystem + Required, sets filesystem value. + + name + Required, sets name value. + + perUnitStorageThroughput + Sets perUnitStorageThroughput value. + + Shorthand Example: + + --add-new-lustre-instances=capacityGb=int,description=string,filesystem=string,name=string,perUnitStorageThroughput=int --add-new-lustre-instances=capacityGb=int,description=string,filesystem=string,name=string,perUnitStorageThroughput=int + + JSON Example: + + --add-new-lustre-instances='[{"capacityGb": int, "description": "string", "filesystem": "string", "name": "string", "perUnitStorageThroughput": int}]' + + File Example: + + --add-new-lustre-instances=path_to_file.(yaml|json) + + --add-new-storage-buckets=[enableAutoclass=ENABLEAUTOCLASS],[enableHNS=ENABLEHNS],[name=NAME],[storageClass=STORAGECLASS] + Parameters to create a Google Cloud Storage bucket. + + For e.g. --add-new-storage-buckets + name={bucket-path},storageClass=STANDARD,enableHNS=true + + Supported storageClass values: + ▸ STANDARD + ▸ NEARLINE + ▸ COLDLINE + ▸ ARCHIVE + + Defaults: + ▸ storageClass: STANDARD + + Note: + ▸ Either storageClass or enableAutoclass can be set. + ▸ HNS: Hierarchical namespace. + + Sets add_new_storage_buckets value. + + enableAutoclass + Sets enableAutoclass value. + + enableHNS + Sets enableHNS value. + + name + Required, sets name value. + + storageClass + Sets storageClass value. + + Shorthand Example: + + --add-new-storage-buckets=enableAutoclass=boolean,enableHNS=boolean,name=string,storageClass=string --add-new-storage-buckets=enableAutoclass=boolean,enableHNS=boolean,name=string,storageClass=string + + JSON Example: + + --add-new-storage-buckets='[{"enableAutoclass": boolean, "enableHNS": boolean, "name": "string", "storageClass": "string"}]' + + File Example: + + --add-new-storage-buckets=path_to_file.(yaml|json) + + --add-on-demand-instances=[id=ID],[machineType=MACHINETYPE],[zone=ZONE] + Parameters to define cluster on demand instances. + + For e.g. --add-on-demand-instances + id={computeId},zone={zone},machineType={machineType}. + + Sets add_on_demand_instances value. + + id + Required, sets id value. + + machineType + Required, sets machineType value. + + zone + Required, sets zone value. + + Shorthand Example: + + --add-on-demand-instances=id=string,machineType=string,zone=string --add-on-demand-instances=id=string,machineType=string,zone=string + + JSON Example: + + --add-on-demand-instances='[{"id": "string", "machineType": "string", "zone": "string"}]' + + File Example: + + --add-on-demand-instances=path_to_file.(yaml|json) + + --add-reserved-instances=[id=ID],[reservation=RESERVATION] + Parameters to define cluster reserved instances. + + For e.g. --add-reserved-instances + id={computeId},reservation=zones/{zone}/reservations/{reservation}. + + Sets add_reserved_instances value. + + id + Required, sets id value. + + reservation + Sets reservation value. + + Shorthand Example: + + --add-reserved-instances=id=string,reservation=string --add-reserved-instances=id=string,reservation=string + + JSON Example: + + --add-reserved-instances='[{"id": "string", "reservation": "string"}]' + + File Example: + + --add-reserved-instances=path_to_file.(yaml|json) + + --add-slurm-epilog-scripts=[ADD_SLURM_EPILOG_SCRIPTS,...] + Slurm epilog bash scripts. + + For e.g. --add-slurm-epilog-scripts script1.sh,script2.sh + + --add-slurm-node-sets=[computeId=COMPUTEID],[computeInstance=COMPUTEINSTANCE],[id=ID],[maxDynamicNodeCount=MAXDYNAMICNODECOUNT],[staticNodeCount=STATICNODECOUNT] + Parameters to define slurm cluster nodeset config. + + For e.g. --add-slurm-node-sets + id={nodesetId},computeId={computeId},staticNodeCount={staticNodeCount},maxDynamicNodeCount={maxDynamicNodeCount},computeInstance=[startupScript="echo + hello",labels="key1=value1,key2=value2"] + + Defaults: + ▸ staticNodeCount: 1 + + Note: + ▸ startupScript: + ▫ Either str or file_path + ▫ For file_path, only bash file format (.sh or .bash) is + supported. + ▫ For file_path, only absolute path is supported. + + Sets add_slurm_node_sets value. + + computeId + Sets computeId value. + + computeInstance + Sets computeInstance value. + + bootDisk + Sets bootDisk value. + + sizeGb + Required, sets sizeGb value. + + type + Required, sets type value. + + labels + Sets labels value. + + KEY + Sets KEY value. + + VALUE + Sets VALUE value. + + startupScript + Sets startupScript value. + + id + Required, sets id value. + + maxDynamicNodeCount + Sets maxDynamicNodeCount value. + + staticNodeCount + Sets staticNodeCount value. + + Shorthand Example: + + --add-slurm-node-sets=computeId=string,computeInstance={bootDisk={sizeGb=int,type=string},labels={string=string},startupScript=string},id=string,maxDynamicNodeCount=int,staticNodeCount=int --add-slurm-node-sets=computeId=string,computeInstance={bootDisk={sizeGb=int,type=string},labels={string=string},startupScript=string},id=string,maxDynamicNodeCount=int,staticNodeCount=int + + JSON Example: + + --add-slurm-node-sets='[{"computeId": "string", "computeInstance": {"bootDisk": {"sizeGb": int, "type": "string"}, "labels": {"string": "string"}, "startupScript": "string"}, "id": "string", "maxDynamicNodeCount": int, "staticNodeCount": int}]' + + File Example: + + --add-slurm-node-sets=path_to_file.(yaml|json) + + --add-slurm-partitions=[id=ID],[nodesetIds=NODESETIDS] + Parameters to define slurm cluster partitions. + + For e.g. --add-slurm-partitions id=p1,nodesetIds=[ns1,ns2]. + + Sets add_slurm_partitions value. + + id + Required, sets id value. + + nodesetIds + Required, sets nodesetIds value. + + Shorthand Example: + + --add-slurm-partitions=id=string,nodesetIds=[string] --add-slurm-partitions=id=string,nodesetIds=[string] + + JSON Example: + + --add-slurm-partitions='[{"id": "string", "nodesetIds": ["string"]}]' + + File Example: + + --add-slurm-partitions=path_to_file.(yaml|json) + + --add-slurm-prolog-scripts=[ADD_SLURM_PROLOG_SCRIPTS,...] + Slurm prolog bash scripts. + + For e.g. --add-slurm-prolog-scripts script1.sh,script2.sh + + --add-spot-instances=[id=ID],[machineType=MACHINETYPE],[terminationAction=TERMINATIONACTION],[zone=ZONE] + Parameters to define cluster spot instances. + + For e.g. --add-spot-instances + id={computeId},zone={zone},machineType={machineType}. + + Sets add_spot_instances value. + + id + Required, sets id value. + + machineType + Required, sets machineType value. + + terminationAction + Sets terminationAction value. + + zone + Required, sets zone value. + + Shorthand Example: + + --add-spot-instances=id=string,machineType=string,terminationAction=string,zone=string --add-spot-instances=id=string,machineType=string,terminationAction=string,zone=string + + JSON Example: + + --add-spot-instances='[{"id": "string", "machineType": "string", "terminationAction": "string", "zone": "string"}]' + + File Example: + + --add-spot-instances=path_to_file.(yaml|json) + + --add-storage-buckets=[ADD_STORAGE_BUCKETS,...] + Reference of existing Google Cloud Storage bucket. + + For e.g. --add-storage-buckets {existing-bucket-name eg. my-bucket} + + --description=DESCRIPTION + Description of the cluster. + + For e.g. --description (BETA) Updates a Cluster Director resource. + + --remove-filestore-instances=[REMOVE_FILESTORE_INSTANCES,...] + Parameters to remove filestore instance config by filestore name. + + For e.g. --remove-filestore-instances + locations/{location}/instances/{filestore1},locations/{location}/instances/{filestore2},... + + --remove-flex-start-instances=[REMOVE_FLEX_START_INSTANCES,...] + Parameters to remove Flex Start instance config by compute id. + + For e.g. --remove-flex-start-instances {computeId1},{computeId2},... + + --remove-labels=[REMOVE_LABELS,...] + Parameters to remove cluster label by key. + + For e.g. --remove-labels {key1},{key2},... + + --remove-lustre-instances=[REMOVE_LUSTRE_INSTANCES,...] + Parameters to remove lustre instance config by lustre name. + + For e.g. --remove-lustre-instances + locations/{location}/instances/{lustre1},locations/{location}/instances/{lustre2},... + + --remove-on-demand-instances=[REMOVE_ON_DEMAND_INSTANCES,...] + Parameters to remove on demand instances config by compute id. + + For e.g. --remove-on-demand-instances {computeId1},{computeId2},... + + --remove-reserved-instances=[REMOVE_RESERVED_INSTANCES,...] + Parameters to remove reserved instance config by compute id. + + For e.g. --remove-reserved-instances {computeId1},{computeId2},... + + --remove-slurm-epilog-scripts=[REMOVE_SLURM_EPILOG_SCRIPTS,...] + Scripts to remove from Slurm epilog bash scripts. + + For e.g. --remove-slurm-epilog-scripts script1.sh,script2.sh + + --remove-slurm-node-sets=[REMOVE_SLURM_NODE_SETS,...] + Parameters to remove slurm nodeset config by nodeset id. + + For e.g. --remove-slurm-node-sets {nodesetId1},{nodesetId2},... + + --remove-slurm-partitions=[REMOVE_SLURM_PARTITIONS,...] + Parameters to remove slurm partition config by partition id. + + For e.g. --remove-slurm-partitions p1,p2,... + + --remove-slurm-prolog-scripts=[REMOVE_SLURM_PROLOG_SCRIPTS,...] + Scripts to remove from Slurm prolog bash scripts. + + For e.g. --remove-slurm-prolog-scripts script1.sh,script2.sh + + --remove-spot-instances=[REMOVE_SPOT_INSTANCES,...] + Parameters to remove spot instance config by compute id. + + For e.g. --remove-spot-instances {computeId1},{computeId2},... + + --remove-storage-buckets=[REMOVE_STORAGE_BUCKETS,...] + Parameters to remove Google Cloud Storage bucket by bucket name. + + For e.g. --remove-storage-buckets {bucket1},{bucket2},... + + --slurm-default-partition=SLURM_DEFAULT_PARTITION + Parameters to define slurm cluster default partition. + + For e.g. --slurm-default-partition {partitionId} + + --update-slurm-login-node=[bootDisk=BOOTDISK],[count=COUNT],[startupScript=STARTUPSCRIPT] + Parameters to update slurm cluster login node. Only bootDisk, count + and startupScript can be updated. + + For e.g. --update-slurm-login-node count=2,startupScript="echo + hello". + + Sets update_slurm_login_node value. + + bootDisk + Sets bootDisk value. + + sizeGb + Required, sets sizeGb value. + + type + Required, sets type value. + + count + Sets count value. + + startupScript + Sets startupScript value. + + Shorthand Example: + + --update-slurm-login-node=bootDisk={sizeGb=int,type=string},count=int,startupScript=string + + JSON Example: + + --update-slurm-login-node='{"bootDisk": {"sizeGb": int, "type": "string"}, "count": int, "startupScript": "string"}' + + File Example: + + --update-slurm-login-node=path_to_file.(yaml|json) + + --update-slurm-node-sets=[computeId=COMPUTEID],[computeInstance=COMPUTEINSTANCE],[id=ID],[maxDynamicNodeCount=MAXDYNAMICNODECOUNT],[staticNodeCount=STATICNODECOUNT] + Parameters to define and update slurm cluster nodeset config. + + For e.g. --update-slurm-node-sets + id={nodesetId},staticNodeCount={staticNodeCount},maxDynamicNodeCount={maxDynamicNodeCount},computeInstance=[startupScript="echo + hello"]. + + Sets update_slurm_node_sets value. + + computeId + Sets computeId value. + + computeInstance + Sets computeInstance value. + + bootDisk + Sets bootDisk value. + + sizeGb + Required, sets sizeGb value. + + type + Required, sets type value. + + labels + Sets labels value. + + KEY + Sets KEY value. + + VALUE + Sets VALUE value. + + startupScript + Sets startupScript value. + + id + Required, sets id value. + + maxDynamicNodeCount + Sets maxDynamicNodeCount value. + + staticNodeCount + Sets staticNodeCount value. + + Shorthand Example: + + --update-slurm-node-sets=computeId=string,computeInstance={bootDisk={sizeGb=int,type=string},labels={string=string},startupScript=string},id=string,maxDynamicNodeCount=int,staticNodeCount=int --update-slurm-node-sets=computeId=string,computeInstance={bootDisk={sizeGb=int,type=string},labels={string=string},startupScript=string},id=string,maxDynamicNodeCount=int,staticNodeCount=int + + JSON Example: + + --update-slurm-node-sets='[{"computeId": "string", "computeInstance": {"bootDisk": {"sizeGb": int, "type": "string"}, "labels": {"string": "string"}, "startupScript": "string"}, "id": "string", "maxDynamicNodeCount": int, "staticNodeCount": int}]' + + File Example: + + --update-slurm-node-sets=path_to_file.(yaml|json) + + --update-slurm-partitions=[id=ID],[nodesetIds=NODESETIDS] + Parameters to define and update slurm cluster partition config. + + For e.g. --update-slurm-partitions id=p1,nodesetIds=[ns1,ns2]. + + Sets update_slurm_partitions value. + + id + Required, sets id value. + + nodesetIds + Sets nodesetIds value. + + Shorthand Example: + + --update-slurm-partitions=id=string,nodesetIds=[string] --update-slurm-partitions=id=string,nodesetIds=[string] + + JSON Example: + + --update-slurm-partitions='[{"id": "string", "nodesetIds": ["string"]}]' + + File Example: + + --update-slurm-partitions=path_to_file.(yaml|json) + + Cluster configuration for updates. + + --config=[computeResources=COMPUTERESOURCES],[description=DESCRIPTION],[labels=LABELS],[name=NAME],[networkResources=NETWORKRESOURCES],[orchestrator=ORCHESTRATOR],[storageResources=STORAGERESOURCES] + Configuration of the cluster specs in the form of a JSON object. + Required, sets config value. + + computeResources + Sets computeResources value. + + KEY + Sets KEY value. + + VALUE + Sets VALUE value. + + config + Sets config value. + + newDwsFlexInstances + Sets newDwsFlexInstances value. + + machineType + Sets machineType value. + + maxDuration + Sets maxDuration value. + + zone + Sets zone value. + + newFlexStartInstances + Sets newFlexStartInstances value. + + machineType + Sets machineType value. + + maxDuration + Sets maxDuration value. + + zone + Sets zone value. + + newOnDemandInstances + Sets newOnDemandInstances value. + + machineType + Sets machineType value. + + zone + Sets zone value. + + newReservedInstances + Sets newReservedInstances value. + + reservation + Sets reservation value. + + newSpotInstances + Sets newSpotInstances value. + + machineType + Sets machineType 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. + + networkResources + Sets networkResources value. + + KEY + Sets KEY value. + + VALUE + Sets VALUE value. + + config + Sets config value. + + existingComputeNetwork + Sets existingComputeNetwork value. + + network + Sets network value. + + subnetwork + Sets subnetwork value. + + existingNetwork + Sets existingNetwork value. + + network + Sets network value. + + subnetwork + Sets subnetwork value. + + newComputeNetwork + Sets newComputeNetwork value. + + description + Sets description value. + + network + Sets network value. + + newNetwork + Sets newNetwork value. + + description + Sets description value. + + network + Sets network value. + + orchestrator + Sets orchestrator value. + + slurm + Sets slurm value. + + defaultPartition + Sets defaultPartition value. + + epilogBashScripts + Sets epilogBashScripts value. + + loginNodes + Sets loginNodes value. + + bootDisk + Sets bootDisk value. + + sizeGb + Required, sets sizeGb value. + + type + Required, sets type 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. + + startupScript + Sets startupScript value. + + zone + Required, sets zone value. + + nodeSets + Sets nodeSets value. + + computeId + Sets computeId value. + + computeInstance + Sets computeInstance value. + + bootDisk + Sets bootDisk value. + + sizeGb + Required, sets sizeGb value. + + type + Required, sets type value. + + labels + Sets labels value. + + KEY + Sets KEY value. + + VALUE + Sets VALUE value. + + startupScript + Sets startupScript value. + + id + Required, sets id value. + + maxDynamicNodeCount + Sets maxDynamicNodeCount value. + + staticNodeCount + Sets staticNodeCount value. + + partitions + Sets partitions value. + + id + Required, sets id value. + + nodesetIds + Required, sets nodesetIds value. + + prologBashScripts + Sets prologBashScripts value. + + storageResources + Sets storageResources value. + + KEY + Sets KEY value. + + VALUE + Sets VALUE 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. + + 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. + + perUnitStorageThroughput + Sets perUnitStorageThroughput value. + + Shorthand Example: + + --config=computeResources={string={config={newDwsFlexInstances={machineType=string,maxDuration=string,zone=string},newFlexStartInstances={machineType=string,maxDuration=string,zone=string},newOnDemandInstances={machineType=string,zone=string},newReservedInstances={reservation=string},newSpotInstances={machineType=string,terminationAction=string,zone=string}}}},description=string,labels={string=string},name=string,networkResources={string={config={existingComputeNetwork={network=string,subnetwork=string},existingNetwork={network=string,subnetwork=string},newComputeNetwork={description=string,network=string},newNetwork={description=string,network=string}}}},orchestrator={slurm={defaultPartition=string,epilogBashScripts,loginNodes={bootDisk={sizeGb=int,type=string},count=int,enableOSLogin=boolean,enablePublicIPs=boolean,labels={string=string},machineType=string,startupScript=string,zone=string},nodeSets=[{computeId=string,computeInstance={bootDisk={sizeGb=int,type=string},labels={string=string},startupScript=string},id=string,maxDynamicNodeCount=int,staticNodeCount=int}],partitions=[{id=string,nodesetIds=[string]}],prologBashScripts}},storageResources={string={config={existingBucket={bucket=string},existingFilestore={filestore=string},existingLustre={lustre=string},newBucket={autoclass={enabled=boolean},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,perUnitStorageThroughput=int}}}} + + JSON Example: + + --config='{"computeResources": {"string": {"config": {"newDwsFlexInstances": {"machineType": "string", "maxDuration": "string", "zone": "string"}, "newFlexStartInstances": {"machineType": "string", "maxDuration": "string", "zone": "string"}, "newOnDemandInstances": {"machineType": "string", "zone": "string"}, "newReservedInstances": {"reservation": "string"}, "newSpotInstances": {"machineType": "string", "terminationAction": "string", "zone": "string"}}}}, "description": "string", "labels": {"string": "string"}, "name": "string", "networkResources": {"string": {"config": {"existingComputeNetwork": {"network": "string", "subnetwork": "string"}, "existingNetwork": {"network": "string", "subnetwork": "string"}, "newComputeNetwork": {"description": "string", "network": "string"}, "newNetwork": {"description": "string", "network": "string"}}}}, "orchestrator": {"slurm": {"defaultPartition": "string", "epilogBashScripts", "loginNodes": {"bootDisk": {"sizeGb": int, "type": "string"}, "count": int, "enableOSLogin": boolean, "enablePublicIPs": boolean, "labels": {"string": "string"}, "machineType": "string", "startupScript": "string", "zone": "string"}, "nodeSets": [{"computeId": "string", "computeInstance": {"bootDisk": {"sizeGb": int, "type": "string"}, "labels": {"string": "string"}, "startupScript": "string"}, "id": "string", "maxDynamicNodeCount": int, "staticNodeCount": int}], "partitions": [{"id": "string", "nodesetIds": ["string"]}], "prologBashScripts"}}, "storageResources": {"string": {"config": {"existingBucket": {"bucket": "string"}, "existingFilestore": {"filestore": "string"}, "existingLustre": {"lustre": "string"}, "newBucket": {"autoclass": {"enabled": boolean}, "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", "perUnitStorageThroughput": int}}}}}' + + File Example: + + --config=path_to_file.(yaml|json) + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --update-mask=UPDATE_MASK + Update mask to specify the fields to update. + + For e.g. --update-mask "description,labels". + + Required, sets update_mask value. + + Input Example: + + --update-mask=string + + File Example: + + --update-mask=path_to_file.(yaml|json) + + This flag argument must be specified if any of the other arguments in + this group are specified. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha cluster-director clusters update + diff --git a/gcloud/beta/cluster-director/help b/gcloud/beta/cluster-director/help new file mode 100644 index 000000000..2c902072a --- /dev/null +++ b/gcloud/beta/cluster-director/help @@ -0,0 +1,32 @@ +NAME + gcloud beta cluster-director - manage Cluster Director resources + +SYNOPSIS + gcloud beta cluster-director GROUP [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Manage Cluster Director resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + clusters + (BETA) Manage Cluster Director cluster resources. + + locations + (BETA) View Locations resources. + + operations + (BETA) Manage Operation resources. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha cluster-director + diff --git a/gcloud/beta/cluster-director/locations/describe b/gcloud/beta/cluster-director/locations/describe new file mode 100644 index 000000000..92bf5b050 --- /dev/null +++ b/gcloud/beta/cluster-director/locations/describe @@ -0,0 +1,53 @@ +NAME + gcloud beta cluster-director locations describe - describe locations + +SYNOPSIS + gcloud beta cluster-director locations describe LOCATION + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Describe a location. + +EXAMPLES + To describe the operation, run: + + $ gcloud beta cluster-director locations describe us-central1 + +POSITIONAL ARGUMENTS + Location resource - The name of the location resource. This represents a + Cloud resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the hypercomputecluster/v1beta API. The full + documentation for this API can be found at: + https://docs.cloud.google.com/cluster-director/docs + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha cluster-director locations describe + diff --git a/gcloud/beta/cluster-director/locations/help b/gcloud/beta/cluster-director/locations/help new file mode 100644 index 000000000..cac08ac0e --- /dev/null +++ b/gcloud/beta/cluster-director/locations/help @@ -0,0 +1,29 @@ +NAME + gcloud beta cluster-director locations - view Locations resources + +SYNOPSIS + gcloud beta cluster-director locations COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) View Locations resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + (BETA) Describe locations. + + list + (BETA) List locations. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha cluster-director locations + diff --git a/gcloud/beta/cluster-director/locations/list b/gcloud/beta/cluster-director/locations/list new file mode 100644 index 000000000..60facd6b5 --- /dev/null +++ b/gcloud/beta/cluster-director/locations/list @@ -0,0 +1,61 @@ +NAME + gcloud beta cluster-director locations list - list locations + +SYNOPSIS + gcloud beta cluster-director locations list [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) List locations. + +EXAMPLES + To list all locations, run: + + $ gcloud beta cluster-director locations list + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the hypercomputecluster/v1beta API. The full + documentation for this API can be found at: + https://docs.cloud.google.com/cluster-director/docs + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha cluster-director locations list + diff --git a/gcloud/beta/cluster-director/operations/describe b/gcloud/beta/cluster-director/operations/describe new file mode 100644 index 000000000..8f443e2cc --- /dev/null +++ b/gcloud/beta/cluster-director/operations/describe @@ -0,0 +1,66 @@ +NAME + gcloud beta cluster-director operations describe - describe operations + +SYNOPSIS + gcloud beta cluster-director operations describe + (OPERATION : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Describe an operation + +EXAMPLES + To describe the operation my-operation in location us-central1-a, run: + + $ gcloud beta cluster-director operations describe my-operation \ + --location=us-central1-a + +POSITIONAL ARGUMENTS + Operation resource - The name of the operation resource. The arguments in + this group can be used to specify the attributes of this resource. (NOTE) + Some attributes are not given arguments in this group but can be set in + other ways. + + To set the project attribute: + ◆ provide the argument operation on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + OPERATION + ID of the operation or fully qualified identifier for the operation. + + To set the operation attribute: + ▸ provide the argument operation on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the operation resource. + + To set the location attribute: + ▸ provide the argument operation on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the hypercomputecluster/v1beta API. The full + documentation for this API can be found at: + https://docs.cloud.google.com/cluster-director/docs + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha cluster-director operations describe + diff --git a/gcloud/beta/cluster-director/operations/help b/gcloud/beta/cluster-director/operations/help new file mode 100644 index 000000000..17eb93739 --- /dev/null +++ b/gcloud/beta/cluster-director/operations/help @@ -0,0 +1,26 @@ +NAME + gcloud beta cluster-director operations - manage Operation resources + +SYNOPSIS + gcloud beta cluster-director operations COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Manage Operation resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + (BETA) Describe operations. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha cluster-director operations + diff --git a/gcloud/beta/compute/firewall-policies/rules/create b/gcloud/beta/compute/firewall-policies/rules/create index c09d6e7da..4502cd4fa 100644 --- a/gcloud/beta/compute/firewall-policies/rules/create +++ b/gcloud/beta/compute/firewall-policies/rules/create @@ -87,12 +87,12 @@ OPTIONAL FLAGS --dest-region-codes=[DEST_REGION_CODES,...] Destination Region Code to match for this rule. Can only be specified if DIRECTION is egress. Cannot be specified when the source network - type is NON_INTERNET. + context is NON_INTERNET. --dest-threat-intelligence=[DEST_THREAT_INTELLIGENCE_LISTS,...] Destination Threat Intelligence lists to match for this rule. Can only be specified if DIRECTION is egress. Cannot be specified when source - network type is NON_INTERNET. The available lists can be found here: + network context is NON_INTERNET. The available lists can be found here: https://cloud.google.com/vpc/docs/firewall-policies-rule-details#threat-intelligence-fw-policy. --direction=DIRECTION @@ -156,8 +156,8 @@ OPTIONAL FLAGS --src-region-codes=[SOURCE_REGION_CODES,...] Source Region Code to match for this rule. Can only be specified if - DIRECTION is ingress. Cannot be specified when the source network type - is NON_INTERNET, VPC_NETWORK or INTRA_VPC. + DIRECTION is ingress. Cannot be specified when the source network + context is NON_INTERNET, VPC_NETWORK or INTRA_VPC. --src-secure-tags=[SOURCE_SECURE_TAGS,...] A list of instance secure tags indicating the set of instances on the @@ -172,8 +172,8 @@ OPTIONAL FLAGS --src-threat-intelligence=[SOURCE_THREAT_INTELLIGENCE_LISTS,...] Source Threat Intelligence lists to match for this rule. Can only be specified if DIRECTION is ingress. Cannot be specified when the source - network type is NON_INTERNET, VPC_NETWORK or INTRA_VPC. The available - lists can be found here: + network context is NON_INTERNET, VPC_NETWORK or INTRA_VPC. The + available lists can be found here: https://cloud.google.com/vpc/docs/firewall-policies-rule-details#threat-intelligence-fw-policy. --target-resources=[TARGET_RESOURCES,...] diff --git a/gcloud/beta/compute/firewall-policies/rules/update b/gcloud/beta/compute/firewall-policies/rules/update index 9055fe53e..6337e3b50 100644 --- a/gcloud/beta/compute/firewall-policies/rules/update +++ b/gcloud/beta/compute/firewall-policies/rules/update @@ -85,12 +85,12 @@ OPTIONAL FLAGS --dest-region-codes=[DEST_REGION_CODES,...] Destination Region Code to match for this rule. Can only be specified if DIRECTION is egress. Cannot be specified when the source network - type is NON_INTERNET. + context is NON_INTERNET. --dest-threat-intelligence=[DEST_THREAT_INTELLIGENCE_LISTS,...] Destination Threat Intelligence lists to match for this rule. Can only be specified if DIRECTION is egress. Cannot be specified when source - network type is NON_INTERNET. The available lists can be found here: + network context is NON_INTERNET. The available lists can be found here: https://cloud.google.com/vpc/docs/firewall-policies-rule-details#threat-intelligence-fw-policy. --direction=DIRECTION @@ -161,8 +161,8 @@ OPTIONAL FLAGS --src-region-codes=[SOURCE_REGION_CODES,...] Source Region Code to match for this rule. Can only be specified if - DIRECTION is ingress. Cannot be specified when the source network type - is NON_INTERNET, VPC_NETWORK or INTRA_VPC. + DIRECTION is ingress. Cannot be specified when the source network + context is NON_INTERNET, VPC_NETWORK or INTRA_VPC. --src-secure-tags=[SOURCE_SECURE_TAGS,...] A list of instance secure tags indicating the set of instances on the @@ -177,8 +177,8 @@ OPTIONAL FLAGS --src-threat-intelligence=[SOURCE_THREAT_INTELLIGENCE_LISTS,...] Source Threat Intelligence lists to match for this rule. Can only be specified if DIRECTION is ingress. Cannot be specified when the source - network type is NON_INTERNET, VPC_NETWORK or INTRA_VPC. The available - lists can be found here: + network context is NON_INTERNET, VPC_NETWORK or INTRA_VPC. The + available lists can be found here: https://cloud.google.com/vpc/docs/firewall-policies-rule-details#threat-intelligence-fw-policy. --target-resources=[TARGET_RESOURCES,...] diff --git a/gcloud/beta/compute/help b/gcloud/beta/compute/help index d97bfb5b5..5f290aa4a 100644 --- a/gcloud/beta/compute/help +++ b/gcloud/beta/compute/help @@ -106,6 +106,9 @@ GROUPS instances (BETA) Read and manipulate Compute Engine virtual machine instances. + instant-snapshot-groups + (BETA) Create, list and delete Compute Engine instant snapshot groups. + instant-snapshots (BETA) Create, list and delete Compute Engine instant snapshots. @@ -178,6 +181,9 @@ GROUPS rollout-plans (BETA) Read and manipulate Compute Engine Rollout Plans. + rollouts + (BETA) Read and manipulate Compute Engine Rollouts. + routers (BETA) List, create, and delete Compute Engine routers. diff --git a/gcloud/beta/compute/instance-groups/managed/create b/gcloud/beta/compute/instance-groups/managed/create index 703073f86..670b78f99 100644 --- a/gcloud/beta/compute/instance-groups/managed/create +++ b/gcloud/beta/compute/instance-groups/managed/create @@ -10,8 +10,9 @@ SYNOPSIS [--default-action-on-vm-failure=ACTION_ON_VM_FAILURE] [--description=DESCRIPTION] [--[no-]force-update-on-repair] [--initial-delay=INITIAL_DELAY] [--instance-redistribution-type=TYPE] - [--instance-selection=name=NAME, - machine-type=MACHINE_TYPE[,machine-type=MACHINE_TYPE...][,rank=RANK]] + [--instance-selection=name=NAME,machine-type=MACHINE_TYPE[, + machine-type=MACHINE_TYPE...][, + rank=RANK][,min-cpu-platform=MIN_CPU_PLATFORM]] [--instance-selection-machine-types=[MACHINE_TYPE,...]] [--list-managed-instances-results=MODE] [--on-repair-allow-changing-zone=ON_REPAIR_ALLOW_CHANGING_ZONE] @@ -153,9 +154,10 @@ OPTIONAL FLAGS The managed instance group proactively redistributes instances to meet its target distribution. - --instance-selection=name=NAME,machine-type=MACHINE_TYPE[,machine-type=MACHINE_TYPE...][,rank=RANK] - Named selection of machine types with an optional rank. For example, - --instance-selection="name=instance-selection-1,machine-type=e2-standard-8,machine-type=t2d-standard-8,rank=0" + --instance-selection=name=NAME,machine-type=MACHINE_TYPE[,machine-type=MACHINE_TYPE...][,rank=RANK][,min-cpu-platform=MIN_CPU_PLATFORM] + Named selection of machine types with an optional rank and minimum CPU + platform. For example, + --instance-selection="name=instance-selection-1,machine-type=e2-standard-8,machine-type=t2d-standard-8,rank=0,min-cpu-platform=MIN_CPU_PLATFORM" --instance-selection-machine-types=[MACHINE_TYPE,...] Machine types that are used to create VMs. If not provided, the machine diff --git a/gcloud/beta/compute/instance-groups/managed/update b/gcloud/beta/compute/instance-groups/managed/update index 533e3ee97..4a27ce1c3 100644 --- a/gcloud/beta/compute/instance-groups/managed/update +++ b/gcloud/beta/compute/instance-groups/managed/update @@ -8,8 +8,9 @@ SYNOPSIS [--default-action-on-vm-failure=ACTION_ON_VM_FAILURE] [--description=DESCRIPTION] [--[no-]force-update-on-repair] [--instance-redistribution-type=TYPE] - [--instance-selection=name=NAME, - machine-type=MACHINE_TYPE[,machine-type=MACHINE_TYPE...][,rank=RANK]] + [--instance-selection=name=NAME,machine-type=MACHINE_TYPE[, + machine-type=MACHINE_TYPE...][, + rank=RANK][,min-cpu-platform=MIN_CPU_PLATFORM]] [--instance-selection-machine-types=[MACHINE_TYPE,...]] [--list-managed-instances-results=MODE] [--on-repair-allow-changing-zone=ON_REPAIR_ALLOW_CHANGING_ZONE] @@ -26,7 +27,7 @@ SYNOPSIS [--stateful-internal-ip=[enabled], [auto-delete=AUTO-DELETE],[interface-name=INTERFACE-NAME]] [--stopped-size=STOPPED_SIZE] [--suspended-size=SUSPENDED_SIZE] - [--target-distribution-shape=SHAPE] + [--target-distribution-shape=SHAPE] [--template=TEMPLATE] [--clear-autohealing | --initial-delay=INITIAL_DELAY --health-check=HEALTH_CHECK | --http-health-check=HTTP_HEALTH_CHECK @@ -132,9 +133,10 @@ FLAGS The managed instance group proactively redistributes instances to meet its target distribution. - --instance-selection=name=NAME,machine-type=MACHINE_TYPE[,machine-type=MACHINE_TYPE...][,rank=RANK] - Named selection of machine types with an optional rank. For example, - --instance-selection="name=instance-selection-1,machine-type=e2-standard-8,machine-type=t2d-standard-8,rank=0" + --instance-selection=name=NAME,machine-type=MACHINE_TYPE[,machine-type=MACHINE_TYPE...][,rank=RANK][,min-cpu-platform=MIN_CPU_PLATFORM] + Named selection of machine types with an optional rank and minimum CPU + platform. For example, + --instance-selection="name=instance-selection-1,machine-type=e2-standard-8,machine-type=t2d-standard-8,rank=0,min-cpu-platform=MIN_CPU_PLATFORM" --instance-selection-machine-types=[MACHINE_TYPE,...] Machine types that are used to create VMs. If not provided, the machine @@ -339,6 +341,13 @@ FLAGS instances does not differ by more than 1 between any two zones. Recommended for highly available serving workloads. + --template=TEMPLATE + Specifies the instance template that will replace the existing template + used by the MIG. The MIG then uses this new template to create + instances. Specifying the new template overrides any template versions + that you've set for the MIG. Specify either a global or a regional + instance template. + At most one of these can be specified: --clear-autohealing diff --git a/gcloud/beta/compute/instant-snapshot-groups/create b/gcloud/beta/compute/instant-snapshot-groups/create new file mode 100644 index 000000000..2e6ebb88b --- /dev/null +++ b/gcloud/beta/compute/instant-snapshot-groups/create @@ -0,0 +1,91 @@ +NAME + gcloud beta compute instant-snapshot-groups create - create a Compute + Engine instant snapshot group + +SYNOPSIS + gcloud beta compute instant-snapshot-groups create + INSTANT_SNAPSHOT_GROUP_NAME + --source-consistency-group=SOURCE_CONSISTENCY_GROUP + [--region=REGION | --zone=ZONE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) gcloud beta compute instant-snapshot-groups create creates an + instant snapshot group of the consistency group. An Instant Snapshot Group + is a Point In Time view of the constituent disks of a Consistency Group, + they are stored in-place as Instant Snapshots on the corresponding disks. + +EXAMPLES + To create an instant snapshot group 'my-instant-snapshot-group' in zone + 'us-east1-a' from a consistency group 'my-consistency-group' in region + 'us-east1', run: $ gcloud beta compute instant-snapshot-groups create \ + my-instant-snapshot-group --zone us-east1-a \ + --source-consistency-group=regions/us-east1/resourcePolicies/\ + policy1 + +POSITIONAL ARGUMENTS + INSTANT_SNAPSHOT_GROUP_NAME + Name of the instant snapshot group to create. + +REQUIRED FLAGS + --source-consistency-group=SOURCE_CONSISTENCY_GROUP + URL of the source consistency group resource policy. The resource + policy is always in the same region as the source disks. + +OPTIONAL FLAGS + At most one of these can be specified: + + --region=REGION + Region of the instant snapshot group to create. If not specified, you + might be prompted to select a region (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/region property: + + $ gcloud config set compute/region REGION + + A list of regions can be fetched by running: + + $ gcloud compute regions list + + To unset the property, run: + + $ gcloud config unset compute/region + + Alternatively, the region can be stored in the environment variable + CLOUDSDK_COMPUTE_REGION. + + --zone=ZONE + Zone of the instant snapshot group to create. If not specified and + the compute/zone property isn't set, you might be prompted to select + a zone (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/zone property: + + $ gcloud config set compute/zone ZONE + + A list of zones can be fetched by running: + + $ gcloud compute zones list + + To unset the property, run: + + $ gcloud config unset compute/zone + + Alternatively, the zone can be stored in the environment variable + CLOUDSDK_COMPUTE_ZONE. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha compute instant-snapshot-groups create + diff --git a/gcloud/beta/compute/instant-snapshot-groups/delete b/gcloud/beta/compute/instant-snapshot-groups/delete new file mode 100644 index 000000000..0d0f39f7e --- /dev/null +++ b/gcloud/beta/compute/instant-snapshot-groups/delete @@ -0,0 +1,74 @@ +NAME + gcloud beta compute instant-snapshot-groups delete - delete a Compute + Engine instant snapshot group + +SYNOPSIS + gcloud beta compute instant-snapshot-groups delete + INSTANT_SNAPSHOT_GROUP_NAME [INSTANT_SNAPSHOT_GROUP_NAME ...] + [--region=REGION | --zone=ZONE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Delete a Compute Engine instant snapshot group. + +POSITIONAL ARGUMENTS + INSTANT_SNAPSHOT_GROUP_NAME [INSTANT_SNAPSHOT_GROUP_NAME ...] + Names of the instant snapshot groups to delete. + +FLAGS + At most one of these can be specified: + + --region=REGION + Region of the instant snapshot groups to delete. If not specified, + you might be prompted to select a region (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/region property: + + $ gcloud config set compute/region REGION + + A list of regions can be fetched by running: + + $ gcloud compute regions list + + To unset the property, run: + + $ gcloud config unset compute/region + + Alternatively, the region can be stored in the environment variable + CLOUDSDK_COMPUTE_REGION. + + --zone=ZONE + Zone of the instant snapshot groups to delete. If not specified and + the compute/zone property isn't set, you might be prompted to select + a zone (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/zone property: + + $ gcloud config set compute/zone ZONE + + A list of zones can be fetched by running: + + $ gcloud compute zones list + + To unset the property, run: + + $ gcloud config unset compute/zone + + Alternatively, the zone can be stored in the environment variable + CLOUDSDK_COMPUTE_ZONE. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha compute instant-snapshot-groups delete + diff --git a/gcloud/beta/compute/instant-snapshot-groups/describe b/gcloud/beta/compute/instant-snapshot-groups/describe new file mode 100644 index 000000000..120f42bd7 --- /dev/null +++ b/gcloud/beta/compute/instant-snapshot-groups/describe @@ -0,0 +1,82 @@ +NAME + gcloud beta compute instant-snapshot-groups describe - describe a Compute + Engine instant snapshot group + +SYNOPSIS + gcloud beta compute instant-snapshot-groups describe + INSTANT_SNAPSHOT_GROUP_NAME [--region=REGION | --zone=ZONE] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) gcloud beta compute instant-snapshot-groups describe displays all + data associated with a Compute Engine instant snapshot group in a project. + +EXAMPLES + To describe the instant snapshot group 'instant-snapshot-group-1' in zone + 'us-east1-a', run: + + $ gcloud beta compute instant-snapshot-groups describe \ + instant-snapshot-group-1 --zone=us-east1-a + +POSITIONAL ARGUMENTS + INSTANT_SNAPSHOT_GROUP_NAME + Name of the instant snapshot group to describe. + +FLAGS + At most one of these can be specified: + + --region=REGION + Region of the instant snapshot group to describe. If not specified, + you might be prompted to select a region (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/region property: + + $ gcloud config set compute/region REGION + + A list of regions can be fetched by running: + + $ gcloud compute regions list + + To unset the property, run: + + $ gcloud config unset compute/region + + Alternatively, the region can be stored in the environment variable + CLOUDSDK_COMPUTE_REGION. + + --zone=ZONE + Zone of the instant snapshot group to describe. If not specified and + the compute/zone property isn't set, you might be prompted to select + a zone (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/zone property: + + $ gcloud config set compute/zone ZONE + + A list of zones can be fetched by running: + + $ gcloud compute zones list + + To unset the property, run: + + $ gcloud config unset compute/zone + + Alternatively, the zone can be stored in the environment variable + CLOUDSDK_COMPUTE_ZONE. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha compute instant-snapshot-groups describe + diff --git a/gcloud/beta/compute/instant-snapshot-groups/help b/gcloud/beta/compute/instant-snapshot-groups/help new file mode 100644 index 000000000..b81f01e8d --- /dev/null +++ b/gcloud/beta/compute/instant-snapshot-groups/help @@ -0,0 +1,36 @@ +NAME + gcloud beta compute instant-snapshot-groups - create, list and delete + Compute Engine instant snapshot groups + +SYNOPSIS + gcloud beta compute instant-snapshot-groups COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Create, list and delete Compute Engine instant snapshot groups. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (BETA) Create a Compute Engine instant snapshot group. + + delete + (BETA) Delete a Compute Engine instant snapshot group. + + describe + (BETA) Describe a Compute Engine instant snapshot group. + + list + (BETA) List Google Compute Engine instant snapshot groups. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha compute instant-snapshot-groups + diff --git a/gcloud/beta/compute/instant-snapshot-groups/list b/gcloud/beta/compute/instant-snapshot-groups/list new file mode 100644 index 000000000..c0084a6cb --- /dev/null +++ b/gcloud/beta/compute/instant-snapshot-groups/list @@ -0,0 +1,96 @@ +NAME + gcloud beta compute instant-snapshot-groups list - list Google Compute + Engine instant snapshot groups + +SYNOPSIS + gcloud beta compute instant-snapshot-groups list + [--regions=[REGION,...] | --zones=[ZONE,...]] [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) gcloud beta compute instant-snapshot-groups list displays all Google + Compute Engine instant snapshot groups in a project. + + By default, instant snapshot groups from all regions and instant snapshot + groups from all zones are listed. The results can be narrowed down by + providing the --regions or --zones flag. + +EXAMPLES + To list all instant snapshot groups in a project in table form, run: + + $ gcloud beta compute instant-snapshot-groups list + + To list the URIs of all instant snapshot groups in a project, run: + + $ gcloud beta compute instant-snapshot-groups list --uri + + To list all instant snapshot groups in the us-central1 and europe-west1 + regions, given they are regional resources, run: + + $ gcloud beta compute instant-snapshot-groups list \ + --filter="region:( europe-west1 us-central1 )" + + To list all instant snapshot groups in zones us-central1-b and + europe-west1-d, given they are zonal resources, run: + + $ gcloud beta compute instant-snapshot-groups list \ + --filter="zone:( europe-west1-d us-central1-b )" + +FLAGS + At most one of these can be specified: + + --regions=[REGION,...] + If provided, only regional resources are shown. If arguments are + provided, only resources from the given regions are shown. + + --zones=[ZONE,...] + If provided, only zonal resources are shown. If arguments are + provided, only resources from the given zones are shown. + +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 + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha compute instant-snapshot-groups list + diff --git a/gcloud/beta/compute/interconnects/create b/gcloud/beta/compute/interconnects/create index 24ca94249..32d900659 100644 --- a/gcloud/beta/compute/interconnects/create +++ b/gcloud/beta/compute/interconnects/create @@ -125,8 +125,10 @@ OPTIONAL FLAGS interconnect. --subzone=SUBZONE - Subzone in the LOCATION specified by the --location flag. SUBZONE must - be one of: + (DEPRECATED) Subzone in the LOCATION specified by the --location flag. + + The --subzone flag is deprecated and will be removed in a future + release. SUBZONE must be one of: a Subzone a. diff --git a/gcloud/beta/compute/network-firewall-policies/rules/create b/gcloud/beta/compute/network-firewall-policies/rules/create index b1cc53233..17815de7d 100644 --- a/gcloud/beta/compute/network-firewall-policies/rules/create +++ b/gcloud/beta/compute/network-firewall-policies/rules/create @@ -95,12 +95,12 @@ OPTIONAL FLAGS --dest-region-codes=[DEST_REGION_CODES,...] Destination Region Code to match for this rule. Can only be specified if DIRECTION is egress. Cannot be specified when the source network - type is NON_INTERNET. + context is NON_INTERNET. --dest-threat-intelligence=[DEST_THREAT_INTELLIGENCE_LISTS,...] Destination Threat Intelligence lists to match for this rule. Can only be specified if DIRECTION is egress. Cannot be specified when source - network type is NON_INTERNET. The available lists can be found here: + network context is NON_INTERNET. The available lists can be found here: https://cloud.google.com/vpc/docs/firewall-policies-rule-details#threat-intelligence-fw-policy. --direction=DIRECTION @@ -161,8 +161,8 @@ OPTIONAL FLAGS --src-region-codes=[SOURCE_REGION_CODES,...] Source Region Code to match for this rule. Can only be specified if - DIRECTION is ingress. Cannot be specified when the source network type - is NON_INTERNET, VPC_NETWORK or INTRA_VPC. + DIRECTION is ingress. Cannot be specified when the source network + context is NON_INTERNET, VPC_NETWORK or INTRA_VPC. --src-secure-tags=[SOURCE_SECURE_TAGS,...] A list of instance secure tags indicating the set of instances on the @@ -178,8 +178,8 @@ OPTIONAL FLAGS --src-threat-intelligence=[SOURCE_THREAT_INTELLIGENCE_LISTS,...] Source Threat Intelligence lists to match for this rule. Can only be specified if DIRECTION is ingress. Cannot be specified when the source - network type is NON_INTERNET, VPC_NETWORK or INTRA_VPC. The available - lists can be found here: + network context is NON_INTERNET, VPC_NETWORK or INTRA_VPC. The + available lists can be found here: https://cloud.google.com/vpc/docs/firewall-policies-rule-details#threat-intelligence-fw-policy. --target-forwarding-rules=[TARGET_FORWARDING_RULES,...] diff --git a/gcloud/beta/compute/network-firewall-policies/rules/update b/gcloud/beta/compute/network-firewall-policies/rules/update index 5326f514c..6cf01c114 100644 --- a/gcloud/beta/compute/network-firewall-policies/rules/update +++ b/gcloud/beta/compute/network-firewall-policies/rules/update @@ -85,12 +85,12 @@ OPTIONAL FLAGS --dest-region-codes=[DEST_REGION_CODES,...] Destination Region Code to match for this rule. Can only be specified if DIRECTION is egress. Cannot be specified when the source network - type is NON_INTERNET. + context is NON_INTERNET. --dest-threat-intelligence=[DEST_THREAT_INTELLIGENCE_LISTS,...] Destination Threat Intelligence lists to match for this rule. Can only be specified if DIRECTION is egress. Cannot be specified when source - network type is NON_INTERNET. The available lists can be found here: + network context is NON_INTERNET. The available lists can be found here: https://cloud.google.com/vpc/docs/firewall-policies-rule-details#threat-intelligence-fw-policy. --direction=DIRECTION @@ -158,8 +158,8 @@ OPTIONAL FLAGS --src-region-codes=[SOURCE_REGION_CODES,...] Source Region Code to match for this rule. Can only be specified if - DIRECTION is ingress. Cannot be specified when the source network type - is NON_INTERNET, VPC_NETWORK or INTRA_VPC. + DIRECTION is ingress. Cannot be specified when the source network + context is NON_INTERNET, VPC_NETWORK or INTRA_VPC. --src-secure-tags=[SOURCE_SECURE_TAGS,...] A list of instance secure tags indicating the set of instances on the @@ -175,8 +175,8 @@ OPTIONAL FLAGS --src-threat-intelligence=[SOURCE_THREAT_INTELLIGENCE_LISTS,...] Source Threat Intelligence lists to match for this rule. Can only be specified if DIRECTION is ingress. Cannot be specified when the source - network type is NON_INTERNET, VPC_NETWORK or INTRA_VPC. The available - lists can be found here: + network context is NON_INTERNET, VPC_NETWORK or INTRA_VPC. The + available lists can be found here: https://cloud.google.com/vpc/docs/firewall-policies-rule-details#threat-intelligence-fw-policy. --target-forwarding-rules=[TARGET_FORWARDING_RULES,...] diff --git a/gcloud/beta/compute/os-config/patch-jobs/execute b/gcloud/beta/compute/os-config/patch-jobs/execute index b5ae1f2d2..c62676f2c 100644 --- a/gcloud/beta/compute/os-config/patch-jobs/execute +++ b/gcloud/beta/compute/os-config/patch-jobs/execute @@ -181,23 +181,22 @@ OPTIONAL FLAGS Never reboot the machine after the update completes. --skip-unpatchable-vms - If set, enables enhanced reporting for the patch job: + Enables enhanced reporting for the patch job. If this flag is set: - 1. Allows the patch job to skip unpatchable instances, reporting them - as SKIPPED. An instance can be unpatchable for two reasons: + 1. The patch job skips instances that cannot be patched and reports + them as SKIPPED. An instance cannot be patched for two reasons: + ◆ The instance runs Container-Optimized OS (COS), which cannot be + patched. + ◆ The instance is part of a managed instance group (MIG), and + patching MIG instances is disabled in the patch job's configuration + (--mig-instances-allowed flag is not set). - a. The instance runs Container-Optimized OS (COS), which cannot be - patched. + 2. The patch job is reported as SUCCEEDED if it completes without + errors, even if some instances are SKIPPED. - b. The instance is part of a managed instance group (MIG), and - patching MIG instances is disabled in the patch job's configuration - (`--mig-instances-allowed` flag is not set). - - 2. Reports the patch job as SUCCEEDED if it completes without errors, - even if some instances were SKIPPED. - - 3. Reports the patch job as COMPLETED_WITH_INACTIVE_VMS if it completes - without errors, but some instances were INACTIVE and were not patched. + 3. The patch job is reported as COMPLETED_WITH_INACTIVE_VMS if it + completes without errors, but does not patch instances that are + INACTIVE. Settings for machines running Apt: diff --git a/gcloud/beta/compute/rollouts/cancel b/gcloud/beta/compute/rollouts/cancel new file mode 100644 index 000000000..9d363b42d --- /dev/null +++ b/gcloud/beta/compute/rollouts/cancel @@ -0,0 +1,54 @@ +NAME + gcloud beta compute rollouts cancel - cancel a Google Compute Engine + rollout + +SYNOPSIS + gcloud beta compute rollouts cancel NAME [--rollback] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Cancel a Google Compute Engine rollout. + +EXAMPLES + To cancel a rollout named 'my-rollout', run: + + $ gcloud beta compute rollouts cancel my-rollout + +POSITIONAL ARGUMENTS + Rollout resource - Name of the rollout to cancel. This represents a Cloud + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument name on the command line with a fully specified + name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + NAME + ID of the rollout or fully qualified identifier for the rollout. + + To set the name attribute: + ▸ provide the argument name on the command line. + +FLAGS + --rollback + If true, then the ongoing rollout must be rolled back. Else, just + cancel the rollout without taking any further actions. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha compute rollouts cancel + diff --git a/gcloud/beta/compute/rollouts/delete b/gcloud/beta/compute/rollouts/delete new file mode 100644 index 000000000..4139f612b --- /dev/null +++ b/gcloud/beta/compute/rollouts/delete @@ -0,0 +1,48 @@ +NAME + gcloud beta compute rollouts delete - delete a Google Compute Engine + rollout + +SYNOPSIS + gcloud beta compute rollouts delete NAME [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Delete a Google Compute Engine rollout. + +EXAMPLES + To delete a rollout named 'my-rollout', run: + + $ gcloud beta compute rollouts delete my-rollout + +POSITIONAL ARGUMENTS + Rollout resource - Name of the rollout to delete. This represents a Cloud + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument name on the command line with a fully specified + name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + NAME + ID of the rollout or fully qualified identifier for the rollout. + + To set the name attribute: + ▸ provide the argument name on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha compute rollouts delete + diff --git a/gcloud/beta/compute/rollouts/describe b/gcloud/beta/compute/rollouts/describe new file mode 100644 index 000000000..cceae0b23 --- /dev/null +++ b/gcloud/beta/compute/rollouts/describe @@ -0,0 +1,52 @@ +NAME + gcloud beta compute rollouts describe - describe a rollout + +SYNOPSIS + gcloud beta compute rollouts describe ROLLOUT [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Describe a rollout. + +EXAMPLES + To retrieve a single rollout and print its properties, run the following + command: + + $ gcloud beta compute rollouts describe my-rollout + +POSITIONAL ARGUMENTS + Rollout resource - Name of the rollout you want to inspect. This + represents a Cloud resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument rollout on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + ROLLOUT + ID of the Rollout or fully qualified identifier for the Rollout. + + To set the rollout attribute: + ▸ provide the argument rollout on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the compute/beta API. The full documentation for this API + can be found at: https://cloud.google.com/compute/ + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha compute rollouts describe + diff --git a/gcloud/beta/compute/rollouts/help b/gcloud/beta/compute/rollouts/help new file mode 100644 index 000000000..1013294a5 --- /dev/null +++ b/gcloud/beta/compute/rollouts/help @@ -0,0 +1,35 @@ +NAME + gcloud beta compute rollouts - read and manipulate Compute Engine Rollouts + +SYNOPSIS + gcloud beta compute rollouts COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Read and manipulate Compute Engine Rollouts. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + cancel + (BETA) Cancel a Google Compute Engine rollout. + + delete + (BETA) Delete a Google Compute Engine rollout. + + describe + (BETA) Describe a rollout. + + list + (BETA) List Google Compute Engine Rollouts. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha compute rollouts + diff --git a/gcloud/beta/compute/rollouts/list b/gcloud/beta/compute/rollouts/list new file mode 100644 index 000000000..23626323f --- /dev/null +++ b/gcloud/beta/compute/rollouts/list @@ -0,0 +1,66 @@ +NAME + gcloud beta compute rollouts list - list Google Compute Engine Rollouts + +SYNOPSIS + gcloud beta compute rollouts list [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) List Google Compute Engine Rollouts in a project. + +EXAMPLES + To list all rollouts in your project, run: + + $ gcloud beta compute rollouts list + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the compute/beta API. The full documentation for this API + can be found at: https://cloud.google.com/compute/ + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha compute rollouts list + diff --git a/gcloud/beta/netapp/volumes/create b/gcloud/beta/netapp/volumes/create index f69d25bd0..59385d956 100644 --- a/gcloud/beta/netapp/volumes/create +++ b/gcloud/beta/netapp/volumes/create @@ -117,8 +117,8 @@ REQUIRED FLAGS unit is specified, GiB is assumed. --protocols=PROTOCOL,[PROTOCOL,...] - Type of File System protocols for the Cloud NetApp Files Volume. Valid - component values are: NFSV3, NFSV4, SMB. + Type of File System protocols for the Cloud NetApp Volume. Valid + component values are: NFSV3, NFSV4, SMB, ISCSI. Storage pool resource - The Storage Pool to associate with Volume. This represents a Cloud resource. (NOTE) Some attributes are not given diff --git a/gcloud/beta/netapp/volumes/update b/gcloud/beta/netapp/volumes/update index 9a73d44c2..4d51eb923 100644 --- a/gcloud/beta/netapp/volumes/update +++ b/gcloud/beta/netapp/volumes/update @@ -186,8 +186,8 @@ FLAGS squash-mode=SQUASH_MODE,anon-uid=ANON_UID --protocols=PROTOCOL,[PROTOCOL,...] - Type of File System protocols for the Cloud NetApp Files Volume. Valid - component values are: NFSV3, NFSV4, SMB. + Type of File System protocols for the Cloud NetApp Volume. Valid + component values are: NFSV3, NFSV4, SMB, ISCSI. --restricted-actions=RESTRICTED_ACTION,[...] Actions to be restricted for a volume. Valid restricted action options diff --git a/gcloud/beta/run/compose/up b/gcloud/beta/run/compose/up index 61f5aa51e..f409310f4 100644 --- a/gcloud/beta/run/compose/up +++ b/gcloud/beta/run/compose/up @@ -3,7 +3,8 @@ NAME SYNOPSIS gcloud beta run compose up [COMPOSE_FILE] [--[no-]allow-unauthenticated] - [--no-build] [--dry-run] [--region=REGION] [GCLOUD_WIDE_FLAG ...] + [--dry-run] [--region=REGION] [--build | --no-build] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Deploy to Cloud Run from compose specification. @@ -27,9 +28,6 @@ FLAGS may take a few moments to take effect. Use --allow-unauthenticated to enable and --no-allow-unauthenticated to disable. - --no-build - Skip building from source if applicable. - --dry-run If set to true, only validates the configuration. The configuration will not be applied. @@ -38,6 +36,14 @@ FLAGS Region in which the resource can be found. Alternatively, set the property [run/region]. + At most one of these can be specified: + + --build + Force build of images. + + --no-build + Skip building from source if applicable. + 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/workbench/executions/create b/gcloud/beta/workbench/executions/create index 46c75ac8e..f580e2e1e 100644 --- a/gcloud/beta/workbench/executions/create +++ b/gcloud/beta/workbench/executions/create @@ -241,5 +241,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud workbench executions create diff --git a/gcloud/beta/workbench/executions/delete b/gcloud/beta/workbench/executions/delete index bbe846e21..a984e8cd3 100644 --- a/gcloud/beta/workbench/executions/delete +++ b/gcloud/beta/workbench/executions/delete @@ -60,5 +60,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud workbench executions delete diff --git a/gcloud/beta/workbench/executions/describe b/gcloud/beta/workbench/executions/describe index 768c8f9a7..1480b0950 100644 --- a/gcloud/beta/workbench/executions/describe +++ b/gcloud/beta/workbench/executions/describe @@ -56,5 +56,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud workbench executions describe diff --git a/gcloud/beta/workbench/executions/help b/gcloud/beta/workbench/executions/help index 9c95c9098..333d3cdaa 100644 --- a/gcloud/beta/workbench/executions/help +++ b/gcloud/beta/workbench/executions/help @@ -28,5 +28,8 @@ COMMANDS (BETA) List your notebook execution jobs. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud workbench executions diff --git a/gcloud/beta/workbench/executions/list b/gcloud/beta/workbench/executions/list index eb80bb1c7..d1f7553da 100644 --- a/gcloud/beta/workbench/executions/list +++ b/gcloud/beta/workbench/executions/list @@ -74,5 +74,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud workbench executions list diff --git a/gcloud/beta/workbench/schedules/create b/gcloud/beta/workbench/schedules/create index 72ad60608..ce2e0e323 100644 --- a/gcloud/beta/workbench/schedules/create +++ b/gcloud/beta/workbench/schedules/create @@ -298,5 +298,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud workbench schedules create diff --git a/gcloud/beta/workbench/schedules/delete b/gcloud/beta/workbench/schedules/delete index 923e4a506..3bff3ee64 100644 --- a/gcloud/beta/workbench/schedules/delete +++ b/gcloud/beta/workbench/schedules/delete @@ -60,5 +60,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud workbench schedules delete diff --git a/gcloud/beta/workbench/schedules/describe b/gcloud/beta/workbench/schedules/describe index 383640a09..dfb8e31b9 100644 --- a/gcloud/beta/workbench/schedules/describe +++ b/gcloud/beta/workbench/schedules/describe @@ -55,5 +55,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud workbench schedules describe diff --git a/gcloud/beta/workbench/schedules/help b/gcloud/beta/workbench/schedules/help index e89a519a0..78723a280 100644 --- a/gcloud/beta/workbench/schedules/help +++ b/gcloud/beta/workbench/schedules/help @@ -37,5 +37,8 @@ COMMANDS (BETA) Update a schedule. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud workbench schedules diff --git a/gcloud/beta/workbench/schedules/list b/gcloud/beta/workbench/schedules/list index 2a6d202b8..d906a0eb9 100644 --- a/gcloud/beta/workbench/schedules/list +++ b/gcloud/beta/workbench/schedules/list @@ -76,5 +76,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud workbench schedules list diff --git a/gcloud/beta/workbench/schedules/pause b/gcloud/beta/workbench/schedules/pause index 8f7086a59..02d3b2f71 100644 --- a/gcloud/beta/workbench/schedules/pause +++ b/gcloud/beta/workbench/schedules/pause @@ -55,5 +55,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud workbench schedules pause diff --git a/gcloud/beta/workbench/schedules/resume b/gcloud/beta/workbench/schedules/resume index 075775340..5980c41b9 100644 --- a/gcloud/beta/workbench/schedules/resume +++ b/gcloud/beta/workbench/schedules/resume @@ -62,5 +62,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud workbench schedules resume diff --git a/gcloud/beta/workbench/schedules/update b/gcloud/beta/workbench/schedules/update index 43f609163..4de42115f 100644 --- a/gcloud/beta/workbench/schedules/update +++ b/gcloud/beta/workbench/schedules/update @@ -106,5 +106,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud workbench schedules update diff --git a/gcloud/compute/firewall-policies/rules/create b/gcloud/compute/firewall-policies/rules/create index 3f2b07578..6331cac5b 100644 --- a/gcloud/compute/firewall-policies/rules/create +++ b/gcloud/compute/firewall-policies/rules/create @@ -8,6 +8,7 @@ SYNOPSIS [--description=DESCRIPTION] [--dest-address-groups=[DEST_ADDRESS_GROUPS,...]] [--dest-fqdns=[DEST_FQDNS,...]] [--dest-ip-ranges=[DEST_IP_RANGE,...]] + [--dest-network-context=DEST_NETWORK_CONTEXT] [--dest-region-codes=[DEST_REGION_CODES,...]] [--dest-threat-intelligence=[DEST_THREAT_INTELLIGENCE_LISTS,...]] [--direction=DIRECTION] [--[no-]disabled] [--[no-]enable-logging] @@ -15,6 +16,8 @@ SYNOPSIS [--security-profile-group=SECURITY_PROFILE_GROUP] [--src-address-groups=[SOURCE_ADDRESS_GROUPS,...]] [--src-fqdns=[SOURCE_FQDNS,...]] [--src-ip-ranges=[SRC_IP_RANGE,...]] + [--src-network-context=SRC_NETWORK_CONTEXT] + [--src-networks=[SRC_NETWORKS,...]] [--src-region-codes=[SOURCE_REGION_CODES,...]] [--src-secure-tags=[SOURCE_SECURE_TAGS,...]] [--src-threat-intelligence=[SOURCE_THREAT_INTELLIGENCE_LISTS,...]] @@ -67,14 +70,21 @@ OPTIONAL FLAGS --dest-ip-ranges=[DEST_IP_RANGE,...] Destination IP ranges to match for this rule. + --dest-network-context=DEST_NETWORK_CONTEXT + Use this flag to indicate that the rule should match internet or + non-internet traffic. It applies to destination traffic for egress + rules. Valid values are INTERNET and NON_INTERNET. Use empty string to + clear the field. + --dest-region-codes=[DEST_REGION_CODES,...] Destination Region Code to match for this rule. Can only be specified - if DIRECTION is egress. + if DIRECTION is egress. Cannot be specified when the source network + context is NON_INTERNET. --dest-threat-intelligence=[DEST_THREAT_INTELLIGENCE_LISTS,...] Destination Threat Intelligence lists to match for this rule. Can only - be specified if DIRECTION is egress. The available lists can be found - here: + be specified if DIRECTION is egress. Cannot be specified when source + network context is NON_INTERNET. The available lists can be found here: https://cloud.google.com/vpc/docs/firewall-policies-rule-details#threat-intelligence-fw-policy. --direction=DIRECTION @@ -117,9 +127,22 @@ OPTIONAL FLAGS --src-ip-ranges=[SRC_IP_RANGE,...] Source IP ranges to match for this rule. + --src-network-context=SRC_NETWORK_CONTEXT + Use this flag to indicate that the rule should match internet, + non-internet traffic or traffic coming from the network specified by + --src-network. It applies to ingress rules. Valid values are INTERNET, + NON_INTERNET, VPC_NETWORKS and INTRA_VPC. Use empty string to clear the + field. + + --src-networks=[SRC_NETWORKS,...] + The source VPC networks to match for this rule. It can only be + specified when --src-network-type is VPC_NETWORKS. It applies to + ingress rules. It accepts full or partial URLs. + --src-region-codes=[SOURCE_REGION_CODES,...] Source Region Code to match for this rule. Can only be specified if - DIRECTION is ingress. + DIRECTION is ingress. Cannot be specified when the source network + context is NON_INTERNET, VPC_NETWORK or INTRA_VPC. --src-secure-tags=[SOURCE_SECURE_TAGS,...] A list of instance secure tags indicating the set of instances on the @@ -133,8 +156,9 @@ OPTIONAL FLAGS --src-threat-intelligence=[SOURCE_THREAT_INTELLIGENCE_LISTS,...] Source Threat Intelligence lists to match for this rule. Can only be - specified if DIRECTION is ingress. The available lists can be found - here: + specified if DIRECTION is ingress. Cannot be specified when the source + network context is NON_INTERNET, VPC_NETWORK or INTRA_VPC. The + available lists can be found here: https://cloud.google.com/vpc/docs/firewall-policies-rule-details#threat-intelligence-fw-policy. --target-resources=[TARGET_RESOURCES,...] diff --git a/gcloud/compute/firewall-policies/rules/update b/gcloud/compute/firewall-policies/rules/update index f383bd6d1..d1d557221 100644 --- a/gcloud/compute/firewall-policies/rules/update +++ b/gcloud/compute/firewall-policies/rules/update @@ -8,6 +8,7 @@ SYNOPSIS [--description=DESCRIPTION] [--dest-address-groups=[DEST_ADDRESS_GROUPS,...]] [--dest-fqdns=[DEST_FQDNS,...]] [--dest-ip-ranges=[DEST_IP_RANGE,...]] + [--dest-network-context=DEST_NETWORK_CONTEXT] [--dest-region-codes=[DEST_REGION_CODES,...]] [--dest-threat-intelligence=[DEST_THREAT_INTELLIGENCE_LISTS,...]] [--direction=DIRECTION] [--[no-]disabled] [--[no-]enable-logging] @@ -16,6 +17,8 @@ SYNOPSIS [--security-profile-group=SECURITY_PROFILE_GROUP] [--src-address-groups=[SOURCE_ADDRESS_GROUPS,...]] [--src-fqdns=[SOURCE_FQDNS,...]] [--src-ip-ranges=[SRC_IP_RANGE,...]] + [--src-network-context=SRC_NETWORK_CONTEXT] + [--src-networks=[SRC_NETWORKS,...]] [--src-region-codes=[SOURCE_REGION_CODES,...]] [--src-secure-tags=[SOURCE_SECURE_TAGS,...]] [--src-threat-intelligence=[SOURCE_THREAT_INTELLIGENCE_LISTS,...]] @@ -65,14 +68,21 @@ OPTIONAL FLAGS --dest-ip-ranges=[DEST_IP_RANGE,...] Destination IP ranges to match for this rule. + --dest-network-context=DEST_NETWORK_CONTEXT + Use this flag to indicate that the rule should match internet or + non-internet traffic. It applies to destination traffic for egress + rules. Valid values are INTERNET and NON_INTERNET. Use empty string to + clear the field. + --dest-region-codes=[DEST_REGION_CODES,...] Destination Region Code to match for this rule. Can only be specified - if DIRECTION is egress. + if DIRECTION is egress. Cannot be specified when the source network + context is NON_INTERNET. --dest-threat-intelligence=[DEST_THREAT_INTELLIGENCE_LISTS,...] Destination Threat Intelligence lists to match for this rule. Can only - be specified if DIRECTION is egress. The available lists can be found - here: + be specified if DIRECTION is egress. Cannot be specified when source + network context is NON_INTERNET. The available lists can be found here: https://cloud.google.com/vpc/docs/firewall-policies-rule-details#threat-intelligence-fw-policy. --direction=DIRECTION @@ -122,9 +132,22 @@ OPTIONAL FLAGS --src-ip-ranges=[SRC_IP_RANGE,...] Source IP ranges to match for this rule. + --src-network-context=SRC_NETWORK_CONTEXT + Use this flag to indicate that the rule should match internet, + non-internet traffic or traffic coming from the network specified by + --src-network. It applies to ingress rules. Valid values are INTERNET, + NON_INTERNET, VPC_NETWORKS and INTRA_VPC. Use empty string to clear the + field. + + --src-networks=[SRC_NETWORKS,...] + The source VPC networks to match for this rule. It can only be + specified when --src-network-type is VPC_NETWORKS. It applies to + ingress rules. It accepts full or partial URLs. + --src-region-codes=[SOURCE_REGION_CODES,...] Source Region Code to match for this rule. Can only be specified if - DIRECTION is ingress. + DIRECTION is ingress. Cannot be specified when the source network + context is NON_INTERNET, VPC_NETWORK or INTRA_VPC. --src-secure-tags=[SOURCE_SECURE_TAGS,...] A list of instance secure tags indicating the set of instances on the @@ -138,8 +161,9 @@ OPTIONAL FLAGS --src-threat-intelligence=[SOURCE_THREAT_INTELLIGENCE_LISTS,...] Source Threat Intelligence lists to match for this rule. Can only be - specified if DIRECTION is ingress. The available lists can be found - here: + specified if DIRECTION is ingress. Cannot be specified when the source + network context is NON_INTERNET, VPC_NETWORK or INTRA_VPC. The + available lists can be found here: https://cloud.google.com/vpc/docs/firewall-policies-rule-details#threat-intelligence-fw-policy. --target-resources=[TARGET_RESOURCES,...] diff --git a/gcloud/compute/instance-groups/managed/update b/gcloud/compute/instance-groups/managed/update index 15b5f2617..ed92335d6 100644 --- a/gcloud/compute/instance-groups/managed/update +++ b/gcloud/compute/instance-groups/managed/update @@ -24,7 +24,7 @@ SYNOPSIS [--stateful-internal-ip=[enabled], [auto-delete=AUTO-DELETE],[interface-name=INTERFACE-NAME]] [--stopped-size=STOPPED_SIZE] [--suspended-size=SUSPENDED_SIZE] - [--target-distribution-shape=SHAPE] + [--target-distribution-shape=SHAPE] [--template=TEMPLATE] [--clear-autohealing | --initial-delay=INITIAL_DELAY --health-check=HEALTH_CHECK | --http-health-check=HTTP_HEALTH_CHECK @@ -312,6 +312,13 @@ FLAGS instances does not differ by more than 1 between any two zones. Recommended for highly available serving workloads. + --template=TEMPLATE + Specifies the instance template that will replace the existing template + used by the MIG. The MIG then uses this new template to create + instances. Specifying the new template overrides any template versions + that you've set for the MIG. Specify either a global or a regional + instance template. + At most one of these can be specified: --clear-autohealing diff --git a/gcloud/compute/interconnects/create b/gcloud/compute/interconnects/create index 635bff832..4096324f7 100644 --- a/gcloud/compute/interconnects/create +++ b/gcloud/compute/interconnects/create @@ -121,8 +121,10 @@ OPTIONAL FLAGS interconnect. --subzone=SUBZONE - Subzone in the LOCATION specified by the --location flag. SUBZONE must - be one of: + (DEPRECATED) Subzone in the LOCATION specified by the --location flag. + + The --subzone flag is deprecated and will be removed in a future + release. SUBZONE must be one of: a Subzone a. diff --git a/gcloud/compute/network-firewall-policies/rules/create b/gcloud/compute/network-firewall-policies/rules/create index 3f2d26423..d333661db 100644 --- a/gcloud/compute/network-firewall-policies/rules/create +++ b/gcloud/compute/network-firewall-policies/rules/create @@ -8,12 +8,15 @@ SYNOPSIS --layer4-configs=[LAYER4_CONFIG,...] [--description=DESCRIPTION] [--dest-address-groups=[DEST_ADDRESS_GROUPS,...]] [--dest-fqdns=[DEST_FQDNS,...]] [--dest-ip-ranges=[DEST_IP_RANGE,...]] + [--dest-network-context=DEST_NETWORK_CONTEXT] [--dest-region-codes=[DEST_REGION_CODES,...]] [--dest-threat-intelligence=[DEST_THREAT_INTELLIGENCE_LISTS,...]] [--direction=DIRECTION] [--[no-]disabled] [--[no-]enable-logging] [--security-profile-group=SECURITY_PROFILE_GROUP] [--src-address-groups=[SOURCE_ADDRESS_GROUPS,...]] [--src-fqdns=[SOURCE_FQDNS,...]] [--src-ip-ranges=[SRC_IP_RANGE,...]] + [--src-network-context=SRC_NETWORK_CONTEXT] + [--src-networks=[SRC_NETWORKS,...]] [--src-region-codes=[SOURCE_REGION_CODES,...]] [--src-secure-tags=[SOURCE_SECURE_TAGS,...]] [--src-threat-intelligence=[SOURCE_THREAT_INTELLIGENCE_LISTS,...]] @@ -74,14 +77,21 @@ OPTIONAL FLAGS --dest-ip-ranges=[DEST_IP_RANGE,...] Destination IP ranges to match for this rule. + --dest-network-context=DEST_NETWORK_CONTEXT + Use this flag to indicate that the rule should match internet or + non-internet traffic. It applies to destination traffic for egress + rules. Valid values are INTERNET and NON_INTERNET. Use empty string to + clear the field. + --dest-region-codes=[DEST_REGION_CODES,...] Destination Region Code to match for this rule. Can only be specified - if DIRECTION is egress. + if DIRECTION is egress. Cannot be specified when the source network + context is NON_INTERNET. --dest-threat-intelligence=[DEST_THREAT_INTELLIGENCE_LISTS,...] Destination Threat Intelligence lists to match for this rule. Can only - be specified if DIRECTION is egress. The available lists can be found - here: + be specified if DIRECTION is egress. Cannot be specified when source + network context is NON_INTERNET. The available lists can be found here: https://cloud.google.com/vpc/docs/firewall-policies-rule-details#threat-intelligence-fw-policy. --direction=DIRECTION @@ -121,9 +131,22 @@ OPTIONAL FLAGS --src-secure-tags.Multiple IP address blocks can be specified if they are separated by commas. + --src-network-context=SRC_NETWORK_CONTEXT + Use this flag to indicate that the rule should match internet, + non-internet traffic or traffic coming from the network specified by + --src-networks. It applies to ingress rules. Valid values are INTERNET, + NON_INTERNET, VPC_NETWORKS and INTRA_VPC. Use empty string to clear the + field. + + --src-networks=[SRC_NETWORKS,...] + The source VPC networks to match for this rule. It can only be + specified when --src-network-type is VPC_NETWORKS. It applies to + ingress rules. It accepts full or partial URLs. + --src-region-codes=[SOURCE_REGION_CODES,...] Source Region Code to match for this rule. Can only be specified if - DIRECTION is ingress. + DIRECTION is ingress. Cannot be specified when the source network + context is NON_INTERNET, VPC_NETWORK or INTRA_VPC. --src-secure-tags=[SOURCE_SECURE_TAGS,...] A list of instance secure tags indicating the set of instances on the @@ -137,8 +160,9 @@ OPTIONAL FLAGS --src-threat-intelligence=[SOURCE_THREAT_INTELLIGENCE_LISTS,...] Source Threat Intelligence lists to match for this rule. Can only be - specified if DIRECTION is ingress. The available lists can be found - here: + specified if DIRECTION is ingress. Cannot be specified when the source + network context is NON_INTERNET, VPC_NETWORK or INTRA_VPC. The + available lists can be found here: https://cloud.google.com/vpc/docs/firewall-policies-rule-details#threat-intelligence-fw-policy. --target-secure-tags=[TARGET_SECURE_TAGS,...] diff --git a/gcloud/compute/network-firewall-policies/rules/update b/gcloud/compute/network-firewall-policies/rules/update index 1d354cc08..e75baffa1 100644 --- a/gcloud/compute/network-firewall-policies/rules/update +++ b/gcloud/compute/network-firewall-policies/rules/update @@ -8,6 +8,7 @@ SYNOPSIS [--description=DESCRIPTION] [--dest-address-groups=[DEST_ADDRESS_GROUPS,...]] [--dest-fqdns=[DEST_FQDNS,...]] [--dest-ip-ranges=[DEST_IP_RANGE,...]] + [--dest-network-context=DEST_NETWORK_CONTEXT] [--dest-region-codes=[DEST_REGION_CODES,...]] [--dest-threat-intelligence=[DEST_THREAT_INTELLIGENCE_LISTS,...]] [--direction=DIRECTION] [--[no-]disabled] [--[no-]enable-logging] @@ -15,6 +16,8 @@ SYNOPSIS [--security-profile-group=SECURITY_PROFILE_GROUP] [--src-address-groups=[SOURCE_ADDRESS_GROUPS,...]] [--src-fqdns=[SOURCE_FQDNS,...]] [--src-ip-ranges=[SRC_IP_RANGE,...]] + [--src-network-context=SRC_NETWORK_CONTEXT] + [--src-networks=[SRC_NETWORKS,...]] [--src-region-codes=[SOURCE_REGION_CODES,...]] [--src-secure-tags=[SOURCE_SECURE_TAGS,...]] [--src-threat-intelligence=[SOURCE_THREAT_INTELLIGENCE_LISTS,...]] @@ -64,6 +67,12 @@ OPTIONAL FLAGS --dest-ip-ranges=[DEST_IP_RANGE,...] Destination IP ranges to match for this rule. + --dest-network-context=DEST_NETWORK_CONTEXT + Use this flag to indicate that the rule should match internet or + non-internet traffic. It applies to destination traffic for egress + rules. Valid values are INTERNET and NON_INTERNET. Use empty string to + clear the field. + --dest-region-codes=[DEST_REGION_CODES,...] Destination Region Code to match for this rule. Can only be specified if DIRECTION is egress. @@ -118,6 +127,18 @@ OPTIONAL FLAGS --src-secure-tags.Multiple IP address blocks can be specified if they are separated by commas. + --src-network-context=SRC_NETWORK_CONTEXT + Use this flag to indicate that the rule should match internet, + non-internet traffic or traffic coming from the network specified by + --src-networks. It applies to ingress rules. Valid values are INTERNET, + NON_INTERNET, VPC_NETWORKS and INTRA_VPC. Use empty string to clear the + field. + + --src-networks=[SRC_NETWORKS,...] + The source VPC networks to match for this rule. It can only be + specified when --src-network-type is VPC_NETWORKS. It applies to + ingress rules. It accepts full or partial URLs. + --src-region-codes=[SOURCE_REGION_CODES,...] Source Region Code to match for this rule. Can only be specified if DIRECTION is ingress. diff --git a/gcloud/compute/os-config/patch-jobs/execute b/gcloud/compute/os-config/patch-jobs/execute index 2632337f0..d2536e0bb 100644 --- a/gcloud/compute/os-config/patch-jobs/execute +++ b/gcloud/compute/os-config/patch-jobs/execute @@ -181,23 +181,22 @@ OPTIONAL FLAGS Never reboot the machine after the update completes. --skip-unpatchable-vms - If set, enables enhanced reporting for the patch job: + Enables enhanced reporting for the patch job. If this flag is set: - 1. Allows the patch job to skip unpatchable instances, reporting them - as SKIPPED. An instance can be unpatchable for two reasons: + 1. The patch job skips instances that cannot be patched and reports + them as SKIPPED. An instance cannot be patched for two reasons: + ◆ The instance runs Container-Optimized OS (COS), which cannot be + patched. + ◆ The instance is part of a managed instance group (MIG), and + patching MIG instances is disabled in the patch job's configuration + (--mig-instances-allowed flag is not set). - a. The instance runs Container-Optimized OS (COS), which cannot be - patched. + 2. The patch job is reported as SUCCEEDED if it completes without + errors, even if some instances are SKIPPED. - b. The instance is part of a managed instance group (MIG), and - patching MIG instances is disabled in the patch job's configuration - (`--mig-instances-allowed` flag is not set). - - 2. Reports the patch job as SUCCEEDED if it completes without errors, - even if some instances were SKIPPED. - - 3. Reports the patch job as COMPLETED_WITH_INACTIVE_VMS if it completes - without errors, but some instances were INACTIVE and were not patched. + 3. The patch job is reported as COMPLETED_WITH_INACTIVE_VMS if it + completes without errors, but does not patch instances that are + INACTIVE. Settings for machines running Apt: diff --git a/gcloud/container/ai/profiles/manifests/create b/gcloud/container/ai/profiles/manifests/create index a2a807b8e..58810553d 100644 --- a/gcloud/container/ai/profiles/manifests/create +++ b/gcloud/container/ai/profiles/manifests/create @@ -56,9 +56,8 @@ OPTIONAL FLAGS terminal. --serving-stack=SERVING_STACK - The serving stack to filter manifests by. If not provided, manifests - for all serving stacks that support the given model and model server - will be considered. + The serving stack to filter manifests by. If not provided, will default + to none. --serving-stack-version=SERVING_STACK_VERSION The serving stack version to filter manifests by. If not provided, diff --git a/gcloud/eventarc/triggers/create b/gcloud/eventarc/triggers/create index 732133532..263fa808a 100644 --- a/gcloud/eventarc/triggers/create +++ b/gcloud/eventarc/triggers/create @@ -208,8 +208,8 @@ OPTIONAL FLAGS contain only hyphens (-), underscores (_), lowercase characters, and numbers. - The retry policy configuration for the trigger. Can only be set for Cloud - Run destinations. + The retry policy configuration for the trigger. Can only be set for Cloud + Run destinations. --max-retry-attempts=MAX_RETRY_ATTEMPTS The maximum number of delivery attempts. The only valid value is 1. diff --git a/gcloud/eventarc/triggers/update b/gcloud/eventarc/triggers/update index d137f0376..317b17563 100644 --- a/gcloud/eventarc/triggers/update +++ b/gcloud/eventarc/triggers/update @@ -6,9 +6,9 @@ SYNOPSIS [--event-data-content-type=EVENT_DATA_CONTENT_TYPE] [--event-filters=[ATTRIBUTE=VALUE,...]] [--event-filters-path-pattern=[ATTRIBUTE=PATH_PATTERN,...]] - [--max-retry-attempts=MAX_RETRY_ATTEMPTS] [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] + [--clear-max-retry-attempts | --max-retry-attempts=MAX_RETRY_ATTEMPTS] [--clear-service-account | --service-account=SERVICE_ACCOUNT] [--destination-gke-namespace=DESTINATION_GKE_NAMESPACE --destination-gke-service=DESTINATION_GKE_SERVICE @@ -92,12 +92,6 @@ FLAGS destination. Currently, path pattern format is only available for the resourceName attribute for Cloud Audit Log events. - The retry policy configuration for the trigger. Can only be set for Cloud - Run destinations. - - --max-retry-attempts=MAX_RETRY_ATTEMPTS - The maximum number of delivery attempts. The only valid value is 1. - --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. @@ -127,6 +121,17 @@ FLAGS silently ignored. If --update-labels is also specified then --update-labels is applied first. + The retry policy configuration for the trigger. Can only be set for Cloud + Run destinations. + + At most one of these can be specified: + + --clear-max-retry-attempts + Clear the maximum number of delivery attempts for the trigger. + + --max-retry-attempts=MAX_RETRY_ATTEMPTS + The maximum number of delivery attempts. The only valid value is 1. + At most one of these can be specified: --clear-service-account diff --git a/gcloud/feedback b/gcloud/feedback index ddfe488e5..c12bb5978 100644 --- a/gcloud/feedback +++ b/gcloud/feedback @@ -8,7 +8,6 @@ DESCRIPTION The Google Cloud CLI team offers support through a number of channels: ▪ Google Cloud CLI Issue Tracker - ▪ Stack Overflow "#gcloud" tag ▪ google-cloud-dev Google group This command lists the available channels and facilitates getting help diff --git a/gcloud/netapp/volumes/create b/gcloud/netapp/volumes/create index 8dd79b198..9c2878e2e 100644 --- a/gcloud/netapp/volumes/create +++ b/gcloud/netapp/volumes/create @@ -117,8 +117,8 @@ REQUIRED FLAGS unit is specified, GiB is assumed. --protocols=PROTOCOL,[PROTOCOL,...] - Type of File System protocols for the Cloud NetApp Files Volume. Valid - component values are: NFSV3, NFSV4, SMB. + Type of File System protocols for the Cloud NetApp Volume. Valid + component values are: NFSV3, NFSV4, SMB, ISCSI. Storage pool resource - The Storage Pool to associate with Volume. This represents a Cloud resource. (NOTE) Some attributes are not given diff --git a/gcloud/netapp/volumes/update b/gcloud/netapp/volumes/update index 0040a072c..0842e3359 100644 --- a/gcloud/netapp/volumes/update +++ b/gcloud/netapp/volumes/update @@ -186,8 +186,8 @@ FLAGS squash-mode=SQUASH_MODE,anon-uid=ANON_UID --protocols=PROTOCOL,[PROTOCOL,...] - Type of File System protocols for the Cloud NetApp Files Volume. Valid - component values are: NFSV3, NFSV4, SMB. + Type of File System protocols for the Cloud NetApp Volume. Valid + component values are: NFSV3, NFSV4, SMB, ISCSI. --restricted-actions=RESTRICTED_ACTION,[...] Actions to be restricted for a volume. Valid restricted action options diff --git a/gcloud/sql/flags/list b/gcloud/sql/flags/list index 05eeb5e7a..ab19ab011 100644 --- a/gcloud/sql/flags/list +++ b/gcloud/sql/flags/list @@ -24,7 +24,9 @@ FLAGS SQLSERVER_2017_WEB, SQLSERVER_2017_STANDARD, SQLSERVER_2017_ENTERPRISE, SQLSERVER_2019_EXPRESS, SQLSERVER_2019_WEB, SQLSERVER_2019_STANDARD, SQLSERVER_2019_ENTERPRISE, SQLSERVER_2022_EXPRESS, SQLSERVER_2022_WEB, - SQLSERVER_2022_STANDARD, SQLSERVER_2022_ENTERPRISE. + SQLSERVER_2022_STANDARD, SQLSERVER_2022_ENTERPRISE, + SQLSERVER_2025_EXPRESS, SQLSERVER_2025_STANDARD, + SQLSERVER_2025_ENTERPRISE. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/sql/instances/create b/gcloud/sql/instances/create index c9b134dc0..4d7d8bdef 100644 --- a/gcloud/sql/instances/create +++ b/gcloud/sql/instances/create @@ -271,7 +271,9 @@ FLAGS SQLSERVER_2017_WEB, SQLSERVER_2017_STANDARD, SQLSERVER_2017_ENTERPRISE, SQLSERVER_2019_EXPRESS, SQLSERVER_2019_WEB, SQLSERVER_2019_STANDARD, SQLSERVER_2019_ENTERPRISE, SQLSERVER_2022_EXPRESS, SQLSERVER_2022_WEB, - SQLSERVER_2022_STANDARD, SQLSERVER_2022_ENTERPRISE. + SQLSERVER_2022_STANDARD, SQLSERVER_2022_ENTERPRISE, + SQLSERVER_2025_EXPRESS, SQLSERVER_2025_STANDARD, + SQLSERVER_2025_ENTERPRISE. --[no-]deletion-protection Enable deletion protection on a Cloud SQL instance. Use diff --git a/gcloud/sql/instances/patch b/gcloud/sql/instances/patch index 4c4599919..68f0705f0 100644 --- a/gcloud/sql/instances/patch +++ b/gcloud/sql/instances/patch @@ -211,7 +211,9 @@ FLAGS SQLSERVER_2017_WEB, SQLSERVER_2017_STANDARD, SQLSERVER_2017_ENTERPRISE, SQLSERVER_2019_EXPRESS, SQLSERVER_2019_WEB, SQLSERVER_2019_STANDARD, SQLSERVER_2019_ENTERPRISE, SQLSERVER_2022_EXPRESS, SQLSERVER_2022_WEB, - SQLSERVER_2022_STANDARD, SQLSERVER_2022_ENTERPRISE. + SQLSERVER_2022_STANDARD, SQLSERVER_2022_ENTERPRISE, + SQLSERVER_2025_EXPRESS, SQLSERVER_2025_STANDARD, + SQLSERVER_2025_ENTERPRISE. --[no-]deletion-protection Enable deletion protection on a Cloud SQL instance. Use diff --git a/gcloud/workbench/executions/create b/gcloud/workbench/executions/create new file mode 100644 index 000000000..932f09283 --- /dev/null +++ b/gcloud/workbench/executions/create @@ -0,0 +1,246 @@ +NAME + gcloud workbench executions create - create a Workbench execution + +SYNOPSIS + gcloud workbench executions create --region=REGION + (--display-name=DISPLAY_NAME --gcs-output-uri=GCS_OUTPUT_URI + --service-account=SERVICE_ACCOUNT (--direct-content=DIRECT_CONTENT + | [--gcs-notebook-uri=GCS_NOTEBOOK_URI : --generation=GENERATION]) + : --execution-timeout=EXECUTION_TIMEOUT; default="24h" + --kernel-name=KERNEL_NAME; default="python3" + --accelerator-count=ACCELERATOR_COUNT + --accelerator-type=ACCELERATOR_TYPE --machine-type=MACHINE_TYPE; + default="e2-standard-4" --disk-size-gb=DISK_SIZE_GB; default=100 + --disk-type=DISK_TYPE; default="PD_STANDARD" + --no-enable-internet-access + --network=NETWORK [--subnetwork=SUBNETWORK + : --subnetwork-region=SUBNETWORK_REGION] [--kms-key=KMS_KEY + : --kms-keyring=KMS_KEYRING + --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT]) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create a Workbench notebook execution. + +EXAMPLES + To create an execution of a notebook file with Cloud Storage URI + gs://my-bucket/my-notebook.ipynb, with an execution job display name + my-execution, running with service account + my-service-account@my-project.iam.gserviceaccount.com, with results + uploaded to Cloud Storage bucket gs://my-bucket/results, and in region + us-central1, with a compute configuration of n1-standard-4 machine type: + + $ gcloud workbench executions create --display-name=my-execution \ + --gcs-notebook-uri=gs://my-bucket/my-notebook.ipynb \ + --service-account=my-service-account@my-project.iam.gserviceacco\ + unt.com --gcs-output-uri=gs://my-bucket/results \ + --region=us-central1 --machine-type=n1-standard-4 + +REQUIRED FLAGS + Region resource - Cloud region to create. This represents a Cloud + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument --region on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --region=REGION + ID of the region or fully qualified identifier for the region. + + To set the region attribute: + ▸ provide the argument --region on the command line. + + Configuration of the execution job. + + This must be specified. + + --display-name=DISPLAY_NAME + The display name of the execution. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --gcs-output-uri=GCS_OUTPUT_URI + The Cloud Storage location to upload notebook execution results to. + Format: gs://bucket-name. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --service-account=SERVICE_ACCOUNT + The service account to run the execution as + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --execution-timeout=EXECUTION_TIMEOUT; default="24h" + The max running time of the execution job, as a duration. See '$ + gcloud topic datetimes' for details on formatting the input duration. + + --kernel-name=KERNEL_NAME; default="python3" + The kernel name to use for the execution. + + Source of the notebook to execute. + + Exactly one of these must be specified: + + --direct-content=DIRECT_CONTENT + The direct notebook content as IPYNB. This can be a local filepath + to an .ipynb file or can be set to - to read content from stdin. + + Or at least one of these can be specified: + + The Cloud Storage notebook source. + + --gcs-notebook-uri=GCS_NOTEBOOK_URI + The Cloud Storage uri pointing to the notebook. Format: + gs://bucket/notebook_file.ipynb + + This flag argument must be specified if any of the other + arguments in this group are specified. + + --generation=GENERATION + The version of the Cloud Storage object to read. If unset, the + current version of the object will be used. + + Compute configuration of the execution job. + + The machine configuration of the runtime. + + --accelerator-count=ACCELERATOR_COUNT + The number of accelerators used by the runtime. + + --accelerator-type=ACCELERATOR_TYPE + The type of hardware accelerator used by the runtime. If specified, + --accelerator-count must also be specified. ACCELERATOR_TYPE must be + one of: NVIDIA_TESLA_V100, NVIDIA_TESLA_T4, NVIDIA_TESLA_A100, + NVIDIA_A100_80GB, NVIDIA_L4. + + --machine-type=MACHINE_TYPE; default="e2-standard-4" + The Compute Engine machine type selected for the runtime. + + The configuration for the data disk of the runtime. + + --disk-size-gb=DISK_SIZE_GB; default=100 + The disk size of the runtime in GB. If specified, the --disk-type + must also be specified. The minimum size is 10GB and the maximum is + 65536GB. + + --disk-type=DISK_TYPE; default="PD_STANDARD" + The type of the persistent disk. DISK_TYPE must be one of: + PD_STANDARD, PD_SSD, PD_BALANCED, PD_EXTREME. + + The network configuration for the runtime. + + --enable-internet-access + Enable public internet access for the runtime. Enabled by default, + use --no-enable-internet-access to disable. + + Network resource - The name of the VPC that this runtime is in. This + represents a Cloud resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ▸ provide the argument --network on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + --network=NETWORK + ID of the network or fully qualified identifier for the network. + + To set the network attribute: + ▸ provide the argument --network on the command line. + + Subnetwork resource - The name of the subnetwork that this runtime is + in. The arguments in this group can be used to specify the attributes of + this resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. + + To set the project attribute: + ▸ provide the argument --subnetwork on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + --subnetwork=SUBNETWORK + ID of the subnetwork or fully qualified identifier for the + subnetwork. + + To set the subnetwork attribute: + ▸ provide the argument --subnetwork on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --subnetwork-region=SUBNETWORK_REGION + Google Cloud region of this subnetwork + https://cloud.google.com/compute/docs/regions-zones/#locations. + + To set the subnetwork-region attribute: + ▸ provide the argument --subnetwork on the command line with a + fully specified name; + ▸ provide the argument --subnetwork-region on the command line. + + Key resource - The Cloud KMS encryption key (customer-managed encryption + key) used to protect the execution. The key must be in the same region + as the execution. If not specified, Google-managed encryption will be + used. The arguments in this group can be used to specify the attributes + of this resource. + + --kms-key=KMS_KEY + ID of the key or fully qualified identifier for the key. + + To set the kms-key attribute: + ▸ provide the argument --kms-key on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --kms-keyring=KMS_KEYRING + KMS keyring id of the key. + + To set the kms-keyring attribute: + ▸ provide the argument --kms-key on the command line with a fully + specified name; + ▸ provide the argument --kms-keyring on the command line. + + --kms-location=KMS_LOCATION + Cloud location for the key. + + To set the kms-location attribute: + ▸ provide the argument --kms-key on the command line with a fully + specified name; + ▸ provide the argument --kms-location on the command line. + + --kms-project=KMS_PROJECT + Cloud project id for the key. + + To set the kms-project attribute: + ▸ provide the argument --kms-key on the command line with a fully + specified name; + ▸ provide the argument --kms-project on the command line. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud beta workbench executions create + diff --git a/gcloud/workbench/executions/delete b/gcloud/workbench/executions/delete new file mode 100644 index 000000000..120b4c72b --- /dev/null +++ b/gcloud/workbench/executions/delete @@ -0,0 +1,66 @@ +NAME + gcloud workbench executions delete - delete an execution + +SYNOPSIS + gcloud workbench executions delete (EXECUTION : --region=REGION) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete a Workbench notebook execution. + +EXAMPLES + To delete an execution with id my-execution, in region us-central1, run: + + $ gcloud workbench executions delete my-execution \ + --region=us-central1 + +POSITIONAL ARGUMENTS + Notebook execution job resource - Unique resource name of the execution to + delete. The arguments in this group can be used to specify the attributes + of this resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument execution on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + EXECUTION + ID of the notebook execution job or fully qualified identifier for + the notebook execution job. + + To set the name attribute: + ▸ provide the argument execution on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Cloud region for the notebook execution job. + + To set the region attribute: + ▸ provide the argument execution on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud beta workbench executions delete + diff --git a/gcloud/workbench/executions/describe b/gcloud/workbench/executions/describe new file mode 100644 index 000000000..307cc68cb --- /dev/null +++ b/gcloud/workbench/executions/describe @@ -0,0 +1,62 @@ +NAME + gcloud workbench executions describe - describe an execution + +SYNOPSIS + gcloud workbench executions describe (EXECUTION : --region=REGION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe a Workbench notebook execution. + +EXAMPLES + To describe a notebook execution with id my-execution in region + us-central1, run: + + $ gcloud workbench executions describe my-execution \ + --region=us-central1 + +POSITIONAL ARGUMENTS + Notebook execution job resource - Unique resource name of the execution to + describe. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument execution on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + EXECUTION + ID of the notebook execution job or fully qualified identifier for + the notebook execution job. + + To set the name attribute: + ▸ provide the argument execution on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Cloud region for the notebook execution job. + + To set the region attribute: + ▸ provide the argument execution on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud beta workbench executions describe + diff --git a/gcloud/workbench/executions/help b/gcloud/workbench/executions/help new file mode 100644 index 000000000..3030e2618 --- /dev/null +++ b/gcloud/workbench/executions/help @@ -0,0 +1,34 @@ +NAME + gcloud workbench executions - workbench executions command group + +SYNOPSIS + gcloud workbench executions COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Workbench executions command group. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + Create a Workbench execution. + + delete + Delete an execution. + + describe + Describe an execution. + + list + List your notebook execution jobs. + +NOTES + This variant is also available: + + $ gcloud beta workbench executions + diff --git a/gcloud/workbench/executions/list b/gcloud/workbench/executions/list new file mode 100644 index 000000000..fe83a0c7e --- /dev/null +++ b/gcloud/workbench/executions/list @@ -0,0 +1,80 @@ +NAME + gcloud workbench executions list - list your notebook execution jobs + +SYNOPSIS + gcloud workbench executions list --region=REGION [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List your project's Workbench executions in a given region. + +EXAMPLES + To list your executions in region us-central1, run: + + $ gcloud workbench executions list --region=us-central1 + +REQUIRED FLAGS + Region resource - Cloud region for which to list all executions. This + represents a Cloud resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --region on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --region=REGION + ID of the region or fully qualified identifier for the region. + + To set the region attribute: + ▸ provide the argument --region on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud beta workbench executions list + diff --git a/gcloud/workbench/help b/gcloud/workbench/help index 877106323..4165174d1 100644 --- a/gcloud/workbench/help +++ b/gcloud/workbench/help @@ -15,9 +15,15 @@ GCLOUD WIDE FLAGS GROUPS GROUP is one of the following: + executions + Workbench executions command group. + instances Workbench Instances command group. + schedules + Workbench schedules command group. + NOTES This variant is also available: diff --git a/gcloud/workbench/schedules/create b/gcloud/workbench/schedules/create new file mode 100644 index 000000000..506841dab --- /dev/null +++ b/gcloud/workbench/schedules/create @@ -0,0 +1,304 @@ +NAME + gcloud workbench schedules create - create a schedule + +SYNOPSIS + gcloud workbench schedules create --region=REGION + (--cron-schedule=CRON_SCHEDULE --display-name=DISPLAY_NAME + (--execution-display-name=EXECUTION_DISPLAY_NAME + --gcs-output-uri=GCS_OUTPUT_URI --service-account=SERVICE_ACCOUNT + ([--gcs-notebook-uri=GCS_NOTEBOOK_URI : --generation=GENERATION]) + : --execution-timeout=EXECUTION_TIMEOUT; default="24h" + --kernel-name=KERNEL_NAME; default="python3" + --accelerator-count=ACCELERATOR_COUNT + --accelerator-type=ACCELERATOR_TYPE --machine-type=MACHINE_TYPE; + default="e2-standard-4" --disk-size-gb=DISK_SIZE_GB; default=100 + --disk-type=DISK_TYPE; default="PD_STANDARD" + --no-enable-internet-access + --network=NETWORK [--subnetwork=SUBNETWORK + : --subnetwork-region=SUBNETWORK_REGION] [--kms-key=KMS_KEY + : --kms-keyring=KMS_KEYRING + --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT]) + : --enable-queueing --end-time=END_TIME + --max-concurrent-runs=MAX_CONCURRENT_RUNS; + default=1 --max-runs=MAX_RUNS --start-time=START_TIME) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create a schedule to run a Workbench notebook execution job. + +EXAMPLES + To create a schedule in region us-central1 with the following schedule + properties: + ▪ display name: my-schedule, + ▪ cron schedule: TZ=America/Los_Angeles * * * * *, + ▪ maximum concurrent runs allowed: 1, + ▪ start time: 2025-01-01T00:00:00-06:00, + + for a notebook execution job: + ▪ with display name my-execution, + ▪ running notebook file from Cloud Storage URI + gs://my-bucket/my-notebook.ipynb, + ▪ running with service account + my-service-account@my-project.iam.gserviceaccount.com, + ▪ with results uploaded to Cloud Storage bucket gs://my-bucket/results + ▪ with machine type n1-standard-4, + + Run the following command: $ gcloud workbench schedules create --region=us-central1 \ + --display-name=my-schedule \ + --cron-schedule='TZ=America/Los_Angeles * * * * *' \ + --max-concurrent-runs=1 --start-time=2025-01-01T00:00:00-06:00 \ + --execution-display-name=my-execution \ + --gcs-notebook-uri=gs://my-bucket/my-notebook.ipynb \ + --service-account=my-service-account@my-project.iam.gserviceacco\ + unt.com --gcs-output-uri=gs://my-bucket/results \ + --machine-type=n1-standard-4 + +REQUIRED FLAGS + Region resource - Cloud region to create. This represents a Cloud + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument --region on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --region=REGION + ID of the region or fully qualified identifier for the region. + + To set the region attribute: + ▸ provide the argument --region on the command line. + + Configuration of the schedule. + + This must be specified. + + --cron-schedule=CRON_SCHEDULE + Cron schedule (https://en.wikipedia.org/wiki/Cron) to launch + scheduled runs. To explicitly set a timezone to the cron tab, apply a + prefix in the cron tab: "CRON_TZ=${IANA_TIME_ZONE}" or + "TZ=${IANA_TIME_ZONE}". The ${IANA_TIME_ZONE} may only be a valid + string from IANA time zone database. For example, + "CRON_TZ=America/New_York 1 * * * ", or "TZ=America/New_York 1 * * * + ". + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --display-name=DISPLAY_NAME + The display name of the schedule. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --enable-queueing + Enables new scheduled runs to be queued when max_concurrent_runs + limit is reached. If set to true, new runs will be queued instead of + skipped. + + --end-time=END_TIME + Timestamp after which no new runs can be scheduled. If specified, the + schedule will be completed when either end_time is reached or when + scheduled_run_count >= max_run_count. If neither end time nor + max_run_count is specified, new runs will keep getting scheduled + until this Schedule is paused or deleted. Must be in the RFC 3339 + (https://www.rfc-editor.org/rfc/rfc3339.txt) format. E.g. + "2026-01-01T00:00:00Z" or "2026-01-01T00:00:00-05:00" + + --max-concurrent-runs=MAX_CONCURRENT_RUNS; default=1 + Maximum number of runs that can be started concurrently for this + Schedule. This is the limit for starting the scheduled requests and + not the execution of the notebook execution jobs created by the + requests. + + --max-runs=MAX_RUNS + The max runs for the schedule. + + --start-time=START_TIME + The timestamp after which the first run can be scheduled. Defaults to + the schedule creation time. Must be in the RFC 3339 + (https://www.rfc-editor.org/rfc/rfc3339.txt) format. E.g. + "2026-01-01T00:00:00Z" or "2026-01-01T00:00:00-05:00" + + Configuration of the execution job. + + This must be specified. + + --execution-display-name=EXECUTION_DISPLAY_NAME + The display name of the execution. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --gcs-output-uri=GCS_OUTPUT_URI + The Cloud Storage location to upload notebook execution results to. + Format: gs://bucket-name. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --service-account=SERVICE_ACCOUNT + The service account to run the execution as + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --execution-timeout=EXECUTION_TIMEOUT; default="24h" + The max running time of the execution job, as a duration. See '$ + gcloud topic datetimes' for details on formatting the input + duration. + + --kernel-name=KERNEL_NAME; default="python3" + The kernel name to use for the execution. + + Source of the notebook to execute. + + This must be specified. + + The Cloud Storage notebook source. + + --gcs-notebook-uri=GCS_NOTEBOOK_URI + The Cloud Storage uri pointing to the notebook. Format: + gs://bucket/notebook_file.ipynb + + This flag argument must be specified if any of the other + arguments in this group are specified. + + --generation=GENERATION + The version of the Cloud Storage object to read. If unset, the + current version of the object will be used. + + Compute configuration of the execution job. + + The machine configuration of the runtime. + + --accelerator-count=ACCELERATOR_COUNT + The number of accelerators used by the runtime. + + --accelerator-type=ACCELERATOR_TYPE + The type of hardware accelerator used by the runtime. If specified, + --accelerator-count must also be specified. ACCELERATOR_TYPE must + be one of: NVIDIA_TESLA_V100, NVIDIA_TESLA_T4, NVIDIA_TESLA_A100, + NVIDIA_A100_80GB, NVIDIA_L4. + + --machine-type=MACHINE_TYPE; default="e2-standard-4" + The Compute Engine machine type selected for the runtime. + + The configuration for the data disk of the runtime. + + --disk-size-gb=DISK_SIZE_GB; default=100 + The disk size of the runtime in GB. If specified, the --disk-type + must also be specified. The minimum size is 10GB and the maximum is + 65536GB. + + --disk-type=DISK_TYPE; default="PD_STANDARD" + The type of the persistent disk. DISK_TYPE must be one of: + PD_STANDARD, PD_SSD, PD_BALANCED, PD_EXTREME. + + The network configuration for the runtime. + + --enable-internet-access + Enable public internet access for the runtime. Enabled by default, + use --no-enable-internet-access to disable. + + Network resource - The name of the VPC that this runtime is in. This + represents a Cloud resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ▫ provide the argument --network on the command line with a fully + specified name; + ▫ provide the argument --project on the command line; + ▫ set the property core/project. + + --network=NETWORK + ID of the network or fully qualified identifier for the network. + + To set the network attribute: + ▫ provide the argument --network on the command line. + + Subnetwork resource - The name of the subnetwork that this runtime is + in. The arguments in this group can be used to specify the attributes + of this resource. (NOTE) Some attributes are not given arguments in + this group but can be set in other ways. + + To set the project attribute: + ▫ provide the argument --subnetwork on the command line with a + fully specified name; + ▫ provide the argument --project on the command line; + ▫ set the property core/project. + + --subnetwork=SUBNETWORK + ID of the subnetwork or fully qualified identifier for the + subnetwork. + + To set the subnetwork attribute: + ▫ provide the argument --subnetwork on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --subnetwork-region=SUBNETWORK_REGION + Google Cloud region of this subnetwork + https://cloud.google.com/compute/docs/regions-zones/#locations. + + To set the subnetwork-region attribute: + ▫ provide the argument --subnetwork on the command line with a + fully specified name; + ▫ provide the argument --subnetwork-region on the command line. + + Key resource - The Cloud KMS encryption key (customer-managed + encryption key) used to protect the execution. The key must be in the + same region as the execution. If not specified, Google-managed + encryption will be used. The arguments in this group can be used to + specify the attributes of this resource. + + --kms-key=KMS_KEY + ID of the key or fully qualified identifier for the key. + + To set the kms-key attribute: + ▫ provide the argument --kms-key on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --kms-keyring=KMS_KEYRING + KMS keyring id of the key. + + To set the kms-keyring attribute: + ▫ provide the argument --kms-key on the command line with a fully + specified name; + ▫ provide the argument --kms-keyring on the command line. + + --kms-location=KMS_LOCATION + Cloud location for the key. + + To set the kms-location attribute: + ▫ provide the argument --kms-key on the command line with a fully + specified name; + ▫ provide the argument --kms-location on the command line. + + --kms-project=KMS_PROJECT + Cloud project id for the key. + + To set the kms-project attribute: + ▫ provide the argument --kms-key on the command line with a fully + specified name; + ▫ provide the argument --kms-project on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud beta workbench schedules create + diff --git a/gcloud/workbench/schedules/delete b/gcloud/workbench/schedules/delete new file mode 100644 index 000000000..a4132fa75 --- /dev/null +++ b/gcloud/workbench/schedules/delete @@ -0,0 +1,65 @@ +NAME + gcloud workbench schedules delete - delete a schedule + +SYNOPSIS + gcloud workbench schedules delete (SCHEDULE : --region=REGION) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete a Workbench notebook execution schedule. + +EXAMPLES + To delete a schedule with id my-schedule, in region us-central1, run: + + $ gcloud workbench schedules delete my-schedule --region=us-central1 + +POSITIONAL ARGUMENTS + Schedule resource - Unique, system-generated resource name of the schedule + to delete. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument schedule on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + SCHEDULE + ID of the schedule or fully qualified identifier for the schedule. + + To set the name attribute: + ▸ provide the argument schedule on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Cloud region for the schedule. + + To set the region attribute: + ▸ provide the argument schedule on the command line with a fully + specified name; + ▸ provide the argument --region on the command line; + ▸ set the property colab/region. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud beta workbench schedules delete + diff --git a/gcloud/workbench/schedules/describe b/gcloud/workbench/schedules/describe new file mode 100644 index 000000000..de37c2049 --- /dev/null +++ b/gcloud/workbench/schedules/describe @@ -0,0 +1,61 @@ +NAME + gcloud workbench schedules describe - describe a schedule + +SYNOPSIS + gcloud workbench schedules describe (SCHEDULE : --region=REGION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe a Workbench notebook execution schedule. + +EXAMPLES + To describe a schedule with id my-schedule in region us-central1, run: + + $ gcloud workbench schedules describe my-schedule \ + --region=us-central1 + +POSITIONAL ARGUMENTS + Schedule resource - Unique, system-generated resource name of the schedule + to describe. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument schedule on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + SCHEDULE + ID of the schedule or fully qualified identifier for the schedule. + + To set the name attribute: + ▸ provide the argument schedule on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Cloud region for the schedule. + + To set the region attribute: + ▸ provide the argument schedule on the command line with a fully + specified name; + ▸ provide the argument --region on the command line; + ▸ set the property colab/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 + This variant is also available: + + $ gcloud beta workbench schedules describe + diff --git a/gcloud/workbench/schedules/help b/gcloud/workbench/schedules/help new file mode 100644 index 000000000..d3682bbb6 --- /dev/null +++ b/gcloud/workbench/schedules/help @@ -0,0 +1,43 @@ +NAME + gcloud workbench schedules - workbench schedules command group + +SYNOPSIS + gcloud workbench schedules COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Workbench schedules command group. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + Create a schedule. + + delete + Delete a schedule. + + describe + Describe a schedule. + + list + List your Workbench notebook execution schedules. + + pause + Pause a schedule. + + resume + Resume a schedule. + + update + Update a schedule. + +NOTES + This variant is also available: + + $ gcloud beta workbench schedules + diff --git a/gcloud/workbench/schedules/list b/gcloud/workbench/schedules/list new file mode 100644 index 000000000..e2e950eda --- /dev/null +++ b/gcloud/workbench/schedules/list @@ -0,0 +1,82 @@ +NAME + gcloud workbench schedules list - list your Workbench notebook execution + schedules + +SYNOPSIS + gcloud workbench schedules list --region=REGION [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List your project's Workbench notebook execution schedules in a given + region. + +EXAMPLES + To list your schedules in region us-central1, run: + + $ gcloud workbench schedules list --region=us-central1 + +REQUIRED FLAGS + Region resource - Cloud region for which to list all schedules. This + represents a Cloud resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --region on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --region=REGION + ID of the region or fully qualified identifier for the region. + + To set the region attribute: + ▸ provide the argument --region on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud beta workbench schedules list + diff --git a/gcloud/workbench/schedules/pause b/gcloud/workbench/schedules/pause new file mode 100644 index 000000000..391ac57db --- /dev/null +++ b/gcloud/workbench/schedules/pause @@ -0,0 +1,60 @@ +NAME + gcloud workbench schedules pause - pause a schedule + +SYNOPSIS + gcloud workbench schedules pause (SCHEDULE : --region=REGION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Pause a Workbench notebook execution schedule. + +EXAMPLES + To pause a schedule with id my-schedule, in region us-central1, run: + + $ gcloud workbench schedules pause my-schedule --region=us-central1 + +POSITIONAL ARGUMENTS + Schedule resource - Unique, system-generated resource name of the schedule + to pause. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument schedule on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + SCHEDULE + ID of the schedule or fully qualified identifier for the schedule. + + To set the name attribute: + ▸ provide the argument schedule on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Cloud region for the schedule. + + To set the region attribute: + ▸ provide the argument schedule on the command line with a fully + specified name; + ▸ provide the argument --region on the command line; + ▸ set the property colab/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 + This variant is also available: + + $ gcloud beta workbench schedules pause + diff --git a/gcloud/workbench/schedules/resume b/gcloud/workbench/schedules/resume new file mode 100644 index 000000000..3813c9a2f --- /dev/null +++ b/gcloud/workbench/schedules/resume @@ -0,0 +1,67 @@ +NAME + gcloud workbench schedules resume - resume a schedule + +SYNOPSIS + gcloud workbench schedules resume (SCHEDULE : --region=REGION) + [--enable-catch-up] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Resume a Workbench notebook execution schedule. + +EXAMPLES + To resume a paused schedule with id my-schedule, in region us-central1, + run: + + $ gcloud workbench schedules resume my-schedule --region=us-central1 + +POSITIONAL ARGUMENTS + Schedule resource - Unique, system-generated resource name of the schedule + to resume. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument schedule on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + SCHEDULE + ID of the schedule or fully qualified identifier for the schedule. + + To set the name attribute: + ▸ provide the argument schedule on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Cloud region for the schedule. + + To set the region attribute: + ▸ provide the argument schedule on the command line with a fully + specified name; + ▸ provide the argument --region on the command line; + ▸ set the property colab/region. + +FLAGS + --enable-catch-up + Enables backfilling missed runs when the schedule is resumed from + PAUSED state. If enabled, all missed runs will be scheduled and new + runs will be scheduled after the backfill is complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud beta workbench schedules resume + diff --git a/gcloud/workbench/schedules/update b/gcloud/workbench/schedules/update new file mode 100644 index 000000000..667102f78 --- /dev/null +++ b/gcloud/workbench/schedules/update @@ -0,0 +1,112 @@ +NAME + gcloud workbench schedules update - update a schedule + +SYNOPSIS + gcloud workbench schedules update (SCHEDULE : --region=REGION) + (--cron-schedule=CRON_SCHEDULE --display-name=DISPLAY_NAME + --enable-queueing --end-time=END_TIME + --max-concurrent-runs=MAX_CONCURRENT_RUNS + --max-runs=MAX_RUNS --start-time=START_TIME) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Update a Workbench notebook execution schedule. + +EXAMPLES + To update the cron schedule and max runs of a schedule with id my-schedule, + in region us-central1, run: + + $ gcloud workbench schedules update my-schedule \ + --region=us-central1 \ + --cron-schedule='TZ=America/Los_Angeles 0 0 * * 0' --max-runs=2 + +POSITIONAL ARGUMENTS + Schedule resource - Unique, system-generated resource name of the schedule + to update. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument schedule on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + SCHEDULE + ID of the schedule or fully qualified identifier for the schedule. + + To set the name attribute: + ▸ provide the argument schedule on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Cloud region for the schedule. + + To set the region attribute: + ▸ provide the argument schedule on the command line with a fully + specified name; + ▸ provide the argument --region on the command line; + ▸ set the property colab/region. + +REQUIRED FLAGS + Configuration of the schedule. + + At least one of these must be specified: + + --cron-schedule=CRON_SCHEDULE + Cron schedule (https://en.wikipedia.org/wiki/Cron) to launch + scheduled runs. To explicitly set a timezone to the cron tab, apply a + prefix in the cron tab: "CRON_TZ=${IANA_TIME_ZONE}" or + "TZ=${IANA_TIME_ZONE}". The ${IANA_TIME_ZONE} may only be a valid + string from IANA time zone database. For example, + "CRON_TZ=America/New_York 1 * * * ", or "TZ=America/New_York 1 * * * + ". + + --display-name=DISPLAY_NAME + The display name of the schedule. + + --enable-queueing + Enables new scheduled runs to be queued when max_concurrent_runs + limit is reached. If set to true, new runs will be queued instead of + skipped. + + --end-time=END_TIME + Timestamp after which no new runs can be scheduled. If specified, the + schedule will be completed when either end_time is reached or when + scheduled_run_count >= max_run_count. If neither end time nor + max_run_count is specified, new runs will keep getting scheduled + until this Schedule is paused or deleted. Must be in the RFC 3339 + (https://www.rfc-editor.org/rfc/rfc3339.txt) format. E.g. + "2026-01-01T00:00:00Z" or "2026-01-01T00:00:00-05:00" + + --max-concurrent-runs=MAX_CONCURRENT_RUNS + Maximum number of runs that can be started concurrently for this + Schedule. This is the limit for starting the scheduled requests and + not the execution of the notebook execution jobs created by the + requests. + + --max-runs=MAX_RUNS + The max runs for the schedule. + + --start-time=START_TIME + The timestamp after which the first run can be scheduled. Defaults to + the schedule creation time. Must be in the RFC 3339 + (https://www.rfc-editor.org/rfc/rfc3339.txt) format. E.g. + "2026-01-01T00:00:00Z" or "2026-01-01T00:00:00-05:00" + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud beta workbench schedules update +