From d34c41a2ce619ca44396297850f3a2ad979a5fde Mon Sep 17 00:00:00 2001 From: Automated Date: Wed, 25 Oct 2023 11:42:23 +0000 Subject: [PATCH] gcloud: Wed Oct 25 11:42:23 UTC 2023 --- gcloud/_version | 10 +- gcloud/ai/index-endpoints/create | 23 ++- gcloud/ai/index-endpoints/deploy-index | 36 ++++- gcloud/ai/indexes/create | 15 +- gcloud/alpha/ai/index-endpoints/create | 23 ++- gcloud/alpha/ai/index-endpoints/deploy-index | 36 ++++- gcloud/alpha/ai/indexes/create | 15 +- .../alpha/ai/tensorboard-experiments/create | 22 +++ .../alpha/ai/tensorboard-experiments/delete | 13 ++ .../alpha/ai/tensorboard-experiments/describe | 13 ++ gcloud/alpha/ai/tensorboard-experiments/list | 5 + .../alpha/ai/tensorboard-experiments/update | 16 ++ gcloud/alpha/ai/tensorboard-runs/create | 27 ++++ gcloud/alpha/ai/tensorboard-runs/delete | 15 ++ gcloud/alpha/ai/tensorboard-runs/describe | 15 ++ gcloud/alpha/ai/tensorboard-runs/list | 7 + gcloud/alpha/ai/tensorboard-runs/update | 17 ++ .../alpha/ai/tensorboard-time-series/create | 30 ++++ .../alpha/ai/tensorboard-time-series/delete | 17 ++ .../alpha/ai/tensorboard-time-series/describe | 17 ++ gcloud/alpha/ai/tensorboard-time-series/list | 10 ++ gcloud/alpha/ai/tensorboard-time-series/read | 17 ++ .../alpha/ai/tensorboard-time-series/update | 19 +++ gcloud/alpha/ai/tensorboards/create | 14 ++ gcloud/alpha/ai/tensorboards/delete | 10 ++ gcloud/alpha/ai/tensorboards/describe | 11 ++ gcloud/alpha/ai/tensorboards/list | 5 + gcloud/alpha/ai/tensorboards/update | 8 + gcloud/alpha/bigtable/app-profiles/create | 19 ++- gcloud/alpha/bigtable/app-profiles/update | 18 ++- gcloud/alpha/bms/instances/auth-info | 62 ++++++++ gcloud/alpha/bms/instances/help | 4 + gcloud/alpha/bms/instances/update | 32 +++- gcloud/alpha/composer/environments/create | 13 +- .../alpha/compute/network-attachments/update | 30 +++- .../alpha/compute/project-zonal-metadata/add | 4 +- .../compute/project-zonal-metadata/describe | 4 +- .../alpha/compute/project-zonal-metadata/help | 4 +- .../compute/project-zonal-metadata/remove | 4 +- gcloud/alpha/config/get | 16 ++ gcloud/alpha/config/help | 16 ++ gcloud/alpha/config/list | 16 ++ gcloud/alpha/config/set | 16 ++ gcloud/alpha/config/unset | 16 ++ gcloud/alpha/container/clusters/create | 14 +- gcloud/alpha/container/fleet/mesh/disable | 5 + gcloud/alpha/container/fleet/mesh/enable | 6 + gcloud/alpha/container/fleet/mesh/update | 85 +++++----- gcloud/alpha/container/hub/mesh/disable | 5 + gcloud/alpha/container/hub/mesh/enable | 6 + gcloud/alpha/container/hub/mesh/update | 85 +++++----- gcloud/alpha/container/node-pools/create | 14 +- gcloud/alpha/container/node-pools/update | 32 +++- gcloud/alpha/container/vmware/clusters/create | 41 +++-- gcloud/alpha/container/vmware/clusters/update | 42 +++-- gcloud/alpha/dataproc/jobs/submit/flink | 14 +- gcloud/alpha/dataproc/jobs/submit/hadoop | 14 +- gcloud/alpha/dataproc/jobs/submit/hive | 14 +- gcloud/alpha/dataproc/jobs/submit/pig | 14 +- gcloud/alpha/dataproc/jobs/submit/presto | 12 ++ gcloud/alpha/dataproc/jobs/submit/pyspark | 14 +- gcloud/alpha/dataproc/jobs/submit/spark | 14 +- gcloud/alpha/dataproc/jobs/submit/spark-r | 14 +- gcloud/alpha/dataproc/jobs/submit/spark-sql | 14 +- gcloud/alpha/dataproc/jobs/submit/trino | 12 ++ .../domains/registrations/configure/contacts | 10 +- .../alpha/domains/registrations/configure/dns | 9 +- gcloud/alpha/domains/registrations/export | 9 +- gcloud/alpha/domains/registrations/help | 7 +- gcloud/alpha/domains/registrations/import | 12 +- gcloud/alpha/domains/registrations/register | 17 +- gcloud/alpha/domains/registrations/transfer | 28 ++-- gcloud/alpha/firebase/test/android/run | 8 +- gcloud/alpha/iam/service-accounts/delete | 2 +- .../create-cred-config | 2 +- gcloud/alpha/infra-manager/deployments/apply | 7 +- gcloud/alpha/kms/help | 3 + gcloud/alpha/kms/key-deletion-opt-out | 46 ++++++ gcloud/alpha/projects/delete | 2 +- .../alpha/projects/remove-iam-policy-binding | 2 +- gcloud/alpha/pubsub/subscriptions/create | 25 ++- .../pubsub/subscriptions/modify-push-config | 4 +- gcloud/alpha/pubsub/subscriptions/pull | 6 +- gcloud/alpha/pubsub/subscriptions/update | 37 +++-- gcloud/alpha/pubsub/topics/update | 6 +- gcloud/alpha/run/deploy | 41 +++-- gcloud/alpha/run/jobs/deploy | 24 ++- gcloud/alpha/run/jobs/update | 24 ++- gcloud/alpha/run/services/update | 41 +++-- gcloud/alpha/spanner/instances/create | 49 +++++- gcloud/alpha/spanner/instances/update | 31 +++- gcloud/alpha/sql/instances/create | 15 +- gcloud/alpha/sql/instances/patch | 15 +- gcloud/alpha/storage/help | 3 + gcloud/alpha/storage/operations/cancel | 38 +++++ gcloud/alpha/storage/operations/describe | 37 +++++ gcloud/alpha/storage/operations/help | 34 ++++ gcloud/alpha/storage/operations/list | 84 ++++++++++ gcloud/alpha/workstations/clusters/create | 3 +- gcloud/alpha/workstations/clusters/delete | 3 +- gcloud/alpha/workstations/clusters/describe | 3 +- gcloud/alpha/workstations/configs/create | 6 +- gcloud/alpha/workstations/configs/delete | 6 +- gcloud/alpha/workstations/configs/describe | 6 +- .../alpha/workstations/configs/get-iam-policy | 6 +- gcloud/alpha/workstations/configs/list | 3 +- .../alpha/workstations/configs/set-iam-policy | 6 +- gcloud/alpha/workstations/configs/update | 6 +- gcloud/alpha/workstations/create | 9 +- gcloud/alpha/workstations/delete | 9 +- gcloud/alpha/workstations/describe | 9 +- gcloud/alpha/workstations/get-iam-policy | 9 +- gcloud/alpha/workstations/list | 6 +- gcloud/alpha/workstations/list-usable | 6 +- gcloud/alpha/workstations/set-iam-policy | 9 +- gcloud/alpha/workstations/ssh | 9 +- gcloud/alpha/workstations/start | 9 +- gcloud/alpha/workstations/start-tcp-tunnel | 9 +- gcloud/alpha/workstations/stop | 9 +- gcloud/artifacts/sbom/export | 5 +- gcloud/beta/ai/index-endpoints/create | 23 ++- gcloud/beta/ai/index-endpoints/deploy-index | 36 ++++- gcloud/beta/ai/indexes/create | 15 +- gcloud/beta/beyondcorp/app/gateways/create | 107 +++++++++++++ gcloud/beta/beyondcorp/app/gateways/delete | 69 ++++++++ gcloud/beta/beyondcorp/app/gateways/describe | 71 +++++++++ gcloud/beta/beyondcorp/app/gateways/help | 35 ++++ gcloud/beta/beyondcorp/app/gateways/list | 87 ++++++++++ gcloud/beta/beyondcorp/app/help | 3 + gcloud/beta/bigtable/app-profiles/create | 19 ++- gcloud/beta/bigtable/app-profiles/update | 18 ++- gcloud/beta/composer/environments/create | 13 +- gcloud/beta/compute/help | 3 + gcloud/beta/compute/network-attachments/help | 3 + .../beta/compute/network-attachments/update | 92 +++++++++++ .../networks/vpc-access/connectors/update | 5 +- .../beta/compute/project-zonal-metadata/add | 53 +++++++ .../compute/project-zonal-metadata/describe | 36 +++++ .../beta/compute/project-zonal-metadata/help | 33 ++++ .../compute/project-zonal-metadata/remove | 60 +++++++ gcloud/beta/config/get | 16 ++ gcloud/beta/config/help | 16 ++ gcloud/beta/config/list | 16 ++ gcloud/beta/config/set | 16 ++ gcloud/beta/config/unset | 16 ++ gcloud/beta/container/clusters/create | 14 +- gcloud/beta/container/fleet/mesh/disable | 5 + gcloud/beta/container/fleet/mesh/enable | 6 + gcloud/beta/container/hub/mesh/disable | 5 + gcloud/beta/container/hub/mesh/enable | 6 + gcloud/beta/container/node-pools/create | 14 +- gcloud/beta/container/node-pools/update | 32 +++- gcloud/beta/container/vmware/clusters/create | 40 ++++- gcloud/beta/container/vmware/clusters/update | 40 ++++- gcloud/beta/dataproc/jobs/submit/flink | 14 +- gcloud/beta/dataproc/jobs/submit/hadoop | 14 +- gcloud/beta/dataproc/jobs/submit/hive | 14 +- gcloud/beta/dataproc/jobs/submit/pig | 14 +- gcloud/beta/dataproc/jobs/submit/presto | 12 ++ gcloud/beta/dataproc/jobs/submit/pyspark | 14 +- gcloud/beta/dataproc/jobs/submit/spark | 14 +- gcloud/beta/dataproc/jobs/submit/spark-r | 14 +- gcloud/beta/dataproc/jobs/submit/spark-sql | 14 +- gcloud/beta/dataproc/jobs/submit/trino | 12 ++ .../domains/registrations/configure/contacts | 10 +- .../beta/domains/registrations/configure/dns | 9 +- gcloud/beta/domains/registrations/export | 7 +- gcloud/beta/domains/registrations/help | 7 +- gcloud/beta/domains/registrations/import | 12 +- gcloud/beta/domains/registrations/register | 17 +- gcloud/beta/domains/registrations/transfer | 28 ++-- gcloud/beta/firebase/test/android/run | 8 +- gcloud/beta/iam/service-accounts/delete | 9 +- .../create-cred-config | 2 +- gcloud/beta/netapp/backup-policies/create | 106 +++++++++++++ gcloud/beta/netapp/backup-policies/delete | 72 +++++++++ gcloud/beta/netapp/backup-policies/describe | 68 ++++++++ gcloud/beta/netapp/backup-policies/help | 36 +++++ gcloud/beta/netapp/backup-policies/list | 88 +++++++++++ gcloud/beta/netapp/backup-policies/update | 134 ++++++++++++++++ gcloud/beta/netapp/backup-vaults/create | 81 ++++++++++ gcloud/beta/netapp/backup-vaults/delete | 72 +++++++++ gcloud/beta/netapp/backup-vaults/describe | 68 ++++++++ gcloud/beta/netapp/backup-vaults/help | 36 +++++ gcloud/beta/netapp/backup-vaults/list | 89 +++++++++++ gcloud/beta/netapp/backup-vaults/update | 109 +++++++++++++ gcloud/beta/netapp/help | 6 + gcloud/beta/projects/delete | 10 +- .../beta/projects/remove-iam-policy-binding | 14 +- gcloud/beta/pubsub/subscriptions/create | 25 ++- .../pubsub/subscriptions/modify-push-config | 4 +- gcloud/beta/pubsub/subscriptions/pull | 6 +- gcloud/beta/pubsub/subscriptions/update | 37 +++-- gcloud/beta/pubsub/topics/update | 6 +- gcloud/beta/spanner/instances/create | 49 +++++- gcloud/beta/spanner/instances/update | 31 +++- gcloud/beta/sql/instances/create | 15 +- gcloud/beta/sql/instances/patch | 15 +- gcloud/beta/workstations/clusters/create | 3 +- gcloud/beta/workstations/clusters/delete | 3 +- gcloud/beta/workstations/clusters/describe | 3 +- gcloud/beta/workstations/configs/create | 6 +- gcloud/beta/workstations/configs/delete | 6 +- gcloud/beta/workstations/configs/describe | 6 +- .../beta/workstations/configs/get-iam-policy | 6 +- gcloud/beta/workstations/configs/list | 3 +- .../beta/workstations/configs/set-iam-policy | 6 +- gcloud/beta/workstations/configs/update | 6 +- gcloud/beta/workstations/create | 9 +- gcloud/beta/workstations/delete | 9 +- gcloud/beta/workstations/describe | 9 +- gcloud/beta/workstations/get-iam-policy | 9 +- gcloud/beta/workstations/list | 6 +- gcloud/beta/workstations/list-usable | 6 +- gcloud/beta/workstations/set-iam-policy | 9 +- gcloud/beta/workstations/ssh | 9 +- gcloud/beta/workstations/start | 9 +- gcloud/beta/workstations/start-tcp-tunnel | 9 +- gcloud/beta/workstations/stop | 9 +- gcloud/bigtable/app-profiles/create | 19 ++- gcloud/bigtable/app-profiles/update | 18 ++- gcloud/composer/environments/create | 13 +- gcloud/compute/network-attachments/help | 3 + gcloud/compute/network-attachments/update | 91 +++++++++++ gcloud/compute/network-endpoint-groups/create | 3 +- .../list-network-endpoints | 25 ++- gcloud/compute/network-endpoint-groups/update | 24 ++- .../networks/vpc-access/connectors/help | 3 + .../networks/vpc-access/connectors/update | 97 ++++++++++++ gcloud/compute/routers/nats/create | 5 +- gcloud/compute/tpus/tpu-vm/update | 31 +++- gcloud/config/get | 16 ++ gcloud/config/help | 16 ++ gcloud/config/list | 16 ++ gcloud/config/set | 16 ++ gcloud/config/unset | 16 ++ gcloud/container/clusters/create | 14 +- gcloud/container/fleet/mesh/disable | 4 + gcloud/container/fleet/mesh/enable | 6 + gcloud/container/fleet/mesh/update | 73 ++++----- gcloud/container/hub/mesh/disable | 4 + gcloud/container/hub/mesh/enable | 6 + gcloud/container/hub/mesh/update | 73 ++++----- gcloud/container/node-pools/create | 14 +- gcloud/container/node-pools/update | 37 ++++- gcloud/container/vmware/clusters/create | 38 ++++- gcloud/container/vmware/clusters/update | 38 ++++- gcloud/dataproc/jobs/submit/flink | 14 +- gcloud/dataproc/jobs/submit/hadoop | 14 +- gcloud/dataproc/jobs/submit/hive | 14 +- gcloud/dataproc/jobs/submit/pig | 14 +- gcloud/dataproc/jobs/submit/presto | 12 ++ gcloud/dataproc/jobs/submit/pyspark | 14 +- gcloud/dataproc/jobs/submit/spark | 14 +- gcloud/dataproc/jobs/submit/spark-r | 14 +- gcloud/dataproc/jobs/submit/spark-sql | 14 +- gcloud/dataproc/jobs/submit/trino | 12 ++ .../domains/registrations/configure/contacts | 10 +- gcloud/domains/registrations/configure/dns | 9 +- gcloud/domains/registrations/export | 5 + gcloud/domains/registrations/help | 7 +- gcloud/domains/registrations/import | 6 + gcloud/domains/registrations/register | 17 +- gcloud/domains/registrations/transfer | 26 ++- .../create-cred-config | 2 +- gcloud/infra-manager/deployments/apply | 7 +- gcloud/netapp/storage-pools/create | 4 + gcloud/notebooks/runtimes/help | 3 + gcloud/notebooks/runtimes/migrate | 149 ++++++++++++++++++ gcloud/pubsub/subscriptions/create | 25 ++- .../pubsub/subscriptions/modify-push-config | 4 +- gcloud/pubsub/subscriptions/pull | 3 +- gcloud/pubsub/subscriptions/update | 37 +++-- gcloud/pubsub/topics/update | 6 +- gcloud/spanner/instances/create | 49 +++++- gcloud/spanner/instances/update | 31 +++- gcloud/sql/instances/create | 21 ++- gcloud/sql/instances/patch | 18 ++- gcloud/storage/help | 3 + gcloud/storage/operations/cancel | 34 ++++ gcloud/storage/operations/describe | 33 ++++ gcloud/storage/operations/help | 31 ++++ gcloud/storage/operations/list | 81 ++++++++++ gcloud/workbench/instances/create | 10 +- gcloud/workstations/clusters/create | 3 +- gcloud/workstations/clusters/delete | 3 +- gcloud/workstations/clusters/describe | 3 +- gcloud/workstations/configs/create | 6 +- gcloud/workstations/configs/delete | 6 +- gcloud/workstations/configs/describe | 6 +- gcloud/workstations/configs/get-iam-policy | 6 +- gcloud/workstations/configs/list | 3 +- gcloud/workstations/configs/set-iam-policy | 6 +- gcloud/workstations/configs/update | 6 +- gcloud/workstations/create | 9 +- gcloud/workstations/delete | 9 +- gcloud/workstations/describe | 9 +- gcloud/workstations/get-iam-policy | 9 +- gcloud/workstations/list | 6 +- gcloud/workstations/list-usable | 6 +- gcloud/workstations/set-iam-policy | 9 +- gcloud/workstations/ssh | 9 +- gcloud/workstations/start | 9 +- gcloud/workstations/start-tcp-tunnel | 9 +- gcloud/workstations/stop | 9 +- 305 files changed, 5549 insertions(+), 699 deletions(-) create mode 100644 gcloud/alpha/bms/instances/auth-info create mode 100644 gcloud/alpha/kms/key-deletion-opt-out create mode 100644 gcloud/alpha/storage/operations/cancel create mode 100644 gcloud/alpha/storage/operations/describe create mode 100644 gcloud/alpha/storage/operations/help create mode 100644 gcloud/alpha/storage/operations/list create mode 100644 gcloud/beta/beyondcorp/app/gateways/create create mode 100644 gcloud/beta/beyondcorp/app/gateways/delete create mode 100644 gcloud/beta/beyondcorp/app/gateways/describe create mode 100644 gcloud/beta/beyondcorp/app/gateways/help create mode 100644 gcloud/beta/beyondcorp/app/gateways/list create mode 100644 gcloud/beta/compute/network-attachments/update create mode 100644 gcloud/beta/compute/project-zonal-metadata/add create mode 100644 gcloud/beta/compute/project-zonal-metadata/describe create mode 100644 gcloud/beta/compute/project-zonal-metadata/help create mode 100644 gcloud/beta/compute/project-zonal-metadata/remove create mode 100644 gcloud/beta/netapp/backup-policies/create create mode 100644 gcloud/beta/netapp/backup-policies/delete create mode 100644 gcloud/beta/netapp/backup-policies/describe create mode 100644 gcloud/beta/netapp/backup-policies/help create mode 100644 gcloud/beta/netapp/backup-policies/list create mode 100644 gcloud/beta/netapp/backup-policies/update create mode 100644 gcloud/beta/netapp/backup-vaults/create create mode 100644 gcloud/beta/netapp/backup-vaults/delete create mode 100644 gcloud/beta/netapp/backup-vaults/describe create mode 100644 gcloud/beta/netapp/backup-vaults/help create mode 100644 gcloud/beta/netapp/backup-vaults/list create mode 100644 gcloud/beta/netapp/backup-vaults/update create mode 100644 gcloud/compute/network-attachments/update create mode 100644 gcloud/compute/networks/vpc-access/connectors/update create mode 100644 gcloud/notebooks/runtimes/migrate create mode 100644 gcloud/storage/operations/cancel create mode 100644 gcloud/storage/operations/describe create mode 100644 gcloud/storage/operations/help create mode 100644 gcloud/storage/operations/list diff --git a/gcloud/_version b/gcloud/_version index 39f74e644..874f0897e 100644 --- a/gcloud/_version +++ b/gcloud/_version @@ -1,8 +1,8 @@ -Google Cloud SDK 451.0.1 -alpha 2023.10.18 -beta 2023.10.18 +Google Cloud SDK 452.0.0 +alpha 2023.10.23 +beta 2023.10.23 bq 2.0.98 -bundled-python3-unix 3.9.16 -core 2023.10.18 +bundled-python3-unix 3.9.17 +core 2023.10.23 gcloud-crc32c 1.0.0 gsutil 5.26 diff --git a/gcloud/ai/index-endpoints/create b/gcloud/ai/index-endpoints/create index eb770a1c9..f9d029712 100644 --- a/gcloud/ai/index-endpoints/create +++ b/gcloud/ai/index-endpoints/create @@ -3,9 +3,11 @@ NAME SYNOPSIS gcloud ai index-endpoints create --display-name=DISPLAY_NAME - [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] - [--network=NETWORK] [--public-endpoint-enabled] [--region=REGION] - [GCLOUD_WIDE_FLAG ...] + [--description=DESCRIPTION] [--enable-private-service-connect] + [--encryption-kms-key-name=ENCRYPTION_KMS_KEY_NAME] + [--labels=[KEY=VALUE,...]] [--network=NETWORK] + [--project-allowlist=[PROJECTS,...]] [--public-endpoint-enabled] + [--region=REGION] [GCLOUD_WIDE_FLAG ...] EXAMPLES To create an index endpoint under project example with network @@ -24,6 +26,17 @@ OPTIONAL FLAGS --description=DESCRIPTION Description of the index endpoint. + --enable-private-service-connect + If true, expose the index endpoint via private service connect. + + --encryption-kms-key-name=ENCRYPTION_KMS_KEY_NAME + The Cloud KMS resource identifier of the customer managed encryption + key used to protect a resource. Has the form: + projects/my-project/locations/my-region/keyRings/my-kr/cryptoKeys/my-key. + + The key needs to be in the same region as where the compute resource is + created. + --labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to add. @@ -36,6 +49,10 @@ OPTIONAL FLAGS The Google Compute Engine network name to which the IndexEndpoint should be peered. + --project-allowlist=[PROJECTS,...] + List of projects from which the forwarding rule will target the service + attachment. + --public-endpoint-enabled If true, the deployed index will be accessible through public endpoint. diff --git a/gcloud/ai/index-endpoints/deploy-index b/gcloud/ai/index-endpoints/deploy-index index 8f7a6a8c9..c7073a329 100644 --- a/gcloud/ai/index-endpoints/deploy-index +++ b/gcloud/ai/index-endpoints/deploy-index @@ -5,7 +5,9 @@ NAME SYNOPSIS gcloud ai index-endpoints deploy-index (INDEX_ENDPOINT : --region=REGION) --deployed-index-id=DEPLOYED_INDEX_ID --display-name=DISPLAY_NAME - --index=INDEX [--machine-type=MACHINE_TYPE] + --index=INDEX [--allowed-issuers=[ALLOWED_ISSUERS,...]] + [--audiences=[AUDIENCES,...]] [--deployment-group=DEPLOYMENT_GROUP] + [--enable-access-logging] [--machine-type=MACHINE_TYPE] [--max-replica-count=MAX_REPLICA_COUNT] [--min-replica-count=MIN_REPLICA_COUNT] [--reserved-ip-ranges=[RESERVED_IP_RANGES,...]] [GCLOUD_WIDE_FLAG ...] @@ -16,14 +18,14 @@ DESCRIPTION EXAMPLES To deploy index 345 to an index endpoint 456 with 2 min replica count and 10 max replica count under project example in region us-central1, within - reserved ip ranges vertex-ai-ip-ranges-1 and vertex-ai-ip-ranges-2 run: + reserved ip ranges vertex-ai-ip-range-1 and vertex-ai-ip-range-2 run: $ gcloud ai index-endpoints deploy-index 456 --project=example \ --region=us-central1 --index=345 \ --deployed-index-id=deployed-index-345 \ --display-name=deployed-index-345 --min-replica-count=2 \ --max-replica-count=10 \ - --reserved-ip-ranges=vertex-ai-ip-ranges-1,vertex-ai-ip-ranges-2 + --reserved-ip-ranges=vertex-ai-ip-range-1,vertex-ai-ip-range-2 POSITIONAL ARGUMENTS Index endpoint resource - The index endpoint to deploy an index. The @@ -70,6 +72,34 @@ REQUIRED FLAGS ID of the index. OPTIONAL FLAGS + --allowed-issuers=[ALLOWED_ISSUERS,...] + List of allowed JWT issuers for a deployed index. + + Each entry must be a valid Google service account, in the following + format: service-account-name@project-id.iam.gserviceaccount.com + + --audiences=[AUDIENCES,...] + List of JWT audiences that are allowed to access a deployed index. + + JWT containing any of these audiences + (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#section + -4.1.3) will be accepted. + + --deployment-group=DEPLOYMENT_GROUP + Deployment group can be no longer than 64 characters (eg:test, prod). + If not set, we will use the default deployment group. + + Creating deployment_groups with reserved_ip_ranges is a recommended + practice when the peered network has multiple peering ranges.This + creates your deployments from predictable IP spaces for easier traffic + administration. + + --enable-access-logging + If true, online prediction access logs are sent to Cloud Logging. + + These logs are standard server access logs, containing information like + timestamp and latency for each prediction request. + --machine-type=MACHINE_TYPE The machine resources to be used for each node of this deployment. For available machine types, see diff --git a/gcloud/ai/indexes/create b/gcloud/ai/indexes/create index 9e0de5239..a34203273 100644 --- a/gcloud/ai/indexes/create +++ b/gcloud/ai/indexes/create @@ -4,8 +4,9 @@ NAME SYNOPSIS gcloud ai indexes create --display-name=DISPLAY_NAME --metadata-file=METADATA_FILE [--description=DESCRIPTION] - [--labels=[KEY=VALUE,...]] [--metadata-schema-uri=METADATA_SCHEMA_URI] - [--region=REGION] [GCLOUD_WIDE_FLAG ...] + [--index-update-method=INDEX_UPDATE_METHOD] [--labels=[KEY=VALUE,...]] + [--metadata-schema-uri=METADATA_SCHEMA_URI] [--region=REGION] + [GCLOUD_WIDE_FLAG ...] EXAMPLES To create an index under project example in region us-central1, run: @@ -26,6 +27,16 @@ OPTIONAL FLAGS --description=DESCRIPTION Description of the index. + --index-update-method=INDEX_UPDATE_METHOD + The update method to use with this index. Choose stream_update or + batch_update. If not set, batch update will be used by default. + + batch_update: can update index with gcloud ai indexes update using + datapoints files on Cloud Storage. + + stream update: can update datapoints with upsert-datapoints and + delete-datapoints and will be applied nearly real-time. + --labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to add. diff --git a/gcloud/alpha/ai/index-endpoints/create b/gcloud/alpha/ai/index-endpoints/create index 10c77391e..b2ee29528 100644 --- a/gcloud/alpha/ai/index-endpoints/create +++ b/gcloud/alpha/ai/index-endpoints/create @@ -4,9 +4,11 @@ NAME SYNOPSIS gcloud alpha ai index-endpoints create --display-name=DISPLAY_NAME - [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] - [--network=NETWORK] [--public-endpoint-enabled] [--region=REGION] - [GCLOUD_WIDE_FLAG ...] + [--description=DESCRIPTION] [--enable-private-service-connect] + [--encryption-kms-key-name=ENCRYPTION_KMS_KEY_NAME] + [--labels=[KEY=VALUE,...]] [--network=NETWORK] + [--project-allowlist=[PROJECTS,...]] [--public-endpoint-enabled] + [--region=REGION] [GCLOUD_WIDE_FLAG ...] EXAMPLES To create an index endpoint under project example with network @@ -25,6 +27,17 @@ OPTIONAL FLAGS --description=DESCRIPTION Description of the index endpoint. + --enable-private-service-connect + If true, expose the index endpoint via private service connect. + + --encryption-kms-key-name=ENCRYPTION_KMS_KEY_NAME + The Cloud KMS resource identifier of the customer managed encryption + key used to protect a resource. Has the form: + projects/my-project/locations/my-region/keyRings/my-kr/cryptoKeys/my-key. + + The key needs to be in the same region as where the compute resource is + created. + --labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to add. @@ -37,6 +50,10 @@ OPTIONAL FLAGS The Google Compute Engine network name to which the IndexEndpoint should be peered. + --project-allowlist=[PROJECTS,...] + List of projects from which the forwarding rule will target the service + attachment. + --public-endpoint-enabled If true, the deployed index will be accessible through public endpoint. diff --git a/gcloud/alpha/ai/index-endpoints/deploy-index b/gcloud/alpha/ai/index-endpoints/deploy-index index 02ae0bd89..92d60cf9a 100644 --- a/gcloud/alpha/ai/index-endpoints/deploy-index +++ b/gcloud/alpha/ai/index-endpoints/deploy-index @@ -6,7 +6,9 @@ SYNOPSIS gcloud alpha ai index-endpoints deploy-index (INDEX_ENDPOINT : --region=REGION) --deployed-index-id=DEPLOYED_INDEX_ID --display-name=DISPLAY_NAME - --index=INDEX [--machine-type=MACHINE_TYPE] + --index=INDEX [--allowed-issuers=[ALLOWED_ISSUERS,...]] + [--audiences=[AUDIENCES,...]] [--deployment-group=DEPLOYMENT_GROUP] + [--enable-access-logging] [--machine-type=MACHINE_TYPE] [--max-replica-count=MAX_REPLICA_COUNT] [--min-replica-count=MIN_REPLICA_COUNT] [--reserved-ip-ranges=[RESERVED_IP_RANGES,...]] [GCLOUD_WIDE_FLAG ...] @@ -17,14 +19,14 @@ DESCRIPTION EXAMPLES To deploy index 345 to an index endpoint 456 with 2 min replica count and 10 max replica count under project example in region us-central1, within - reserved ip ranges vertex-ai-ip-ranges-1 and vertex-ai-ip-ranges-2 run: + reserved ip ranges vertex-ai-ip-range-1 and vertex-ai-ip-range-2 run: $ gcloud alpha ai index-endpoints deploy-index 456 \ --project=example --region=us-central1 --index=345 \ --deployed-index-id=deployed-index-345 \ --display-name=deployed-index-345 --min-replica-count=2 \ --max-replica-count=10 \ - --reserved-ip-ranges=vertex-ai-ip-ranges-1,vertex-ai-ip-ranges-2 + --reserved-ip-ranges=vertex-ai-ip-range-1,vertex-ai-ip-range-2 POSITIONAL ARGUMENTS Index endpoint resource - The index endpoint to deploy an index. The @@ -71,6 +73,34 @@ REQUIRED FLAGS ID of the index. OPTIONAL FLAGS + --allowed-issuers=[ALLOWED_ISSUERS,...] + List of allowed JWT issuers for a deployed index. + + Each entry must be a valid Google service account, in the following + format: service-account-name@project-id.iam.gserviceaccount.com + + --audiences=[AUDIENCES,...] + List of JWT audiences that are allowed to access a deployed index. + + JWT containing any of these audiences + (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#section + -4.1.3) will be accepted. + + --deployment-group=DEPLOYMENT_GROUP + Deployment group can be no longer than 64 characters (eg:test, prod). + If not set, we will use the default deployment group. + + Creating deployment_groups with reserved_ip_ranges is a recommended + practice when the peered network has multiple peering ranges.This + creates your deployments from predictable IP spaces for easier traffic + administration. + + --enable-access-logging + If true, online prediction access logs are sent to Cloud Logging. + + These logs are standard server access logs, containing information like + timestamp and latency for each prediction request. + --machine-type=MACHINE_TYPE The machine resources to be used for each node of this deployment. For available machine types, see diff --git a/gcloud/alpha/ai/indexes/create b/gcloud/alpha/ai/indexes/create index d069a7dca..03a19f4eb 100644 --- a/gcloud/alpha/ai/indexes/create +++ b/gcloud/alpha/ai/indexes/create @@ -4,8 +4,9 @@ NAME SYNOPSIS gcloud alpha ai indexes create --display-name=DISPLAY_NAME --metadata-file=METADATA_FILE [--description=DESCRIPTION] - [--labels=[KEY=VALUE,...]] [--metadata-schema-uri=METADATA_SCHEMA_URI] - [--region=REGION] [GCLOUD_WIDE_FLAG ...] + [--index-update-method=INDEX_UPDATE_METHOD] [--labels=[KEY=VALUE,...]] + [--metadata-schema-uri=METADATA_SCHEMA_URI] [--region=REGION] + [GCLOUD_WIDE_FLAG ...] EXAMPLES To create an index under project example in region us-central1, run: @@ -26,6 +27,16 @@ OPTIONAL FLAGS --description=DESCRIPTION Description of the index. + --index-update-method=INDEX_UPDATE_METHOD + The update method to use with this index. Choose stream_update or + batch_update. If not set, batch update will be used by default. + + batch_update: can update index with gcloud ai indexes update using + datapoints files on Cloud Storage. + + stream update: can update datapoints with upsert-datapoints and + delete-datapoints and will be applied nearly real-time. + --labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to add. diff --git a/gcloud/alpha/ai/tensorboard-experiments/create b/gcloud/alpha/ai/tensorboard-experiments/create index cd9e22d6e..aa349f961 100644 --- a/gcloud/alpha/ai/tensorboard-experiments/create +++ b/gcloud/alpha/ai/tensorboard-experiments/create @@ -12,6 +12,28 @@ SYNOPSIS DESCRIPTION (ALPHA) Create a new Vertex AI Tensorboard experiment. +EXAMPLES + To create a Tensorboard Experiment in a Tensorboard 12345, with the display + name my tensorboard experiment: + + $ gcloud alpha ai tensorboard-experiments create 12345 \ + --tensorboard-experiment-id=my-tensorboard-experiment \ + --display-name="my tensorboard experiment" + + You may also provide a description and/or labels: + + $ gcloud alpha ai tensorboard-experiments create 12345 \ + --tensorboard-experiment-id=my-tensorboard-experiment \ + --description="my description" --labels="label1=value1" \ + --labels="label2=value2" + + To create a Tensorboard Experiment my-tensorboard-experiment in a + Tensorboard 12345, region us-central1, and project my-project: + + $ gcloud alpha ai tensorboard-experiments create \ + projects/my-project/locations/us-central1/tensorboards/12345 \ + --tensorboard-experiment-id=my-tensorboard-experiment + POSITIONAL ARGUMENTS Tensorboard resource - The tensorboard to create a Tensorboard experiment. The arguments in this group can be used to specify the attributes of this diff --git a/gcloud/alpha/ai/tensorboard-experiments/delete b/gcloud/alpha/ai/tensorboard-experiments/delete index 0816d4ff3..3b0e13fbb 100644 --- a/gcloud/alpha/ai/tensorboard-experiments/delete +++ b/gcloud/alpha/ai/tensorboard-experiments/delete @@ -11,6 +11,19 @@ SYNOPSIS DESCRIPTION (ALPHA) Delete an existing Vertex AI Tensorboard experiment. +EXAMPLES + To delete a Tensorboard Experiment my-tensorboard-experiment in Tensorboard + 12345, region us-central1, and project my-project: + + $ gcloud alpha ai tensorboard-experiments delete \ + projects/my-project/locations/us-central1/tensorboards/12345/\ + experiments/my-tensorboard-experiment + + Or with flags: + + $ gcloud alpha ai tensorboard-experiments delete \ + my-tensorboard-experiment --tensorboard-id=12345 + POSITIONAL ARGUMENTS Tensorboard experiment resource - The Tensorboard experiment to delete. The arguments in this group can be used to specify the attributes of this diff --git a/gcloud/alpha/ai/tensorboard-experiments/describe b/gcloud/alpha/ai/tensorboard-experiments/describe index 41d1ea4b5..6139d5fa5 100644 --- a/gcloud/alpha/ai/tensorboard-experiments/describe +++ b/gcloud/alpha/ai/tensorboard-experiments/describe @@ -12,6 +12,19 @@ DESCRIPTION (ALPHA) Get detailed Tensorboard experiment information about the given Tensorboard experiment id. +EXAMPLES + To describe a Tensorboard Experiment my-tensorboard-experiment in + Tensorboard 12345, region us-central1, and project my-project: + + $ gcloud alpha ai tensorboard-experiments describe \ + projects/my-project/locations/us-central1/tensorboards/12345/\ + experiments/my-tensorboard-experiment + + Or with flags: + + $ gcloud alpha ai tensorboard-experiments describe \ + my-tensorboard-experiment --tensorboard-id=12345 + POSITIONAL ARGUMENTS Tensorboard experiment resource - The Tensorboard experiment to describe. The arguments in this group can be used to specify the attributes of this diff --git a/gcloud/alpha/ai/tensorboard-experiments/list b/gcloud/alpha/ai/tensorboard-experiments/list index 83eebdba5..84890e101 100644 --- a/gcloud/alpha/ai/tensorboard-experiments/list +++ b/gcloud/alpha/ai/tensorboard-experiments/list @@ -12,6 +12,11 @@ DESCRIPTION (ALPHA) List the Tensorboard experiments of the given project, region, and Tensorboard. +EXAMPLES + To list Tensorboard Experiments in Tensorboard 12345: + + $ gcloud alpha ai tensorboard-experiments list 12345 + POSITIONAL ARGUMENTS Tensorboard resource - The tensorboard to create a Tensorboard experiment. The arguments in this group can be used to specify the attributes of this diff --git a/gcloud/alpha/ai/tensorboard-experiments/update b/gcloud/alpha/ai/tensorboard-experiments/update index d7f353879..b5802255f 100644 --- a/gcloud/alpha/ai/tensorboard-experiments/update +++ b/gcloud/alpha/ai/tensorboard-experiments/update @@ -13,6 +13,22 @@ SYNOPSIS DESCRIPTION (ALPHA) Update an existing Vertex AI Tensorboard experiment. +EXAMPLES + To update a Tensorboard Experiment my-tensorboard-experiment in Tensorboard + 12345, region us-central1, and project my-project, with the display name + updated display name: + + $ gcloud alpha ai tensorboard-experiments update \ + projects/my-project/locations/us-central1/tensorboards/12345/\ + experiments/my-tensorboard-experiment \ + --display-name="updated display name" + + Or with flags: + + $ gcloud alpha ai tensorboard-experiments update \ + my-tensorboard-experiment --tensorboard-id=12345 \ + --display-name="updated display name" + POSITIONAL ARGUMENTS Tensorboard experiment resource - The Tensorboard experiment to update. The arguments in this group can be used to specify the attributes of this diff --git a/gcloud/alpha/ai/tensorboard-runs/create b/gcloud/alpha/ai/tensorboard-runs/create index 50f234ace..0f21f1c49 100644 --- a/gcloud/alpha/ai/tensorboard-runs/create +++ b/gcloud/alpha/ai/tensorboard-runs/create @@ -13,6 +13,33 @@ SYNOPSIS DESCRIPTION (ALPHA) Create a new Vertex AI Tensorboard run. +EXAMPLES + To create a Tensorboard Run my-tensorboard-run in Tensorboard 12345 and + Tensorboard Experiment my-tensorboard-experiment, with the display name my + tensorboard run: + + $ gcloud alpha ai tensorboard-runs create \ + my-tensorboard-experiment \ + --tensorboard-run-id=my-tensorboard-run --tensorboard-id=12345 \ + --display-name="my tensorboard run" + + You may also provide a description and/or labels: + + $ gcloud alpha ai tensorboard-runs create \ + my-tensorboard-experiment \ + --tensorboard-run-id=my-tensorboard-run --tensorboard-id=12345 \ + --description="my description" --labels="label1=value1" \ + --labels="label2=value2" + + To create a Tensorboard Run my-tensorboard-run in Tensorboard 12345, + Tensorboard Experiment my-tensorboard-experiment, region us-central1, and + project my-project: + + $ gcloud alpha ai tensorboard-runs create \ + projects/my-project/locations/us-central1/tensorboards/12345/\ + experiments/my-tensorboard-experiment \ + --tensorboard-run-id=my-tensorboard-run + POSITIONAL ARGUMENTS Tensorboard experiment resource - The Tensorboard experiment to create a Tensorboard run. The arguments in this group can be used to specify the diff --git a/gcloud/alpha/ai/tensorboard-runs/delete b/gcloud/alpha/ai/tensorboard-runs/delete index 12073cc2a..287a61f4f 100644 --- a/gcloud/alpha/ai/tensorboard-runs/delete +++ b/gcloud/alpha/ai/tensorboard-runs/delete @@ -11,6 +11,21 @@ SYNOPSIS DESCRIPTION (ALPHA) Delete an existing Vertex AI Tensorboard run. +EXAMPLES + To delete a Tensorboard Run my-tensorboard-run in Tensorboard 12345, + Tensorboard Experiment my-tensorboard-experiment, region us-central1, and + project my-project: + + $ gcloud alpha ai tensorboard-runs delete \ + projects/my-project/locations/us-central1/tensorboards/12345/\ + experiments/my-tensorboard-experiment/runs/my-tensorboard-run + + Or with flags: + + $ gcloud alpha ai tensorboard-runs delete my-tensorboard-run \ + --tensorboard-id=12345 \ + --tensorboard-experiment-id=my-tensorboard-experiment + POSITIONAL ARGUMENTS Tensorboard run resource - The Tensorboard run to delete. The arguments in this group can be used to specify the attributes of this resource. (NOTE) diff --git a/gcloud/alpha/ai/tensorboard-runs/describe b/gcloud/alpha/ai/tensorboard-runs/describe index 9ac15792b..58711664a 100644 --- a/gcloud/alpha/ai/tensorboard-runs/describe +++ b/gcloud/alpha/ai/tensorboard-runs/describe @@ -12,6 +12,21 @@ DESCRIPTION (ALPHA) Get detailed Tensorboard run information about the given Tensorboard run id. +EXAMPLES + To describe a Tensorboard Run my-tensorboard-run in Tensorboard 12345, + Tensorboard Experiment my-tensorboard-experiment, region us-central1, and + project my-project: + + $ gcloud alpha ai tensorboard-runs describe \ + projects/my-project/locations/us-central1/tensorboards/12345/\ + experiments/my-tensorboard-experiment/runs/my-tensorboard-run + + Or with flags: + + $ gcloud alpha ai tensorboard-runs describe my-tensorboard-run \ + --tensorboard-id=12345 \ + --tensorboard-experiment-id=my-tensorboard-experiment + POSITIONAL ARGUMENTS Tensorboard run resource - The Tensorboard run to describe. The arguments in this group can be used to specify the attributes of this resource. diff --git a/gcloud/alpha/ai/tensorboard-runs/list b/gcloud/alpha/ai/tensorboard-runs/list index b9baf887f..7abbb6d23 100644 --- a/gcloud/alpha/ai/tensorboard-runs/list +++ b/gcloud/alpha/ai/tensorboard-runs/list @@ -13,6 +13,13 @@ DESCRIPTION (ALPHA) List the Tensorboard runs of the given project, region, and Tensorboard experiment. +EXAMPLES + To list Tensorboard Runs in Tensorboard 12345 and Tensorboard Experiment + my-tensorboard-experiment: + + $ gcloud alpha ai tensorboard-runs list --tensorboard-id=12345 \ + --tensorboard-experiment-id=my-tensorboard-experiment + REQUIRED FLAGS Tensorboard experiment resource - To list Tensorboard runs The arguments in this group can be used to specify the attributes of this resource. diff --git a/gcloud/alpha/ai/tensorboard-runs/update b/gcloud/alpha/ai/tensorboard-runs/update index fdb71bab3..6deae188e 100644 --- a/gcloud/alpha/ai/tensorboard-runs/update +++ b/gcloud/alpha/ai/tensorboard-runs/update @@ -13,6 +13,23 @@ SYNOPSIS DESCRIPTION (ALPHA) Update an existing Vertex AI Tensorboard run. +EXAMPLES + To update Tensorboard Time Run my-tensorboard-run in Tensorboard 12345, + Tensorboard Experiment my-tensorboard-experiment, with the display name + updated display name: + + $ gcloud alpha ai tensorboard-runs update \ + projects/my-project/locations/us-central1/tensorboards/12345/\ + experiments/my-tensorboard-experiment/runs/my-tensorboard-run \ + --display-name="updated display name" + + Or with flags: + + $ gcloud alpha ai tensorboard-runs update my-tensorboard-run \ + --tensorboard-id=12345 \ + --tensorboard-experiment-id=my-tensorboard-experiment \ + --display-name="updated display name" + POSITIONAL ARGUMENTS Tensorboard run resource - The Tensorboard run to update. The arguments in this group can be used to specify the attributes of this resource. (NOTE) diff --git a/gcloud/alpha/ai/tensorboard-time-series/create b/gcloud/alpha/ai/tensorboard-time-series/create index 0e01cbc9a..a29daf46d 100644 --- a/gcloud/alpha/ai/tensorboard-time-series/create +++ b/gcloud/alpha/ai/tensorboard-time-series/create @@ -13,6 +13,36 @@ SYNOPSIS DESCRIPTION (ALPHA) Create a new Vertex AI Tensorboard time series. +EXAMPLES + To create a Tensorboard Time Series in Tensorboard 12345, Tensorboard + Experiment my-tensorboard-experiment, and in Tensorboard Run + my-tensorboard-run, with the display name my tensorboard time series and + type Scalar: + + $ gcloud alpha ai tensorboard-time-series create \ + my-tensorboard-run \ + --tensorboard-experiment-id=my-tensorboard-experiment \ + --tensorboard-id=12345 \ + --display-name="my tensorboard time series" --type=SCALAR + + You may also provide a description: + + $ gcloud alpha ai tensorboard-time-series create \ + my-tensorboard-run \ + --tensorboard-experiment-id=my-tensorboard-experiment \ + --tensorboard-id=12345 \ + --display-name="my tensorboard time series" --type=SCALAR \ + --description="my description" + + To create a Tensorboard Time Series in Tensorboard 12345, Tensorboard + Experiment my-tensorboard-experiment, Tensorboard Run my-tensorboard-run, + region us-central1, and project my-project: + + $ gcloud alpha ai tensorboard-time-series create \ + projects/my-project/locations/us-central1/tensorboards/12345/\ + experiments/my-tensorboard-experiment/runs/my-tensorboard-run \ + --display-name="my tensorboard time series" --type=SCALAR + POSITIONAL ARGUMENTS Tensorboard run resource - The Tensorboard run to create a Tensorboard time series. The arguments in this group can be used to specify the diff --git a/gcloud/alpha/ai/tensorboard-time-series/delete b/gcloud/alpha/ai/tensorboard-time-series/delete index 053d167db..7301340e7 100644 --- a/gcloud/alpha/ai/tensorboard-time-series/delete +++ b/gcloud/alpha/ai/tensorboard-time-series/delete @@ -12,6 +12,23 @@ SYNOPSIS DESCRIPTION (ALPHA) Delete an existing Vertex AI Tensorboard time series. +EXAMPLES + To delete a Tensorboard Time Series 123 in Tensorboard 12345, Tensorboard + Experiment my-tensorboard-experiment, Tensorboard Run my-tensorboard-run, + region us-central1, and project my-project: + + $ gcloud alpha ai tensorboard-time-series delete \ + projects/my-project/locations/us-central1/tensorboards/12345/\ + experiments/my-tensorboard-experiment/runs/my-tensorboard-run/\ + timeSeries/123 + + Or with flags: + + $ gcloud alpha ai tensorboard-time-series delete 123 \ + --tensorboard-id=12345 \ + --tensorboard-experiment-id=my-tensorboard-experiment \ + --tensorboard-run-id=my-tensorboard-run + POSITIONAL ARGUMENTS Tensorboard time series resource - The Tensorboard time series to delete. The arguments in this group can be used to specify the attributes of this diff --git a/gcloud/alpha/ai/tensorboard-time-series/describe b/gcloud/alpha/ai/tensorboard-time-series/describe index 10e9a712c..0d74cbeae 100644 --- a/gcloud/alpha/ai/tensorboard-time-series/describe +++ b/gcloud/alpha/ai/tensorboard-time-series/describe @@ -13,6 +13,23 @@ DESCRIPTION (ALPHA) Get detailed Tensorboard time series information about the given Tensorboard time series id. +EXAMPLES + To describe a Tensorboard Time Series 123 in Tensorboard 12345, Tensorboard + Experiment my-tensorboard-experiment, Tensorboard Run my-tensorboard-run, + region us-central1, and project my-project: + + $ gcloud alpha ai tensorboard-time-series describe \ + projects/my-project/locations/us-central1/tensorboards/12345/\ + experiments/my-tensorboard-experiment/runs/my-tensorboard-run/\ + timeSeries/123 + + Or with flags: + + $ gcloud alpha ai tensorboard-time-series describe 123 \ + --tensorboard-id=12345 \ + --tensorboard-experiment-id=my-tensorboard-experiment \ + --tensorboard-run-id=my-tensorboard-run + POSITIONAL ARGUMENTS Tensorboard time series resource - The Tensorboard time series to describe. The arguments in this group can be used to specify the diff --git a/gcloud/alpha/ai/tensorboard-time-series/list b/gcloud/alpha/ai/tensorboard-time-series/list index 822123b3a..2c403a830 100644 --- a/gcloud/alpha/ai/tensorboard-time-series/list +++ b/gcloud/alpha/ai/tensorboard-time-series/list @@ -14,6 +14,16 @@ DESCRIPTION (ALPHA) List the Tensorboard time series of the given project, region, and Tensorboard run. +EXAMPLES + To list Tensorboard Time Series in Tensorboard 12345, Tensorboard + Experiment my-tensorboard-experiment, and Tensorboard Run + my-tensorboard-run: + + $ gcloud alpha ai tensorboard-time-series list \ + --tensorboard-id=12345 \ + --tensorboard-experiment-id=my-tensorboard-experiment \ + --tensorboard-run-id=my-tensorboard-run + REQUIRED FLAGS Tensorboard run resource - To list Tensorboard time series The arguments in this group can be used to specify the attributes of this resource. diff --git a/gcloud/alpha/ai/tensorboard-time-series/read b/gcloud/alpha/ai/tensorboard-time-series/read index 0f9e9535a..537c92c63 100644 --- a/gcloud/alpha/ai/tensorboard-time-series/read +++ b/gcloud/alpha/ai/tensorboard-time-series/read @@ -14,6 +14,23 @@ DESCRIPTION (ALPHA) Read the Tensorboard time series data from the given Tensorboard time series id. +EXAMPLES + To read Tensorboard Time Series 123 data in Tensorboard 12345, Tensorboard + Experiment my-tensorboard-experiment, Tensorboard Run my-tensorboard-run, + region us-central1, and project my-project: + + $ gcloud alpha ai tensorboard-time-series read \ + projects/my-project/locations/us-central1/tensorboards/12345/\ + experiments/my-tensorboard-experiment/runs/my-tensorboard-run/\ + timeSeries/123 + + Or with flags: + + $ gcloud alpha ai tensorboard-time-series read 123 \ + --tensorboard-id=12345 \ + --tensorboard-experiment-id=my-tensorboard-experiment \ + --tensorboard-run-id=my-tensorboard-run + POSITIONAL ARGUMENTS Tensorboard time series resource - The Tensorboard time series to read data. The arguments in this group can be used to specify the attributes of diff --git a/gcloud/alpha/ai/tensorboard-time-series/update b/gcloud/alpha/ai/tensorboard-time-series/update index 0366d995b..b3445d4ef 100644 --- a/gcloud/alpha/ai/tensorboard-time-series/update +++ b/gcloud/alpha/ai/tensorboard-time-series/update @@ -14,6 +14,25 @@ SYNOPSIS DESCRIPTION (ALPHA) Update an existing Vertex AI Tensorboard time series. +EXAMPLES + To update a Tensorboard Time Series 123 in Tensorboard 12345, Tensorboard + Experiment my-tensorboard-experiment, Tensorboard Run my-tensorboard-run, + region us-central1, and project my-project, with the display name updated + display name: + + $ gcloud alpha ai tensorboard-time-series update \ + projects/my-project/locations/us-central1/tensorboards/12345/\ + experiments/my-tensorboard-experiment/runs/my-tensorboard-run/\ + timeSeries/123 --display-name="updated display name" + + Or with flags: + + $ gcloud alpha ai tensorboard-time-series update 123 \ + --tensorboard-id=12345 \ + --tensorboard-experiment-id=my-tensorboard-experiment \ + --tensorboard-run-id=my-tensorboard-run \ + --display-name="updated display name" + POSITIONAL ARGUMENTS Tensorboard time series resource - The Tensorboard time series to update. The arguments in this group can be used to specify the attributes of this diff --git a/gcloud/alpha/ai/tensorboards/create b/gcloud/alpha/ai/tensorboards/create index 9824a4073..506fd33e9 100644 --- a/gcloud/alpha/ai/tensorboards/create +++ b/gcloud/alpha/ai/tensorboards/create @@ -12,6 +12,20 @@ SYNOPSIS DESCRIPTION (ALPHA) Create a new Vertex AI Tensorboard. +EXAMPLES + To create a Tensorboard with the display name my tensorboard: + + $ gcloud alpha ai tensorboards create --display-name="my tensorboard" + + You may also provide a description: + + $ gcloud alpha ai tensorboards create --description="my description" + + You may also provide labels: + + $ gcloud alpha ai tensorboards create --labels="label1=value1" \ + --labels="label2=value2" + REQUIRED FLAGS --display-name=DISPLAY_NAME Display name of the tensorboard. diff --git a/gcloud/alpha/ai/tensorboards/delete b/gcloud/alpha/ai/tensorboards/delete index 73fc2271b..db818ebe4 100644 --- a/gcloud/alpha/ai/tensorboards/delete +++ b/gcloud/alpha/ai/tensorboards/delete @@ -9,6 +9,16 @@ SYNOPSIS DESCRIPTION (ALPHA) Delete an existing Vertex AI Tensorboard. +EXAMPLES + To delete a Tensorboard 12345 in region us-central1 and project my-project: + + $ gcloud alpha ai tensorboards delete \ + projects/my-project/locations/us-central1/tensorboards/12345 + + Or with flags: + + $ gcloud alpha ai tensorboards delete 12345 + POSITIONAL ARGUMENTS Tensorboard resource - The tensorboard to delete. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some diff --git a/gcloud/alpha/ai/tensorboards/describe b/gcloud/alpha/ai/tensorboards/describe index 3d6f65d5d..4cef6911d 100644 --- a/gcloud/alpha/ai/tensorboards/describe +++ b/gcloud/alpha/ai/tensorboards/describe @@ -10,6 +10,17 @@ DESCRIPTION (ALPHA) Gets detailed Tensorboard information about the given Tensorboard id. +EXAMPLES + To describe a Tensorboard 12345 in region us-central1 and project + my-project: + + $ gcloud alpha ai tensorboards describe \ + projects/my-project/locations/us-central1/tensorboards/12345 + + Or with flags: + + $ gcloud alpha ai tensorboards describe 12345 + POSITIONAL ARGUMENTS Tensorboard resource - The tensorboard to describe. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some diff --git a/gcloud/alpha/ai/tensorboards/list b/gcloud/alpha/ai/tensorboards/list index 3a3922d41..26e7692ee 100644 --- a/gcloud/alpha/ai/tensorboards/list +++ b/gcloud/alpha/ai/tensorboards/list @@ -10,6 +10,11 @@ SYNOPSIS DESCRIPTION (ALPHA) Lists the Tensorboards of the given project and region. +EXAMPLES + To list Tensorboards: + + $ gcloud alpha ai tensorboards list + FLAGS Region resource - Cloud region to list Tensorboards. This represents a Cloud resource. (NOTE) Some attributes are not given arguments in this diff --git a/gcloud/alpha/ai/tensorboards/update b/gcloud/alpha/ai/tensorboards/update index ca5d79490..21001dbc6 100644 --- a/gcloud/alpha/ai/tensorboards/update +++ b/gcloud/alpha/ai/tensorboards/update @@ -11,6 +11,14 @@ SYNOPSIS DESCRIPTION (ALPHA) Update an existing Vertex AI Tensorboard. +EXAMPLES + To update a Tensorboard 12345, in region us-central1 and project + my-project, with the display name updated display name: + + $ gcloud alpha ai tensorboards update \ + projects/my-project/locations/us-central1/tensorboards/12345 \ + --display-name="updated display name" + POSITIONAL ARGUMENTS Tensorboard resource - The tensorboard to update. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some diff --git a/gcloud/alpha/bigtable/app-profiles/create b/gcloud/alpha/bigtable/app-profiles/create index fa83e0435..8eaea2dd0 100644 --- a/gcloud/alpha/bigtable/app-profiles/create +++ b/gcloud/alpha/bigtable/app-profiles/create @@ -7,7 +7,8 @@ SYNOPSIS (APP_PROFILE : --instance=INSTANCE) ([--route-any : --restrict-to=[RESTRICT_TO,...]] | [--route-to=ROUTE_TO : --transactional-writes]) - [--description=DESCRIPTION] [--force] [GCLOUD_WIDE_FLAG ...] + [--description=DESCRIPTION] [--force] [--priority=PRIORITY] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Create a new Bigtable app profile. @@ -31,6 +32,11 @@ EXAMPLES --instance=my-instance-id --route-any \ --description="Routes requests for my use case" + To create an app profile with a request priority of PRIORITY_MEDIUM, run: + + $ gcloud alpha bigtable app-profiles create my-app-profile-id \ + --instance=my-instance-id --route-any --priority=PRIORITY_MEDIUM + POSITIONAL ARGUMENTS App profile resource - The app profile to create. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some @@ -96,6 +102,17 @@ OPTIONAL FLAGS --force Ignore warnings and force create. + --priority=PRIORITY + Specify the request priority. If not specified, the app profile uses + PRIORITY_HIGH by default. PRIORITY must be one of: + + PRIORITY_HIGH + Requests are treated with high priority. + PRIORITY_LOW + Requests are treated with low priority. + PRIORITY_MEDIUM + Requests are treated with medium priority. + 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/bigtable/app-profiles/update b/gcloud/alpha/bigtable/app-profiles/update index 72e48cfb4..52dc200bd 100644 --- a/gcloud/alpha/bigtable/app-profiles/update +++ b/gcloud/alpha/bigtable/app-profiles/update @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud alpha bigtable app-profiles update (APP_PROFILE : --instance=INSTANCE) [--async] - [--description=DESCRIPTION] [--force] + [--description=DESCRIPTION] [--force] [--priority=PRIORITY] [[--route-any : --restrict-to=[RESTRICT_TO,...]] | [--route-to=ROUTE_TO : --transactional-writes]] [GCLOUD_WIDE_FLAG ...] @@ -30,6 +30,11 @@ EXAMPLES $ gcloud alpha bigtable app-profiles update my-app-profile-id \ --instance=my-instance-id --description="New description" + To update the request priority for an app profile to PRIORITY_LOW, run: + + $ gcloud alpha bigtable app-profiles update my-app-profile-id \ + --instance=my-instance-id --priority=PRIORITY_LOW + POSITIONAL ARGUMENTS App profile resource - The app profile to update. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some @@ -73,6 +78,17 @@ FLAGS --force Ignore warnings and force update. + --priority=PRIORITY + Specify the request priority. If not specified, the app profile uses + PRIORITY_HIGH by default. PRIORITY must be one of: + + PRIORITY_HIGH + Requests are treated with high priority. + PRIORITY_LOW + Requests are treated with low priority. + PRIORITY_MEDIUM + Requests are treated with medium priority. + At most one of these can be specified: Multi Cluster Routing Policy diff --git a/gcloud/alpha/bms/instances/auth-info b/gcloud/alpha/bms/instances/auth-info new file mode 100644 index 000000000..9ab82f3d3 --- /dev/null +++ b/gcloud/alpha/bms/instances/auth-info @@ -0,0 +1,62 @@ +NAME + gcloud alpha bms instances auth-info - get authentication information for a + Bare Metal Solution instance + +SYNOPSIS + gcloud alpha bms instances auth-info (INSTANCE : --region=REGION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Get authentication information for a Bare Metal Solution instance. + +EXAMPLES + To get authentication information for an instance called my-instance in + project my-project and region us-central1, run: + + $ gcloud alpha bms instances auth-info my-instance \ + --project=my-project --region=us-central1 + +POSITIONAL ARGUMENTS + Instance resource - instance. The arguments in this group can be used to + specify the attributes of this resource. (NOTE) Some attributes are not + given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument instance on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + INSTANCE + ID of the instance or fully qualified identifier for the instance. + + To set the instance attribute: + ▸ provide the argument instance on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Region of the resource. + + To set the region attribute: + ▸ provide the argument instance on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +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/bms/instances/help b/gcloud/alpha/bms/instances/help index 0f4ed811e..dd387262a 100644 --- a/gcloud/alpha/bms/instances/help +++ b/gcloud/alpha/bms/instances/help @@ -16,6 +16,10 @@ GCLOUD WIDE FLAGS COMMANDS COMMAND is one of the following: + auth-info + (ALPHA) Get authentication information for a Bare Metal Solution + instance. + describe (ALPHA) Describe a Bare Metal solution instance. diff --git a/gcloud/alpha/bms/instances/update b/gcloud/alpha/bms/instances/update index 61f596537..7a6826f9d 100644 --- a/gcloud/alpha/bms/instances/update +++ b/gcloud/alpha/bms/instances/update @@ -3,8 +3,9 @@ NAME SYNOPSIS gcloud alpha bms instances update (INSTANCE : --region=REGION) [--async] - [--[no-]enable-hyperthreading] [--os-image=OS_IMAGE] - [--update-labels=[KEY=VALUE,...]] + [--[no-]enable-hyperthreading] + [--kms-crypto-key-version=KMS_CRYPTO_KEY_VERSION] [--os-image=OS_IMAGE] + [--ssh-keys=[SSH_KEYS,...]] [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -65,9 +66,36 @@ FLAGS Enable hyperthreading for the server. Use --enable-hyperthreading to enable and --no-enable-hyperthreading to disable. + --kms-crypto-key-version=KMS_CRYPTO_KEY_VERSION + Resource ID of a KMS CryptoKeyVersion used to encrypt the initial + password. + + https://cloud.google.com/kms/docs/resource-hierarchy#key_versions + --os-image=OS_IMAGE OS image to install on the server. + SSH key resource - ssh_key. 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 --ssh-keys on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + To set the region attribute: + ◆ provide the argument --ssh-keys on the command line with a fully + specified name; + ◆ global is the only supported location. + + --ssh-keys=[SSH_KEYS,...] + IDs of the SSH keys or fully qualified identifiers for the SSH keys. + + To set the ssh_key attribute: + ▸ provide the argument --ssh-keys on the command line. + --update-labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to update. If a label exists, its value is modified. Otherwise, a new label is created. diff --git a/gcloud/alpha/composer/environments/create b/gcloud/alpha/composer/environments/create index db2e884c8..cebb80477 100644 --- a/gcloud/alpha/composer/environments/create +++ b/gcloud/alpha/composer/environments/create @@ -6,13 +6,15 @@ SYNOPSIS gcloud alpha composer environments create (ENVIRONMENT : --location=LOCATION) [--airflow-configs=[KEY=VALUE,...]] [--async] [--cloud-sql-machine-type=CLOUD_SQL_MACHINE_TYPE] + [--cloud-sql-preferred-zone=CLOUD_SQL_PREFERRED_ZONE] [--disk-size=DISK_SIZE] [--enable-cloud-data-lineage-integration] [--enable-high-resilience] [--env-variables=[NAME=VALUE,...]] [--environment-size=ENVIRONMENT_SIZE] [--labels=[KEY=VALUE,...]] [--machine-type=MACHINE_TYPE] [--node-count=NODE_COUNT] [--oauth-scopes=[SCOPE,...]] [--python-version=PYTHON_VERSION] - [--service-account=SERVICE_ACCOUNT] [--tags=[TAG,...]] - [--web-server-machine-type=WEB_SERVER_MACHINE_TYPE] [--zone=ZONE] + [--service-account=SERVICE_ACCOUNT] [--storage-bucket=STORAGE_BUCKET] + [--tags=[TAG,...]] [--web-server-machine-type=WEB_SERVER_MACHINE_TYPE] + [--zone=ZONE] [--airflow-version=AIRFLOW_VERSION | --image-version=IMAGE_VERSION] [--cloud-sql-ipv4-cidr=CLOUD_SQL_IPV4_CIDR --composer-network-ipv4-cidr=COMPOSER_NETWORK_IPV4_CIDR @@ -120,6 +122,9 @@ FLAGS available machine types is available here: https://cloud.google.com/composer/pricing#db-machine-types. + --cloud-sql-preferred-zone=CLOUD_SQL_PREFERRED_ZONE + Select cloud sql preferred zone, supported for Composer 2 Environments. + --disk-size=DISK_SIZE The disk size for each VM node in the environment. The minimum size is 20GB, and the maximum is 64TB. Specified value must be an integer @@ -184,6 +189,10 @@ FLAGS If a service account is not specified, the "default" Compute Engine service account for the project is used. Cannot be updated. + --storage-bucket=STORAGE_BUCKET + Name of an exisiting Cloud Storage bucket to be used by the + environment. Supported only for Composer 2.4.X and above. + --tags=[TAG,...] The set of instance tags applied to all node VMs. Tags are used to identify valid sources or targets for network firewalls. Each tag diff --git a/gcloud/alpha/compute/network-attachments/update b/gcloud/alpha/compute/network-attachments/update index 24e54bca5..34bc39948 100644 --- a/gcloud/alpha/compute/network-attachments/update +++ b/gcloud/alpha/compute/network-attachments/update @@ -11,9 +11,27 @@ SYNOPSIS DESCRIPTION (ALPHA) gcloud alpha compute network-attachments update is used to update - network attachments. A service consumer creates a network attachment to - make a network available to producers. Service producers use Private - Service Connect Interfaces to privately connect to the network attachment. + network attachments. You can update the following fields: description, + subnets, producer-accept-list and producer-reject-list. If you update the + producer-accept-list or producer-reject-list, the full new list should be + specified. + +EXAMPLES + To update all the parameters with the new list, run: + + $ gcloud alpha compute network-attachments update \ + NETWORK_ATTACHMENT_NAME --region=us-central1 \ + --subnets=MY_SUBNET2 \ + --description='default network attachment' \ + --producer-accept-list=PROJECT5,PROJECT6 \ + --producer-reject-list=PROJECT7,PROJECT8 + + To update a network attachment to change only the subnet to MY_SUBNET3, + run: + + $ gcloud alpha compute network-attachments update \ + NETWORK_ATTACHMENT_NAME --region=us-central1 \ + --subnets=MY_SUBNET3 POSITIONAL ARGUMENTS NAME @@ -68,5 +86,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. These variants are also available: + + $ gcloud compute network-attachments update + + $ gcloud beta compute network-attachments update diff --git a/gcloud/alpha/compute/project-zonal-metadata/add b/gcloud/alpha/compute/project-zonal-metadata/add index 7d1812d79..81b336c9f 100644 --- a/gcloud/alpha/compute/project-zonal-metadata/add +++ b/gcloud/alpha/compute/project-zonal-metadata/add @@ -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 compute project-zonal-metadata add diff --git a/gcloud/alpha/compute/project-zonal-metadata/describe b/gcloud/alpha/compute/project-zonal-metadata/describe index e19e38087..ad850d70e 100644 --- a/gcloud/alpha/compute/project-zonal-metadata/describe +++ b/gcloud/alpha/compute/project-zonal-metadata/describe @@ -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 project-zonal-metadata describe diff --git a/gcloud/alpha/compute/project-zonal-metadata/help b/gcloud/alpha/compute/project-zonal-metadata/help index 9d30923d8..510dc3ef4 100644 --- a/gcloud/alpha/compute/project-zonal-metadata/help +++ b/gcloud/alpha/compute/project-zonal-metadata/help @@ -29,5 +29,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 project-zonal-metadata diff --git a/gcloud/alpha/compute/project-zonal-metadata/remove b/gcloud/alpha/compute/project-zonal-metadata/remove index 33be8d52b..18e2ce29b 100644 --- a/gcloud/alpha/compute/project-zonal-metadata/remove +++ b/gcloud/alpha/compute/project-zonal-metadata/remove @@ -56,5 +56,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 project-zonal-metadata remove diff --git a/gcloud/alpha/config/get b/gcloud/alpha/config/get index a49b8d089..2e294e1c3 100644 --- a/gcloud/alpha/config/get +++ b/gcloud/alpha/config/get @@ -1395,6 +1395,22 @@ AVAILABLE PROPERTIES When a --region flag is required but not provided, the command will fall back to this value, if set. + workstations + cluster + Default cluster to use when working with Workstations resources. + When a --cluster flag is required but not provided, the command + will fall back to this value, if set. + + config + Default configuration to use when working with Workstations + resources. When a --config flag is required but not provided, the + command will fall back to this value, if set. + + region + Default region to use when working with Workstations resources. + When a --region flag is required but not provided, the command will + fall back to this value, if set. + NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct diff --git a/gcloud/alpha/config/help b/gcloud/alpha/config/help index 3c1347e92..3e2727950 100644 --- a/gcloud/alpha/config/help +++ b/gcloud/alpha/config/help @@ -1427,6 +1427,22 @@ AVAILABLE PROPERTIES When a --region flag is required but not provided, the command will fall back to this value, if set. + workstations + cluster + Default cluster to use when working with Workstations resources. + When a --cluster flag is required but not provided, the command + will fall back to this value, if set. + + config + Default configuration to use when working with Workstations + resources. When a --config flag is required but not provided, the + command will fall back to this value, if set. + + region + Default region to use when working with Workstations resources. + When a --region flag is required but not provided, the command will + fall back to this value, if set. + NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct diff --git a/gcloud/alpha/config/list b/gcloud/alpha/config/list index 8745172b9..2a388fd62 100644 --- a/gcloud/alpha/config/list +++ b/gcloud/alpha/config/list @@ -1439,6 +1439,22 @@ AVAILABLE PROPERTIES When a --region flag is required but not provided, the command will fall back to this value, if set. + workstations + cluster + Default cluster to use when working with Workstations resources. + When a --cluster flag is required but not provided, the command + will fall back to this value, if set. + + config + Default configuration to use when working with Workstations + resources. When a --config flag is required but not provided, the + command will fall back to this value, if set. + + region + Default region to use when working with Workstations resources. + When a --region flag is required but not provided, the command will + fall back to this value, if set. + NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct diff --git a/gcloud/alpha/config/set b/gcloud/alpha/config/set index 8a91f2230..cc02a582e 100644 --- a/gcloud/alpha/config/set +++ b/gcloud/alpha/config/set @@ -1442,6 +1442,22 @@ AVAILABLE PROPERTIES When a --region flag is required but not provided, the command will fall back to this value, if set. + workstations + cluster + Default cluster to use when working with Workstations resources. + When a --cluster flag is required but not provided, the command + will fall back to this value, if set. + + config + Default configuration to use when working with Workstations + resources. When a --config flag is required but not provided, the + command will fall back to this value, if set. + + region + Default region to use when working with Workstations resources. + When a --region flag is required but not provided, the command will + fall back to this value, if set. + NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct diff --git a/gcloud/alpha/config/unset b/gcloud/alpha/config/unset index 613fd2f4f..4871fc32c 100644 --- a/gcloud/alpha/config/unset +++ b/gcloud/alpha/config/unset @@ -1403,6 +1403,22 @@ AVAILABLE PROPERTIES When a --region flag is required but not provided, the command will fall back to this value, if set. + workstations + cluster + Default cluster to use when working with Workstations resources. + When a --cluster flag is required but not provided, the command + will fall back to this value, if set. + + config + Default configuration to use when working with Workstations + resources. When a --config flag is required but not provided, the + command will fall back to this value, if set. + + region + Default region to use when working with Workstations resources. + When a --region flag is required but not provided, the command will + fall back to this value, if set. + NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct diff --git a/gcloud/alpha/container/clusters/create b/gcloud/alpha/container/clusters/create index 0a595024e..91bf49418 100644 --- a/gcloud/alpha/container/clusters/create +++ b/gcloud/alpha/container/clusters/create @@ -423,10 +423,10 @@ FLAGS Size for node VM boot disks in GB. Defaults to 100GB. --disk-type=DISK_TYPE - Type of the node VM boot disk. For version 1.24.0+, defaults to - pd-balanced. Before version 1.24.0, defaults to pd-standard. DISK_TYPE - must be one of: pd-standard, pd-ssd, pd-balanced, hyperdisk-balanced, - hyperdisk-extreme, hyperdisk-throughput. + Type of the node VM boot disk. For version 1.24 and later, defaults to + pd-balanced. For versions earlier than 1.24, defaults to pd-standard. + DISK_TYPE must be one of: pd-standard, pd-ssd, pd-balanced, + hyperdisk-balanced, hyperdisk-extreme, hyperdisk-throughput. --enable-autorepair Enable node autorepair feature for a cluster's default node pool(s). @@ -772,9 +772,9 @@ FLAGS $ gcloud compute machine-types list - You can also specify custom machine types with the string - "custom-CPUS-RAM" where "CPUS" is the number of virtual CPUs and "RAM" - is the amount of RAM in MiB. + You can also specify custom machine types by providing a string with + the format "custom-CPUS-RAM" where "CPUS" is the number of virtual CPUs + and "RAM" is the amount of RAM in MiB. For example, to create a node pool using custom machines with 2 vCPUs and 12 GB of RAM: diff --git a/gcloud/alpha/container/fleet/mesh/disable b/gcloud/alpha/container/fleet/mesh/disable index a4626285a..d3e413e07 100644 --- a/gcloud/alpha/container/fleet/mesh/disable +++ b/gcloud/alpha/container/fleet/mesh/disable @@ -12,6 +12,11 @@ EXAMPLES $ gcloud alpha container fleet mesh disable + To delete the fleet-level default Membership configuration, run: + + $ gcloud alpha container fleet mesh disable \ + --fleet-default-member-config + FLAGS --force Disable this feature, even if it is currently in use. Force disablement diff --git a/gcloud/alpha/container/fleet/mesh/enable b/gcloud/alpha/container/fleet/mesh/enable index 6c9524db6..a25f76d58 100644 --- a/gcloud/alpha/container/fleet/mesh/enable +++ b/gcloud/alpha/container/fleet/mesh/enable @@ -12,6 +12,12 @@ EXAMPLES $ gcloud alpha container fleet mesh enable + To enable the Service Mesh Feature with a fleet-level default Membership + configuration, run: + + $ gcloud alpha container fleet mesh enable \ + --fleet-default-member-config=/path/to/service-mesh.yaml + 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/container/fleet/mesh/update b/gcloud/alpha/container/fleet/mesh/update index 7d772f903..0d1b0e893 100644 --- a/gcloud/alpha/container/fleet/mesh/update +++ b/gcloud/alpha/container/fleet/mesh/update @@ -4,9 +4,9 @@ NAME SYNOPSIS gcloud alpha container fleet mesh update - (--control-plane=CONTROL_PLANE --management=MANAGEMENT) - [--membership=MEMBERSHIP - | [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]] + ([(--control-plane=CONTROL_PLANE --management=MANAGEMENT) + : --membership=MEMBERSHIP + | [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]]) [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -21,58 +21,59 @@ EXAMPLES --control-plane=CONTROL_PLANE REQUIRED FLAGS - At least one of these must be specified: + Exactly one of these must be specified: - --control-plane=CONTROL_PLANE - (DEPRECATED) The control plane management to update to. + At least one of these must be specified: - The --control-plane flag is now deprecated. Please use --management - instead. See - https://cloud.google.com/service-mesh/docs/managed/provision-managed-anthos-service-mesh. - CONTROL_PLANE must be one of: automatic, manual. + --control-plane=CONTROL_PLANE + (DEPRECATED) Control plane management to update to. - --management=MANAGEMENT - The management mode to update to. MANAGEMENT must be one of: - automatic, manual. + The --control-plane flag is now deprecated. Please use --management + instead. See + https://cloud.google.com/service-mesh/docs/managed/provision-managed-anthos-service-mesh. + CONTROL_PLANE must be one of: automatic, manual. -OPTIONAL FLAGS - At most one of these can be specified: + --management=MANAGEMENT + The management mode to update to. MANAGEMENT must be one of: + automatic, manual. - --membership=MEMBERSHIP - (DEPRECATED) Membership name to update. + At most one of these can be specified: - The --membership flag is now deprecated. Please use --memberships - instead. + --membership=MEMBERSHIP + (DEPRECATED) Membership name to update. - Membership resource - The group of arguments defining one or more - memberships. The arguments in this group can be used to specify the - attributes of this resource. (NOTE) Some attributes are not given - arguments in this group but can be set in other ways. + The --membership flag is now deprecated. Please use --memberships + instead. - To set the project attribute: - ▸ provide the argument --memberships on the command line with a fully - specified name; - ▸ provide the argument --project on the command line; - ▸ set the property core/project. + Membership resource - The group of arguments defining one or more + memberships. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. - --memberships=[MEMBERSHIPS,...] - IDs of the memberships or fully qualified identifiers for the - memberships. + To set the project attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --project on the command line; + ▫ set the property core/project. - To set the memberships attribute: - ▫ provide the argument --memberships on the command line. + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. - This flag argument must be specified if any of the other arguments - in this group are specified. + To set the memberships attribute: + ◇ provide the argument --memberships on the command line. - --location=LOCATION - Location for the memberships. + This flag argument must be specified if any of the other + arguments in this group are specified. - To set the location attribute: - ▫ provide the argument --memberships on the command line with a - fully specified name; - ▫ provide the argument --location on the command line; - ▫ set the property gkehub/location. + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ◇ provide the argument --memberships on the command line with a + fully specified name; + ◇ provide the argument --location on the command line; + ◇ set the property gkehub/location. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/container/hub/mesh/disable b/gcloud/alpha/container/hub/mesh/disable index 280ce74f7..2a6cf86d4 100644 --- a/gcloud/alpha/container/hub/mesh/disable +++ b/gcloud/alpha/container/hub/mesh/disable @@ -12,6 +12,11 @@ EXAMPLES $ gcloud alpha container hub mesh disable + To delete the fleet-level default Membership configuration, run: + + $ gcloud alpha container hub mesh disable \ + --fleet-default-member-config + FLAGS --force Disable this feature, even if it is currently in use. Force disablement diff --git a/gcloud/alpha/container/hub/mesh/enable b/gcloud/alpha/container/hub/mesh/enable index ab7f440ed..2add1c997 100644 --- a/gcloud/alpha/container/hub/mesh/enable +++ b/gcloud/alpha/container/hub/mesh/enable @@ -12,6 +12,12 @@ EXAMPLES $ gcloud alpha container hub mesh enable + To enable the Service Mesh Feature with a fleet-level default Membership + configuration, run: + + $ gcloud alpha container hub mesh enable \ + --fleet-default-member-config=/path/to/service-mesh.yaml + 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/container/hub/mesh/update b/gcloud/alpha/container/hub/mesh/update index 0116f4055..8f9bef11f 100644 --- a/gcloud/alpha/container/hub/mesh/update +++ b/gcloud/alpha/container/hub/mesh/update @@ -4,9 +4,9 @@ NAME SYNOPSIS gcloud alpha container hub mesh update - (--control-plane=CONTROL_PLANE --management=MANAGEMENT) - [--membership=MEMBERSHIP - | [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]] + ([(--control-plane=CONTROL_PLANE --management=MANAGEMENT) + : --membership=MEMBERSHIP + | [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]]) [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -21,58 +21,59 @@ EXAMPLES --control-plane=CONTROL_PLANE REQUIRED FLAGS - At least one of these must be specified: + Exactly one of these must be specified: - --control-plane=CONTROL_PLANE - (DEPRECATED) The control plane management to update to. + At least one of these must be specified: - The --control-plane flag is now deprecated. Please use --management - instead. See - https://cloud.google.com/service-mesh/docs/managed/provision-managed-anthos-service-mesh. - CONTROL_PLANE must be one of: automatic, manual. + --control-plane=CONTROL_PLANE + (DEPRECATED) Control plane management to update to. - --management=MANAGEMENT - The management mode to update to. MANAGEMENT must be one of: - automatic, manual. + The --control-plane flag is now deprecated. Please use --management + instead. See + https://cloud.google.com/service-mesh/docs/managed/provision-managed-anthos-service-mesh. + CONTROL_PLANE must be one of: automatic, manual. -OPTIONAL FLAGS - At most one of these can be specified: + --management=MANAGEMENT + The management mode to update to. MANAGEMENT must be one of: + automatic, manual. - --membership=MEMBERSHIP - (DEPRECATED) Membership name to update. + At most one of these can be specified: - The --membership flag is now deprecated. Please use --memberships - instead. + --membership=MEMBERSHIP + (DEPRECATED) Membership name to update. - Membership resource - The group of arguments defining one or more - memberships. The arguments in this group can be used to specify the - attributes of this resource. (NOTE) Some attributes are not given - arguments in this group but can be set in other ways. + The --membership flag is now deprecated. Please use --memberships + instead. - To set the project attribute: - ▸ provide the argument --memberships on the command line with a fully - specified name; - ▸ provide the argument --project on the command line; - ▸ set the property core/project. + Membership resource - The group of arguments defining one or more + memberships. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. - --memberships=[MEMBERSHIPS,...] - IDs of the memberships or fully qualified identifiers for the - memberships. + To set the project attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --project on the command line; + ▫ set the property core/project. - To set the memberships attribute: - ▫ provide the argument --memberships on the command line. + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. - This flag argument must be specified if any of the other arguments - in this group are specified. + To set the memberships attribute: + ◇ provide the argument --memberships on the command line. - --location=LOCATION - Location for the memberships. + This flag argument must be specified if any of the other + arguments in this group are specified. - To set the location attribute: - ▫ provide the argument --memberships on the command line with a - fully specified name; - ▫ provide the argument --location on the command line; - ▫ set the property gkehub/location. + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ◇ provide the argument --memberships on the command line with a + fully specified name; + ◇ provide the argument --location on the command line; + ◇ set the property gkehub/location. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/container/node-pools/create b/gcloud/alpha/container/node-pools/create index c00be9de2..7ff6c8fb0 100644 --- a/gcloud/alpha/container/node-pools/create +++ b/gcloud/alpha/container/node-pools/create @@ -192,10 +192,10 @@ FLAGS Size for node VM boot disks in GB. Defaults to 100GB. --disk-type=DISK_TYPE - Type of the node VM boot disk. For version 1.24.0+, defaults to - pd-balanced. Before version 1.24.0, defaults to pd-standard. DISK_TYPE - must be one of: pd-standard, pd-ssd, pd-balanced, hyperdisk-balanced, - hyperdisk-extreme, hyperdisk-throughput. + Type of the node VM boot disk. For version 1.24 and later, defaults to + pd-balanced. For versions earlier than 1.24, defaults to pd-standard. + DISK_TYPE must be one of: pd-standard, pd-ssd, pd-balanced, + hyperdisk-balanced, hyperdisk-extreme, hyperdisk-throughput. --enable-autoprovisioning Enables Cluster Autoscaler to treat the node pool as if it was @@ -313,9 +313,9 @@ FLAGS $ gcloud compute machine-types list - You can also specify custom machine types with the string - "custom-CPUS-RAM" where "CPUS" is the number of virtual CPUs and "RAM" - is the amount of RAM in MiB. + You can also specify custom machine types by providing a string with + the format "custom-CPUS-RAM" where "CPUS" is the number of virtual CPUs + and "RAM" is the amount of RAM in MiB. For example, to create a node pool using custom machines with 2 vCPUs and 12 GB of RAM: diff --git a/gcloud/alpha/container/node-pools/update b/gcloud/alpha/container/node-pools/update index 31b8c3d02..079f3debe 100644 --- a/gcloud/alpha/container/node-pools/update +++ b/gcloud/alpha/container/node-pools/update @@ -19,7 +19,8 @@ SYNOPSIS --node-pool-soak-duration=NODE_POOL_SOAK_DURATION --standard-rollout-policy=[batch-node-count=BATCH_NODE_COUNT, batch-percent=BATCH_NODE_PERCENTAGE, - batch-soak-duration=BATCH_SOAK_DURATION,...] + batch-soak-duration=BATCH_SOAK_DURATION,...] | --disk-size=DISK_SIZE + --disk-type=DISK_TYPE --machine-type=MACHINE_TYPE | --enable-autoprovisioning --enable-autoscaling --location-policy=LOCATION_POLICY --max-nodes=MAX_NODES --min-nodes=MIN_NODES @@ -354,6 +355,35 @@ REQUIRED FLAGS --standard-rollout-policy=batch-percent=0.3,\ batch-soak-duration=60s + Node config + + --disk-size=DISK_SIZE + Size for node VM boot disks in GB. Defaults to 100GB. + + --disk-type=DISK_TYPE + Type of the node VM boot disk. For version 1.24 and later, defaults + to pd-balanced. For versions earlier than 1.24, defaults to + pd-standard. DISK_TYPE must be one of: pd-standard, pd-ssd, + pd-balanced, hyperdisk-balanced, hyperdisk-extreme, + hyperdisk-throughput. + + --machine-type=MACHINE_TYPE + The type of machine to use for nodes. Defaults to e2-medium. The + list of predefined machine types is available using the following + command: + + $ gcloud compute machine-types list + + You can also specify custom machine types by providing a string + with the format "custom-CPUS-RAM" where "CPUS" is the number of + virtual CPUs and "RAM" is the amount of RAM in MiB. + + For example, to create a node pool using custom machines with 2 + vCPUs and 12 GB of RAM: + + $ gcloud alpha container node-pools update high-mem-pool \ + --machine-type=custom-2-12288 + Cluster autoscaling --enable-autoprovisioning diff --git a/gcloud/alpha/container/vmware/clusters/create b/gcloud/alpha/container/vmware/clusters/create index ca48138bb..c3edcb86a 100644 --- a/gcloud/alpha/container/vmware/clusters/create +++ b/gcloud/alpha/container/vmware/clusters/create @@ -29,7 +29,8 @@ SYNOPSIS [ips=IPS],[netmask=NETMASK]) [--admin-users=ADMIN_USERS] [--annotations=[KEY=VALUE,...]] [--async] [--description=DESCRIPTION] [--disable-aag-config] [--disable-vsphere-csi] [--enable-auto-repair] - [--enable-vm-tracking] [--upgrade-control-plane=UPGRADE_CONTROL_PLANE] + [--enable-vm-tracking] + [--upgrade-policy=[control-plane-only=CONTROL-PLANE-ONLY]] [--validate-only] [--cpus=CPUS --enable-auto-resize --memory=MEMORY --replicas=REPLICAS] [--disable-control-plane-v2 | --enable-control-plane-v2] @@ -336,21 +337,39 @@ OPTIONAL FLAGS Upgrade policy for the cluster. - --upgrade-control-plane=UPGRADE_CONTROL_PLANE - If not specified, node pools are upgraded together with the control - plane. + --upgrade-policy=[control-plane-only=CONTROL-PLANE-ONLY] + If not specified, control-plane-only is set to False. In the next + upgrade operation, all worker node pools will be upgraded together + with the control plane. - Examples: + Example: - To upgrade control plane only and keep node pools version unchanged, + To upgrade the control plane only and keep worker node pools version unchanged, first specify the policy: - $ gcloud alpha container vmware clusters create \ - --upgrade-control-plane=True + $ gcloud alpha container vmware clusters create CLUSTER \ + --upgrade-policy control-plane-only=True - To upgrade both control plane and node pools, + Then to start the upgrade operation using the specified policy, run: - $ gcloud alpha container vmware clusters create \ - --upgrade-control-plane=False + $ gcloud alpha container vmware clusters upgrade CLUSTER \ + --version=VERSION + + After upgrading only the cluster control plane, to upgrade an individual node pool, run: + + $ gcloud alpha container vmware node-pools update NODE_POOL \ + --version=VERSION + + Example: + + Alternatively, to upgrade both the control plane and all worker node pools, first specify the policy: + + $ gcloud alpha container vmware clusters create CLUSTER \ + --upgrade-policy control-plane-only=False + + Then to start the upgrade operation using the specified policy, run: + + $ gcloud alpha container vmware clusters upgrade CLUSTER \ + --version=VERSION --validate-only If set, only validate the request, but do not actually perform the diff --git a/gcloud/alpha/container/vmware/clusters/update b/gcloud/alpha/container/vmware/clusters/update index be3e9ffd6..2ad5ece1e 100644 --- a/gcloud/alpha/container/vmware/clusters/update +++ b/gcloud/alpha/container/vmware/clusters/update @@ -11,8 +11,8 @@ SYNOPSIS [manual-assign=MANUAL-ASSIGN],[pool=POOL]] [--static-ip-config-ip-blocks=[gateway=GATEWAY], [ips=IPS],[netmask=NETMASK]] - [--upgrade-control-plane=UPGRADE_CONTROL_PLANE] [--validate-only] - [--version=VERSION] + [--upgrade-policy=[control-plane-only=CONTROL-PLANE-ONLY]] + [--validate-only] [--version=VERSION] [--add-annotations=[KEY1=VALUE1,KEY2=VALUE2,...] | --remove-annotations=[KEY1,KEY2,...]] [--cpus=CPUS --memory=MEMORY --disable-auto-resize @@ -135,21 +135,39 @@ FLAGS Upgrade policy for the cluster. - --upgrade-control-plane=UPGRADE_CONTROL_PLANE - If not specified, node pools are upgraded together with the control - plane. + --upgrade-policy=[control-plane-only=CONTROL-PLANE-ONLY] + If not specified, control-plane-only is set to False. In the next + upgrade operation, all worker node pools will be upgraded together + with the control plane. - Examples: + Example: - To upgrade control plane only and keep node pools version unchanged, + To upgrade the control plane only and keep worker node pools version unchanged, first specify the policy: - $ gcloud alpha container vmware clusters update \ - --upgrade-control-plane=True + $ gcloud alpha container vmware clusters update CLUSTER \ + --upgrade-policy control-plane-only=True - To upgrade both control plane and node pools, + Then to start the upgrade operation using the specified policy, run: - $ gcloud alpha container vmware clusters update \ - --upgrade-control-plane=False + $ gcloud alpha container vmware clusters upgrade CLUSTER \ + --version=VERSION + + After upgrading only the cluster control plane, to upgrade an individual node pool, run: + + $ gcloud alpha container vmware node-pools update NODE_POOL \ + --version=VERSION + + Example: + + Alternatively, to upgrade both the control plane and all worker node pools, first specify the policy: + + $ gcloud alpha container vmware clusters update CLUSTER \ + --upgrade-policy control-plane-only=False + + Then to start the upgrade operation using the specified policy, run: + + $ gcloud alpha container vmware clusters upgrade CLUSTER \ + --version=VERSION --validate-only If set, only validate the request, but do not actually perform the diff --git a/gcloud/alpha/dataproc/jobs/submit/flink b/gcloud/alpha/dataproc/jobs/submit/flink index 05fe573b5..c9dc5d0e4 100644 --- a/gcloud/alpha/dataproc/jobs/submit/flink +++ b/gcloud/alpha/dataproc/jobs/submit/flink @@ -6,7 +6,9 @@ SYNOPSIS (--class=MAIN_CLASS | --jar=MAIN_JAR) (--cluster=CLUSTER | --cluster-labels=[KEY=VALUE,...]) [--async] [--bucket=BUCKET] [--driver-log-levels=[PACKAGE=LEVEL,...]] - [--jars=[JAR,...]] [--labels=[KEY=VALUE,...]] + [--driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB] + [--driver-required-vcores=DRIVER_REQUIRED_VCORES] [--jars=[JAR,...]] + [--labels=[KEY=VALUE,...]] [--max-failures-per-hour=MAX_FAILURES_PER_HOUR] [--max-failures-total=MAX_FAILURES_TOTAL] [--properties=[PROPERTY=VALUE,...]] [--properties-file=PROPERTIES_FILE] @@ -79,6 +81,16 @@ OPTIONAL FLAGS List of package to log4j log level pairs to configure driver logging. For example: root=FATAL,com.example=INFO. + --driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB + The memory allocation requested by the job driver in megabytes (MB) for + execution on the driver node group (it is used only by clusters with a + driver node group). + + --driver-required-vcores=DRIVER_REQUIRED_VCORES + The vCPU allocation requested by the job driver for execution on the + driver node group (it is used only by clusters with a driver node + group). + --jars=[JAR,...] Comma-separated list of jar files to provide to the task manager classpaths. diff --git a/gcloud/alpha/dataproc/jobs/submit/hadoop b/gcloud/alpha/dataproc/jobs/submit/hadoop index e47137069..4bb3e9d73 100644 --- a/gcloud/alpha/dataproc/jobs/submit/hadoop +++ b/gcloud/alpha/dataproc/jobs/submit/hadoop @@ -6,7 +6,9 @@ SYNOPSIS (--class=MAIN_CLASS | --jar=MAIN_JAR) (--cluster=CLUSTER | --cluster-labels=[KEY=VALUE,...]) [--archives=[ARCHIVE,...]] [--async] [--bucket=BUCKET] - [--driver-log-levels=[PACKAGE=LEVEL,...]] [--files=[FILE,...]] + [--driver-log-levels=[PACKAGE=LEVEL,...]] + [--driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB] + [--driver-required-vcores=DRIVER_REQUIRED_VCORES] [--files=[FILE,...]] [--jars=[JAR,...]] [--labels=[KEY=VALUE,...]] [--max-failures-per-hour=MAX_FAILURES_PER_HOUR] [--max-failures-total=MAX_FAILURES_TOTAL] @@ -83,6 +85,16 @@ OPTIONAL FLAGS A list of package to log4j log level pairs to configure driver logging. For example: root=FATAL,com.example=INFO + --driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB + The memory allocation requested by the job driver in megabytes (MB) for + execution on the driver node group (it is used only by clusters with a + driver node group). + + --driver-required-vcores=DRIVER_REQUIRED_VCORES + The vCPU allocation requested by the job driver for execution on the + driver node group (it is used only by clusters with a driver node + group). + --files=[FILE,...] Comma separated list of file paths to be provided to the job. A file path can either be a path to a local file or a path to a file already diff --git a/gcloud/alpha/dataproc/jobs/submit/hive b/gcloud/alpha/dataproc/jobs/submit/hive index 2317e0ab8..3d84ae29a 100644 --- a/gcloud/alpha/dataproc/jobs/submit/hive +++ b/gcloud/alpha/dataproc/jobs/submit/hive @@ -5,7 +5,9 @@ SYNOPSIS gcloud alpha dataproc jobs submit hive (--cluster=CLUSTER | --cluster-labels=[KEY=VALUE,...]) (--execute=QUERY, -e QUERY | --file=FILE, -f FILE) [--async] - [--bucket=BUCKET] [--continue-on-failure] [--jars=[JAR,...]] + [--bucket=BUCKET] [--continue-on-failure] + [--driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB] + [--driver-required-vcores=DRIVER_REQUIRED_VCORES] [--jars=[JAR,...]] [--labels=[KEY=VALUE,...]] [--max-failures-per-hour=MAX_FAILURES_PER_HOUR] [--max-failures-total=MAX_FAILURES_TOTAL] [--params=[PARAM=VALUE,...]] @@ -63,6 +65,16 @@ OPTIONAL FLAGS --continue-on-failure Whether to continue if a single query fails. + --driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB + The memory allocation requested by the job driver in megabytes (MB) for + execution on the driver node group (it is used only by clusters with a + driver node group). + + --driver-required-vcores=DRIVER_REQUIRED_VCORES + The vCPU allocation requested by the job driver for execution on the + driver node group (it is used only by clusters with a driver node + group). + --jars=[JAR,...] Comma separated list of jar files to be provided to the Hive and MR. May contain UDFs. diff --git a/gcloud/alpha/dataproc/jobs/submit/pig b/gcloud/alpha/dataproc/jobs/submit/pig index bebd4ef4d..873f5a06f 100644 --- a/gcloud/alpha/dataproc/jobs/submit/pig +++ b/gcloud/alpha/dataproc/jobs/submit/pig @@ -6,7 +6,9 @@ SYNOPSIS (--cluster=CLUSTER | --cluster-labels=[KEY=VALUE,...]) (--execute=QUERY, -e QUERY | --file=FILE, -f FILE) [--async] [--bucket=BUCKET] [--continue-on-failure] - [--driver-log-levels=[PACKAGE=LEVEL,...]] [--jars=[JAR,...]] + [--driver-log-levels=[PACKAGE=LEVEL,...]] + [--driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB] + [--driver-required-vcores=DRIVER_REQUIRED_VCORES] [--jars=[JAR,...]] [--labels=[KEY=VALUE,...]] [--max-failures-per-hour=MAX_FAILURES_PER_HOUR] [--max-failures-total=MAX_FAILURES_TOTAL] [--params=[PARAM=VALUE,...]] @@ -71,6 +73,16 @@ OPTIONAL FLAGS A list of package to log4j log level pairs to configure driver logging. For example: root=FATAL,com.example=INFO + --driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB + The memory allocation requested by the job driver in megabytes (MB) for + execution on the driver node group (it is used only by clusters with a + driver node group). + + --driver-required-vcores=DRIVER_REQUIRED_VCORES + The vCPU allocation requested by the job driver for execution on the + driver node group (it is used only by clusters with a driver node + group). + --jars=[JAR,...] Comma separated list of jar files to be provided to Pig and MR. May contain UDFs. diff --git a/gcloud/alpha/dataproc/jobs/submit/presto b/gcloud/alpha/dataproc/jobs/submit/presto index ce436e276..7631d96e0 100644 --- a/gcloud/alpha/dataproc/jobs/submit/presto +++ b/gcloud/alpha/dataproc/jobs/submit/presto @@ -7,6 +7,8 @@ SYNOPSIS (--execute=QUERY, -e QUERY | --file=FILE, -f FILE) [--async] [--bucket=BUCKET] [--client-tags=[CLIENT_TAG,...]] [--continue-on-failure] [--driver-log-levels=[PACKAGE=LEVEL,...]] + [--driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB] + [--driver-required-vcores=DRIVER_REQUIRED_VCORES] [--labels=[KEY=VALUE,...]] [--max-failures-per-hour=MAX_FAILURES_PER_HOUR] [--max-failures-total=MAX_FAILURES_TOTAL] @@ -71,6 +73,16 @@ OPTIONAL FLAGS A list of package-to-log4j log level pairs to configure driver logging. For example: root=FATAL,com.example=INFO + --driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB + The memory allocation requested by the job driver in megabytes (MB) for + execution on the driver node group (it is used only by clusters with a + driver node group). + + --driver-required-vcores=DRIVER_REQUIRED_VCORES + The vCPU allocation requested by the job driver for execution on the + driver node group (it is used only by clusters with a driver node + group). + --labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to add. diff --git a/gcloud/alpha/dataproc/jobs/submit/pyspark b/gcloud/alpha/dataproc/jobs/submit/pyspark index 4efba8654..215a211b6 100644 --- a/gcloud/alpha/dataproc/jobs/submit/pyspark +++ b/gcloud/alpha/dataproc/jobs/submit/pyspark @@ -6,7 +6,9 @@ SYNOPSIS gcloud alpha dataproc jobs submit pyspark PY_FILE (--cluster=CLUSTER | --cluster-labels=[KEY=VALUE,...]) [--archives=[ARCHIVE,...]] [--async] [--bucket=BUCKET] - [--driver-log-levels=[PACKAGE=LEVEL,...]] [--files=[FILE,...]] + [--driver-log-levels=[PACKAGE=LEVEL,...]] + [--driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB] + [--driver-required-vcores=DRIVER_REQUIRED_VCORES] [--files=[FILE,...]] [--jars=[JAR,...]] [--labels=[KEY=VALUE,...]] [--max-failures-per-hour=MAX_FAILURES_PER_HOUR] [--max-failures-total=MAX_FAILURES_TOTAL] @@ -74,6 +76,16 @@ OPTIONAL FLAGS package and value is the log4j log level. For example: root=FATAL,com.example=INFO + --driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB + The memory allocation requested by the job driver in megabytes (MB) for + execution on the driver node group (it is used only by clusters with a + driver node group). + + --driver-required-vcores=DRIVER_REQUIRED_VCORES + The vCPU allocation requested by the job driver for execution on the + driver node group (it is used only by clusters with a driver node + group). + --files=[FILE,...] Comma separated list of files to be placed in the working directory of both the app master and executors. diff --git a/gcloud/alpha/dataproc/jobs/submit/spark b/gcloud/alpha/dataproc/jobs/submit/spark index 1c06f0906..2ae9392d1 100644 --- a/gcloud/alpha/dataproc/jobs/submit/spark +++ b/gcloud/alpha/dataproc/jobs/submit/spark @@ -6,7 +6,9 @@ SYNOPSIS (--class=MAIN_CLASS | --jar=MAIN_JAR) (--cluster=CLUSTER | --cluster-labels=[KEY=VALUE,...]) [--archives=[ARCHIVE,...]] [--async] [--bucket=BUCKET] - [--driver-log-levels=[PACKAGE=LEVEL,...]] [--files=[FILE,...]] + [--driver-log-levels=[PACKAGE=LEVEL,...]] + [--driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB] + [--driver-required-vcores=DRIVER_REQUIRED_VCORES] [--files=[FILE,...]] [--jars=[JAR,...]] [--labels=[KEY=VALUE,...]] [--max-failures-per-hour=MAX_FAILURES_PER_HOUR] [--max-failures-total=MAX_FAILURES_TOTAL] @@ -85,6 +87,16 @@ OPTIONAL FLAGS List of package to log4j log level pairs to configure driver logging. For example: root=FATAL,com.example=INFO + --driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB + The memory allocation requested by the job driver in megabytes (MB) for + execution on the driver node group (it is used only by clusters with a + driver node group). + + --driver-required-vcores=DRIVER_REQUIRED_VCORES + The vCPU allocation requested by the job driver for execution on the + driver node group (it is used only by clusters with a driver node + group). + --files=[FILE,...] Comma separated list of files to be placed in the working directory of both the app master and executors. diff --git a/gcloud/alpha/dataproc/jobs/submit/spark-r b/gcloud/alpha/dataproc/jobs/submit/spark-r index 5a71b4c65..bc9264906 100644 --- a/gcloud/alpha/dataproc/jobs/submit/spark-r +++ b/gcloud/alpha/dataproc/jobs/submit/spark-r @@ -6,7 +6,9 @@ SYNOPSIS gcloud alpha dataproc jobs submit spark-r R_FILE (--cluster=CLUSTER | --cluster-labels=[KEY=VALUE,...]) [--archives=[ARCHIVE,...]] [--async] [--bucket=BUCKET] - [--driver-log-levels=[PACKAGE=LEVEL,...]] [--files=[FILE,...]] + [--driver-log-levels=[PACKAGE=LEVEL,...]] + [--driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB] + [--driver-required-vcores=DRIVER_REQUIRED_VCORES] [--files=[FILE,...]] [--labels=[KEY=VALUE,...]] [--max-failures-per-hour=MAX_FAILURES_PER_HOUR] [--max-failures-total=MAX_FAILURES_TOTAL] @@ -72,6 +74,16 @@ OPTIONAL FLAGS package and value is the log4j log level. For example: root=FATAL,com.example=INFO + --driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB + The memory allocation requested by the job driver in megabytes (MB) for + execution on the driver node group (it is used only by clusters with a + driver node group). + + --driver-required-vcores=DRIVER_REQUIRED_VCORES + The vCPU allocation requested by the job driver for execution on the + driver node group (it is used only by clusters with a driver node + group). + --files=[FILE,...] Comma separated list of files to be placed in the working directory of both the app master and executors. diff --git a/gcloud/alpha/dataproc/jobs/submit/spark-sql b/gcloud/alpha/dataproc/jobs/submit/spark-sql index 1b3653683..e05a2092f 100644 --- a/gcloud/alpha/dataproc/jobs/submit/spark-sql +++ b/gcloud/alpha/dataproc/jobs/submit/spark-sql @@ -7,7 +7,9 @@ SYNOPSIS (--cluster=CLUSTER | --cluster-labels=[KEY=VALUE,...]) (--execute=QUERY, -e QUERY | --file=FILE, -f FILE) [--async] [--bucket=BUCKET] [--driver-log-levels=[PACKAGE=LEVEL,...]] - [--jars=[JAR,...]] [--labels=[KEY=VALUE,...]] + [--driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB] + [--driver-required-vcores=DRIVER_REQUIRED_VCORES] [--jars=[JAR,...]] + [--labels=[KEY=VALUE,...]] [--max-failures-per-hour=MAX_FAILURES_PER_HOUR] [--max-failures-total=MAX_FAILURES_TOTAL] [--params=[PARAM=VALUE,...]] [--properties=[PROPERTY=VALUE,...]] [--properties-file=PROPERTIES_FILE] @@ -65,6 +67,16 @@ OPTIONAL FLAGS A list of package to log4j log level pairs to configure driver logging. For example: root=FATAL,com.example=INFO + --driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB + The memory allocation requested by the job driver in megabytes (MB) for + execution on the driver node group (it is used only by clusters with a + driver node group). + + --driver-required-vcores=DRIVER_REQUIRED_VCORES + The vCPU allocation requested by the job driver for execution on the + driver node group (it is used only by clusters with a driver node + group). + --jars=[JAR,...] Comma separated list of jar files to be provided to the executor and driver classpaths. May contain UDFs. diff --git a/gcloud/alpha/dataproc/jobs/submit/trino b/gcloud/alpha/dataproc/jobs/submit/trino index 25106e787..ac22e2e91 100644 --- a/gcloud/alpha/dataproc/jobs/submit/trino +++ b/gcloud/alpha/dataproc/jobs/submit/trino @@ -7,6 +7,8 @@ SYNOPSIS (--execute=QUERY, -e QUERY | --file=FILE, -f FILE) [--async] [--bucket=BUCKET] [--client-tags=[CLIENT_TAG,...]] [--continue-on-failure] [--driver-log-levels=[PACKAGE=LEVEL,...]] + [--driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB] + [--driver-required-vcores=DRIVER_REQUIRED_VCORES] [--labels=[KEY=VALUE,...]] [--max-failures-per-hour=MAX_FAILURES_PER_HOUR] [--max-failures-total=MAX_FAILURES_TOTAL] @@ -71,6 +73,16 @@ OPTIONAL FLAGS A list of package-to-log4j log level pairs to configure driver logging. For example: root=FATAL,com.example=INFO + --driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB + The memory allocation requested by the job driver in megabytes (MB) for + execution on the driver node group (it is used only by clusters with a + driver node group). + + --driver-required-vcores=DRIVER_REQUIRED_VCORES + The vCPU allocation requested by the job driver for execution on the + driver node group (it is used only by clusters with a driver node + group). + --labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to add. diff --git a/gcloud/alpha/domains/registrations/configure/contacts b/gcloud/alpha/domains/registrations/configure/contacts index fce7d6b34..d46949055 100644 --- a/gcloud/alpha/domains/registrations/configure/contacts +++ b/gcloud/alpha/domains/registrations/configure/contacts @@ -136,10 +136,12 @@ COMMONLY USED FLAGS domain. CONTACT_PRIVACY must be one of: private-contact-data - Your contact info won't be available to the public. To help protect - your info and prevent spam, a third party provides alternate - (proxy) contact info for your domain in the public directory at no - extra cost. They will forward received messages to you. + (DEPRECATED) Your contact info won't be available to the public. To + help protect your info and prevent spam, a third party provides + alternate (proxy) contact info for your domain in the public + directory at no extra cost. They will forward received messages to + you. The private-contact-data option is deprecated; See + https://cloud.google.com/domains/docs/deprecations/feature-deprecations. public-contact-data All the data from contact config is publicly available. To set this value, you must also pass the --notices flag with value diff --git a/gcloud/alpha/domains/registrations/configure/dns b/gcloud/alpha/domains/registrations/configure/dns index 04f97cf9d..9ca70a7f4 100644 --- a/gcloud/alpha/domains/registrations/configure/dns +++ b/gcloud/alpha/domains/registrations/configure/dns @@ -129,9 +129,12 @@ COMMONLY USED FLAGS List of DNS name servers for the domain. --use-google-domains-dns - Use free name servers provided by Google Domains. If the zone is - signed, DNSSEC will be enabled by default unless you pass - --disable-dnssec. + (DEPRECATED) Use free name servers provided by Google Domains. If + the zone is signed, DNSSEC will be enabled by default unless you + pass --disable-dnssec. + + The --use-google-domains-dns option is deprecated; See + https://cloud.google.com/domains/docs/deprecations/feature-deprecations. OTHER FLAGS --async diff --git a/gcloud/alpha/domains/registrations/export b/gcloud/alpha/domains/registrations/export index 8197dc2fa..d1cf5f5ad 100644 --- a/gcloud/alpha/domains/registrations/export +++ b/gcloud/alpha/domains/registrations/export @@ -7,8 +7,13 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Export the domain to direct management by Google Domains. The - domain remains valid until expiry. + (ALPHA) (DEPRECATED) Export a Cloud Domains registration. + + This command is deprecated. See + https://cloud.google.com/domains/docs/deprecations/feature-deprecations. + + Export the domain to direct management by Google Domains. The domain + remains valid until expiry. After you export a registered domain, the auto-renewal will be disabled, but you will continue to incur billing charges until the next yearly diff --git a/gcloud/alpha/domains/registrations/help b/gcloud/alpha/domains/registrations/help index c9dbaf5cd..9e14841e3 100644 --- a/gcloud/alpha/domains/registrations/help +++ b/gcloud/alpha/domains/registrations/help @@ -35,7 +35,7 @@ COMMANDS (ALPHA) Describe an existing Cloud Domains registration. export - (ALPHA) Export a Cloud Domains registration. + (ALPHA) (DEPRECATED) Export a Cloud Domains registration. get-register-parameters (ALPHA) Get register parameters (including availability) of a specific @@ -45,7 +45,8 @@ COMMANDS (ALPHA) Get transfer parameters of a specific domain. import - (ALPHA) Import a domain from Google Domains registrar to Cloud Domains. + (ALPHA) (DEPRECATED) Import a domain from Google Domains registrar to + Cloud Domains. list (ALPHA) List Cloud Domains registrations. @@ -61,7 +62,7 @@ COMMANDS (ALPHA) Search for available domains. transfer - (ALPHA) Transfer a domain from another registrar. + (ALPHA) (DEPRECATED) Transfer a domain from another registrar. update (ALPHA) Update a Cloud Domains registration. diff --git a/gcloud/alpha/domains/registrations/import b/gcloud/alpha/domains/registrations/import index 14956615e..3da7b8a45 100644 --- a/gcloud/alpha/domains/registrations/import +++ b/gcloud/alpha/domains/registrations/import @@ -7,9 +7,15 @@ SYNOPSIS [--labels=[KEY=VALUE,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Create a new Cloud Domains registration resource by importing an - existing domain from Google Domains registrar. The new resource's ID will - be equal to the domain name. + (ALPHA) (DEPRECATED) Import a domain from Google Domains registrar to Cloud + Domains. + + This command is deprecated. See + https://cloud.google.com/domains/docs/deprecations/feature-deprecations. + + Create a new Cloud Domains registration resource by importing an existing + domain from Google Domains registrar. The new resource's ID will be equal + to the domain name. After this command executes, a resource is created with state ACTIVE, indicating that the import was successful. Cloud Domains will automatically diff --git a/gcloud/alpha/domains/registrations/register b/gcloud/alpha/domains/registrations/register index f65714521..665f62ebe 100644 --- a/gcloud/alpha/domains/registrations/register +++ b/gcloud/alpha/domains/registrations/register @@ -137,10 +137,12 @@ COMMONLY USED FLAGS domain. CONTACT_PRIVACY must be one of: private-contact-data - Your contact info won't be available to the public. To help protect - your info and prevent spam, a third party provides alternate - (proxy) contact info for your domain in the public directory at no - extra cost. They will forward received messages to you. + (DEPRECATED) Your contact info won't be available to the public. To + help protect your info and prevent spam, a third party provides + alternate (proxy) contact info for your domain in the public + directory at no extra cost. They will forward received messages to + you. The private-contact-data option is deprecated; See + https://cloud.google.com/domains/docs/deprecations/feature-deprecations. public-contact-data All the data from contact config is publicly available. To set this value, you must also pass the --notices flag with value @@ -170,10 +172,13 @@ COMMONLY USED FLAGS List of DNS name servers for the domain. --use-google-domains-dns - Use free name servers provided by Google Domains. If the zone is - signed, DNSSEC will be enabled by default unless you pass + (DEPRECATED) Use free name servers provided by Google Domains. If the + zone is signed, DNSSEC will be enabled by default unless you pass --disable-dnssec. + The --use-google-domains-dns option is deprecated; See + https://cloud.google.com/domains/docs/deprecations/feature-deprecations. + OTHER FLAGS --async Return immediately, without waiting for the operation in progress to diff --git a/gcloud/alpha/domains/registrations/transfer b/gcloud/alpha/domains/registrations/transfer index baf57476c..d7b0aae3d 100644 --- a/gcloud/alpha/domains/registrations/transfer +++ b/gcloud/alpha/domains/registrations/transfer @@ -13,7 +13,12 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Create a new Cloud Domains registration resource by transferring an + (ALPHA) (DEPRECATED) Transfer a domain from another registrar. + + This command is deprecated. See + https://cloud.google.com/domains/docs/deprecations/feature-deprecations. + + Create a new Cloud Domains registration resource by transferring an existing domain from another registrar. The new resource's ID will be equal to the domain name. @@ -142,10 +147,12 @@ COMMONLY USED FLAGS domain. CONTACT_PRIVACY must be one of: private-contact-data - Your contact info won't be available to the public. To help protect - your info and prevent spam, a third party provides alternate - (proxy) contact info for your domain in the public directory at no - extra cost. They will forward received messages to you. + (DEPRECATED) Your contact info won't be available to the public. To + help protect your info and prevent spam, a third party provides + alternate (proxy) contact info for your domain in the public + directory at no extra cost. They will forward received messages to + you. The private-contact-data option is deprecated; See + https://cloud.google.com/domains/docs/deprecations/feature-deprecations. public-contact-data All the data from contact config is publicly available. To set this value, you must also pass the --notices flag with value @@ -192,10 +199,13 @@ COMMONLY USED FLAGS case for DNS services provided for free by the registrar. --use-google-domains-dns - Use free name servers provided by Google Domains. This blank-slate - option cannot be configured before transfer. DNSSEC will be - disabled and will need to be enabled after the transfer completes, - if desired. + (DEPRECATED) Use free name servers provided by Google Domains. This + blank-slate option cannot be configured before transfer. DNSSEC + will be disabled and will need to be enabled after the transfer + completes, if desired. + + The --use-google-domains-dns option is deprecated; See + https://cloud.google.com/domains/docs/deprecations/feature-deprecations. OTHER FLAGS --async diff --git a/gcloud/alpha/firebase/test/android/run b/gcloud/alpha/firebase/test/android/run index 06754ce91..888f9f967 100644 --- a/gcloud/alpha/firebase/test/android/run +++ b/gcloud/alpha/firebase/test/android/run @@ -379,8 +379,8 @@ FLAGS The number of shards specified must always be a positive number that is no greater than the total number of test cases. When you select one or more physical devices, the number of shards specified must be - <= 50. When you select one or more ARM virtual devices, the number of - shards specified must be <= 100. When you select only x86 virtual + <= 50. When you select one or more Arm virtual devices, the number of + shards specified must be <= 200. When you select only x86 virtual devices, the number of shards specified must be <= 500. --test-targets-for-shard=TEST_TARGETS_FOR_SHARD @@ -388,8 +388,8 @@ FLAGS each shard (a group of test cases). Each time this flag is repeated, it creates a new shard. The shards are run in parallel on separate devices. You can repeat this flag up to 50 times when you select one - or more physical devices, up to 100 times when you select one or more - ARM virtual devices, and up to 500 times when you select only x86 + or more physical devices, up to 200 times when you select one or more + Arm virtual devices, and up to 500 times when you select only x86 virtual devices. Note: If you include the flags --environment-variable or diff --git a/gcloud/alpha/iam/service-accounts/delete b/gcloud/alpha/iam/service-accounts/delete index a0ba63f1f..5a4cb7634 100644 --- a/gcloud/alpha/iam/service-accounts/delete +++ b/gcloud/alpha/iam/service-accounts/delete @@ -26,7 +26,7 @@ FLAGS --recommend=BOOLEAN_VALUE If true, checks Active Assist recommendation for the risk level of service account deletion, and issues a warning in the prompt. Optional - flag is set to false/no by default. For details see + flag is set to false by default. For details see https://cloud.google.com/recommender/docs/change-risk-recommendations GCLOUD WIDE FLAGS diff --git a/gcloud/alpha/iam/workload-identity-pools/create-cred-config b/gcloud/alpha/iam/workload-identity-pools/create-cred-config index 10b187af5..edde593a5 100644 --- a/gcloud/alpha/iam/workload-identity-pools/create-cred-config +++ b/gcloud/alpha/iam/workload-identity-pools/create-cred-config @@ -75,7 +75,7 @@ EXAMPLES POSITIONAL ARGUMENTS AUDIENCE - The workload identity pool provider resource name. + The workload identity pool provider resource ID. REQUIRED FLAGS --output-file=OUTPUT_FILE diff --git a/gcloud/alpha/infra-manager/deployments/apply b/gcloud/alpha/infra-manager/deployments/apply index 301494eff..df3bd8963 100644 --- a/gcloud/alpha/infra-manager/deployments/apply +++ b/gcloud/alpha/infra-manager/deployments/apply @@ -6,9 +6,8 @@ SYNOPSIS gcloud alpha infra-manager deployments apply (DEPLOYMENT : --location=LOCATION) [--artifacts-gcs-bucket=ARTIFACTS_GCS_BUCKET] [--async] - [--import-existing-resources=IMPORT_EXISTING_RESOURCES] - [--labels=[KEY=VALUE,...]] [--service-account=SERVICE_ACCOUNT] - [--worker-pool=WORKER_POOL] + [--import-existing-resources] [--labels=[KEY=VALUE,...]] + [--service-account=SERVICE_ACCOUNT] [--worker-pool=WORKER_POOL] [--gcs-source=GCS_SOURCE | --git-source-directory=GIT_SOURCE_DIRECTORY --git-source-ref=GIT_SOURCE_REF --git-source-repo=GIT_SOURCE_REPO | --ignore-file=IGNORE_FILE @@ -88,7 +87,7 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. - --import-existing-resources=IMPORT_EXISTING_RESOURCES + --import-existing-resources By default, Infrastructure Manager will return a failure when Terraform encounters a 409 code (resource conflict error) during actuation. If this flag is set to true, Infrastructure Manager will instead attempt diff --git a/gcloud/alpha/kms/help b/gcloud/alpha/kms/help index 47db6d5fb..1e6e9493c 100644 --- a/gcloud/alpha/kms/help +++ b/gcloud/alpha/kms/help @@ -65,6 +65,9 @@ COMMANDS encrypt (ALPHA) Encrypt a plaintext file using a key. + key-deletion-opt-out + (ALPHA) Opt out a project of the key deletion change announced via MSA. + mac-sign (ALPHA) Sign a user input file using a MAC key version. diff --git a/gcloud/alpha/kms/key-deletion-opt-out b/gcloud/alpha/kms/key-deletion-opt-out new file mode 100644 index 000000000..b31e914f0 --- /dev/null +++ b/gcloud/alpha/kms/key-deletion-opt-out @@ -0,0 +1,46 @@ +NAME + gcloud alpha kms key-deletion-opt-out - opt out a project of the key + deletion change announced via MSA + +SYNOPSIS + gcloud alpha kms key-deletion-opt-out --project=PROJECT_ID_OR_NUMBER + [--undo] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) The flag --project indicates the project that you want to opt out. + + The optional flag --undo allows you to opt a project back in. + +EXAMPLES + The following command opts out the project my-project-id-or-number. + + $ gcloud alpha kms key-deletion-opt-out \ + --project=projects/my-project-id-or-number + + The following command opts the project my-project-id-or-number back in. + + $ gcloud alpha kms key-deletion-opt-out \ + --project=projects/my-project-id-or-number --undo=true + +REQUIRED FLAGS + --project=PROJECT_ID_OR_NUMBER + Project ID to opt out. + +OPTIONAL FLAGS + --undo + Opt the project back in the key deletion change. + +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/projects/delete b/gcloud/alpha/projects/delete index 2c60cff57..4aae2cd1e 100644 --- a/gcloud/alpha/projects/delete +++ b/gcloud/alpha/projects/delete @@ -31,7 +31,7 @@ FLAGS --recommend=BOOLEAN_VALUE If true, checks Active Assist recommendation for the risk level of project deletion, and issues a warning in the prompt. Optional flag is - set to false/no by default. For details see + set to false by default. For details see https://cloud.google.com/recommender/docs/change-risk-recommendations GCLOUD WIDE FLAGS diff --git a/gcloud/alpha/projects/remove-iam-policy-binding b/gcloud/alpha/projects/remove-iam-policy-binding index 2b3491937..fdbb25639 100644 --- a/gcloud/alpha/projects/remove-iam-policy-binding +++ b/gcloud/alpha/projects/remove-iam-policy-binding @@ -92,7 +92,7 @@ OPTIONAL FLAGS --recommend=BOOLEAN_VALUE If true, checks Active Assist recommendation for the risk level of IAM policy binding removal, and issues a warning in the prompt. Optional - flag is set to false/no by default. For details see + flag is set to false by default. For details see https://cloud.google.com/recommender/docs/change-risk-recommendations At most one of these can be specified: diff --git a/gcloud/alpha/pubsub/subscriptions/create b/gcloud/alpha/pubsub/subscriptions/create index 7e4c2743f..725d4ad07 100644 --- a/gcloud/alpha/pubsub/subscriptions/create +++ b/gcloud/alpha/pubsub/subscriptions/create @@ -91,12 +91,14 @@ OPTIONAL FLAGS message with a given value of message_id on this subscription: The message sent to a subscriber is guaranteed not to be resent before the message's acknowledgment deadline expires. An acknowledged message will - not be resent to a subscriber. + not be resent to a subscriber. Use --no-enable-exactly-once-delivery to + disable this flag. --enable-message-ordering Whether to receive messages with the same ordering key in order. If set, messages with the same ordering key are sent to subscribers in the - order that Pub/Sub receives them. + order that Pub/Sub receives them. Use --no-enable-message-ordering to + disable this flag. --expiration-period=EXPIRATION_PERIOD The subscription will expire if it is inactive for the given period. @@ -146,7 +148,8 @@ OPTIONAL FLAGS Whether or not to retain acknowledged messages. If true, messages are not expunged from the subscription's backlog until they fall out of the --message-retention-duration window. Acknowledged messages are not - retained by default. + retained by default. Use --no-retain-acked-messages to disable this + flag. At most one of these can be specified: @@ -166,11 +169,13 @@ OPTIONAL FLAGS When --use-topic-schema is set, whether or not to ignore fields in the topic schema that do not appear in the BigQuery schema. If false, then the BigQuery schema must contain all fields that are - also present in the topic schema. + also present in the topic schema. Use --no-drop-unknown-fields to + disable this flag. --use-topic-schema Whether or not to use the schema for the subscription's topic (if - it exists) when writing messages to BigQuery. + it exists) when writing messages to BigQuery. Use + --no-use-topic-schema to disable this flag. --write-metadata Whether or not to write message metadata including message ID, @@ -178,7 +183,8 @@ OPTIONAL FLAGS subscription name, message_id, and publish_time fields are put in their own columns while all other message properties other than data (for example, an ordering_key, if present) are written to a - JSON object in the attributes column. + JSON object in the attributes column. Use --no-write-metadata to + disable this flag. Cloud Storage Config Options. The Cloud Pub/Sub service account associated with the enclosing subscription's parent project (i.e., @@ -225,7 +231,8 @@ OPTIONAL FLAGS properties other than data (for example, an ordering_key, if present) are added as entries in the attributes map. This has an effect only for subscriptions with - --cloud-storage-output-format=avro. + --cloud-storage-output-format=avro. Use + --no-cloud-storage-write-metadata to disable this flag. Dead Letter Queue Options. The Cloud Pub/Sub service account associated with the enclosing subscription's parent project (i.e., @@ -284,6 +291,7 @@ OPTIONAL FLAGS --push-no-wrapper When set, the message data is delivered directly as the HTTP body. + Use --no-push-no-wrapper to disable this flag. This flag argument must be specified if any of the other arguments in this group are specified. @@ -292,7 +300,8 @@ OPTIONAL FLAGS When true, writes the Pub/Sub message metadata to x-goog-pubsub-: headers of the HTTP request. Writes the Pub/Sub message attributes to : headers of the HTTP - request. + request. Use --no-push-no-wrapper-write-metadata to disable this + flag. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/pubsub/subscriptions/modify-push-config b/gcloud/alpha/pubsub/subscriptions/modify-push-config index 907da2b52..2ec0ca3b0 100644 --- a/gcloud/alpha/pubsub/subscriptions/modify-push-config +++ b/gcloud/alpha/pubsub/subscriptions/modify-push-config @@ -51,6 +51,7 @@ OPTIONAL FLAGS --push-no-wrapper When set, the message data is delivered directly as the HTTP body. + Use --no-push-no-wrapper to disable this flag. This flag argument must be specified if any of the other arguments in this group are specified. @@ -59,7 +60,8 @@ OPTIONAL FLAGS When true, writes the Pub/Sub message metadata to x-goog-pubsub-: headers of the HTTP request. Writes the Pub/Sub message attributes to : headers of the HTTP - request. + request. Use --no-push-no-wrapper-write-metadata to disable this + flag. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/pubsub/subscriptions/pull b/gcloud/alpha/pubsub/subscriptions/pull index e99634c37..a3ec7782e 100644 --- a/gcloud/alpha/pubsub/subscriptions/pull +++ b/gcloud/alpha/pubsub/subscriptions/pull @@ -42,7 +42,8 @@ POSITIONAL ARGUMENTS FLAGS --auto-ack - Automatically ACK every message pulled from this subscription. + Automatically ACK every message pulled from this subscription. Use + --no-auto-ack to disable this flag. --max-messages=MAX_MESSAGES; default=1 (DEPRECATED) The maximum number of messages that Cloud Pub/Sub can @@ -59,7 +60,8 @@ FLAGS messages readily available in memory buffers. If no messages are available in the buffers, returns an empty list of messages as response, even if having messages in the backlog. Do not set this - flag as it adversely impacts the performance of pull. + flag as it adversely impacts the performance of pull. Use + --no-return-immediately to disable this flag. --wait (DEPRECATED) Wait (for a bounded amount of time) for new messages diff --git a/gcloud/alpha/pubsub/subscriptions/update b/gcloud/alpha/pubsub/subscriptions/update index d163dc79e..844e3c2d4 100644 --- a/gcloud/alpha/pubsub/subscriptions/update +++ b/gcloud/alpha/pubsub/subscriptions/update @@ -66,7 +66,8 @@ FLAGS message sent to a subscriber is guaranteed not to be resent before the message's acknowledgment deadline expires. An acknowledged message will not be resent to a subscriber. To disable exactly-once delivery use - --no-enable-exactly-once-delivery. + --no-enable-exactly-once-delivery. Use + --no-enable-exactly-once-delivery to disable this flag. --expiration-period=EXPIRATION_PERIOD The subscription will expire if it is inactive for the given period. @@ -101,7 +102,8 @@ FLAGS Whether or not to retain acknowledged messages. If true, messages are not expunged from the subscription's backlog until they fall out of the --message-retention-duration window. Acknowledged messages are not - retained by default. + retained by default. Use --no-retain-acked-messages to disable this + flag. --update-labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to update. If a label exists, its value @@ -117,7 +119,8 @@ FLAGS At most one of these can be specified: --clear-bigquery-config - If set, clear the BigQuery config from the subscription. + If set, clear the BigQuery config from the subscription. Use + --no-clear-bigquery-config to disable this flag. BigQuery Config Options. The Cloud Pub/Sub service account associated with the enclosing subscription's parent project (i.e., @@ -136,11 +139,13 @@ FLAGS When --use-topic-schema is set, whether or not to ignore fields in the topic schema that do not appear in the BigQuery schema. If false, then the BigQuery schema must contain all fields that are - also present in the topic schema. + also present in the topic schema. Use --no-drop-unknown-fields to + disable this flag. --use-topic-schema Whether or not to use the schema for the subscription's topic (if - it exists) when writing messages to BigQuery. + it exists) when writing messages to BigQuery. Use + --no-use-topic-schema to disable this flag. --write-metadata Whether or not to write message metadata including message ID, @@ -148,12 +153,14 @@ FLAGS subscription name, message_id, and publish_time fields are put in their own columns while all other message properties other than data (for example, an ordering_key, if present) are written to a - JSON object in the attributes column. + JSON object in the attributes column. Use --no-write-metadata to + disable this flag. At most one of these can be specified: --clear-cloud-storage-config - If set, clear the Cloud Storage config from the subscription. + If set, clear the Cloud Storage config from the subscription. Use + --no-clear-cloud-storage-config to disable this flag. Cloud Storage Config Options. The Cloud Pub/Sub service account associated with the enclosing subscription's parent project (i.e., @@ -204,12 +211,14 @@ FLAGS message properties other than data (for example, an ordering_key, if present) are added as entries in the attributes map. This has an effect only for subscriptions with - --cloud-storage-output-format=avro. + --cloud-storage-output-format=avro. Use + --no-cloud-storage-write-metadata to disable this flag. At most one of these can be specified: --clear-dead-letter-policy - If set, clear the dead letter policy from the subscription. + If set, clear the dead letter policy from the subscription. Use + --no-clear-dead-letter-policy to disable this flag. Dead Letter Queue Options. The Cloud Pub/Sub service account associated with the enclosing subscription's parent project (i.e., @@ -270,12 +279,14 @@ FLAGS At most one of these can be specified: --clear-push-no-wrapper-config - If set, clear the NoWrapper config from the subscription. + If set, clear the NoWrapper config from the subscription. Use + --no-clear-push-no-wrapper-config to disable this flag. NoWrapper Config Options. --push-no-wrapper When set, the message data is delivered directly as the HTTP body. + Use --no-push-no-wrapper to disable this flag. This flag argument must be specified if any of the other arguments in this group are specified. @@ -284,12 +295,14 @@ FLAGS When true, writes the Pub/Sub message metadata to x-goog-pubsub-: headers of the HTTP request. Writes the Pub/Sub message attributes to : headers of the HTTP - request. + request. Use --no-push-no-wrapper-write-metadata to disable this + flag. At most one of these can be specified: --clear-retry-policy - If set, clear the retry policy from the subscription. + If set, clear the retry policy from the subscription. Use + --no-clear-retry-policy to disable this flag. Retry Policy Options. Retry policy specifies how Cloud Pub/Sub retries message delivery for this subscription. diff --git a/gcloud/alpha/pubsub/topics/update b/gcloud/alpha/pubsub/topics/update index 6ce50f342..8d1e18345 100644 --- a/gcloud/alpha/pubsub/topics/update +++ b/gcloud/alpha/pubsub/topics/update @@ -117,7 +117,8 @@ FLAGS At most one of these can be specified: --clear-message-retention-duration - If set, clear the message retention duration from the topic. + If set, clear the message retention duration from the topic. Use + --no-clear-message-retention-duration to disable this flag. --message-retention-duration=MESSAGE_RETENTION_DURATION Indicates the minimum duration to retain a message after it is @@ -135,7 +136,8 @@ FLAGS At most one of these can be specified: --clear-schema-settings - If set, clear the Schema Settings from the topic. + If set, clear the Schema Settings from the topic. Use + --no-clear-schema-settings to disable this flag. Schema settings. The schema that messages published to this topic must conform to and the expected message encoding. diff --git a/gcloud/alpha/run/deploy b/gcloud/alpha/run/deploy index 3add95f8c..e293e350f 100644 --- a/gcloud/alpha/run/deploy +++ b/gcloud/alpha/run/deploy @@ -17,7 +17,8 @@ SYNOPSIS --clear-vpc-connector --[no-]cpu-boost --[no-]cpu-throttling --[no-]default-url --description=DESCRIPTION --execution-environment=EXECUTION_ENVIRONMENT - --revision-suffix=REVISION_SUFFIX --[no-]session-affinity + --revision-suffix=REVISION_SUFFIX + --service-min-instances=SERVICE_MIN_INSTANCES --[no-]session-affinity --vpc-connector=VPC_CONNECTOR --vpc-egress=VPC_EGRESS --add-cloudsql-instances=[CLOUDSQL-INSTANCES,...] | --clear-cloudsql-instances @@ -27,13 +28,14 @@ SYNOPSIS | --clear-custom-audiences | --remove-custom-audiences=[CUSTOM-AUDIENCES,...] | --set-custom-audiences=[CUSTOM-AUDIENCES,...] - --add-volume=[KEY=VALUE,...] --remove-volume=[VOLUME,...] - --add-volume-mount=[KEY=VALUE,...] --args=[ARG,...] - --command=[COMMAND,...] --cpu=CPU --depends-on=[CONTAINER,...] - --memory=MEMORY --port=PORT - --remove-volume-mount=[MOUNT,...] --[no-]use-http2 --clear-env-vars - | --env-vars-file=FILE_PATH | --set-env-vars=[KEY=VALUE,...] - | --remove-env-vars=[KEY,...] + --add-volume=[KEY=VALUE,...] --clear-volumes + --remove-volume=[VOLUME,...] + --add-volume-mount=[volume=NAME,mount-path=MOUNT_PATH,...] + --args=[ARG,...] --clear-volume-mounts --command=[COMMAND,...] + --cpu=CPU --depends-on=[CONTAINER,...] --memory=MEMORY --port=PORT + --remove-volume-mount=[MOUNT_PATH,...] + --[no-]use-http2 --clear-env-vars | --env-vars-file=FILE_PATH + | --set-env-vars=[KEY=VALUE,...] | --remove-env-vars=[KEY,...] --update-env-vars=[KEY=VALUE,...] --clear-secrets | --set-secrets=[KEY=VALUE,...] | --remove-secrets=[KEY,...] --update-secrets=[KEY=VALUE,...] --image=IMAGE | --source=SOURCE @@ -316,6 +318,11 @@ FLAGS [--revision-suffix=v1] for a service named 'helloworld', would lead to a revision named 'helloworld-v1'. + --service-min-instances=SERVICE_MIN_INSTANCES + The minimum number of container instances for this Service to run or + 'default' to remove any minimum. These instances will be divided + among all Revisions receiving a percentage of traffic. + --[no-]session-affinity Whether to enable session affinity for connections to the service. Use --session-affinity to enable and --no-session-affinity to @@ -406,7 +413,9 @@ FLAGS instances and all data will be lost when the instance it is on is terminated. Additional keys: ▸ size-limit: (required) A quantity representing the maximum amount - of memory allocated to this volume, such as "512Mi" or "3G". + of memory allocated to this volume, such as "512Mi" or "3G". Data + stored in an in-memory volume consumes the memory allocation of the + container that wrote the data. nfs: Represents a volume backed by an NFS server. Additional keys: ▸ location: (required) The location of the NFS Server, in the form @@ -424,6 +433,10 @@ FLAGS ▸ path: (required) The relative path within the volume to mount that version. + --clear-volumes + Remove all existing volumes from the Cloud Run resource, including + volumes mounted as secrets + --remove-volume=[VOLUME,...] Removes volumes from the Cloud Run resource. @@ -442,7 +455,7 @@ FLAGS If the --container or --remove-containers flag is specified the following arguments may only be specified after a --container flag. - --add-volume-mount=[KEY=VALUE,...] + --add-volume-mount=[volume=NAME,mount-path=MOUNT_PATH,...] Adds a mount to the current container. Must contain the keys volume=NAME and mount-path=/PATH where NAME is the name of a volume on this resource and PATH is the path within the @@ -455,6 +468,9 @@ FLAGS if not specified, no arguments are passed. To reset this field to its default, pass an empty string. + --clear-volume-mounts + Remove all existing mounts from the current container. + --command=[COMMAND,...] Entrypoint for the container image. If not specified, the container image's default Entrypoint is run. To reset this field @@ -484,8 +500,9 @@ FLAGS probe pointing to the previous container port, this will also update the probe port. - --remove-volume-mount=[MOUNT,...] - Removes a mount from the current container. + --remove-volume-mount=[MOUNT_PATH,...] + Removes the volume mounted at the specified path from the + current container. --[no-]use-http2 Whether to use HTTP/2 for connections to the service. Use diff --git a/gcloud/alpha/run/jobs/deploy b/gcloud/alpha/run/jobs/deploy index 211a9994f..711e6a357 100644 --- a/gcloud/alpha/run/jobs/deploy +++ b/gcloud/alpha/run/jobs/deploy @@ -12,8 +12,10 @@ SYNOPSIS [--set-secrets=[KEY=SECRET_NAME:SECRET_VERSION,...]] [--task-timeout=TASK_TIMEOUT] [--tasks=TASKS; default=1] [--vpc-connector=VPC_CONNECTOR] [--vpc-egress=VPC_EGRESS] - [--add-volume=[KEY=VALUE,...] --remove-volume=[VOLUME,...]] - [--add-volume-mount=[KEY=VALUE,...] --remove-volume-mount=[MOUNT,...]] + [--add-volume=[KEY=VALUE,...] + --clear-volumes --remove-volume=[VOLUME,...]] + [--add-volume-mount=[volume=NAME,mount-path=MOUNT_PATH,...] + --clear-volume-mounts --remove-volume-mount=[MOUNT_PATH,...]] [--async | --execute-now --wait] [--clear-env-vars | --env-vars-file=FILE_PATH | --set-env-vars=[KEY=VALUE,...] @@ -187,7 +189,9 @@ FLAGS and all data will be lost when the instance it is on is terminated. Additional keys: ◆ size-limit: (required) A quantity representing the maximum amount - of memory allocated to this volume, such as "512Mi" or "3G". + of memory allocated to this volume, such as "512Mi" or "3G". Data + stored in an in-memory volume consumes the memory allocation of the + container that wrote the data. nfs: Represents a volume backed by an NFS server. Additional keys: ◆ location: (required) The location of the NFS Server, in the form @@ -205,17 +209,25 @@ FLAGS ◆ path: (required) The relative path within the volume to mount that version. + --clear-volumes + Remove all existing volumes from the Cloud Run resource, including + volumes mounted as secrets + --remove-volume=[VOLUME,...] Removes volumes from the Cloud Run resource. - --add-volume-mount=[KEY=VALUE,...] + --add-volume-mount=[volume=NAME,mount-path=MOUNT_PATH,...] Adds a mount to the current container. Must contain the keys volume=NAME and mount-path=/PATH where NAME is the name of a volume on this resource and PATH is the path within the container's filesystem to mount this volume. - --remove-volume-mount=[MOUNT,...] - Removes a mount from the current container. + --clear-volume-mounts + Remove all existing mounts from the current container. + + --remove-volume-mount=[MOUNT_PATH,...] + Removes the volume mounted at the specified path from the current + container. At most one of these can be specified: diff --git a/gcloud/alpha/run/jobs/update b/gcloud/alpha/run/jobs/update index 868e1e49d..7fd79eb2f 100644 --- a/gcloud/alpha/run/jobs/update +++ b/gcloud/alpha/run/jobs/update @@ -14,8 +14,10 @@ SYNOPSIS | --clear-cloudsql-instances | --remove-cloudsql-instances=[CLOUDSQL-INSTANCES,...] | --set-cloudsql-instances=[CLOUDSQL-INSTANCES,...]] - [--add-volume=[KEY=VALUE,...] --remove-volume=[VOLUME,...]] - [--add-volume-mount=[KEY=VALUE,...] --remove-volume-mount=[MOUNT,...]] + [--add-volume=[KEY=VALUE,...] + --clear-volumes --remove-volume=[VOLUME,...]] + [--add-volume-mount=[volume=NAME,mount-path=MOUNT_PATH,...] + --clear-volume-mounts --remove-volume-mount=[MOUNT_PATH,...]] [--async | --execute-now --wait] [--binary-authorization=POLICY | --clear-binary-authorization] [--clear-env-vars | --env-vars-file=FILE_PATH @@ -196,7 +198,9 @@ FLAGS and all data will be lost when the instance it is on is terminated. Additional keys: ◆ size-limit: (required) A quantity representing the maximum amount - of memory allocated to this volume, such as "512Mi" or "3G". + of memory allocated to this volume, such as "512Mi" or "3G". Data + stored in an in-memory volume consumes the memory allocation of the + container that wrote the data. nfs: Represents a volume backed by an NFS server. Additional keys: ◆ location: (required) The location of the NFS Server, in the form @@ -214,17 +218,25 @@ FLAGS ◆ path: (required) The relative path within the volume to mount that version. + --clear-volumes + Remove all existing volumes from the Cloud Run resource, including + volumes mounted as secrets + --remove-volume=[VOLUME,...] Removes volumes from the Cloud Run resource. - --add-volume-mount=[KEY=VALUE,...] + --add-volume-mount=[volume=NAME,mount-path=MOUNT_PATH,...] Adds a mount to the current container. Must contain the keys volume=NAME and mount-path=/PATH where NAME is the name of a volume on this resource and PATH is the path within the container's filesystem to mount this volume. - --remove-volume-mount=[MOUNT,...] - Removes a mount from the current container. + --clear-volume-mounts + Remove all existing mounts from the current container. + + --remove-volume-mount=[MOUNT_PATH,...] + Removes the volume mounted at the specified path from the current + container. At most one of these can be specified: diff --git a/gcloud/alpha/run/services/update b/gcloud/alpha/run/services/update index d45f6e6ab..24792a0c4 100644 --- a/gcloud/alpha/run/services/update +++ b/gcloud/alpha/run/services/update @@ -13,7 +13,8 @@ SYNOPSIS [--breakglass=JUSTIFICATION --clear-vpc-connector --[no-]cpu-boost --[no-]cpu-throttling --[no-]default-url --description=DESCRIPTION --execution-environment=EXECUTION_ENVIRONMENT - --revision-suffix=REVISION_SUFFIX --[no-]session-affinity + --revision-suffix=REVISION_SUFFIX + --service-min-instances=SERVICE_MIN_INSTANCES --[no-]session-affinity --vpc-connector=VPC_CONNECTOR --vpc-egress=VPC_EGRESS --add-cloudsql-instances=[CLOUDSQL-INSTANCES,...] | --clear-cloudsql-instances @@ -23,13 +24,14 @@ SYNOPSIS | --clear-custom-audiences | --remove-custom-audiences=[CUSTOM-AUDIENCES,...] | --set-custom-audiences=[CUSTOM-AUDIENCES,...] - --add-volume=[KEY=VALUE,...] --remove-volume=[VOLUME,...] - --add-volume-mount=[KEY=VALUE,...] --args=[ARG,...] - --command=[COMMAND,...] --cpu=CPU --depends-on=[CONTAINER,...] - --image=IMAGE --memory=MEMORY --port=PORT - --remove-volume-mount=[MOUNT,...] --[no-]use-http2 --clear-env-vars - | --env-vars-file=FILE_PATH | --set-env-vars=[KEY=VALUE,...] - | --remove-env-vars=[KEY,...] + --add-volume=[KEY=VALUE,...] --clear-volumes + --remove-volume=[VOLUME,...] + --add-volume-mount=[volume=NAME,mount-path=MOUNT_PATH,...] + --args=[ARG,...] --clear-volume-mounts --command=[COMMAND,...] + --cpu=CPU --depends-on=[CONTAINER,...] --image=IMAGE --memory=MEMORY + --port=PORT --remove-volume-mount=[MOUNT_PATH,...] + --[no-]use-http2 --clear-env-vars | --env-vars-file=FILE_PATH + | --set-env-vars=[KEY=VALUE,...] | --remove-env-vars=[KEY,...] --update-env-vars=[KEY=VALUE,...] --clear-secrets | --set-secrets=[KEY=VALUE,...] | --remove-secrets=[KEY,...] --update-secrets=[KEY=VALUE,...] @@ -221,6 +223,11 @@ FLAGS [--revision-suffix=v1] for a service named 'helloworld', would lead to a revision named 'helloworld-v1'. + --service-min-instances=SERVICE_MIN_INSTANCES + The minimum number of container instances for this Service to run or + 'default' to remove any minimum. These instances will be divided + among all Revisions receiving a percentage of traffic. + --[no-]session-affinity Whether to enable session affinity for connections to the service. Use --session-affinity to enable and --no-session-affinity to @@ -311,7 +318,9 @@ FLAGS instances and all data will be lost when the instance it is on is terminated. Additional keys: ▸ size-limit: (required) A quantity representing the maximum amount - of memory allocated to this volume, such as "512Mi" or "3G". + of memory allocated to this volume, such as "512Mi" or "3G". Data + stored in an in-memory volume consumes the memory allocation of the + container that wrote the data. nfs: Represents a volume backed by an NFS server. Additional keys: ▸ location: (required) The location of the NFS Server, in the form @@ -329,6 +338,10 @@ FLAGS ▸ path: (required) The relative path within the volume to mount that version. + --clear-volumes + Remove all existing volumes from the Cloud Run resource, including + volumes mounted as secrets + --remove-volume=[VOLUME,...] Removes volumes from the Cloud Run resource. @@ -347,7 +360,7 @@ FLAGS If the --container or --remove-containers flag is specified the following arguments may only be specified after a --container flag. - --add-volume-mount=[KEY=VALUE,...] + --add-volume-mount=[volume=NAME,mount-path=MOUNT_PATH,...] Adds a mount to the current container. Must contain the keys volume=NAME and mount-path=/PATH where NAME is the name of a volume on this resource and PATH is the path within the @@ -360,6 +373,9 @@ FLAGS if not specified, no arguments are passed. To reset this field to its default, pass an empty string. + --clear-volume-mounts + Remove all existing mounts from the current container. + --command=[COMMAND,...] Entrypoint for the container image. If not specified, the container image's default Entrypoint is run. To reset this field @@ -393,8 +409,9 @@ FLAGS probe pointing to the previous container port, this will also update the probe port. - --remove-volume-mount=[MOUNT,...] - Removes a mount from the current container. + --remove-volume-mount=[MOUNT_PATH,...] + Removes the volume mounted at the specified path from the + current container. --[no-]use-http2 Whether to use HTTP/2 for connections to the service. Use diff --git a/gcloud/alpha/spanner/instances/create b/gcloud/alpha/spanner/instances/create index 2adcfe8c2..9ba957cce 100644 --- a/gcloud/alpha/spanner/instances/create +++ b/gcloud/alpha/spanner/instances/create @@ -5,7 +5,8 @@ SYNOPSIS gcloud alpha spanner instances create INSTANCE --config=CONFIG --description=DESCRIPTION [--async] [--expire-behavior=EXPIRE_BEHAVIOR] [--instance-type=INSTANCE_TYPE] - [--nodes=NODES | --processing-units=PROCESSING_UNITS] + [--nodes=NODES | --processing-units=PROCESSING_UNITS + | --autoscaling-high-priority-cpu-target=AUTOSCALING_HIGH_PRIORITY_CPU_TARGET --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET (--autoscaling-max-nodes=AUTOSCALING_MAX_NODES --autoscaling-min-nodes=AUTOSCALING_MIN_NODES | --autoscaling-max-processing-units=AUTOSCALING_MAX_PROCESSING_UNITS --autoscaling-min-processing-units=AUTOSCALING_MIN_PROCESSING_UNITS)] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -67,6 +68,52 @@ OPTIONAL FLAGS --processing-units=PROCESSING_UNITS Number of processing units for the instance. + Autoscaling + + --autoscaling-high-priority-cpu-target=AUTOSCALING_HIGH_PRIORITY_CPU_TARGET + Specifies the target percentage of high-priority CPU the autoscaled + instance can utilize. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET + Specifies the target percentage of storage the autoscaled instance + can utilize. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + Exactly one of these must be specified: + + Autoscaling limits in nodes + + --autoscaling-max-nodes=AUTOSCALING_MAX_NODES + Maximum number of nodes for the autoscaled instance. + + This flag argument must be specified if any of the other + arguments in this group are specified. + + --autoscaling-min-nodes=AUTOSCALING_MIN_NODES + Minimum number of nodes for the autoscaled instance. + + This flag argument must be specified if any of the other + arguments in this group are specified. + + Autoscaling limits in processing units + + --autoscaling-max-processing-units=AUTOSCALING_MAX_PROCESSING_UNITS + Maximum number of processing units for the autoscaled instance. + + This flag argument must be specified if any of the other + arguments in this group are specified. + + --autoscaling-min-processing-units=AUTOSCALING_MIN_PROCESSING_UNITS + Minimum number of processing units for the autoscaled instance. + + This flag argument must be specified if any of the other + arguments in this group are specified. + 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/spanner/instances/update b/gcloud/alpha/spanner/instances/update index 911cc6da0..f4224e844 100644 --- a/gcloud/alpha/spanner/instances/update +++ b/gcloud/alpha/spanner/instances/update @@ -5,7 +5,8 @@ SYNOPSIS gcloud alpha spanner instances update INSTANCE [--async] [--description=DESCRIPTION] [--expire-behavior=EXPIRE_BEHAVIOR] [--instance-type=INSTANCE_TYPE] - [--nodes=NODES | --processing-units=PROCESSING_UNITS] + [--nodes=NODES | --processing-units=PROCESSING_UNITS + | --autoscaling-high-priority-cpu-target=AUTOSCALING_HIGH_PRIORITY_CPU_TARGET --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET --autoscaling-max-nodes=AUTOSCALING_MAX_NODES --autoscaling-min-nodes=AUTOSCALING_MIN_NODES | --autoscaling-max-processing-units=AUTOSCALING_MAX_PROCESSING_UNITS --autoscaling-min-processing-units=AUTOSCALING_MIN_PROCESSING_UNITS] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -64,6 +65,34 @@ FLAGS --processing-units=PROCESSING_UNITS Number of processing units for the instance. + Autoscaling + + --autoscaling-high-priority-cpu-target=AUTOSCALING_HIGH_PRIORITY_CPU_TARGET + Specifies the target percentage of high-priority CPU the autoscaled + instance can utilize. + + --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET + Specifies the target percentage of storage the autoscaled instance + can utilize. + + At most one of these can be specified: + + Autoscaling limits in nodes + + --autoscaling-max-nodes=AUTOSCALING_MAX_NODES + Maximum number of nodes for the autoscaled instance. + + --autoscaling-min-nodes=AUTOSCALING_MIN_NODES + Minimum number of nodes for the autoscaled instance. + + Autoscaling limits in processing units + + --autoscaling-max-processing-units=AUTOSCALING_MAX_PROCESSING_UNITS + Maximum number of processing units for the autoscaled instance. + + --autoscaling-min-processing-units=AUTOSCALING_MIN_PROCESSING_UNITS + Minimum number of processing units for the autoscaled instance. + 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/sql/instances/create b/gcloud/alpha/sql/instances/create index dc862e3cb..ad6ecec51 100644 --- a/gcloud/alpha/sql/instances/create +++ b/gcloud/alpha/sql/instances/create @@ -45,7 +45,8 @@ SYNOPSIS [--replica-type=REPLICA_TYPE] [--replication=REPLICATION] [--require-ssl] [--retained-backups-count=RETAINED_BACKUPS_COUNT] [--retained-transaction-log-days=RETAINED_TRANSACTION_LOG_DAYS] - [--root-password=ROOT_PASSWORD] [--[no-]storage-auto-increase] + [--root-password=ROOT_PASSWORD] [--ssl-mode=SSL_MODE] + [--[no-]storage-auto-increase] [--storage-auto-increase-limit=STORAGE_AUTO_INCREASE_LIMIT] [--storage-size=STORAGE_SIZE] [--storage-type=STORAGE_TYPE] [--threads-per-core=THREADS_PER_CORE] [--tier=TIER, -t TIER] @@ -399,6 +400,18 @@ FLAGS --root-password=ROOT_PASSWORD Root Cloud SQL user's password. + --ssl-mode=SSL_MODE + Set the SSL mode of the instance. SSL_MODE must be one of: + + ALLOW_UNENCRYPTED_AND_ENCRYPTED + Allow non-SSL and SSL connections. For SSL connections, client + certificate will not be verified. + ENCRYPTED_ONLY + Only allow connections encrypted with SSL/TLS. + TRUSTED_CLIENT_CERTIFICATE_REQUIRED + Only allow connections encrypted with SSL/TLS and with valid client + certificates. + --[no-]storage-auto-increase Storage size can be increased, but it cannot be decreased; storage increases are permanent for the life of the instance. With this setting diff --git a/gcloud/alpha/sql/instances/patch b/gcloud/alpha/sql/instances/patch index c419301e8..29c12d912 100644 --- a/gcloud/alpha/sql/instances/patch +++ b/gcloud/alpha/sql/instances/patch @@ -39,7 +39,8 @@ SYNOPSIS [--pricing-plan=PRICING_PLAN, -p PRICING_PLAN] [--[no-]recreate-replicas-on-primary-crash] [--remove-deny-maintenance-period] [--replication=REPLICATION] - [--[no-]require-ssl] [--[no-]storage-auto-increase] + [--[no-]require-ssl] [--ssl-mode=SSL_MODE] + [--[no-]storage-auto-increase] [--storage-auto-increase-limit=STORAGE_AUTO_INCREASE_LIMIT] [--storage-size=STORAGE_SIZE] [--threads-per-core=THREADS_PER_CORE] [--tier=TIER, -t TIER] [--update-labels=[KEY=VALUE,...]] @@ -333,6 +334,18 @@ FLAGS mysqld should default to 'REQUIRE X509' for users connecting over IP. Use --require-ssl to enable and --no-require-ssl to disable. + --ssl-mode=SSL_MODE + Set the SSL mode of the instance. SSL_MODE must be one of: + + ALLOW_UNENCRYPTED_AND_ENCRYPTED + Allow non-SSL and SSL connections. For SSL connections, client + certificate will not be verified. + ENCRYPTED_ONLY + Only allow connections encrypted with SSL/TLS. + TRUSTED_CLIENT_CERTIFICATE_REQUIRED + Only allow connections encrypted with SSL/TLS and with valid client + certificates. + --[no-]storage-auto-increase Storage size can be increased, but it cannot be decreased; storage increases are permanent for the life of the instance. With this setting diff --git a/gcloud/alpha/storage/help b/gcloud/alpha/storage/help index d67e8a711..336050d89 100644 --- a/gcloud/alpha/storage/help +++ b/gcloud/alpha/storage/help @@ -35,6 +35,9 @@ GROUPS objects (ALPHA) Manage Cloud Storage objects. + operations + (ALPHA) Manage storage operations. + COMMANDS COMMAND is one of the following: diff --git a/gcloud/alpha/storage/operations/cancel b/gcloud/alpha/storage/operations/cancel new file mode 100644 index 000000000..2c4d04dad --- /dev/null +++ b/gcloud/alpha/storage/operations/cancel @@ -0,0 +1,38 @@ +NAME + gcloud alpha storage operations cancel - cancel a storage operation + +SYNOPSIS + gcloud alpha storage operations cancel OPERATION_NAME + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Cancel a storage operation. Since operations are asynchronous, this + request is best effort and may fail in cases such as when the operation is + already complete. + +EXAMPLES + To cancel the operation "C894F35J" on bucket "my-bucket", run: + + $ gcloud alpha storage operations cancel \ + projects/_/buckets/my-bucket/operations/C894F35J + +POSITIONAL ARGUMENTS + OPERATION_NAME + The operation name including the Cloud Storage bucket and operation ID. + +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. This variant is also available: + + $ gcloud storage operations cancel + diff --git a/gcloud/alpha/storage/operations/describe b/gcloud/alpha/storage/operations/describe new file mode 100644 index 000000000..2fd89851a --- /dev/null +++ b/gcloud/alpha/storage/operations/describe @@ -0,0 +1,37 @@ +NAME + gcloud alpha storage operations describe - get configuration and latest + storage operation details + +SYNOPSIS + gcloud alpha storage operations describe OPERATION_NAME + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Get details about a specific storage operation. + +EXAMPLES + To describe an operation "C894F35J" on bucket "my-bucket", run: + + $ gcloud alpha storage operations describe \ + projects/_/buckets/my-bucket/operations/C894F35J + +POSITIONAL ARGUMENTS + OPERATION_NAME + The operation name including the Cloud Storage bucket and operation ID. + +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. This variant is also available: + + $ gcloud storage operations describe + diff --git a/gcloud/alpha/storage/operations/help b/gcloud/alpha/storage/operations/help new file mode 100644 index 000000000..a8f8ace5e --- /dev/null +++ b/gcloud/alpha/storage/operations/help @@ -0,0 +1,34 @@ +NAME + gcloud alpha storage operations - manage storage operations + +SYNOPSIS + gcloud alpha storage operations COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage storage operations. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + cancel + (ALPHA) Cancel a storage operation. + + describe + (ALPHA) Get configuration and latest storage operation details. + + list + (ALPHA) List storage operations. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud storage operations + diff --git a/gcloud/alpha/storage/operations/list b/gcloud/alpha/storage/operations/list new file mode 100644 index 000000000..34045c48d --- /dev/null +++ b/gcloud/alpha/storage/operations/list @@ -0,0 +1,84 @@ +NAME + gcloud alpha storage operations list - list storage operations + +SYNOPSIS + gcloud alpha storage operations list OPERATION_NAME + [--server-filter=SERVER_FILTER] [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List storage operations. + +EXAMPLES + To list all storage operations that belong to the bucket "my-bucket", run: + + $ gcloud alpha storage operations list projects/_/buckets/my-bucket + + To list operations in JSON format, run: + + $ gcloud alpha storage operations list \ + projects/_/buckets/my-bucket --format=json + + An alternative bucket format is available: + + $ gcloud alpha storage operations list gs://my-bucket + +POSITIONAL ARGUMENTS + OPERATION_NAME + The operation name including the Cloud Storage bucket and operation ID. + +FLAGS + --server-filter=SERVER_FILTER + Server-side filter string used to determine what operations to return. + Example: (done = true AND complete_time >= "2023-01-01T00:00:00Z") OR + requested_cancellation = true + +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. This variant is also available: + + $ gcloud storage operations list + diff --git a/gcloud/alpha/workstations/clusters/create b/gcloud/alpha/workstations/clusters/create index 52c4cc0ff..9e2b93022 100644 --- a/gcloud/alpha/workstations/clusters/create +++ b/gcloud/alpha/workstations/clusters/create @@ -51,7 +51,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument cluster on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. FLAGS --async diff --git a/gcloud/alpha/workstations/clusters/delete b/gcloud/alpha/workstations/clusters/delete index eaaf9b9e2..b5593eba4 100644 --- a/gcloud/alpha/workstations/clusters/delete +++ b/gcloud/alpha/workstations/clusters/delete @@ -42,7 +42,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument cluster on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. FLAGS --async diff --git a/gcloud/alpha/workstations/clusters/describe b/gcloud/alpha/workstations/clusters/describe index 61c2486bb..de4f4a36c 100644 --- a/gcloud/alpha/workstations/clusters/describe +++ b/gcloud/alpha/workstations/clusters/describe @@ -42,7 +42,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument cluster on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/workstations/configs/create b/gcloud/alpha/workstations/configs/create index 49c849d46..5bcb1325c 100644 --- a/gcloud/alpha/workstations/configs/create +++ b/gcloud/alpha/workstations/configs/create @@ -85,7 +85,8 @@ POSITIONAL ARGUMENTS To set the cluster attribute: ▸ provide the argument config on the command line with a fully specified name; - ▸ provide the argument --cluster on the command line. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster. --region=REGION The location for the config. @@ -93,7 +94,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument config on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. FLAGS --async diff --git a/gcloud/alpha/workstations/configs/delete b/gcloud/alpha/workstations/configs/delete index 9f7c61267..a31501493 100644 --- a/gcloud/alpha/workstations/configs/delete +++ b/gcloud/alpha/workstations/configs/delete @@ -44,7 +44,8 @@ POSITIONAL ARGUMENTS To set the cluster attribute: ▸ provide the argument config on the command line with a fully specified name; - ▸ provide the argument --cluster on the command line. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster. --region=REGION The name of the region of the config. @@ -52,7 +53,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument config on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. FLAGS --async diff --git a/gcloud/alpha/workstations/configs/describe b/gcloud/alpha/workstations/configs/describe index 5e57a3f3d..66023ce49 100644 --- a/gcloud/alpha/workstations/configs/describe +++ b/gcloud/alpha/workstations/configs/describe @@ -42,7 +42,8 @@ POSITIONAL ARGUMENTS To set the cluster attribute: ▸ provide the argument config on the command line with a fully specified name; - ▸ provide the argument --cluster on the command line. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster. --region=REGION The name of the region of the config. @@ -50,7 +51,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument config on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/workstations/configs/get-iam-policy b/gcloud/alpha/workstations/configs/get-iam-policy index e13488e74..e4af35195 100644 --- a/gcloud/alpha/workstations/configs/get-iam-policy +++ b/gcloud/alpha/workstations/configs/get-iam-policy @@ -50,7 +50,8 @@ POSITIONAL ARGUMENTS To set the cluster attribute: ▸ provide the argument config on the command line with a fully specified name; - ▸ provide the argument --cluster on the command line. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster. --region=REGION The name of the region of the config. @@ -58,7 +59,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument config on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/alpha/workstations/configs/list b/gcloud/alpha/workstations/configs/list index 1ec2789ea..2d8e19339 100644 --- a/gcloud/alpha/workstations/configs/list +++ b/gcloud/alpha/workstations/configs/list @@ -44,7 +44,8 @@ REQUIRED FLAGS To set the region attribute: ▸ provide the argument --cluster on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/alpha/workstations/configs/set-iam-policy b/gcloud/alpha/workstations/configs/set-iam-policy index 67a3c8f07..332216e09 100644 --- a/gcloud/alpha/workstations/configs/set-iam-policy +++ b/gcloud/alpha/workstations/configs/set-iam-policy @@ -49,7 +49,8 @@ POSITIONAL ARGUMENTS To set the cluster attribute: ▸ provide the argument config on the command line with a fully specified name; - ▸ provide the argument --cluster on the command line. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster. --region=REGION The name of the region of the config. @@ -57,7 +58,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument config on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. POLICY_FILE Path to a local JSON or YAML formatted file containing a valid policy. diff --git a/gcloud/alpha/workstations/configs/update b/gcloud/alpha/workstations/configs/update index 8b126598c..02b8b1df4 100644 --- a/gcloud/alpha/workstations/configs/update +++ b/gcloud/alpha/workstations/configs/update @@ -72,7 +72,8 @@ POSITIONAL ARGUMENTS To set the cluster attribute: ▸ provide the argument config on the command line with a fully specified name; - ▸ provide the argument --cluster on the command line. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster. --region=REGION The location for the config. @@ -80,7 +81,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument config on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. FLAGS --async diff --git a/gcloud/alpha/workstations/create b/gcloud/alpha/workstations/create index 4bbb7d3f6..384a85a7c 100644 --- a/gcloud/alpha/workstations/create +++ b/gcloud/alpha/workstations/create @@ -44,7 +44,8 @@ POSITIONAL ARGUMENTS To set the cluster attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --cluster on the command line. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster. --config=CONFIG The name of the config containing the workstation. @@ -52,7 +53,8 @@ POSITIONAL ARGUMENTS To set the config attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --config on the command line. + ▸ provide the argument --config on the command line; + ▸ set the property workstations/config. --region=REGION The name of the region of the workstation. @@ -60,7 +62,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. FLAGS --async diff --git a/gcloud/alpha/workstations/delete b/gcloud/alpha/workstations/delete index 220ac4928..f41c57407 100644 --- a/gcloud/alpha/workstations/delete +++ b/gcloud/alpha/workstations/delete @@ -44,7 +44,8 @@ POSITIONAL ARGUMENTS To set the cluster attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --cluster on the command line. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster. --config=CONFIG The name of the config containing the workstation. @@ -52,7 +53,8 @@ POSITIONAL ARGUMENTS To set the config attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --config on the command line. + ▸ provide the argument --config on the command line; + ▸ set the property workstations/config. --region=REGION The name of the region of the workstation. @@ -60,7 +62,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. FLAGS --async diff --git a/gcloud/alpha/workstations/describe b/gcloud/alpha/workstations/describe index b77a7c757..8b067dca7 100644 --- a/gcloud/alpha/workstations/describe +++ b/gcloud/alpha/workstations/describe @@ -44,7 +44,8 @@ POSITIONAL ARGUMENTS To set the cluster attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --cluster on the command line. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster. --config=CONFIG The name of the config containing the workstation. @@ -52,7 +53,8 @@ POSITIONAL ARGUMENTS To set the config attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --config on the command line. + ▸ provide the argument --config on the command line; + ▸ set the property workstations/config. --region=REGION The name of the region of the workstation. @@ -60,7 +62,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/workstations/get-iam-policy b/gcloud/alpha/workstations/get-iam-policy index a099ed36a..2b41bd17c 100644 --- a/gcloud/alpha/workstations/get-iam-policy +++ b/gcloud/alpha/workstations/get-iam-policy @@ -51,7 +51,8 @@ POSITIONAL ARGUMENTS To set the cluster attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --cluster on the command line. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster. --config=CONFIG The name of the config containing the workstation. @@ -59,7 +60,8 @@ POSITIONAL ARGUMENTS To set the config attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --config on the command line. + ▸ provide the argument --config on the command line; + ▸ set the property workstations/config. --region=REGION The name of the region of the workstation. @@ -67,7 +69,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/alpha/workstations/list b/gcloud/alpha/workstations/list index 7a4ccbaa4..7ecef47ac 100644 --- a/gcloud/alpha/workstations/list +++ b/gcloud/alpha/workstations/list @@ -44,7 +44,8 @@ REQUIRED FLAGS To set the cluster attribute: ▸ provide the argument --config on the command line with a fully specified name; - ▸ provide the argument --cluster on the command line. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster. --region=REGION The name of the region of the config. @@ -52,7 +53,8 @@ REQUIRED FLAGS To set the region attribute: ▸ provide the argument --config on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/alpha/workstations/list-usable b/gcloud/alpha/workstations/list-usable index 067aba847..030ac3eb0 100644 --- a/gcloud/alpha/workstations/list-usable +++ b/gcloud/alpha/workstations/list-usable @@ -44,7 +44,8 @@ REQUIRED FLAGS To set the cluster attribute: ▸ provide the argument --config on the command line with a fully specified name; - ▸ provide the argument --cluster on the command line. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster. --region=REGION The location for the config. @@ -52,7 +53,8 @@ REQUIRED FLAGS To set the region attribute: ▸ provide the argument --config on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/alpha/workstations/set-iam-policy b/gcloud/alpha/workstations/set-iam-policy index adcb7f0aa..e1532efa2 100644 --- a/gcloud/alpha/workstations/set-iam-policy +++ b/gcloud/alpha/workstations/set-iam-policy @@ -50,7 +50,8 @@ POSITIONAL ARGUMENTS To set the cluster attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --cluster on the command line. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster. --config=CONFIG The name of the config containing the workstation. @@ -58,7 +59,8 @@ POSITIONAL ARGUMENTS To set the config attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --config on the command line. + ▸ provide the argument --config on the command line; + ▸ set the property workstations/config. --region=REGION The name of the region of the workstation. @@ -66,7 +68,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. POLICY_FILE Path to a local JSON or YAML formatted file containing a valid policy. diff --git a/gcloud/alpha/workstations/ssh b/gcloud/alpha/workstations/ssh index 6a71e37bf..b8d92af2e 100644 --- a/gcloud/alpha/workstations/ssh +++ b/gcloud/alpha/workstations/ssh @@ -56,7 +56,8 @@ POSITIONAL ARGUMENTS To set the cluster attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --cluster on the command line. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster. --config=CONFIG The config for the workstation. @@ -64,7 +65,8 @@ POSITIONAL ARGUMENTS To set the config attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --config on the command line. + ▸ provide the argument --config on the command line; + ▸ set the property workstations/config. --region=REGION The location for the workstation. @@ -72,7 +74,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. [-- SSH_ARGS ...] Flags and positionals passed to the underlying ssh implementation. diff --git a/gcloud/alpha/workstations/start b/gcloud/alpha/workstations/start index dfcc6c9ad..e6977384f 100644 --- a/gcloud/alpha/workstations/start +++ b/gcloud/alpha/workstations/start @@ -44,7 +44,8 @@ POSITIONAL ARGUMENTS To set the cluster attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --cluster on the command line. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster. --config=CONFIG The config for the workstation. @@ -52,7 +53,8 @@ POSITIONAL ARGUMENTS To set the config attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --config on the command line. + ▸ provide the argument --config on the command line; + ▸ set the property workstations/config. --region=REGION The location for the workstation. @@ -60,7 +62,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. FLAGS --async diff --git a/gcloud/alpha/workstations/start-tcp-tunnel b/gcloud/alpha/workstations/start-tcp-tunnel index 0eb9f817b..663c0e0c4 100644 --- a/gcloud/alpha/workstations/start-tcp-tunnel +++ b/gcloud/alpha/workstations/start-tcp-tunnel @@ -50,7 +50,8 @@ POSITIONAL ARGUMENTS To set the cluster attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --cluster on the command line. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster. --config=CONFIG The config for the workstation. @@ -58,7 +59,8 @@ POSITIONAL ARGUMENTS To set the config attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --config on the command line. + ▸ provide the argument --config on the command line; + ▸ set the property workstations/config. --region=REGION The location for the workstation. @@ -66,7 +68,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. WORKSTATION_PORT The port on the workstation to which traffic should be sent. diff --git a/gcloud/alpha/workstations/stop b/gcloud/alpha/workstations/stop index 436f694c1..a488f163c 100644 --- a/gcloud/alpha/workstations/stop +++ b/gcloud/alpha/workstations/stop @@ -44,7 +44,8 @@ POSITIONAL ARGUMENTS To set the cluster attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --cluster on the command line. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster. --config=CONFIG The config for the workstation. @@ -52,7 +53,8 @@ POSITIONAL ARGUMENTS To set the config attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --config on the command line. + ▸ provide the argument --config on the command line; + ▸ set the property workstations/config. --region=REGION The location for the workstation. @@ -60,7 +62,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. FLAGS --async diff --git a/gcloud/artifacts/sbom/export b/gcloud/artifacts/sbom/export index dc39a13a6..85084b382 100644 --- a/gcloud/artifacts/sbom/export +++ b/gcloud/artifacts/sbom/export @@ -17,7 +17,10 @@ EXAMPLES REQUIRED FLAGS --uri=URI - The URI of the Artifact Registry image the SBOM is exported for. + The URI of the Artifact Registry image the SBOM is exported for. A + 'gcr.io' image can also be used if redirection is enabled in Artifact + Registry. Make sure 'artifactregistry.projectsettings.get' permission + is granted to the current gcloud user to verify the redirection status. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/ai/index-endpoints/create b/gcloud/beta/ai/index-endpoints/create index d454a6556..68ba6e096 100644 --- a/gcloud/beta/ai/index-endpoints/create +++ b/gcloud/beta/ai/index-endpoints/create @@ -4,9 +4,11 @@ NAME SYNOPSIS gcloud beta ai index-endpoints create --display-name=DISPLAY_NAME - [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] - [--network=NETWORK] [--public-endpoint-enabled] [--region=REGION] - [GCLOUD_WIDE_FLAG ...] + [--description=DESCRIPTION] [--enable-private-service-connect] + [--encryption-kms-key-name=ENCRYPTION_KMS_KEY_NAME] + [--labels=[KEY=VALUE,...]] [--network=NETWORK] + [--project-allowlist=[PROJECTS,...]] [--public-endpoint-enabled] + [--region=REGION] [GCLOUD_WIDE_FLAG ...] EXAMPLES To create an index endpoint under project example with network @@ -25,6 +27,17 @@ OPTIONAL FLAGS --description=DESCRIPTION Description of the index endpoint. + --enable-private-service-connect + If true, expose the index endpoint via private service connect. + + --encryption-kms-key-name=ENCRYPTION_KMS_KEY_NAME + The Cloud KMS resource identifier of the customer managed encryption + key used to protect a resource. Has the form: + projects/my-project/locations/my-region/keyRings/my-kr/cryptoKeys/my-key. + + The key needs to be in the same region as where the compute resource is + created. + --labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to add. @@ -37,6 +50,10 @@ OPTIONAL FLAGS The Google Compute Engine network name to which the IndexEndpoint should be peered. + --project-allowlist=[PROJECTS,...] + List of projects from which the forwarding rule will target the service + attachment. + --public-endpoint-enabled If true, the deployed index will be accessible through public endpoint. diff --git a/gcloud/beta/ai/index-endpoints/deploy-index b/gcloud/beta/ai/index-endpoints/deploy-index index 715395abc..53f614408 100644 --- a/gcloud/beta/ai/index-endpoints/deploy-index +++ b/gcloud/beta/ai/index-endpoints/deploy-index @@ -6,7 +6,9 @@ SYNOPSIS gcloud beta ai index-endpoints deploy-index (INDEX_ENDPOINT : --region=REGION) --deployed-index-id=DEPLOYED_INDEX_ID --display-name=DISPLAY_NAME - --index=INDEX [--machine-type=MACHINE_TYPE] + --index=INDEX [--allowed-issuers=[ALLOWED_ISSUERS,...]] + [--audiences=[AUDIENCES,...]] [--deployment-group=DEPLOYMENT_GROUP] + [--enable-access-logging] [--machine-type=MACHINE_TYPE] [--max-replica-count=MAX_REPLICA_COUNT] [--min-replica-count=MIN_REPLICA_COUNT] [--reserved-ip-ranges=[RESERVED_IP_RANGES,...]] [GCLOUD_WIDE_FLAG ...] @@ -17,14 +19,14 @@ DESCRIPTION EXAMPLES To deploy index 345 to an index endpoint 456 with 2 min replica count and 10 max replica count under project example in region us-central1, within - reserved ip ranges vertex-ai-ip-ranges-1 and vertex-ai-ip-ranges-2 run: + reserved ip ranges vertex-ai-ip-range-1 and vertex-ai-ip-range-2 run: $ gcloud beta ai index-endpoints deploy-index 456 \ --project=example --region=us-central1 --index=345 \ --deployed-index-id=deployed-index-345 \ --display-name=deployed-index-345 --min-replica-count=2 \ --max-replica-count=10 \ - --reserved-ip-ranges=vertex-ai-ip-ranges-1,vertex-ai-ip-ranges-2 + --reserved-ip-ranges=vertex-ai-ip-range-1,vertex-ai-ip-range-2 POSITIONAL ARGUMENTS Index endpoint resource - The index endpoint to deploy an index. The @@ -71,6 +73,34 @@ REQUIRED FLAGS ID of the index. OPTIONAL FLAGS + --allowed-issuers=[ALLOWED_ISSUERS,...] + List of allowed JWT issuers for a deployed index. + + Each entry must be a valid Google service account, in the following + format: service-account-name@project-id.iam.gserviceaccount.com + + --audiences=[AUDIENCES,...] + List of JWT audiences that are allowed to access a deployed index. + + JWT containing any of these audiences + (https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#section + -4.1.3) will be accepted. + + --deployment-group=DEPLOYMENT_GROUP + Deployment group can be no longer than 64 characters (eg:test, prod). + If not set, we will use the default deployment group. + + Creating deployment_groups with reserved_ip_ranges is a recommended + practice when the peered network has multiple peering ranges.This + creates your deployments from predictable IP spaces for easier traffic + administration. + + --enable-access-logging + If true, online prediction access logs are sent to Cloud Logging. + + These logs are standard server access logs, containing information like + timestamp and latency for each prediction request. + --machine-type=MACHINE_TYPE The machine resources to be used for each node of this deployment. For available machine types, see diff --git a/gcloud/beta/ai/indexes/create b/gcloud/beta/ai/indexes/create index 1a7db283a..5a07776fa 100644 --- a/gcloud/beta/ai/indexes/create +++ b/gcloud/beta/ai/indexes/create @@ -4,8 +4,9 @@ NAME SYNOPSIS gcloud beta ai indexes create --display-name=DISPLAY_NAME --metadata-file=METADATA_FILE [--description=DESCRIPTION] - [--labels=[KEY=VALUE,...]] [--metadata-schema-uri=METADATA_SCHEMA_URI] - [--region=REGION] [GCLOUD_WIDE_FLAG ...] + [--index-update-method=INDEX_UPDATE_METHOD] [--labels=[KEY=VALUE,...]] + [--metadata-schema-uri=METADATA_SCHEMA_URI] [--region=REGION] + [GCLOUD_WIDE_FLAG ...] EXAMPLES To create an index under project example in region us-central1, run: @@ -26,6 +27,16 @@ OPTIONAL FLAGS --description=DESCRIPTION Description of the index. + --index-update-method=INDEX_UPDATE_METHOD + The update method to use with this index. Choose stream_update or + batch_update. If not set, batch update will be used by default. + + batch_update: can update index with gcloud ai indexes update using + datapoints files on Cloud Storage. + + stream update: can update datapoints with upsert-datapoints and + delete-datapoints and will be applied nearly real-time. + --labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to add. diff --git a/gcloud/beta/beyondcorp/app/gateways/create b/gcloud/beta/beyondcorp/app/gateways/create new file mode 100644 index 000000000..0cc430e9b --- /dev/null +++ b/gcloud/beta/beyondcorp/app/gateways/create @@ -0,0 +1,107 @@ +NAME + gcloud beta beyondcorp app gateways create - create a new Beyondcorp + AppConnector Gateway + +SYNOPSIS + gcloud beta beyondcorp app gateways create + (APP_GATEWAY : --location=LOCATION) [--async] + [--display-name=DISPLAY_NAME] [--host-type=HOST_TYPE] + [--labels=[KEY=VALUE,...]] [--type=TYPE; default="TCP_PROXY"] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Create a new Beyondcorp AppConnector Gateway. + +EXAMPLES + The following command creates a Gateway with ID my-gateway in the default + user project: + + $ gcloud beta beyondcorp app gateways create my-gateway \ + --location=us-central1 --host-type=regional-mig + + The following command creates a Gateway with ID my-gateway with explicit + project value for all required and optional parameters: + + $ gcloud beta beyondcorp app gateways create my-gateway \ + --project=projectId --location=us-central1 \ + --host-type=regional-mig --type=tcp --labels='foo=bar' \ + --display-name=gateway-display-name --async + +POSITIONAL ARGUMENTS + App gateway resource - The Beyondcorp appconnector gateway you want to + create. The arguments in this group can be used to specify the attributes + of this resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument app_gateway on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + APP_GATEWAY + ID of the app gateway or fully qualified identifier for the app + gateway. + + To set the app_gateway attribute: + ▸ provide the argument app_gateway on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the beyondcorp service. + + To set the location attribute: + ▸ provide the argument app_gateway 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. + + --display-name=DISPLAY_NAME + An arbitrary user-provided name for the connection. Cannot exceed 64 + characters. + + --host-type=HOST_TYPE + The type of network connnectivity used by the connection. HOST_TYPE + must be (only one value is supported): + + regional-mig + REGIONAL MIG + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + --type=TYPE; default="TCP_PROXY" + The type of network connnectivity used by the connection. TYPE must be + (only one value is supported): + + tcp + TCP connection + +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 beyondcorp/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/ + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/beyondcorp/app/gateways/delete b/gcloud/beta/beyondcorp/app/gateways/delete new file mode 100644 index 000000000..25b3f57d5 --- /dev/null +++ b/gcloud/beta/beyondcorp/app/gateways/delete @@ -0,0 +1,69 @@ +NAME + gcloud beta beyondcorp app gateways delete - delete a single AppConnector + Gateway + +SYNOPSIS + gcloud beta beyondcorp app gateways delete + (APP_GATEWAY : --location=LOCATION) [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Delete a single AppConnector Gateway. + +EXAMPLES + To delete a gateway my-gateway run: + + $ gcloud beta beyondcorp app gateways delete my-gateway \ + --project={project} --location={location} + +POSITIONAL ARGUMENTS + App gateway resource - The Beyondcorp appconnector gateway you want 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 app_gateway on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + APP_GATEWAY + ID of the app gateway or fully qualified identifier for the app + gateway. + + To set the app_gateway attribute: + ▸ provide the argument app_gateway on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the beyondcorp service. + + To set the location attribute: + ▸ provide the argument app_gateway 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 beyondcorp/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/ + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/beyondcorp/app/gateways/describe b/gcloud/beta/beyondcorp/app/gateways/describe new file mode 100644 index 000000000..e84fa9bf1 --- /dev/null +++ b/gcloud/beta/beyondcorp/app/gateways/describe @@ -0,0 +1,71 @@ +NAME + gcloud beta beyondcorp app gateways describe - describe a single + AppConnector Gateway + +SYNOPSIS + gcloud beta beyondcorp app gateways describe + (APP_GATEWAY : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Describe a single AppConnector Gateway. + +EXAMPLES + To describe a gateway my-gateway run: + + $ gcloud beta beyondcorp app gateways describe my-gateway \ + --project={project} --location={location} + + To describe a gateway in a project for location us-central1 in table form, + run: + + $ gcloud beta beyondcorp app gateways describe --project=projectId \ + --location=us-central1 --format=json(displayName, name, state, \ + type, hostType, updateTime, labels) + +POSITIONAL ARGUMENTS + App gateway resource - The Beyondcorp appconnector gateway you want to get + details about. 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 app_gateway on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + APP_GATEWAY + ID of the app gateway or fully qualified identifier for the app + gateway. + + To set the app_gateway attribute: + ▸ provide the argument app_gateway on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the beyondcorp service. + + To set the location attribute: + ▸ provide the argument app_gateway 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 beyondcorp/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/ + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/beyondcorp/app/gateways/help b/gcloud/beta/beyondcorp/app/gateways/help new file mode 100644 index 000000000..5c70cf5d5 --- /dev/null +++ b/gcloud/beta/beyondcorp/app/gateways/help @@ -0,0 +1,35 @@ +NAME + gcloud beta beyondcorp app gateways - manages appconnector gateways + +SYNOPSIS + gcloud beta beyondcorp app gateways COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) A BeyondCorp AppGateway resource represents a BeyondCorp protected + AppGateway to a remote application. It creates all the necessary google + cloud platform components needed for creating a BeyondCorp protected + AppGateway. Multiple connectors can be authorised for a single AppGateway + +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 new Beyondcorp AppConnector Gateway. + + delete + (BETA) Delete a single AppConnector Gateway. + + describe + (BETA) Describe a single AppConnector Gateway. + + list + (BETA) List Beyondcorp AppConnector Gateway resources. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/beyondcorp/app/gateways/list b/gcloud/beta/beyondcorp/app/gateways/list new file mode 100644 index 000000000..b903d956a --- /dev/null +++ b/gcloud/beta/beyondcorp/app/gateways/list @@ -0,0 +1,87 @@ +NAME + gcloud beta beyondcorp app gateways list - list Beyondcorp AppConnector + Gateway resources + +SYNOPSIS + gcloud beta beyondcorp app gateways list --location=LOCATION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) List Beyondcorp AppConnector Gateway resources based on project and + location. + +EXAMPLES + examples: | To list all gateways in a project for location us-central1 in + table form, run: + + $ gcloud beta beyondcorp app gateways list --project=projectId \ + --location=us-central1 + + To list all gateways in a project for location us-central1 in json form, + run: + + $ gcloud beta beyondcorp app gateways list --project=projectId \ + --location=us-central1 --format=json(displayName, name, state, \ + type, hostType, updateTime, labels) + +REQUIRED FLAGS + Location resource - Arguments and flags that define the Beyondcorp gateway + you want to list. This represents a Cloud resource. (NOTE) Some attributes + are not given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + 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. + +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 beyondcorp/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/ + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/beyondcorp/app/help b/gcloud/beta/beyondcorp/app/help index bae551f78..fd2e96d47 100644 --- a/gcloud/beta/beyondcorp/app/help +++ b/gcloud/beta/beyondcorp/app/help @@ -32,6 +32,9 @@ GROUPS connectors (BETA) Create and manipulate beyondcorp connectors. + gateways + (BETA) Manages appconnector gateways. + operations (BETA) List and Describe beyondcorp appconnector operations. diff --git a/gcloud/beta/bigtable/app-profiles/create b/gcloud/beta/bigtable/app-profiles/create index a02608ff9..a198d7c30 100644 --- a/gcloud/beta/bigtable/app-profiles/create +++ b/gcloud/beta/bigtable/app-profiles/create @@ -7,7 +7,8 @@ SYNOPSIS (APP_PROFILE : --instance=INSTANCE) ([--route-any : --restrict-to=[RESTRICT_TO,...]] | [--route-to=ROUTE_TO : --transactional-writes]) - [--description=DESCRIPTION] [--force] [GCLOUD_WIDE_FLAG ...] + [--description=DESCRIPTION] [--force] [--priority=PRIORITY] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Create a new Bigtable app profile. @@ -31,6 +32,11 @@ EXAMPLES --instance=my-instance-id --route-any \ --description="Routes requests for my use case" + To create an app profile with a request priority of PRIORITY_MEDIUM, run: + + $ gcloud beta bigtable app-profiles create my-app-profile-id \ + --instance=my-instance-id --route-any --priority=PRIORITY_MEDIUM + POSITIONAL ARGUMENTS App profile resource - The app profile to create. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some @@ -96,6 +102,17 @@ OPTIONAL FLAGS --force Ignore warnings and force create. + --priority=PRIORITY + Specify the request priority. If not specified, the app profile uses + PRIORITY_HIGH by default. PRIORITY must be one of: + + PRIORITY_HIGH + Requests are treated with high priority. + PRIORITY_LOW + Requests are treated with low priority. + PRIORITY_MEDIUM + Requests are treated with medium priority. + 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/bigtable/app-profiles/update b/gcloud/beta/bigtable/app-profiles/update index caaca3eba..0d4974000 100644 --- a/gcloud/beta/bigtable/app-profiles/update +++ b/gcloud/beta/bigtable/app-profiles/update @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud beta bigtable app-profiles update (APP_PROFILE : --instance=INSTANCE) [--async] - [--description=DESCRIPTION] [--force] + [--description=DESCRIPTION] [--force] [--priority=PRIORITY] [[--route-any : --restrict-to=[RESTRICT_TO,...]] | [--route-to=ROUTE_TO : --transactional-writes]] [GCLOUD_WIDE_FLAG ...] @@ -30,6 +30,11 @@ EXAMPLES $ gcloud beta bigtable app-profiles update my-app-profile-id \ --instance=my-instance-id --description="New description" + To update the request priority for an app profile to PRIORITY_LOW, run: + + $ gcloud beta bigtable app-profiles update my-app-profile-id \ + --instance=my-instance-id --priority=PRIORITY_LOW + POSITIONAL ARGUMENTS App profile resource - The app profile to update. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some @@ -73,6 +78,17 @@ FLAGS --force Ignore warnings and force update. + --priority=PRIORITY + Specify the request priority. If not specified, the app profile uses + PRIORITY_HIGH by default. PRIORITY must be one of: + + PRIORITY_HIGH + Requests are treated with high priority. + PRIORITY_LOW + Requests are treated with low priority. + PRIORITY_MEDIUM + Requests are treated with medium priority. + At most one of these can be specified: Multi Cluster Routing Policy diff --git a/gcloud/beta/composer/environments/create b/gcloud/beta/composer/environments/create index 9615d7b0d..4931ef4a5 100644 --- a/gcloud/beta/composer/environments/create +++ b/gcloud/beta/composer/environments/create @@ -6,13 +6,15 @@ SYNOPSIS gcloud beta composer environments create (ENVIRONMENT : --location=LOCATION) [--airflow-configs=[KEY=VALUE,...]] [--async] [--cloud-sql-machine-type=CLOUD_SQL_MACHINE_TYPE] + [--cloud-sql-preferred-zone=CLOUD_SQL_PREFERRED_ZONE] [--disk-size=DISK_SIZE] [--enable-cloud-data-lineage-integration] [--enable-high-resilience] [--env-variables=[NAME=VALUE,...]] [--environment-size=ENVIRONMENT_SIZE] [--labels=[KEY=VALUE,...]] [--machine-type=MACHINE_TYPE] [--node-count=NODE_COUNT] [--oauth-scopes=[SCOPE,...]] [--python-version=PYTHON_VERSION] - [--service-account=SERVICE_ACCOUNT] [--tags=[TAG,...]] - [--web-server-machine-type=WEB_SERVER_MACHINE_TYPE] [--zone=ZONE] + [--service-account=SERVICE_ACCOUNT] [--storage-bucket=STORAGE_BUCKET] + [--tags=[TAG,...]] [--web-server-machine-type=WEB_SERVER_MACHINE_TYPE] + [--zone=ZONE] [--airflow-version=AIRFLOW_VERSION | --image-version=IMAGE_VERSION] [--cloud-sql-ipv4-cidr=CLOUD_SQL_IPV4_CIDR --composer-network-ipv4-cidr=COMPOSER_NETWORK_IPV4_CIDR @@ -120,6 +122,9 @@ FLAGS available machine types is available here: https://cloud.google.com/composer/pricing#db-machine-types. + --cloud-sql-preferred-zone=CLOUD_SQL_PREFERRED_ZONE + Select cloud sql preferred zone, supported for Composer 2 Environments. + --disk-size=DISK_SIZE The disk size for each VM node in the environment. The minimum size is 20GB, and the maximum is 64TB. Specified value must be an integer @@ -184,6 +189,10 @@ FLAGS If a service account is not specified, the "default" Compute Engine service account for the project is used. Cannot be updated. + --storage-bucket=STORAGE_BUCKET + Name of an exisiting Cloud Storage bucket to be used by the + environment. Supported only for Composer 2.4.X and above. + --tags=[TAG,...] The set of instance tags applied to all node VMs. Tags are used to identify valid sources or targets for network firewalls. Each tag diff --git a/gcloud/beta/compute/help b/gcloud/beta/compute/help index 044cd8b09..2da0f29b2 100644 --- a/gcloud/beta/compute/help +++ b/gcloud/beta/compute/help @@ -132,6 +132,9 @@ GROUPS project-info (BETA) Read and manipulate project-level data like quotas and metadata. + project-zonal-metadata + (BETA) Describe and update project zonal metadata. + public-advertised-prefixes (BETA) Manage public advertised prefix resources. diff --git a/gcloud/beta/compute/network-attachments/help b/gcloud/beta/compute/network-attachments/help index 0dc01558a..0dd92507b 100644 --- a/gcloud/beta/compute/network-attachments/help +++ b/gcloud/beta/compute/network-attachments/help @@ -28,6 +28,9 @@ COMMANDS list (BETA) List Google Compute Engine network attachments. + update + (BETA) Update a Google Compute Engine network attachment. + NOTES This command is currently in beta and might change without notice. These variants are also available: diff --git a/gcloud/beta/compute/network-attachments/update b/gcloud/beta/compute/network-attachments/update new file mode 100644 index 000000000..936eb8e00 --- /dev/null +++ b/gcloud/beta/compute/network-attachments/update @@ -0,0 +1,92 @@ +NAME + gcloud beta compute network-attachments update - update a Google Compute + Engine network attachment + +SYNOPSIS + gcloud beta compute network-attachments update NAME + [--description=DESCRIPTION] [--producer-accept-list=[ACCEPT_LIST,...]] + [--producer-reject-list=[REJECT_LIST,...]] [--region=REGION] + [--subnets=SUBNETS,[SUBNETS,...]] [--subnets-region=SUBNETS_REGION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) gcloud beta compute network-attachments update is used to update + network attachments. You can update the following fields: description, + subnets, producer-accept-list and producer-reject-list. If you update the + producer-accept-list or producer-reject-list, the full new list should be + specified. + +EXAMPLES + To update all the parameters with the new list, run: + + $ gcloud beta compute network-attachments update \ + NETWORK_ATTACHMENT_NAME --region=us-central1 \ + --subnets=MY_SUBNET2 \ + --description='default network attachment' \ + --producer-accept-list=PROJECT5,PROJECT6 \ + --producer-reject-list=PROJECT7,PROJECT8 + + To update a network attachment to change only the subnet to MY_SUBNET3, + run: + + $ gcloud beta compute network-attachments update \ + NETWORK_ATTACHMENT_NAME --region=us-central1 \ + --subnets=MY_SUBNET3 + +POSITIONAL ARGUMENTS + NAME + Name of the network attachment to update. + +FLAGS + --description=DESCRIPTION + An optional, textual description for the network attachment. + + --producer-accept-list=[ACCEPT_LIST,...] + Projects that are allowed to connect to this network attachment. + + --producer-reject-list=[REJECT_LIST,...] + Projects that are not allowed to connect to this network attachment. + + --region=REGION + Region of the network attachment to update. 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. + + --subnets=SUBNETS,[SUBNETS,...] + The subnetworks provided by the consumer for the producers + + --subnets-region=SUBNETS_REGION + Region of the subnetworks to operate on. Overrides the default + compute/region property value for this command invocation. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud compute network-attachments update + + $ gcloud alpha compute network-attachments update + diff --git a/gcloud/beta/compute/networks/vpc-access/connectors/update b/gcloud/beta/compute/networks/vpc-access/connectors/update index 42b11596c..cb5bb16ed 100644 --- a/gcloud/beta/compute/networks/vpc-access/connectors/update +++ b/gcloud/beta/compute/networks/vpc-access/connectors/update @@ -91,5 +91,8 @@ API REFERENCE https://cloud.google.com/vpc/docs/configure-serverless-vpc-access 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 compute networks vpc-access connectors update diff --git a/gcloud/beta/compute/project-zonal-metadata/add b/gcloud/beta/compute/project-zonal-metadata/add new file mode 100644 index 000000000..fba6ea9c2 --- /dev/null +++ b/gcloud/beta/compute/project-zonal-metadata/add @@ -0,0 +1,53 @@ +NAME + gcloud beta compute project-zonal-metadata add - add or update project + zonal metadata + +SYNOPSIS + gcloud beta compute project-zonal-metadata add + --metadata=KEY=VALUE,[KEY=VALUE,...] --zone=ZONE [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) gcloud beta compute project-zonal-metadata add is used to add or + update project zonal metadata for your VM instances. Project zonal metadata + values propagate to all VMs within the specified zone. Every VM has access + to a metadata server that you can use to query the configured project zonal + metadata values. To set metadata for individual instances, use gcloud + compute instances add-metadata. For information about metadata, see + https://cloud.google.com/compute/docs/metadata. + + Only the metadata keys that you provide in the command get mutated. All + other existing metadata entries remain the same. + +EXAMPLES + To set the project zonal metadata with key=value in the zone us-central1-a + for the project my-gcp-project, run: + + $ gcloud beta compute project-zonal-metadata add \ + --metadata=key=value --zone=us-central1-a \ + --project=my-gcp-project + + For more information and examples for setting project zonal metadata, see + https://cloud.google.com/compute/docs/metadata/setting-custom-metadata#set-custom-project-zonal-metadata + +REQUIRED FLAGS + --metadata=KEY=VALUE,[KEY=VALUE,...] + The project zonal metadata key-value pairs that you want to add or + update + + --zone=ZONE + The zone in which you want to add or update project zonal metadata + +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 project-zonal-metadata add + diff --git a/gcloud/beta/compute/project-zonal-metadata/describe b/gcloud/beta/compute/project-zonal-metadata/describe new file mode 100644 index 000000000..ae3275d3d --- /dev/null +++ b/gcloud/beta/compute/project-zonal-metadata/describe @@ -0,0 +1,36 @@ +NAME + gcloud beta compute project-zonal-metadata describe - describe project + zonal metadata + +SYNOPSIS + gcloud beta compute project-zonal-metadata describe --zone=ZONE + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Describe project zonal metadata. + +EXAMPLES + To describe the project zonal metadata in the zone us-central1-a for the + project my-gcp-project, run: + + $ gcloud beta compute project-zonal-metadata describe \ + --zone=us-central1-a --project=my-gcp-project + +REQUIRED FLAGS + --zone=ZONE + Zone for project zonal metadata + +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 project-zonal-metadata describe + diff --git a/gcloud/beta/compute/project-zonal-metadata/help b/gcloud/beta/compute/project-zonal-metadata/help new file mode 100644 index 000000000..688dba92d --- /dev/null +++ b/gcloud/beta/compute/project-zonal-metadata/help @@ -0,0 +1,33 @@ +NAME + gcloud beta compute project-zonal-metadata - describe and update project + zonal metadata + +SYNOPSIS + gcloud beta compute project-zonal-metadata COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Describe and update Compute Engine project zonal metadata. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + add + (BETA) Add or update project zonal metadata. + + describe + (BETA) Describe project zonal metadata. + + remove + (BETA) Remove project zonal metadata. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha compute project-zonal-metadata + diff --git a/gcloud/beta/compute/project-zonal-metadata/remove b/gcloud/beta/compute/project-zonal-metadata/remove new file mode 100644 index 000000000..891f8d006 --- /dev/null +++ b/gcloud/beta/compute/project-zonal-metadata/remove @@ -0,0 +1,60 @@ +NAME + gcloud beta compute project-zonal-metadata remove - remove project zonal + metadata + +SYNOPSIS + gcloud beta compute project-zonal-metadata remove --zone=ZONE + [--all | --keys=KEY,[KEY,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) gcloud beta compute project-zonal-metadata remove is used to remove + project zonal metadata from all VMs within the specified zone. For + information about metadata, see + https://cloud.google.com/compute/docs/metadata. + + Only the metadata keys that you provide in the command get removed. All + other existing metadata entries remain the same. + + After you remove a specific project zonal metadata entry, if that metadata + key has any project-wide value configured, then the VMs in the zone + automatically inherit that project-wide value. + +EXAMPLES + To remove the project zonal metadata with key=value in the zone + us-central1-a for the project my-gcp-project, run: + + $ gcloud beta compute project-zonal-metadata remove --keys=key \ + --zone=us-central1-a --project=my-gcp-project + + For more information and examples about how to remove project zonal + metadata, see + https://cloud.google.com/compute/docs/metadata/setting-custom-metadata#remove-custom-project-zonal-metadata + +REQUIRED FLAGS + --zone=ZONE + The zone in which you want to remove project zonal metadata + +OPTIONAL FLAGS + At most one of these can be specified: + + --all + If provided, all project zonal metadata entries are removed from VM + instances in the zone. + + --keys=KEY,[KEY,...] + The keys for which you want to remove project zonal metadata + +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 project-zonal-metadata remove + diff --git a/gcloud/beta/config/get b/gcloud/beta/config/get index ecc56c106..f742ca7e1 100644 --- a/gcloud/beta/config/get +++ b/gcloud/beta/config/get @@ -1395,6 +1395,22 @@ AVAILABLE PROPERTIES When a --region flag is required but not provided, the command will fall back to this value, if set. + workstations + cluster + Default cluster to use when working with Workstations resources. + When a --cluster flag is required but not provided, the command + will fall back to this value, if set. + + config + Default configuration to use when working with Workstations + resources. When a --config flag is required but not provided, the + command will fall back to this value, if set. + + region + Default region to use when working with Workstations resources. + When a --region flag is required but not provided, the command will + fall back to this value, if set. + NOTES This command is currently in beta and might change without notice. These variants are also available: diff --git a/gcloud/beta/config/help b/gcloud/beta/config/help index 55d1068a9..75c5ccadf 100644 --- a/gcloud/beta/config/help +++ b/gcloud/beta/config/help @@ -1427,6 +1427,22 @@ AVAILABLE PROPERTIES When a --region flag is required but not provided, the command will fall back to this value, if set. + workstations + cluster + Default cluster to use when working with Workstations resources. + When a --cluster flag is required but not provided, the command + will fall back to this value, if set. + + config + Default configuration to use when working with Workstations + resources. When a --config flag is required but not provided, the + command will fall back to this value, if set. + + region + Default region to use when working with Workstations resources. + When a --region flag is required but not provided, the command will + fall back to this value, if set. + NOTES This command is currently in beta and might change without notice. These variants are also available: diff --git a/gcloud/beta/config/list b/gcloud/beta/config/list index a644450e9..ea098a58e 100644 --- a/gcloud/beta/config/list +++ b/gcloud/beta/config/list @@ -1439,6 +1439,22 @@ AVAILABLE PROPERTIES When a --region flag is required but not provided, the command will fall back to this value, if set. + workstations + cluster + Default cluster to use when working with Workstations resources. + When a --cluster flag is required but not provided, the command + will fall back to this value, if set. + + config + Default configuration to use when working with Workstations + resources. When a --config flag is required but not provided, the + command will fall back to this value, if set. + + region + Default region to use when working with Workstations resources. + When a --region flag is required but not provided, the command will + fall back to this value, if set. + NOTES This command is currently in beta and might change without notice. These variants are also available: diff --git a/gcloud/beta/config/set b/gcloud/beta/config/set index 79207b2eb..bdb4524b4 100644 --- a/gcloud/beta/config/set +++ b/gcloud/beta/config/set @@ -1442,6 +1442,22 @@ AVAILABLE PROPERTIES When a --region flag is required but not provided, the command will fall back to this value, if set. + workstations + cluster + Default cluster to use when working with Workstations resources. + When a --cluster flag is required but not provided, the command + will fall back to this value, if set. + + config + Default configuration to use when working with Workstations + resources. When a --config flag is required but not provided, the + command will fall back to this value, if set. + + region + Default region to use when working with Workstations resources. + When a --region flag is required but not provided, the command will + fall back to this value, if set. + NOTES This command is currently in beta and might change without notice. These variants are also available: diff --git a/gcloud/beta/config/unset b/gcloud/beta/config/unset index 5b10dab04..a84a5ba34 100644 --- a/gcloud/beta/config/unset +++ b/gcloud/beta/config/unset @@ -1403,6 +1403,22 @@ AVAILABLE PROPERTIES When a --region flag is required but not provided, the command will fall back to this value, if set. + workstations + cluster + Default cluster to use when working with Workstations resources. + When a --cluster flag is required but not provided, the command + will fall back to this value, if set. + + config + Default configuration to use when working with Workstations + resources. When a --config flag is required but not provided, the + command will fall back to this value, if set. + + region + Default region to use when working with Workstations resources. + When a --region flag is required but not provided, the command will + fall back to this value, if set. + NOTES This command is currently in beta and might change without notice. These variants are also available: diff --git a/gcloud/beta/container/clusters/create b/gcloud/beta/container/clusters/create index cecc5ce73..fd7ae2744 100644 --- a/gcloud/beta/container/clusters/create +++ b/gcloud/beta/container/clusters/create @@ -419,10 +419,10 @@ FLAGS Size for node VM boot disks in GB. Defaults to 100GB. --disk-type=DISK_TYPE - Type of the node VM boot disk. For version 1.24.0+, defaults to - pd-balanced. Before version 1.24.0, defaults to pd-standard. DISK_TYPE - must be one of: pd-standard, pd-ssd, pd-balanced, hyperdisk-balanced, - hyperdisk-extreme, hyperdisk-throughput. + Type of the node VM boot disk. For version 1.24 and later, defaults to + pd-balanced. For versions earlier than 1.24, defaults to pd-standard. + DISK_TYPE must be one of: pd-standard, pd-ssd, pd-balanced, + hyperdisk-balanced, hyperdisk-extreme, hyperdisk-throughput. --enable-autorepair Enable node autorepair feature for a cluster's default node pool(s). @@ -754,9 +754,9 @@ FLAGS $ gcloud compute machine-types list - You can also specify custom machine types with the string - "custom-CPUS-RAM" where "CPUS" is the number of virtual CPUs and "RAM" - is the amount of RAM in MiB. + You can also specify custom machine types by providing a string with + the format "custom-CPUS-RAM" where "CPUS" is the number of virtual CPUs + and "RAM" is the amount of RAM in MiB. For example, to create a node pool using custom machines with 2 vCPUs and 12 GB of RAM: diff --git a/gcloud/beta/container/fleet/mesh/disable b/gcloud/beta/container/fleet/mesh/disable index 66167e9d1..5b5d8c9dd 100644 --- a/gcloud/beta/container/fleet/mesh/disable +++ b/gcloud/beta/container/fleet/mesh/disable @@ -12,6 +12,11 @@ EXAMPLES $ gcloud beta container fleet mesh disable + To delete the fleet-level default Membership configuration, run: + + $ gcloud beta container fleet mesh disable \ + --fleet-default-member-config + FLAGS --force Disable this feature, even if it is currently in use. Force disablement diff --git a/gcloud/beta/container/fleet/mesh/enable b/gcloud/beta/container/fleet/mesh/enable index 1b31a0d5b..c300053a6 100644 --- a/gcloud/beta/container/fleet/mesh/enable +++ b/gcloud/beta/container/fleet/mesh/enable @@ -12,6 +12,12 @@ EXAMPLES $ gcloud beta container fleet mesh enable + To enable the Service Mesh Feature with a fleet-level default Membership + configuration, run: + + $ gcloud beta container fleet mesh enable \ + --fleet-default-member-config=/path/to/service-mesh.yaml + 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/container/hub/mesh/disable b/gcloud/beta/container/hub/mesh/disable index 4aec87fba..bb2fdc4e6 100644 --- a/gcloud/beta/container/hub/mesh/disable +++ b/gcloud/beta/container/hub/mesh/disable @@ -12,6 +12,11 @@ EXAMPLES $ gcloud beta container hub mesh disable + To delete the fleet-level default Membership configuration, run: + + $ gcloud beta container hub mesh disable \ + --fleet-default-member-config + FLAGS --force Disable this feature, even if it is currently in use. Force disablement diff --git a/gcloud/beta/container/hub/mesh/enable b/gcloud/beta/container/hub/mesh/enable index ba5a5b29e..89286ce6b 100644 --- a/gcloud/beta/container/hub/mesh/enable +++ b/gcloud/beta/container/hub/mesh/enable @@ -12,6 +12,12 @@ EXAMPLES $ gcloud beta container hub mesh enable + To enable the Service Mesh Feature with a fleet-level default Membership + configuration, run: + + $ gcloud beta container hub mesh enable \ + --fleet-default-member-config=/path/to/service-mesh.yaml + 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/container/node-pools/create b/gcloud/beta/container/node-pools/create index 9a280399f..643fe545d 100644 --- a/gcloud/beta/container/node-pools/create +++ b/gcloud/beta/container/node-pools/create @@ -189,10 +189,10 @@ FLAGS Size for node VM boot disks in GB. Defaults to 100GB. --disk-type=DISK_TYPE - Type of the node VM boot disk. For version 1.24.0+, defaults to - pd-balanced. Before version 1.24.0, defaults to pd-standard. DISK_TYPE - must be one of: pd-standard, pd-ssd, pd-balanced, hyperdisk-balanced, - hyperdisk-extreme, hyperdisk-throughput. + Type of the node VM boot disk. For version 1.24 and later, defaults to + pd-balanced. For versions earlier than 1.24, defaults to pd-standard. + DISK_TYPE must be one of: pd-standard, pd-ssd, pd-balanced, + hyperdisk-balanced, hyperdisk-extreme, hyperdisk-throughput. --enable-autoprovisioning Enables Cluster Autoscaler to treat the node pool as if it was @@ -297,9 +297,9 @@ FLAGS $ gcloud compute machine-types list - You can also specify custom machine types with the string - "custom-CPUS-RAM" where "CPUS" is the number of virtual CPUs and "RAM" - is the amount of RAM in MiB. + You can also specify custom machine types by providing a string with + the format "custom-CPUS-RAM" where "CPUS" is the number of virtual CPUs + and "RAM" is the amount of RAM in MiB. For example, to create a node pool using custom machines with 2 vCPUs and 12 GB of RAM: diff --git a/gcloud/beta/container/node-pools/update b/gcloud/beta/container/node-pools/update index aaa36b371..d6fdc83ac 100644 --- a/gcloud/beta/container/node-pools/update +++ b/gcloud/beta/container/node-pools/update @@ -19,7 +19,8 @@ SYNOPSIS --node-pool-soak-duration=NODE_POOL_SOAK_DURATION --standard-rollout-policy=[batch-node-count=BATCH_NODE_COUNT, batch-percent=BATCH_NODE_PERCENTAGE, - batch-soak-duration=BATCH_SOAK_DURATION,...] + batch-soak-duration=BATCH_SOAK_DURATION,...] | --disk-size=DISK_SIZE + --disk-type=DISK_TYPE --machine-type=MACHINE_TYPE | --enable-autoprovisioning --enable-autoscaling --location-policy=LOCATION_POLICY --max-nodes=MAX_NODES --min-nodes=MIN_NODES @@ -354,6 +355,35 @@ REQUIRED FLAGS --standard-rollout-policy=batch-percent=0.3,\ batch-soak-duration=60s + Node config + + --disk-size=DISK_SIZE + Size for node VM boot disks in GB. Defaults to 100GB. + + --disk-type=DISK_TYPE + Type of the node VM boot disk. For version 1.24 and later, defaults + to pd-balanced. For versions earlier than 1.24, defaults to + pd-standard. DISK_TYPE must be one of: pd-standard, pd-ssd, + pd-balanced, hyperdisk-balanced, hyperdisk-extreme, + hyperdisk-throughput. + + --machine-type=MACHINE_TYPE + The type of machine to use for nodes. Defaults to e2-medium. The + list of predefined machine types is available using the following + command: + + $ gcloud compute machine-types list + + You can also specify custom machine types by providing a string + with the format "custom-CPUS-RAM" where "CPUS" is the number of + virtual CPUs and "RAM" is the amount of RAM in MiB. + + For example, to create a node pool using custom machines with 2 + vCPUs and 12 GB of RAM: + + $ gcloud beta container node-pools update high-mem-pool \ + --machine-type=custom-2-12288 + Cluster autoscaling --enable-autoprovisioning diff --git a/gcloud/beta/container/vmware/clusters/create b/gcloud/beta/container/vmware/clusters/create index 743b782ce..37b18e4c8 100644 --- a/gcloud/beta/container/vmware/clusters/create +++ b/gcloud/beta/container/vmware/clusters/create @@ -29,7 +29,9 @@ SYNOPSIS [ips=IPS],[netmask=NETMASK]) [--admin-users=ADMIN_USERS] [--annotations=[KEY=VALUE,...]] [--async] [--description=DESCRIPTION] [--disable-aag-config] [--disable-vsphere-csi] [--enable-auto-repair] - [--enable-vm-tracking] [--validate-only] + [--enable-vm-tracking] + [--upgrade-policy=[control-plane-only=CONTROL-PLANE-ONLY]] + [--validate-only] [--cpus=CPUS --enable-auto-resize --memory=MEMORY --replicas=REPLICAS] [--disable-control-plane-v2 | --enable-control-plane-v2] [--enable-advanced-networking --enable-dataplane-v2] @@ -333,6 +335,42 @@ OPTIONAL FLAGS --enable-vm-tracking If set, enable VM tracking. + Upgrade policy for the cluster. + + --upgrade-policy=[control-plane-only=CONTROL-PLANE-ONLY] + If not specified, control-plane-only is set to False. In the next + upgrade operation, all worker node pools will be upgraded together + with the control plane. + + Example: + + To upgrade the control plane only and keep worker node pools version unchanged, first specify the policy: + + $ gcloud beta container vmware clusters create CLUSTER \ + --upgrade-policy control-plane-only=True + + Then to start the upgrade operation using the specified policy, run: + + $ gcloud beta container vmware clusters upgrade CLUSTER \ + --version=VERSION + + After upgrading only the cluster control plane, to upgrade an individual node pool, run: + + $ gcloud beta container vmware node-pools update NODE_POOL \ + --version=VERSION + + Example: + + Alternatively, to upgrade both the control plane and all worker node pools, first specify the policy: + + $ gcloud beta container vmware clusters create CLUSTER \ + --upgrade-policy control-plane-only=False + + Then to start the upgrade operation using the specified policy, run: + + $ gcloud beta container vmware clusters upgrade CLUSTER \ + --version=VERSION + --validate-only If set, only validate the request, but do not actually perform the operation. diff --git a/gcloud/beta/container/vmware/clusters/update b/gcloud/beta/container/vmware/clusters/update index 8e92166b6..25b518aac 100644 --- a/gcloud/beta/container/vmware/clusters/update +++ b/gcloud/beta/container/vmware/clusters/update @@ -10,7 +10,9 @@ SYNOPSIS [avoid-buggy-ips=AVOID-BUGGY-IPS], [manual-assign=MANUAL-ASSIGN],[pool=POOL]] [--static-ip-config-ip-blocks=[gateway=GATEWAY], - [ips=IPS],[netmask=NETMASK]] [--validate-only] [--version=VERSION] + [ips=IPS],[netmask=NETMASK]] + [--upgrade-policy=[control-plane-only=CONTROL-PLANE-ONLY]] + [--validate-only] [--version=VERSION] [--add-annotations=[KEY1=VALUE1,KEY2=VALUE2,...] | --remove-annotations=[KEY1,KEY2,...]] [--cpus=CPUS --memory=MEMORY --disable-auto-resize @@ -131,6 +133,42 @@ FLAGS Use quote around the flag value to escape semicolon in the terminal. + Upgrade policy for the cluster. + + --upgrade-policy=[control-plane-only=CONTROL-PLANE-ONLY] + If not specified, control-plane-only is set to False. In the next + upgrade operation, all worker node pools will be upgraded together + with the control plane. + + Example: + + To upgrade the control plane only and keep worker node pools version unchanged, first specify the policy: + + $ gcloud beta container vmware clusters update CLUSTER \ + --upgrade-policy control-plane-only=True + + Then to start the upgrade operation using the specified policy, run: + + $ gcloud beta container vmware clusters upgrade CLUSTER \ + --version=VERSION + + After upgrading only the cluster control plane, to upgrade an individual node pool, run: + + $ gcloud beta container vmware node-pools update NODE_POOL \ + --version=VERSION + + Example: + + Alternatively, to upgrade both the control plane and all worker node pools, first specify the policy: + + $ gcloud beta container vmware clusters update CLUSTER \ + --upgrade-policy control-plane-only=False + + Then to start the upgrade operation using the specified policy, run: + + $ gcloud beta container vmware clusters upgrade CLUSTER \ + --version=VERSION + --validate-only If set, only validate the request, but do not actually perform the operation. diff --git a/gcloud/beta/dataproc/jobs/submit/flink b/gcloud/beta/dataproc/jobs/submit/flink index 50d753a5d..a70a9f87b 100644 --- a/gcloud/beta/dataproc/jobs/submit/flink +++ b/gcloud/beta/dataproc/jobs/submit/flink @@ -6,7 +6,9 @@ SYNOPSIS (--class=MAIN_CLASS | --jar=MAIN_JAR) (--cluster=CLUSTER | --cluster-labels=[KEY=VALUE,...]) [--async] [--bucket=BUCKET] [--driver-log-levels=[PACKAGE=LEVEL,...]] - [--jars=[JAR,...]] [--labels=[KEY=VALUE,...]] + [--driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB] + [--driver-required-vcores=DRIVER_REQUIRED_VCORES] [--jars=[JAR,...]] + [--labels=[KEY=VALUE,...]] [--max-failures-per-hour=MAX_FAILURES_PER_HOUR] [--max-failures-total=MAX_FAILURES_TOTAL] [--properties=[PROPERTY=VALUE,...]] [--properties-file=PROPERTIES_FILE] @@ -79,6 +81,16 @@ OPTIONAL FLAGS List of package to log4j log level pairs to configure driver logging. For example: root=FATAL,com.example=INFO. + --driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB + The memory allocation requested by the job driver in megabytes (MB) for + execution on the driver node group (it is used only by clusters with a + driver node group). + + --driver-required-vcores=DRIVER_REQUIRED_VCORES + The vCPU allocation requested by the job driver for execution on the + driver node group (it is used only by clusters with a driver node + group). + --jars=[JAR,...] Comma-separated list of jar files to provide to the task manager classpaths. diff --git a/gcloud/beta/dataproc/jobs/submit/hadoop b/gcloud/beta/dataproc/jobs/submit/hadoop index ccb07641e..501cd6ddf 100644 --- a/gcloud/beta/dataproc/jobs/submit/hadoop +++ b/gcloud/beta/dataproc/jobs/submit/hadoop @@ -6,7 +6,9 @@ SYNOPSIS (--class=MAIN_CLASS | --jar=MAIN_JAR) (--cluster=CLUSTER | --cluster-labels=[KEY=VALUE,...]) [--archives=[ARCHIVE,...]] [--async] [--bucket=BUCKET] - [--driver-log-levels=[PACKAGE=LEVEL,...]] [--files=[FILE,...]] + [--driver-log-levels=[PACKAGE=LEVEL,...]] + [--driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB] + [--driver-required-vcores=DRIVER_REQUIRED_VCORES] [--files=[FILE,...]] [--jars=[JAR,...]] [--labels=[KEY=VALUE,...]] [--max-failures-per-hour=MAX_FAILURES_PER_HOUR] [--max-failures-total=MAX_FAILURES_TOTAL] @@ -83,6 +85,16 @@ OPTIONAL FLAGS A list of package to log4j log level pairs to configure driver logging. For example: root=FATAL,com.example=INFO + --driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB + The memory allocation requested by the job driver in megabytes (MB) for + execution on the driver node group (it is used only by clusters with a + driver node group). + + --driver-required-vcores=DRIVER_REQUIRED_VCORES + The vCPU allocation requested by the job driver for execution on the + driver node group (it is used only by clusters with a driver node + group). + --files=[FILE,...] Comma separated list of file paths to be provided to the job. A file path can either be a path to a local file or a path to a file already diff --git a/gcloud/beta/dataproc/jobs/submit/hive b/gcloud/beta/dataproc/jobs/submit/hive index 38dafcc89..c6dae4eb1 100644 --- a/gcloud/beta/dataproc/jobs/submit/hive +++ b/gcloud/beta/dataproc/jobs/submit/hive @@ -5,7 +5,9 @@ SYNOPSIS gcloud beta dataproc jobs submit hive (--cluster=CLUSTER | --cluster-labels=[KEY=VALUE,...]) (--execute=QUERY, -e QUERY | --file=FILE, -f FILE) [--async] - [--bucket=BUCKET] [--continue-on-failure] [--jars=[JAR,...]] + [--bucket=BUCKET] [--continue-on-failure] + [--driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB] + [--driver-required-vcores=DRIVER_REQUIRED_VCORES] [--jars=[JAR,...]] [--labels=[KEY=VALUE,...]] [--max-failures-per-hour=MAX_FAILURES_PER_HOUR] [--max-failures-total=MAX_FAILURES_TOTAL] [--params=[PARAM=VALUE,...]] @@ -63,6 +65,16 @@ OPTIONAL FLAGS --continue-on-failure Whether to continue if a single query fails. + --driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB + The memory allocation requested by the job driver in megabytes (MB) for + execution on the driver node group (it is used only by clusters with a + driver node group). + + --driver-required-vcores=DRIVER_REQUIRED_VCORES + The vCPU allocation requested by the job driver for execution on the + driver node group (it is used only by clusters with a driver node + group). + --jars=[JAR,...] Comma separated list of jar files to be provided to the Hive and MR. May contain UDFs. diff --git a/gcloud/beta/dataproc/jobs/submit/pig b/gcloud/beta/dataproc/jobs/submit/pig index 71166b867..20ba67383 100644 --- a/gcloud/beta/dataproc/jobs/submit/pig +++ b/gcloud/beta/dataproc/jobs/submit/pig @@ -6,7 +6,9 @@ SYNOPSIS (--cluster=CLUSTER | --cluster-labels=[KEY=VALUE,...]) (--execute=QUERY, -e QUERY | --file=FILE, -f FILE) [--async] [--bucket=BUCKET] [--continue-on-failure] - [--driver-log-levels=[PACKAGE=LEVEL,...]] [--jars=[JAR,...]] + [--driver-log-levels=[PACKAGE=LEVEL,...]] + [--driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB] + [--driver-required-vcores=DRIVER_REQUIRED_VCORES] [--jars=[JAR,...]] [--labels=[KEY=VALUE,...]] [--max-failures-per-hour=MAX_FAILURES_PER_HOUR] [--max-failures-total=MAX_FAILURES_TOTAL] [--params=[PARAM=VALUE,...]] @@ -71,6 +73,16 @@ OPTIONAL FLAGS A list of package to log4j log level pairs to configure driver logging. For example: root=FATAL,com.example=INFO + --driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB + The memory allocation requested by the job driver in megabytes (MB) for + execution on the driver node group (it is used only by clusters with a + driver node group). + + --driver-required-vcores=DRIVER_REQUIRED_VCORES + The vCPU allocation requested by the job driver for execution on the + driver node group (it is used only by clusters with a driver node + group). + --jars=[JAR,...] Comma separated list of jar files to be provided to Pig and MR. May contain UDFs. diff --git a/gcloud/beta/dataproc/jobs/submit/presto b/gcloud/beta/dataproc/jobs/submit/presto index 0d5b42e8d..244779300 100644 --- a/gcloud/beta/dataproc/jobs/submit/presto +++ b/gcloud/beta/dataproc/jobs/submit/presto @@ -7,6 +7,8 @@ SYNOPSIS (--execute=QUERY, -e QUERY | --file=FILE, -f FILE) [--async] [--bucket=BUCKET] [--client-tags=[CLIENT_TAG,...]] [--continue-on-failure] [--driver-log-levels=[PACKAGE=LEVEL,...]] + [--driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB] + [--driver-required-vcores=DRIVER_REQUIRED_VCORES] [--labels=[KEY=VALUE,...]] [--max-failures-per-hour=MAX_FAILURES_PER_HOUR] [--max-failures-total=MAX_FAILURES_TOTAL] @@ -71,6 +73,16 @@ OPTIONAL FLAGS A list of package-to-log4j log level pairs to configure driver logging. For example: root=FATAL,com.example=INFO + --driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB + The memory allocation requested by the job driver in megabytes (MB) for + execution on the driver node group (it is used only by clusters with a + driver node group). + + --driver-required-vcores=DRIVER_REQUIRED_VCORES + The vCPU allocation requested by the job driver for execution on the + driver node group (it is used only by clusters with a driver node + group). + --labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to add. diff --git a/gcloud/beta/dataproc/jobs/submit/pyspark b/gcloud/beta/dataproc/jobs/submit/pyspark index 50fd4c44e..caa4a6d62 100644 --- a/gcloud/beta/dataproc/jobs/submit/pyspark +++ b/gcloud/beta/dataproc/jobs/submit/pyspark @@ -6,7 +6,9 @@ SYNOPSIS gcloud beta dataproc jobs submit pyspark PY_FILE (--cluster=CLUSTER | --cluster-labels=[KEY=VALUE,...]) [--archives=[ARCHIVE,...]] [--async] [--bucket=BUCKET] - [--driver-log-levels=[PACKAGE=LEVEL,...]] [--files=[FILE,...]] + [--driver-log-levels=[PACKAGE=LEVEL,...]] + [--driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB] + [--driver-required-vcores=DRIVER_REQUIRED_VCORES] [--files=[FILE,...]] [--jars=[JAR,...]] [--labels=[KEY=VALUE,...]] [--max-failures-per-hour=MAX_FAILURES_PER_HOUR] [--max-failures-total=MAX_FAILURES_TOTAL] @@ -74,6 +76,16 @@ OPTIONAL FLAGS package and value is the log4j log level. For example: root=FATAL,com.example=INFO + --driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB + The memory allocation requested by the job driver in megabytes (MB) for + execution on the driver node group (it is used only by clusters with a + driver node group). + + --driver-required-vcores=DRIVER_REQUIRED_VCORES + The vCPU allocation requested by the job driver for execution on the + driver node group (it is used only by clusters with a driver node + group). + --files=[FILE,...] Comma separated list of files to be placed in the working directory of both the app master and executors. diff --git a/gcloud/beta/dataproc/jobs/submit/spark b/gcloud/beta/dataproc/jobs/submit/spark index 9c3e8c010..2e434757e 100644 --- a/gcloud/beta/dataproc/jobs/submit/spark +++ b/gcloud/beta/dataproc/jobs/submit/spark @@ -6,7 +6,9 @@ SYNOPSIS (--class=MAIN_CLASS | --jar=MAIN_JAR) (--cluster=CLUSTER | --cluster-labels=[KEY=VALUE,...]) [--archives=[ARCHIVE,...]] [--async] [--bucket=BUCKET] - [--driver-log-levels=[PACKAGE=LEVEL,...]] [--files=[FILE,...]] + [--driver-log-levels=[PACKAGE=LEVEL,...]] + [--driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB] + [--driver-required-vcores=DRIVER_REQUIRED_VCORES] [--files=[FILE,...]] [--jars=[JAR,...]] [--labels=[KEY=VALUE,...]] [--max-failures-per-hour=MAX_FAILURES_PER_HOUR] [--max-failures-total=MAX_FAILURES_TOTAL] @@ -85,6 +87,16 @@ OPTIONAL FLAGS List of package to log4j log level pairs to configure driver logging. For example: root=FATAL,com.example=INFO + --driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB + The memory allocation requested by the job driver in megabytes (MB) for + execution on the driver node group (it is used only by clusters with a + driver node group). + + --driver-required-vcores=DRIVER_REQUIRED_VCORES + The vCPU allocation requested by the job driver for execution on the + driver node group (it is used only by clusters with a driver node + group). + --files=[FILE,...] Comma separated list of files to be placed in the working directory of both the app master and executors. diff --git a/gcloud/beta/dataproc/jobs/submit/spark-r b/gcloud/beta/dataproc/jobs/submit/spark-r index 5e1edcec5..79b0bd7e7 100644 --- a/gcloud/beta/dataproc/jobs/submit/spark-r +++ b/gcloud/beta/dataproc/jobs/submit/spark-r @@ -5,7 +5,9 @@ SYNOPSIS gcloud beta dataproc jobs submit spark-r R_FILE (--cluster=CLUSTER | --cluster-labels=[KEY=VALUE,...]) [--archives=[ARCHIVE,...]] [--async] [--bucket=BUCKET] - [--driver-log-levels=[PACKAGE=LEVEL,...]] [--files=[FILE,...]] + [--driver-log-levels=[PACKAGE=LEVEL,...]] + [--driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB] + [--driver-required-vcores=DRIVER_REQUIRED_VCORES] [--files=[FILE,...]] [--labels=[KEY=VALUE,...]] [--max-failures-per-hour=MAX_FAILURES_PER_HOUR] [--max-failures-total=MAX_FAILURES_TOTAL] @@ -71,6 +73,16 @@ OPTIONAL FLAGS package and value is the log4j log level. For example: root=FATAL,com.example=INFO + --driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB + The memory allocation requested by the job driver in megabytes (MB) for + execution on the driver node group (it is used only by clusters with a + driver node group). + + --driver-required-vcores=DRIVER_REQUIRED_VCORES + The vCPU allocation requested by the job driver for execution on the + driver node group (it is used only by clusters with a driver node + group). + --files=[FILE,...] Comma separated list of files to be placed in the working directory of both the app master and executors. diff --git a/gcloud/beta/dataproc/jobs/submit/spark-sql b/gcloud/beta/dataproc/jobs/submit/spark-sql index c393bd14b..4009a32e0 100644 --- a/gcloud/beta/dataproc/jobs/submit/spark-sql +++ b/gcloud/beta/dataproc/jobs/submit/spark-sql @@ -7,7 +7,9 @@ SYNOPSIS (--cluster=CLUSTER | --cluster-labels=[KEY=VALUE,...]) (--execute=QUERY, -e QUERY | --file=FILE, -f FILE) [--async] [--bucket=BUCKET] [--driver-log-levels=[PACKAGE=LEVEL,...]] - [--jars=[JAR,...]] [--labels=[KEY=VALUE,...]] + [--driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB] + [--driver-required-vcores=DRIVER_REQUIRED_VCORES] [--jars=[JAR,...]] + [--labels=[KEY=VALUE,...]] [--max-failures-per-hour=MAX_FAILURES_PER_HOUR] [--max-failures-total=MAX_FAILURES_TOTAL] [--params=[PARAM=VALUE,...]] [--properties=[PROPERTY=VALUE,...]] [--properties-file=PROPERTIES_FILE] @@ -65,6 +67,16 @@ OPTIONAL FLAGS A list of package to log4j log level pairs to configure driver logging. For example: root=FATAL,com.example=INFO + --driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB + The memory allocation requested by the job driver in megabytes (MB) for + execution on the driver node group (it is used only by clusters with a + driver node group). + + --driver-required-vcores=DRIVER_REQUIRED_VCORES + The vCPU allocation requested by the job driver for execution on the + driver node group (it is used only by clusters with a driver node + group). + --jars=[JAR,...] Comma separated list of jar files to be provided to the executor and driver classpaths. May contain UDFs. diff --git a/gcloud/beta/dataproc/jobs/submit/trino b/gcloud/beta/dataproc/jobs/submit/trino index 05ade9b81..c33188c21 100644 --- a/gcloud/beta/dataproc/jobs/submit/trino +++ b/gcloud/beta/dataproc/jobs/submit/trino @@ -7,6 +7,8 @@ SYNOPSIS (--execute=QUERY, -e QUERY | --file=FILE, -f FILE) [--async] [--bucket=BUCKET] [--client-tags=[CLIENT_TAG,...]] [--continue-on-failure] [--driver-log-levels=[PACKAGE=LEVEL,...]] + [--driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB] + [--driver-required-vcores=DRIVER_REQUIRED_VCORES] [--labels=[KEY=VALUE,...]] [--max-failures-per-hour=MAX_FAILURES_PER_HOUR] [--max-failures-total=MAX_FAILURES_TOTAL] @@ -71,6 +73,16 @@ OPTIONAL FLAGS A list of package-to-log4j log level pairs to configure driver logging. For example: root=FATAL,com.example=INFO + --driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB + The memory allocation requested by the job driver in megabytes (MB) for + execution on the driver node group (it is used only by clusters with a + driver node group). + + --driver-required-vcores=DRIVER_REQUIRED_VCORES + The vCPU allocation requested by the job driver for execution on the + driver node group (it is used only by clusters with a driver node + group). + --labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to add. diff --git a/gcloud/beta/domains/registrations/configure/contacts b/gcloud/beta/domains/registrations/configure/contacts index c0fcd81e2..9e74ded1e 100644 --- a/gcloud/beta/domains/registrations/configure/contacts +++ b/gcloud/beta/domains/registrations/configure/contacts @@ -136,10 +136,12 @@ COMMONLY USED FLAGS domain. CONTACT_PRIVACY must be one of: private-contact-data - Your contact info won't be available to the public. To help protect - your info and prevent spam, a third party provides alternate - (proxy) contact info for your domain in the public directory at no - extra cost. They will forward received messages to you. + (DEPRECATED) Your contact info won't be available to the public. To + help protect your info and prevent spam, a third party provides + alternate (proxy) contact info for your domain in the public + directory at no extra cost. They will forward received messages to + you. The private-contact-data option is deprecated; See + https://cloud.google.com/domains/docs/deprecations/feature-deprecations. public-contact-data All the data from contact config is publicly available. To set this value, you must also pass the --notices flag with value diff --git a/gcloud/beta/domains/registrations/configure/dns b/gcloud/beta/domains/registrations/configure/dns index afd727003..f527d06ec 100644 --- a/gcloud/beta/domains/registrations/configure/dns +++ b/gcloud/beta/domains/registrations/configure/dns @@ -129,9 +129,12 @@ COMMONLY USED FLAGS List of DNS name servers for the domain. --use-google-domains-dns - Use free name servers provided by Google Domains. If the zone is - signed, DNSSEC will be enabled by default unless you pass - --disable-dnssec. + (DEPRECATED) Use free name servers provided by Google Domains. If + the zone is signed, DNSSEC will be enabled by default unless you + pass --disable-dnssec. + + The --use-google-domains-dns option is deprecated; See + https://cloud.google.com/domains/docs/deprecations/feature-deprecations. OTHER FLAGS --async diff --git a/gcloud/beta/domains/registrations/export b/gcloud/beta/domains/registrations/export index 62ae531cc..6a3e3aa64 100644 --- a/gcloud/beta/domains/registrations/export +++ b/gcloud/beta/domains/registrations/export @@ -7,7 +7,12 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Export the domain to direct management by Google Domains. The domain + (BETA) (DEPRECATED) Export a Cloud Domains registration. + + This command is deprecated. See + https://cloud.google.com/domains/docs/deprecations/feature-deprecations. + + Export the domain to direct management by Google Domains. The domain remains valid until expiry. After you export a registered domain, the auto-renewal will be disabled, diff --git a/gcloud/beta/domains/registrations/help b/gcloud/beta/domains/registrations/help index 7d5536d36..ff6058aa7 100644 --- a/gcloud/beta/domains/registrations/help +++ b/gcloud/beta/domains/registrations/help @@ -35,7 +35,7 @@ COMMANDS (BETA) Describe an existing Cloud Domains registration. export - (BETA) Export a Cloud Domains registration. + (BETA) (DEPRECATED) Export a Cloud Domains registration. get-register-parameters (BETA) Get register parameters (including availability) of a specific @@ -45,7 +45,8 @@ COMMANDS (BETA) Get transfer parameters of a specific domain. import - (BETA) Import a domain from Google Domains registrar to Cloud Domains. + (BETA) (DEPRECATED) Import a domain from Google Domains registrar to + Cloud Domains. list (BETA) List Cloud Domains registrations. @@ -60,7 +61,7 @@ COMMANDS (BETA) Search for available domains. transfer - (BETA) Transfer a domain from another registrar. + (BETA) (DEPRECATED) Transfer a domain from another registrar. update (BETA) Update a Cloud Domains registration. diff --git a/gcloud/beta/domains/registrations/import b/gcloud/beta/domains/registrations/import index b3602c589..db16b6eda 100644 --- a/gcloud/beta/domains/registrations/import +++ b/gcloud/beta/domains/registrations/import @@ -7,9 +7,15 @@ SYNOPSIS [--labels=[KEY=VALUE,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Create a new Cloud Domains registration resource by importing an - existing domain from Google Domains registrar. The new resource's ID will - be equal to the domain name. + (BETA) (DEPRECATED) Import a domain from Google Domains registrar to Cloud + Domains. + + This command is deprecated. See + https://cloud.google.com/domains/docs/deprecations/feature-deprecations. + + Create a new Cloud Domains registration resource by importing an existing + domain from Google Domains registrar. The new resource's ID will be equal + to the domain name. After this command executes, a resource is created with state ACTIVE, indicating that the import was successful. Cloud Domains will automatically diff --git a/gcloud/beta/domains/registrations/register b/gcloud/beta/domains/registrations/register index 5c2bf3d21..81bab5d45 100644 --- a/gcloud/beta/domains/registrations/register +++ b/gcloud/beta/domains/registrations/register @@ -137,10 +137,12 @@ COMMONLY USED FLAGS domain. CONTACT_PRIVACY must be one of: private-contact-data - Your contact info won't be available to the public. To help protect - your info and prevent spam, a third party provides alternate - (proxy) contact info for your domain in the public directory at no - extra cost. They will forward received messages to you. + (DEPRECATED) Your contact info won't be available to the public. To + help protect your info and prevent spam, a third party provides + alternate (proxy) contact info for your domain in the public + directory at no extra cost. They will forward received messages to + you. The private-contact-data option is deprecated; See + https://cloud.google.com/domains/docs/deprecations/feature-deprecations. public-contact-data All the data from contact config is publicly available. To set this value, you must also pass the --notices flag with value @@ -170,10 +172,13 @@ COMMONLY USED FLAGS List of DNS name servers for the domain. --use-google-domains-dns - Use free name servers provided by Google Domains. If the zone is - signed, DNSSEC will be enabled by default unless you pass + (DEPRECATED) Use free name servers provided by Google Domains. If the + zone is signed, DNSSEC will be enabled by default unless you pass --disable-dnssec. + The --use-google-domains-dns option is deprecated; See + https://cloud.google.com/domains/docs/deprecations/feature-deprecations. + OTHER FLAGS --async Return immediately, without waiting for the operation in progress to diff --git a/gcloud/beta/domains/registrations/transfer b/gcloud/beta/domains/registrations/transfer index d2df5f457..a5335af18 100644 --- a/gcloud/beta/domains/registrations/transfer +++ b/gcloud/beta/domains/registrations/transfer @@ -13,7 +13,12 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Create a new Cloud Domains registration resource by transferring an + (BETA) (DEPRECATED) Transfer a domain from another registrar. + + This command is deprecated. See + https://cloud.google.com/domains/docs/deprecations/feature-deprecations. + + Create a new Cloud Domains registration resource by transferring an existing domain from another registrar. The new resource's ID will be equal to the domain name. @@ -142,10 +147,12 @@ COMMONLY USED FLAGS domain. CONTACT_PRIVACY must be one of: private-contact-data - Your contact info won't be available to the public. To help protect - your info and prevent spam, a third party provides alternate - (proxy) contact info for your domain in the public directory at no - extra cost. They will forward received messages to you. + (DEPRECATED) Your contact info won't be available to the public. To + help protect your info and prevent spam, a third party provides + alternate (proxy) contact info for your domain in the public + directory at no extra cost. They will forward received messages to + you. The private-contact-data option is deprecated; See + https://cloud.google.com/domains/docs/deprecations/feature-deprecations. public-contact-data All the data from contact config is publicly available. To set this value, you must also pass the --notices flag with value @@ -192,10 +199,13 @@ COMMONLY USED FLAGS case for DNS services provided for free by the registrar. --use-google-domains-dns - Use free name servers provided by Google Domains. This blank-slate - option cannot be configured before transfer. DNSSEC will be - disabled and will need to be enabled after the transfer completes, - if desired. + (DEPRECATED) Use free name servers provided by Google Domains. This + blank-slate option cannot be configured before transfer. DNSSEC + will be disabled and will need to be enabled after the transfer + completes, if desired. + + The --use-google-domains-dns option is deprecated; See + https://cloud.google.com/domains/docs/deprecations/feature-deprecations. OTHER FLAGS --async diff --git a/gcloud/beta/firebase/test/android/run b/gcloud/beta/firebase/test/android/run index 17dfcef35..9d1d79b85 100644 --- a/gcloud/beta/firebase/test/android/run +++ b/gcloud/beta/firebase/test/android/run @@ -379,8 +379,8 @@ FLAGS The number of shards specified must always be a positive number that is no greater than the total number of test cases. When you select one or more physical devices, the number of shards specified must be - <= 50. When you select one or more ARM virtual devices, the number of - shards specified must be <= 100. When you select only x86 virtual + <= 50. When you select one or more Arm virtual devices, the number of + shards specified must be <= 200. When you select only x86 virtual devices, the number of shards specified must be <= 500. --test-targets-for-shard=TEST_TARGETS_FOR_SHARD @@ -388,8 +388,8 @@ FLAGS each shard (a group of test cases). Each time this flag is repeated, it creates a new shard. The shards are run in parallel on separate devices. You can repeat this flag up to 50 times when you select one - or more physical devices, up to 100 times when you select one or more - ARM virtual devices, and up to 500 times when you select only x86 + or more physical devices, up to 200 times when you select one or more + Arm virtual devices, and up to 500 times when you select only x86 virtual devices. Note: If you include the flags --environment-variable or diff --git a/gcloud/beta/iam/service-accounts/delete b/gcloud/beta/iam/service-accounts/delete index 255384050..0bea1e74c 100644 --- a/gcloud/beta/iam/service-accounts/delete +++ b/gcloud/beta/iam/service-accounts/delete @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud beta iam service-accounts delete SERVICE_ACCOUNT - [GCLOUD_WIDE_FLAG ...] + [--recommend=BOOLEAN_VALUE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) If the service account does not exist, this command returns a @@ -22,6 +22,13 @@ POSITIONAL ARGUMENTS as a numeric service account ID or as an email, like this: 123456789876543212345 or my-iam-account@somedomain.com. +FLAGS + --recommend=BOOLEAN_VALUE + If true, checks Active Assist recommendation for the risk level of + service account deletion, and issues a warning in the prompt. Optional + flag is set to false by default. For details see + https://cloud.google.com/recommender/docs/change-risk-recommendations + 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/iam/workload-identity-pools/create-cred-config b/gcloud/beta/iam/workload-identity-pools/create-cred-config index 7b877c983..26b645d03 100644 --- a/gcloud/beta/iam/workload-identity-pools/create-cred-config +++ b/gcloud/beta/iam/workload-identity-pools/create-cred-config @@ -75,7 +75,7 @@ EXAMPLES POSITIONAL ARGUMENTS AUDIENCE - The workload identity pool provider resource name. + The workload identity pool provider resource ID. REQUIRED FLAGS --output-file=OUTPUT_FILE diff --git a/gcloud/beta/netapp/backup-policies/create b/gcloud/beta/netapp/backup-policies/create new file mode 100644 index 000000000..c7c289e21 --- /dev/null +++ b/gcloud/beta/netapp/backup-policies/create @@ -0,0 +1,106 @@ +NAME + gcloud beta netapp backup-policies create - create a Cloud NetApp Backup + Policy + +SYNOPSIS + gcloud beta netapp backup-policies create + (BACKUP_POLICY : --location=LOCATION) [--async] + [--description=DESCRIPTION] [--enabled=ENABLED] + [--labels=[KEY=VALUE,...]] + [--daily-backup-limit=DAILY_BACKUP_LIMIT + --monthly-backup-limit=MONTHLY_BACKUP_LIMIT + --weekly-backup-limit=WEEKLY_BACKUP_LIMIT] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Creates a Backup Policy for Cloud NetApp Volumes. + +EXAMPLES + The following command creates a Backup Policy named BACKUP_POLICY with all + possible arguments: + + $ gcloud beta netapp backup-policies create BACKUP_POLICY \ + --location=us-central1 --enabled=true --daily-backup-limit=3 \ + --weekly-backup-limit=5 --monthly-backup-limit=2 \ + --description="first backup policy" --labels=key1=val1 + +POSITIONAL ARGUMENTS + Backup policy resource - The Backup Policy to create The arguments in this + group can be used to specify the attributes of this resource. (NOTE) Some + attributes are not given arguments in this group but can be set in other + ways. + + To set the project attribute: + ◆ provide the argument backup_policy on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + BACKUP_POLICY + ID of the backup_policy or fully qualified identifier for the + backup_policy. + + To set the backup_policy attribute: + ▸ provide the argument backup_policy on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the backup_policy. + + To set the location attribute: + ▸ provide the argument backup_policy on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location; + ▸ set the property netapp/region. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + A description of the Cloud NetApp Backup Policy + + --enabled=ENABLED + The Boolean value indiciating whether backups are made automatically + according to the schedules. If enabled, this will be applied to all + volumes that have this backup policy attached and enforced on the + volume level. If not specified, the default is true. + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + Add backup limit arguments. + + --daily-backup-limit=DAILY_BACKUP_LIMIT + Maximum number of daily backups to keep. Note that the minimum daily + backup limit is 2. + + --monthly-backup-limit=MONTHLY_BACKUP_LIMIT + Number of monthly backups to keep. Note that the sum of daily, weekly + and monthly backups should be greater than 1 + + --weekly-backup-limit=WEEKLY_BACKUP_LIMIT + Number of weekly backups to keep. Note that the sum of daily, weekly + and monthly backups should be greater than 1 + +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. + diff --git a/gcloud/beta/netapp/backup-policies/delete b/gcloud/beta/netapp/backup-policies/delete new file mode 100644 index 000000000..21e6affe0 --- /dev/null +++ b/gcloud/beta/netapp/backup-policies/delete @@ -0,0 +1,72 @@ +NAME + gcloud beta netapp backup-policies delete - delete a Cloud NetApp Volumes + Backup Policy + +SYNOPSIS + gcloud beta netapp backup-policies delete + (BACKUP_POLICY : --location=LOCATION) [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Delete a Backup Policy + +EXAMPLES + The following command deletes a Backup Policy instance named BACKUP_POLICY + in the default netapp/location + + $ gcloud beta netapp backup-policies delete BACKUP_POLICY + + To delete a Backup Policy named BACKUP_POLICY asynchronously, run the + following command: + + $ gcloud beta netapp backup-policies delete BACKUP_POLICY --async + +POSITIONAL ARGUMENTS + Backup policy resource - The Backup Policy 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 backup_policy on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + BACKUP_POLICY + ID of the backup_policy or fully qualified identifier for the + backup_policy. + + To set the backup_policy attribute: + ▸ provide the argument backup_policy on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the backup_policy. + + To set the location attribute: + ▸ provide the argument backup_policy on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location; + ▸ set the property netapp/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 command is currently in beta and might change without notice. + diff --git a/gcloud/beta/netapp/backup-policies/describe b/gcloud/beta/netapp/backup-policies/describe new file mode 100644 index 000000000..aa9fcbf42 --- /dev/null +++ b/gcloud/beta/netapp/backup-policies/describe @@ -0,0 +1,68 @@ +NAME + gcloud beta netapp backup-policies describe - show metadata for a Cloud + NetApp Volumes Backup Policy + +SYNOPSIS + gcloud beta netapp backup-policies describe + (BACKUP_POLICY : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Describe a Backup Policy + +EXAMPLES + The following command gets metadata using describe for a Backup Policy + named BACKUP_POLICY in the default netapp/location: + + $ gcloud beta netapp backup-policies describe BACKUP_POLICY + + To get metadata on a Backup Policy named BACKUP_POLICY in a specified + location, run: + + $ gcloud beta netapp backup-policies describe BACKUP_POLICY \ + --location=us-central1 + +POSITIONAL ARGUMENTS + Backup policy resource - The Backup Policy 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 backup_policy on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + BACKUP_POLICY + ID of the backup_policy or fully qualified identifier for the + backup_policy. + + To set the backup_policy attribute: + ▸ provide the argument backup_policy on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the backup_policy. + + To set the location attribute: + ▸ provide the argument backup_policy on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location; + ▸ set the property netapp/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 command is currently in beta and might change without notice. + diff --git a/gcloud/beta/netapp/backup-policies/help b/gcloud/beta/netapp/backup-policies/help new file mode 100644 index 000000000..fc0a67669 --- /dev/null +++ b/gcloud/beta/netapp/backup-policies/help @@ -0,0 +1,36 @@ +NAME + gcloud beta netapp backup-policies - create and manage Cloud NetApp Backup + Policies + +SYNOPSIS + gcloud beta netapp backup-policies COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Create and manage Cloud NetApp Backup Policies. + +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 Cloud NetApp Backup Policy. + + delete + (BETA) Delete a Cloud NetApp Volumes Backup Policy. + + describe + (BETA) Show metadata for a Cloud NetApp Volumes Backup Policy. + + list + (BETA) List Cloud NetApp Volumes Backup Policies. + + update + (BETA) Update a Cloud NetApp Volumes Backup Policies. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/netapp/backup-policies/list b/gcloud/beta/netapp/backup-policies/list new file mode 100644 index 000000000..59c4f7aa2 --- /dev/null +++ b/gcloud/beta/netapp/backup-policies/list @@ -0,0 +1,88 @@ +NAME + gcloud beta netapp backup-policies list - list Cloud NetApp Volumes Backup + Policies + +SYNOPSIS + gcloud beta netapp backup-policies list [--location=LOCATION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Lists Backup Policies for Cloud NetApp Volumes + +EXAMPLES + The following command lists all Backup Policies in the default + netapp/location + + $ gcloud beta netapp backup-policies list + + To list all Backup Policies in a specified location, run: + + $ gcloud beta netapp backup-policies list --location=us-central1 + +FLAGS + Location resource - The location in which to list Backup Policies. 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; + ◆ uses all locations by default. with a fully specified name; + ◆ set the property netapp/location with a fully specified name; + ◆ set the property netapp/region with a fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --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; + ▸ uses all locations by default.; + ▸ set the property netapp/location; + ▸ set the property netapp/region. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/netapp/backup-policies/update b/gcloud/beta/netapp/backup-policies/update new file mode 100644 index 000000000..719d3638b --- /dev/null +++ b/gcloud/beta/netapp/backup-policies/update @@ -0,0 +1,134 @@ +NAME + gcloud beta netapp backup-policies update - update a Cloud NetApp Volumes + Backup Policies + +SYNOPSIS + gcloud beta netapp backup-policies update + (BACKUP_POLICY : --location=LOCATION) [--async] + [--description=DESCRIPTION] [--enabled=ENABLED] + [--update-labels=[KEY=VALUE,...]] + [--clear-labels | --remove-labels=[KEY,...]] + [--daily-backup-limit=DAILY_BACKUP_LIMIT + --monthly-backup-limit=MONTHLY_BACKUP_LIMIT + --weekly-backup-limit=WEEKLY_BACKUP_LIMIT] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Updates a Backup Policy + +EXAMPLES + The following command updates a Backup Policy named BACKUP_POLICY with all + possible arguments + + $ gcloud beta netapp backup-policies update BACKUP_POLICY \ + --location=us-central1 --enabled=True --daily-backup-limit=5 \ + --weekly-backup-limit=3 --monthly-backup-limit=2 + + To update a Backup Policy named BACKUP_POLICY asynchronously, run the + following command: + + $ gcloud beta netapp backup-policies update BACKUP_POLICY --async \ + --location=us-central1 --enabled=True --daily-backup-limit=5 \ + --weekly-backup-limit=3 --monthly-backup-limit=2 + +POSITIONAL ARGUMENTS + Backup policy resource - The Backup Policy 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 backup_policy on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + BACKUP_POLICY + ID of the backup_policy or fully qualified identifier for the + backup_policy. + + To set the backup_policy attribute: + ▸ provide the argument backup_policy on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the backup_policy. + + To set the location attribute: + ▸ provide the argument backup_policy on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location; + ▸ set the property netapp/region. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + A description of the Cloud NetApp Backup Policy + + --enabled=ENABLED + The Boolean value indiciating whether backups are made automatically + according to the schedules. If enabled, this will be applied to all + volumes that have this backup policy attached and enforced on the + volume level. If not specified, the default is true. + + --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. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + At most one of these can be specified: + + --clear-labels + Remove all labels. If --update-labels is also specified then + --clear-labels is applied first. + + For example, to remove all labels: + + $ gcloud beta netapp backup-policies update --clear-labels + + To remove all existing labels and create two new labels, foo and baz: + + $ gcloud beta netapp backup-policies update --clear-labels \ + --update-labels foo=bar,baz=qux + + --remove-labels=[KEY,...] + List of label keys to remove. If a label does not exist it is + silently ignored. If --update-labels is also specified then + --update-labels is applied first. + + Add backup limit arguments. + + --daily-backup-limit=DAILY_BACKUP_LIMIT + Maximum number of daily backups to keep. Note that the minimum daily + backup limit is 2. + + --monthly-backup-limit=MONTHLY_BACKUP_LIMIT + Number of monthly backups to keep. Note that the sum of daily, weekly + and monthly backups should be greater than 1 + + --weekly-backup-limit=WEEKLY_BACKUP_LIMIT + Number of weekly backups to keep. Note that the sum of daily, weekly + and monthly backups should be greater than 1 + +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. + diff --git a/gcloud/beta/netapp/backup-vaults/create b/gcloud/beta/netapp/backup-vaults/create new file mode 100644 index 000000000..93f7bbf01 --- /dev/null +++ b/gcloud/beta/netapp/backup-vaults/create @@ -0,0 +1,81 @@ +NAME + gcloud beta netapp backup-vaults create - create a Cloud NetApp Backup + Vault + +SYNOPSIS + gcloud beta netapp backup-vaults create + (BACKUP_VAULT : --location=LOCATION) [--async] + [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Create a Cloud NetApp Backup Vault. + +EXAMPLES + The following command creates a Backup Vault named BACKUP_VAULT + asynchronously using the specified arguments: + + $ gcloud beta netapp backup-vaults create BACKUP_VAULT \ + --location=LOCATION --async --description="test" + +POSITIONAL ARGUMENTS + Backup vault resource - The Backup Vault to create The arguments in this + group can be used to specify the attributes of this resource. (NOTE) Some + attributes are not given arguments in this group but can be set in other + ways. + + To set the project attribute: + ◆ provide the argument backup_vault on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + BACKUP_VAULT + ID of the backup_vault or fully qualified identifier for the + backup_vault. + + To set the backup_vault attribute: + ▸ provide the argument backup_vault on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the backup_vault. + + To set the location attribute: + ▸ provide the argument backup_vault on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location; + ▸ set the property netapp/region. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + A description of the Cloud NetApp Backup Vault + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + +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. + diff --git a/gcloud/beta/netapp/backup-vaults/delete b/gcloud/beta/netapp/backup-vaults/delete new file mode 100644 index 000000000..df391bc6f --- /dev/null +++ b/gcloud/beta/netapp/backup-vaults/delete @@ -0,0 +1,72 @@ +NAME + gcloud beta netapp backup-vaults delete - delete a Cloud NetApp Volumes + Backup Vault + +SYNOPSIS + gcloud beta netapp backup-vaults delete + (BACKUP_VAULT : --location=LOCATION) [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Delete a Backup Vault. + +EXAMPLES + The following command deletes a Backup Vault instance named BACKUP_VAULT in + the default netapp/location: + + $ gcloud beta netapp backup-vaults delete BACKUP_VAULT + + To delete a Backup Vault named BACKUP_VAULT asynchronously, run the + following command: + + $ gcloud beta netapp backup-vaults delete BACKUP_VAULT --async + +POSITIONAL ARGUMENTS + Backup vault resource - The Backup Vault 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 backup_vault on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + BACKUP_VAULT + ID of the backup_vault or fully qualified identifier for the + backup_vault. + + To set the backup_vault attribute: + ▸ provide the argument backup_vault on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the backup_vault. + + To set the location attribute: + ▸ provide the argument backup_vault on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location; + ▸ set the property netapp/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 command is currently in beta and might change without notice. + diff --git a/gcloud/beta/netapp/backup-vaults/describe b/gcloud/beta/netapp/backup-vaults/describe new file mode 100644 index 000000000..8f8b644b7 --- /dev/null +++ b/gcloud/beta/netapp/backup-vaults/describe @@ -0,0 +1,68 @@ +NAME + gcloud beta netapp backup-vaults describe - show metadata for a Cloud + NetApp Volumes Backup Vault + +SYNOPSIS + gcloud beta netapp backup-vaults describe + (BACKUP_VAULT : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Describe a Backup Vault. + +EXAMPLES + The following command gets metadata using describe for a Backup Vault + instance named BACKUP_VAULT in the default netapp/location: + + $ gcloud beta netapp backup-vaults describe BACKUP_VAULT + + To get metadata on a Backup Vault named BACKUP_VAULT in a specified + location, run: + + $ gcloud beta netapp backup-vaults describe BACKUP_VAULT \ + --location=us-central1 + +POSITIONAL ARGUMENTS + Backup vault resource - The Backup Vault 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 backup_vault on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + BACKUP_VAULT + ID of the backup_vault or fully qualified identifier for the + backup_vault. + + To set the backup_vault attribute: + ▸ provide the argument backup_vault on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the backup_vault. + + To set the location attribute: + ▸ provide the argument backup_vault on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location; + ▸ set the property netapp/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 command is currently in beta and might change without notice. + diff --git a/gcloud/beta/netapp/backup-vaults/help b/gcloud/beta/netapp/backup-vaults/help new file mode 100644 index 000000000..f09f9943d --- /dev/null +++ b/gcloud/beta/netapp/backup-vaults/help @@ -0,0 +1,36 @@ +NAME + gcloud beta netapp backup-vaults - create and manage Cloud NetApp Backup + Vaults + +SYNOPSIS + gcloud beta netapp backup-vaults GROUP | COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Create and manage Cloud NetApp Backup Vaults. + +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 Cloud NetApp Backup Vault. + + delete + (BETA) Delete a Cloud NetApp Volumes Backup Vault. + + describe + (BETA) Show metadata for a Cloud NetApp Volumes Backup Vault. + + list + (BETA) List Cloud NetApp Volumes Backup Vaults. + + update + (BETA) Update a Cloud NetApp Volumes Backup Vault. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/netapp/backup-vaults/list b/gcloud/beta/netapp/backup-vaults/list new file mode 100644 index 000000000..8255befa2 --- /dev/null +++ b/gcloud/beta/netapp/backup-vaults/list @@ -0,0 +1,89 @@ +NAME + gcloud beta netapp backup-vaults list - list Cloud NetApp Volumes Backup + Vaults + +SYNOPSIS + gcloud beta netapp backup-vaults list [--location=LOCATION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Lists Cloud NetApp Backup Vaults to store Cloud NetApp Volumes + Backups. + +EXAMPLES + The following command lists all Backup Vaults in the default + netapp/location + + $ gcloud beta netapp backup-vaults list + + To list all Backup Vaults in a specified location, run: + + $ gcloud beta netapp backup-vaults list --location=us-central1 + +FLAGS + Location resource - The location in which to list Backup Vaults. 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; + ◆ uses all locations by default. with a fully specified name; + ◆ set the property netapp/location with a fully specified name; + ◆ set the property netapp/region with a fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --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; + ▸ uses all locations by default.; + ▸ set the property netapp/location; + ▸ set the property netapp/region. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/netapp/backup-vaults/update b/gcloud/beta/netapp/backup-vaults/update new file mode 100644 index 000000000..c0139b1bc --- /dev/null +++ b/gcloud/beta/netapp/backup-vaults/update @@ -0,0 +1,109 @@ +NAME + gcloud beta netapp backup-vaults update - update a Cloud NetApp Volumes + Backup Vault + +SYNOPSIS + gcloud beta netapp backup-vaults update + (BACKUP_VAULT : --location=LOCATION) [--async] + [--description=DESCRIPTION] [--update-labels=[KEY=VALUE,...]] + [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Updates a Backup Vault + +EXAMPLES + The following command updates a Backup Vault instance named BACKUP_VAULT + + $ gcloud beta netapp backup-vaults update BACKUP_VAULT \ + --location=us-central1 --description="new description" \ + --update-labels=newkey=newval + + To update a Backup Vault named BACKUP_VAULT asynchronously, run the + following command: + + $ gcloud beta netapp backup-vaults update BACKUP_VAULT --async \ + --location=us-central1 --description="new description" \ + --update-labels=newkey=newval + +POSITIONAL ARGUMENTS + Backup vault resource - The Backup Vault 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 backup_vault on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + BACKUP_VAULT + ID of the backup_vault or fully qualified identifier for the + backup_vault. + + To set the backup_vault attribute: + ▸ provide the argument backup_vault on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the backup_vault. + + To set the location attribute: + ▸ provide the argument backup_vault on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location; + ▸ set the property netapp/region. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + A description of the Cloud NetApp Backup Vault + + --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. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + At most one of these can be specified: + + --clear-labels + Remove all labels. If --update-labels is also specified then + --clear-labels is applied first. + + For example, to remove all labels: + + $ gcloud beta netapp backup-vaults update --clear-labels + + To remove all existing labels and create two new labels, foo and baz: + + $ gcloud beta netapp backup-vaults update --clear-labels \ + --update-labels foo=bar,baz=qux + + --remove-labels=[KEY,...] + List of label keys to remove. If a label does not exist it is + silently ignored. If --update-labels is also specified then + --update-labels is applied first. + +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. + diff --git a/gcloud/beta/netapp/help b/gcloud/beta/netapp/help index 593eebf8f..d8de85bfc 100644 --- a/gcloud/beta/netapp/help +++ b/gcloud/beta/netapp/help @@ -29,6 +29,12 @@ GROUPS active-directories (BETA) Create and manage Cloud NetApp Active Directories. + backup-policies + (BETA) Create and manage Cloud NetApp Backup Policies. + + backup-vaults + (BETA) Create and manage Cloud NetApp Backup Vaults. + kms-configs (BETA) Create and manage Cloud NetApp Volumes KMS Configs. diff --git a/gcloud/beta/projects/delete b/gcloud/beta/projects/delete index 4a3d82df6..6f0d640ae 100644 --- a/gcloud/beta/projects/delete +++ b/gcloud/beta/projects/delete @@ -2,7 +2,8 @@ NAME gcloud beta projects delete - delete a project SYNOPSIS - gcloud beta projects delete PROJECT_ID_OR_NUMBER [GCLOUD_WIDE_FLAG ...] + gcloud beta projects delete PROJECT_ID_OR_NUMBER + [--recommend=BOOLEAN_VALUE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Deletes the project with the given project ID. @@ -26,6 +27,13 @@ POSITIONAL ARGUMENTS PROJECT_ID_OR_NUMBER ID or number for the project you want to delete. +FLAGS + --recommend=BOOLEAN_VALUE + If true, checks Active Assist recommendation for the risk level of + project deletion, and issues a warning in the prompt. Optional flag is + set to false by default. For details see + https://cloud.google.com/recommender/docs/change-risk-recommendations + 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/projects/remove-iam-policy-binding b/gcloud/beta/projects/remove-iam-policy-binding index 58b4eae08..c499264b0 100644 --- a/gcloud/beta/projects/remove-iam-policy-binding +++ b/gcloud/beta/projects/remove-iam-policy-binding @@ -4,12 +4,12 @@ NAME SYNOPSIS gcloud beta projects remove-iam-policy-binding PROJECT_ID - --member=PRINCIPAL --role=ROLE + --member=PRINCIPAL --role=ROLE [--recommend=BOOLEAN_VALUE] [--all | --condition=[KEY=VALUE,...] | --condition-from-file=CONDITION_FROM_FILE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Removes a policy binding to the IAM policy of a project, given a + (BETA) Removes a policy binding from the IAM policy of a project, given a project ID and the binding. One binding consists of a member, a role and an optional condition. @@ -55,8 +55,8 @@ EXAMPLES policy role and member types. POSITIONAL ARGUMENTS - Project resource - The project to remove the IAM policy binding from. This - represents a Cloud resource. + Project resource - ID for the project you want to remove IAM policy + binding from. This represents a Cloud resource. This must be specified. @@ -89,6 +89,12 @@ REQUIRED FLAGS The role to remove the principal from. OPTIONAL FLAGS + --recommend=BOOLEAN_VALUE + If true, checks Active Assist recommendation for the risk level of IAM + policy binding removal, and issues a warning in the prompt. Optional + flag is set to false by default. For details see + https://cloud.google.com/recommender/docs/change-risk-recommendations + At most one of these can be specified: --all diff --git a/gcloud/beta/pubsub/subscriptions/create b/gcloud/beta/pubsub/subscriptions/create index 7bbe4fe16..f456b1ea9 100644 --- a/gcloud/beta/pubsub/subscriptions/create +++ b/gcloud/beta/pubsub/subscriptions/create @@ -91,12 +91,14 @@ OPTIONAL FLAGS message with a given value of message_id on this subscription: The message sent to a subscriber is guaranteed not to be resent before the message's acknowledgment deadline expires. An acknowledged message will - not be resent to a subscriber. + not be resent to a subscriber. Use --no-enable-exactly-once-delivery to + disable this flag. --enable-message-ordering Whether to receive messages with the same ordering key in order. If set, messages with the same ordering key are sent to subscribers in the - order that Pub/Sub receives them. + order that Pub/Sub receives them. Use --no-enable-message-ordering to + disable this flag. --expiration-period=EXPIRATION_PERIOD The subscription will expire if it is inactive for the given period. @@ -146,7 +148,8 @@ OPTIONAL FLAGS Whether or not to retain acknowledged messages. If true, messages are not expunged from the subscription's backlog until they fall out of the --message-retention-duration window. Acknowledged messages are not - retained by default. + retained by default. Use --no-retain-acked-messages to disable this + flag. At most one of these can be specified: @@ -166,11 +169,13 @@ OPTIONAL FLAGS When --use-topic-schema is set, whether or not to ignore fields in the topic schema that do not appear in the BigQuery schema. If false, then the BigQuery schema must contain all fields that are - also present in the topic schema. + also present in the topic schema. Use --no-drop-unknown-fields to + disable this flag. --use-topic-schema Whether or not to use the schema for the subscription's topic (if - it exists) when writing messages to BigQuery. + it exists) when writing messages to BigQuery. Use + --no-use-topic-schema to disable this flag. --write-metadata Whether or not to write message metadata including message ID, @@ -178,7 +183,8 @@ OPTIONAL FLAGS subscription name, message_id, and publish_time fields are put in their own columns while all other message properties other than data (for example, an ordering_key, if present) are written to a - JSON object in the attributes column. + JSON object in the attributes column. Use --no-write-metadata to + disable this flag. Cloud Storage Config Options. The Cloud Pub/Sub service account associated with the enclosing subscription's parent project (i.e., @@ -225,7 +231,8 @@ OPTIONAL FLAGS properties other than data (for example, an ordering_key, if present) are added as entries in the attributes map. This has an effect only for subscriptions with - --cloud-storage-output-format=avro. + --cloud-storage-output-format=avro. Use + --no-cloud-storage-write-metadata to disable this flag. Dead Letter Queue Options. The Cloud Pub/Sub service account associated with the enclosing subscription's parent project (i.e., @@ -284,6 +291,7 @@ OPTIONAL FLAGS --push-no-wrapper When set, the message data is delivered directly as the HTTP body. + Use --no-push-no-wrapper to disable this flag. This flag argument must be specified if any of the other arguments in this group are specified. @@ -292,7 +300,8 @@ OPTIONAL FLAGS When true, writes the Pub/Sub message metadata to x-goog-pubsub-: headers of the HTTP request. Writes the Pub/Sub message attributes to : headers of the HTTP - request. + request. Use --no-push-no-wrapper-write-metadata to disable this + flag. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/pubsub/subscriptions/modify-push-config b/gcloud/beta/pubsub/subscriptions/modify-push-config index aa3dec754..cd356c481 100644 --- a/gcloud/beta/pubsub/subscriptions/modify-push-config +++ b/gcloud/beta/pubsub/subscriptions/modify-push-config @@ -51,6 +51,7 @@ OPTIONAL FLAGS --push-no-wrapper When set, the message data is delivered directly as the HTTP body. + Use --no-push-no-wrapper to disable this flag. This flag argument must be specified if any of the other arguments in this group are specified. @@ -59,7 +60,8 @@ OPTIONAL FLAGS When true, writes the Pub/Sub message metadata to x-goog-pubsub-: headers of the HTTP request. Writes the Pub/Sub message attributes to : headers of the HTTP - request. + request. Use --no-push-no-wrapper-write-metadata to disable this + flag. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/pubsub/subscriptions/pull b/gcloud/beta/pubsub/subscriptions/pull index 138f00b8b..b49c65b81 100644 --- a/gcloud/beta/pubsub/subscriptions/pull +++ b/gcloud/beta/pubsub/subscriptions/pull @@ -42,7 +42,8 @@ POSITIONAL ARGUMENTS FLAGS --auto-ack - Automatically ACK every message pulled from this subscription. + Automatically ACK every message pulled from this subscription. Use + --no-auto-ack to disable this flag. --max-messages=MAX_MESSAGES; default=1 (DEPRECATED) The maximum number of messages that Cloud Pub/Sub can @@ -59,7 +60,8 @@ FLAGS messages readily available in memory buffers. If no messages are available in the buffers, returns an empty list of messages as response, even if having messages in the backlog. Do not set this - flag as it adversely impacts the performance of pull. + flag as it adversely impacts the performance of pull. Use + --no-return-immediately to disable this flag. --wait (DEPRECATED) Wait (for a bounded amount of time) for new messages diff --git a/gcloud/beta/pubsub/subscriptions/update b/gcloud/beta/pubsub/subscriptions/update index c5af9a8c0..3dcc33627 100644 --- a/gcloud/beta/pubsub/subscriptions/update +++ b/gcloud/beta/pubsub/subscriptions/update @@ -66,7 +66,8 @@ FLAGS message sent to a subscriber is guaranteed not to be resent before the message's acknowledgment deadline expires. An acknowledged message will not be resent to a subscriber. To disable exactly-once delivery use - --no-enable-exactly-once-delivery. + --no-enable-exactly-once-delivery. Use + --no-enable-exactly-once-delivery to disable this flag. --expiration-period=EXPIRATION_PERIOD The subscription will expire if it is inactive for the given period. @@ -101,7 +102,8 @@ FLAGS Whether or not to retain acknowledged messages. If true, messages are not expunged from the subscription's backlog until they fall out of the --message-retention-duration window. Acknowledged messages are not - retained by default. + retained by default. Use --no-retain-acked-messages to disable this + flag. --update-labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to update. If a label exists, its value @@ -117,7 +119,8 @@ FLAGS At most one of these can be specified: --clear-bigquery-config - If set, clear the BigQuery config from the subscription. + If set, clear the BigQuery config from the subscription. Use + --no-clear-bigquery-config to disable this flag. BigQuery Config Options. The Cloud Pub/Sub service account associated with the enclosing subscription's parent project (i.e., @@ -136,11 +139,13 @@ FLAGS When --use-topic-schema is set, whether or not to ignore fields in the topic schema that do not appear in the BigQuery schema. If false, then the BigQuery schema must contain all fields that are - also present in the topic schema. + also present in the topic schema. Use --no-drop-unknown-fields to + disable this flag. --use-topic-schema Whether or not to use the schema for the subscription's topic (if - it exists) when writing messages to BigQuery. + it exists) when writing messages to BigQuery. Use + --no-use-topic-schema to disable this flag. --write-metadata Whether or not to write message metadata including message ID, @@ -148,12 +153,14 @@ FLAGS subscription name, message_id, and publish_time fields are put in their own columns while all other message properties other than data (for example, an ordering_key, if present) are written to a - JSON object in the attributes column. + JSON object in the attributes column. Use --no-write-metadata to + disable this flag. At most one of these can be specified: --clear-cloud-storage-config - If set, clear the Cloud Storage config from the subscription. + If set, clear the Cloud Storage config from the subscription. Use + --no-clear-cloud-storage-config to disable this flag. Cloud Storage Config Options. The Cloud Pub/Sub service account associated with the enclosing subscription's parent project (i.e., @@ -204,12 +211,14 @@ FLAGS message properties other than data (for example, an ordering_key, if present) are added as entries in the attributes map. This has an effect only for subscriptions with - --cloud-storage-output-format=avro. + --cloud-storage-output-format=avro. Use + --no-cloud-storage-write-metadata to disable this flag. At most one of these can be specified: --clear-dead-letter-policy - If set, clear the dead letter policy from the subscription. + If set, clear the dead letter policy from the subscription. Use + --no-clear-dead-letter-policy to disable this flag. Dead Letter Queue Options. The Cloud Pub/Sub service account associated with the enclosing subscription's parent project (i.e., @@ -270,12 +279,14 @@ FLAGS At most one of these can be specified: --clear-push-no-wrapper-config - If set, clear the NoWrapper config from the subscription. + If set, clear the NoWrapper config from the subscription. Use + --no-clear-push-no-wrapper-config to disable this flag. NoWrapper Config Options. --push-no-wrapper When set, the message data is delivered directly as the HTTP body. + Use --no-push-no-wrapper to disable this flag. This flag argument must be specified if any of the other arguments in this group are specified. @@ -284,12 +295,14 @@ FLAGS When true, writes the Pub/Sub message metadata to x-goog-pubsub-: headers of the HTTP request. Writes the Pub/Sub message attributes to : headers of the HTTP - request. + request. Use --no-push-no-wrapper-write-metadata to disable this + flag. At most one of these can be specified: --clear-retry-policy - If set, clear the retry policy from the subscription. + If set, clear the retry policy from the subscription. Use + --no-clear-retry-policy to disable this flag. Retry Policy Options. Retry policy specifies how Cloud Pub/Sub retries message delivery for this subscription. diff --git a/gcloud/beta/pubsub/topics/update b/gcloud/beta/pubsub/topics/update index 95cb4ee63..596805ea5 100644 --- a/gcloud/beta/pubsub/topics/update +++ b/gcloud/beta/pubsub/topics/update @@ -117,7 +117,8 @@ FLAGS At most one of these can be specified: --clear-message-retention-duration - If set, clear the message retention duration from the topic. + If set, clear the message retention duration from the topic. Use + --no-clear-message-retention-duration to disable this flag. --message-retention-duration=MESSAGE_RETENTION_DURATION Indicates the minimum duration to retain a message after it is @@ -135,7 +136,8 @@ FLAGS At most one of these can be specified: --clear-schema-settings - If set, clear the Schema Settings from the topic. + If set, clear the Schema Settings from the topic. Use + --no-clear-schema-settings to disable this flag. Schema settings. The schema that messages published to this topic must conform to and the expected message encoding. diff --git a/gcloud/beta/spanner/instances/create b/gcloud/beta/spanner/instances/create index 39aa32fbd..c8cf891e2 100644 --- a/gcloud/beta/spanner/instances/create +++ b/gcloud/beta/spanner/instances/create @@ -5,7 +5,8 @@ SYNOPSIS gcloud beta spanner instances create INSTANCE --config=CONFIG --description=DESCRIPTION [--async] [--expire-behavior=EXPIRE_BEHAVIOR] [--instance-type=INSTANCE_TYPE] - [--nodes=NODES | --processing-units=PROCESSING_UNITS] + [--nodes=NODES | --processing-units=PROCESSING_UNITS + | --autoscaling-high-priority-cpu-target=AUTOSCALING_HIGH_PRIORITY_CPU_TARGET --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET (--autoscaling-max-nodes=AUTOSCALING_MAX_NODES --autoscaling-min-nodes=AUTOSCALING_MIN_NODES | --autoscaling-max-processing-units=AUTOSCALING_MAX_PROCESSING_UNITS --autoscaling-min-processing-units=AUTOSCALING_MIN_PROCESSING_UNITS)] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -67,6 +68,52 @@ OPTIONAL FLAGS --processing-units=PROCESSING_UNITS Number of processing units for the instance. + Autoscaling + + --autoscaling-high-priority-cpu-target=AUTOSCALING_HIGH_PRIORITY_CPU_TARGET + Specifies the target percentage of high-priority CPU the autoscaled + instance can utilize. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET + Specifies the target percentage of storage the autoscaled instance + can utilize. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + Exactly one of these must be specified: + + Autoscaling limits in nodes + + --autoscaling-max-nodes=AUTOSCALING_MAX_NODES + Maximum number of nodes for the autoscaled instance. + + This flag argument must be specified if any of the other + arguments in this group are specified. + + --autoscaling-min-nodes=AUTOSCALING_MIN_NODES + Minimum number of nodes for the autoscaled instance. + + This flag argument must be specified if any of the other + arguments in this group are specified. + + Autoscaling limits in processing units + + --autoscaling-max-processing-units=AUTOSCALING_MAX_PROCESSING_UNITS + Maximum number of processing units for the autoscaled instance. + + This flag argument must be specified if any of the other + arguments in this group are specified. + + --autoscaling-min-processing-units=AUTOSCALING_MIN_PROCESSING_UNITS + Minimum number of processing units for the autoscaled instance. + + This flag argument must be specified if any of the other + arguments in this group are specified. + 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/spanner/instances/update b/gcloud/beta/spanner/instances/update index 4791ad903..4da8d0779 100644 --- a/gcloud/beta/spanner/instances/update +++ b/gcloud/beta/spanner/instances/update @@ -5,7 +5,8 @@ SYNOPSIS gcloud beta spanner instances update INSTANCE [--async] [--description=DESCRIPTION] [--expire-behavior=EXPIRE_BEHAVIOR] [--instance-type=INSTANCE_TYPE] - [--nodes=NODES | --processing-units=PROCESSING_UNITS] + [--nodes=NODES | --processing-units=PROCESSING_UNITS + | --autoscaling-high-priority-cpu-target=AUTOSCALING_HIGH_PRIORITY_CPU_TARGET --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET --autoscaling-max-nodes=AUTOSCALING_MAX_NODES --autoscaling-min-nodes=AUTOSCALING_MIN_NODES | --autoscaling-max-processing-units=AUTOSCALING_MAX_PROCESSING_UNITS --autoscaling-min-processing-units=AUTOSCALING_MIN_PROCESSING_UNITS] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -64,6 +65,34 @@ FLAGS --processing-units=PROCESSING_UNITS Number of processing units for the instance. + Autoscaling + + --autoscaling-high-priority-cpu-target=AUTOSCALING_HIGH_PRIORITY_CPU_TARGET + Specifies the target percentage of high-priority CPU the autoscaled + instance can utilize. + + --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET + Specifies the target percentage of storage the autoscaled instance + can utilize. + + At most one of these can be specified: + + Autoscaling limits in nodes + + --autoscaling-max-nodes=AUTOSCALING_MAX_NODES + Maximum number of nodes for the autoscaled instance. + + --autoscaling-min-nodes=AUTOSCALING_MIN_NODES + Minimum number of nodes for the autoscaled instance. + + Autoscaling limits in processing units + + --autoscaling-max-processing-units=AUTOSCALING_MAX_PROCESSING_UNITS + Maximum number of processing units for the autoscaled instance. + + --autoscaling-min-processing-units=AUTOSCALING_MIN_PROCESSING_UNITS + Minimum number of processing units for the autoscaled instance. + 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/sql/instances/create b/gcloud/beta/sql/instances/create index bea18e616..21f1a10dc 100644 --- a/gcloud/beta/sql/instances/create +++ b/gcloud/beta/sql/instances/create @@ -45,7 +45,8 @@ SYNOPSIS [--replica-type=REPLICA_TYPE] [--replication=REPLICATION] [--require-ssl] [--retained-backups-count=RETAINED_BACKUPS_COUNT] [--retained-transaction-log-days=RETAINED_TRANSACTION_LOG_DAYS] - [--root-password=ROOT_PASSWORD] [--[no-]storage-auto-increase] + [--root-password=ROOT_PASSWORD] [--ssl-mode=SSL_MODE] + [--[no-]storage-auto-increase] [--storage-auto-increase-limit=STORAGE_AUTO_INCREASE_LIMIT] [--storage-size=STORAGE_SIZE] [--storage-type=STORAGE_TYPE] [--threads-per-core=THREADS_PER_CORE] [--tier=TIER, -t TIER] @@ -399,6 +400,18 @@ FLAGS --root-password=ROOT_PASSWORD Root Cloud SQL user's password. + --ssl-mode=SSL_MODE + Set the SSL mode of the instance. SSL_MODE must be one of: + + ALLOW_UNENCRYPTED_AND_ENCRYPTED + Allow non-SSL and SSL connections. For SSL connections, client + certificate will not be verified. + ENCRYPTED_ONLY + Only allow connections encrypted with SSL/TLS. + TRUSTED_CLIENT_CERTIFICATE_REQUIRED + Only allow connections encrypted with SSL/TLS and with valid client + certificates. + --[no-]storage-auto-increase Storage size can be increased, but it cannot be decreased; storage increases are permanent for the life of the instance. With this setting diff --git a/gcloud/beta/sql/instances/patch b/gcloud/beta/sql/instances/patch index 84d6c0dd0..76a526aa7 100644 --- a/gcloud/beta/sql/instances/patch +++ b/gcloud/beta/sql/instances/patch @@ -39,7 +39,8 @@ SYNOPSIS [--pricing-plan=PRICING_PLAN, -p PRICING_PLAN] [--[no-]recreate-replicas-on-primary-crash] [--remove-deny-maintenance-period] [--replication=REPLICATION] - [--[no-]require-ssl] [--[no-]storage-auto-increase] + [--[no-]require-ssl] [--ssl-mode=SSL_MODE] + [--[no-]storage-auto-increase] [--storage-auto-increase-limit=STORAGE_AUTO_INCREASE_LIMIT] [--storage-size=STORAGE_SIZE] [--threads-per-core=THREADS_PER_CORE] [--tier=TIER, -t TIER] [--update-labels=[KEY=VALUE,...]] @@ -333,6 +334,18 @@ FLAGS mysqld should default to 'REQUIRE X509' for users connecting over IP. Use --require-ssl to enable and --no-require-ssl to disable. + --ssl-mode=SSL_MODE + Set the SSL mode of the instance. SSL_MODE must be one of: + + ALLOW_UNENCRYPTED_AND_ENCRYPTED + Allow non-SSL and SSL connections. For SSL connections, client + certificate will not be verified. + ENCRYPTED_ONLY + Only allow connections encrypted with SSL/TLS. + TRUSTED_CLIENT_CERTIFICATE_REQUIRED + Only allow connections encrypted with SSL/TLS and with valid client + certificates. + --[no-]storage-auto-increase Storage size can be increased, but it cannot be decreased; storage increases are permanent for the life of the instance. With this setting diff --git a/gcloud/beta/workstations/clusters/create b/gcloud/beta/workstations/clusters/create index a71ea7931..0205677e5 100644 --- a/gcloud/beta/workstations/clusters/create +++ b/gcloud/beta/workstations/clusters/create @@ -51,7 +51,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument cluster on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. FLAGS --async diff --git a/gcloud/beta/workstations/clusters/delete b/gcloud/beta/workstations/clusters/delete index fb8581fd3..7880290a5 100644 --- a/gcloud/beta/workstations/clusters/delete +++ b/gcloud/beta/workstations/clusters/delete @@ -42,7 +42,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument cluster on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. FLAGS --async diff --git a/gcloud/beta/workstations/clusters/describe b/gcloud/beta/workstations/clusters/describe index 183f38acd..2372c3d35 100644 --- a/gcloud/beta/workstations/clusters/describe +++ b/gcloud/beta/workstations/clusters/describe @@ -42,7 +42,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument cluster on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/workstations/configs/create b/gcloud/beta/workstations/configs/create index 3dbaff358..639cac0a1 100644 --- a/gcloud/beta/workstations/configs/create +++ b/gcloud/beta/workstations/configs/create @@ -85,7 +85,8 @@ POSITIONAL ARGUMENTS To set the cluster attribute: ▸ provide the argument config on the command line with a fully specified name; - ▸ provide the argument --cluster on the command line. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster. --region=REGION The location for the config. @@ -93,7 +94,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument config on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. FLAGS --async diff --git a/gcloud/beta/workstations/configs/delete b/gcloud/beta/workstations/configs/delete index 77100caac..dff223aae 100644 --- a/gcloud/beta/workstations/configs/delete +++ b/gcloud/beta/workstations/configs/delete @@ -44,7 +44,8 @@ POSITIONAL ARGUMENTS To set the cluster attribute: ▸ provide the argument config on the command line with a fully specified name; - ▸ provide the argument --cluster on the command line. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster. --region=REGION The name of the region of the config. @@ -52,7 +53,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument config on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. FLAGS --async diff --git a/gcloud/beta/workstations/configs/describe b/gcloud/beta/workstations/configs/describe index b27283a20..f9698d08c 100644 --- a/gcloud/beta/workstations/configs/describe +++ b/gcloud/beta/workstations/configs/describe @@ -42,7 +42,8 @@ POSITIONAL ARGUMENTS To set the cluster attribute: ▸ provide the argument config on the command line with a fully specified name; - ▸ provide the argument --cluster on the command line. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster. --region=REGION The name of the region of the config. @@ -50,7 +51,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument config on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/workstations/configs/get-iam-policy b/gcloud/beta/workstations/configs/get-iam-policy index eca0b5ca7..00c54a37f 100644 --- a/gcloud/beta/workstations/configs/get-iam-policy +++ b/gcloud/beta/workstations/configs/get-iam-policy @@ -50,7 +50,8 @@ POSITIONAL ARGUMENTS To set the cluster attribute: ▸ provide the argument config on the command line with a fully specified name; - ▸ provide the argument --cluster on the command line. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster. --region=REGION The name of the region of the config. @@ -58,7 +59,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument config on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/beta/workstations/configs/list b/gcloud/beta/workstations/configs/list index 8bc1c0780..8652c8dcf 100644 --- a/gcloud/beta/workstations/configs/list +++ b/gcloud/beta/workstations/configs/list @@ -43,7 +43,8 @@ REQUIRED FLAGS To set the region attribute: ▸ provide the argument --cluster on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/beta/workstations/configs/set-iam-policy b/gcloud/beta/workstations/configs/set-iam-policy index 578108919..01b4d2fae 100644 --- a/gcloud/beta/workstations/configs/set-iam-policy +++ b/gcloud/beta/workstations/configs/set-iam-policy @@ -49,7 +49,8 @@ POSITIONAL ARGUMENTS To set the cluster attribute: ▸ provide the argument config on the command line with a fully specified name; - ▸ provide the argument --cluster on the command line. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster. --region=REGION The name of the region of the config. @@ -57,7 +58,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument config on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. POLICY_FILE Path to a local JSON or YAML formatted file containing a valid policy. diff --git a/gcloud/beta/workstations/configs/update b/gcloud/beta/workstations/configs/update index 7653e62cd..a16565036 100644 --- a/gcloud/beta/workstations/configs/update +++ b/gcloud/beta/workstations/configs/update @@ -72,7 +72,8 @@ POSITIONAL ARGUMENTS To set the cluster attribute: ▸ provide the argument config on the command line with a fully specified name; - ▸ provide the argument --cluster on the command line. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster. --region=REGION The location for the config. @@ -80,7 +81,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument config on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. FLAGS --async diff --git a/gcloud/beta/workstations/create b/gcloud/beta/workstations/create index 6e3cc6ce4..001e91754 100644 --- a/gcloud/beta/workstations/create +++ b/gcloud/beta/workstations/create @@ -44,7 +44,8 @@ POSITIONAL ARGUMENTS To set the cluster attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --cluster on the command line. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster. --config=CONFIG The name of the config containing the workstation. @@ -52,7 +53,8 @@ POSITIONAL ARGUMENTS To set the config attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --config on the command line. + ▸ provide the argument --config on the command line; + ▸ set the property workstations/config. --region=REGION The name of the region of the workstation. @@ -60,7 +62,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. FLAGS --async diff --git a/gcloud/beta/workstations/delete b/gcloud/beta/workstations/delete index 2ee8d6f28..ea84419ad 100644 --- a/gcloud/beta/workstations/delete +++ b/gcloud/beta/workstations/delete @@ -44,7 +44,8 @@ POSITIONAL ARGUMENTS To set the cluster attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --cluster on the command line. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster. --config=CONFIG The name of the config containing the workstation. @@ -52,7 +53,8 @@ POSITIONAL ARGUMENTS To set the config attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --config on the command line. + ▸ provide the argument --config on the command line; + ▸ set the property workstations/config. --region=REGION The name of the region of the workstation. @@ -60,7 +62,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. FLAGS --async diff --git a/gcloud/beta/workstations/describe b/gcloud/beta/workstations/describe index c9335c4ca..35ea8e083 100644 --- a/gcloud/beta/workstations/describe +++ b/gcloud/beta/workstations/describe @@ -44,7 +44,8 @@ POSITIONAL ARGUMENTS To set the cluster attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --cluster on the command line. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster. --config=CONFIG The name of the config containing the workstation. @@ -52,7 +53,8 @@ POSITIONAL ARGUMENTS To set the config attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --config on the command line. + ▸ provide the argument --config on the command line; + ▸ set the property workstations/config. --region=REGION The name of the region of the workstation. @@ -60,7 +62,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/workstations/get-iam-policy b/gcloud/beta/workstations/get-iam-policy index ad2b1f31c..4bef5eb69 100644 --- a/gcloud/beta/workstations/get-iam-policy +++ b/gcloud/beta/workstations/get-iam-policy @@ -51,7 +51,8 @@ POSITIONAL ARGUMENTS To set the cluster attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --cluster on the command line. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster. --config=CONFIG The name of the config containing the workstation. @@ -59,7 +60,8 @@ POSITIONAL ARGUMENTS To set the config attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --config on the command line. + ▸ provide the argument --config on the command line; + ▸ set the property workstations/config. --region=REGION The name of the region of the workstation. @@ -67,7 +69,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/beta/workstations/list b/gcloud/beta/workstations/list index 5c129dcd4..df619f2e7 100644 --- a/gcloud/beta/workstations/list +++ b/gcloud/beta/workstations/list @@ -44,7 +44,8 @@ REQUIRED FLAGS To set the cluster attribute: ▸ provide the argument --config on the command line with a fully specified name; - ▸ provide the argument --cluster on the command line. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster. --region=REGION The name of the region of the config. @@ -52,7 +53,8 @@ REQUIRED FLAGS To set the region attribute: ▸ provide the argument --config on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/beta/workstations/list-usable b/gcloud/beta/workstations/list-usable index 4e72a3ee6..424201380 100644 --- a/gcloud/beta/workstations/list-usable +++ b/gcloud/beta/workstations/list-usable @@ -44,7 +44,8 @@ REQUIRED FLAGS To set the cluster attribute: ▸ provide the argument --config on the command line with a fully specified name; - ▸ provide the argument --cluster on the command line. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster. --region=REGION The location for the config. @@ -52,7 +53,8 @@ REQUIRED FLAGS To set the region attribute: ▸ provide the argument --config on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/beta/workstations/set-iam-policy b/gcloud/beta/workstations/set-iam-policy index 784934a80..b73aa7098 100644 --- a/gcloud/beta/workstations/set-iam-policy +++ b/gcloud/beta/workstations/set-iam-policy @@ -50,7 +50,8 @@ POSITIONAL ARGUMENTS To set the cluster attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --cluster on the command line. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster. --config=CONFIG The name of the config containing the workstation. @@ -58,7 +59,8 @@ POSITIONAL ARGUMENTS To set the config attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --config on the command line. + ▸ provide the argument --config on the command line; + ▸ set the property workstations/config. --region=REGION The name of the region of the workstation. @@ -66,7 +68,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. POLICY_FILE Path to a local JSON or YAML formatted file containing a valid policy. diff --git a/gcloud/beta/workstations/ssh b/gcloud/beta/workstations/ssh index e2cb81aa2..22a4afd63 100644 --- a/gcloud/beta/workstations/ssh +++ b/gcloud/beta/workstations/ssh @@ -56,7 +56,8 @@ POSITIONAL ARGUMENTS To set the cluster attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --cluster on the command line. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster. --config=CONFIG The config for the workstation. @@ -64,7 +65,8 @@ POSITIONAL ARGUMENTS To set the config attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --config on the command line. + ▸ provide the argument --config on the command line; + ▸ set the property workstations/config. --region=REGION The location for the workstation. @@ -72,7 +74,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. [-- SSH_ARGS ...] Flags and positionals passed to the underlying ssh implementation. diff --git a/gcloud/beta/workstations/start b/gcloud/beta/workstations/start index f48c6b92e..4d934ce24 100644 --- a/gcloud/beta/workstations/start +++ b/gcloud/beta/workstations/start @@ -44,7 +44,8 @@ POSITIONAL ARGUMENTS To set the cluster attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --cluster on the command line. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster. --config=CONFIG The config for the workstation. @@ -52,7 +53,8 @@ POSITIONAL ARGUMENTS To set the config attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --config on the command line. + ▸ provide the argument --config on the command line; + ▸ set the property workstations/config. --region=REGION The location for the workstation. @@ -60,7 +62,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. FLAGS --async diff --git a/gcloud/beta/workstations/start-tcp-tunnel b/gcloud/beta/workstations/start-tcp-tunnel index a13a94f49..1cd4b8e4b 100644 --- a/gcloud/beta/workstations/start-tcp-tunnel +++ b/gcloud/beta/workstations/start-tcp-tunnel @@ -50,7 +50,8 @@ POSITIONAL ARGUMENTS To set the cluster attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --cluster on the command line. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster. --config=CONFIG The config for the workstation. @@ -58,7 +59,8 @@ POSITIONAL ARGUMENTS To set the config attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --config on the command line. + ▸ provide the argument --config on the command line; + ▸ set the property workstations/config. --region=REGION The location for the workstation. @@ -66,7 +68,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. WORKSTATION_PORT The port on the workstation to which traffic should be sent. diff --git a/gcloud/beta/workstations/stop b/gcloud/beta/workstations/stop index 07a4f5a74..349d75205 100644 --- a/gcloud/beta/workstations/stop +++ b/gcloud/beta/workstations/stop @@ -44,7 +44,8 @@ POSITIONAL ARGUMENTS To set the cluster attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --cluster on the command line. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster. --config=CONFIG The config for the workstation. @@ -52,7 +53,8 @@ POSITIONAL ARGUMENTS To set the config attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --config on the command line. + ▸ provide the argument --config on the command line; + ▸ set the property workstations/config. --region=REGION The location for the workstation. @@ -60,7 +62,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. FLAGS --async diff --git a/gcloud/bigtable/app-profiles/create b/gcloud/bigtable/app-profiles/create index f3fecaf94..8a93cc7b3 100644 --- a/gcloud/bigtable/app-profiles/create +++ b/gcloud/bigtable/app-profiles/create @@ -5,7 +5,8 @@ SYNOPSIS gcloud bigtable app-profiles create (APP_PROFILE : --instance=INSTANCE) ([--route-any : --restrict-to=[RESTRICT_TO,...]] | [--route-to=ROUTE_TO : --transactional-writes]) - [--description=DESCRIPTION] [--force] [GCLOUD_WIDE_FLAG ...] + [--description=DESCRIPTION] [--force] [--priority=PRIORITY] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION Create a new Bigtable app profile. @@ -29,6 +30,11 @@ EXAMPLES --instance=my-instance-id --route-any \ --description="Routes requests for my use case" + To create an app profile with a request priority of PRIORITY_MEDIUM, run: + + $ gcloud bigtable app-profiles create my-app-profile-id \ + --instance=my-instance-id --route-any --priority=PRIORITY_MEDIUM + POSITIONAL ARGUMENTS App profile resource - The app profile to create. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some @@ -94,6 +100,17 @@ OPTIONAL FLAGS --force Ignore warnings and force create. + --priority=PRIORITY + Specify the request priority. If not specified, the app profile uses + PRIORITY_HIGH by default. PRIORITY must be one of: + + PRIORITY_HIGH + Requests are treated with high priority. + PRIORITY_LOW + Requests are treated with low priority. + PRIORITY_MEDIUM + Requests are treated with medium priority. + 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/bigtable/app-profiles/update b/gcloud/bigtable/app-profiles/update index 73d81187d..ec80cb461 100644 --- a/gcloud/bigtable/app-profiles/update +++ b/gcloud/bigtable/app-profiles/update @@ -3,7 +3,7 @@ NAME SYNOPSIS gcloud bigtable app-profiles update (APP_PROFILE : --instance=INSTANCE) - [--async] [--description=DESCRIPTION] [--force] + [--async] [--description=DESCRIPTION] [--force] [--priority=PRIORITY] [[--route-any : --restrict-to=[RESTRICT_TO,...]] | [--route-to=ROUTE_TO : --transactional-writes]] [GCLOUD_WIDE_FLAG ...] @@ -29,6 +29,11 @@ EXAMPLES $ gcloud bigtable app-profiles update my-app-profile-id \ --instance=my-instance-id --description="New description" + To update the request priority for an app profile to PRIORITY_LOW, run: + + $ gcloud bigtable app-profiles update my-app-profile-id \ + --instance=my-instance-id --priority=PRIORITY_LOW + POSITIONAL ARGUMENTS App profile resource - The app profile to update. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some @@ -72,6 +77,17 @@ FLAGS --force Ignore warnings and force update. + --priority=PRIORITY + Specify the request priority. If not specified, the app profile uses + PRIORITY_HIGH by default. PRIORITY must be one of: + + PRIORITY_HIGH + Requests are treated with high priority. + PRIORITY_LOW + Requests are treated with low priority. + PRIORITY_MEDIUM + Requests are treated with medium priority. + At most one of these can be specified: Multi Cluster Routing Policy diff --git a/gcloud/composer/environments/create b/gcloud/composer/environments/create index 16135a8b2..60de0cf59 100644 --- a/gcloud/composer/environments/create +++ b/gcloud/composer/environments/create @@ -6,13 +6,15 @@ SYNOPSIS gcloud composer environments create (ENVIRONMENT : --location=LOCATION) [--airflow-configs=[KEY=VALUE,...]] [--async] [--cloud-sql-machine-type=CLOUD_SQL_MACHINE_TYPE] + [--cloud-sql-preferred-zone=CLOUD_SQL_PREFERRED_ZONE] [--disk-size=DISK_SIZE] [--enable-high-resilience] [--env-variables=[NAME=VALUE,...]] [--environment-size=ENVIRONMENT_SIZE] [--labels=[KEY=VALUE,...]] [--machine-type=MACHINE_TYPE] [--node-count=NODE_COUNT] [--oauth-scopes=[SCOPE,...]] [--python-version=PYTHON_VERSION] - [--service-account=SERVICE_ACCOUNT] [--tags=[TAG,...]] - [--web-server-machine-type=WEB_SERVER_MACHINE_TYPE] [--zone=ZONE] + [--service-account=SERVICE_ACCOUNT] [--storage-bucket=STORAGE_BUCKET] + [--tags=[TAG,...]] [--web-server-machine-type=WEB_SERVER_MACHINE_TYPE] + [--zone=ZONE] [--airflow-version=AIRFLOW_VERSION | --image-version=IMAGE_VERSION] [--cloud-sql-ipv4-cidr=CLOUD_SQL_IPV4_CIDR --composer-network-ipv4-cidr=COMPOSER_NETWORK_IPV4_CIDR @@ -118,6 +120,9 @@ FLAGS available machine types is available here: https://cloud.google.com/composer/pricing#db-machine-types. + --cloud-sql-preferred-zone=CLOUD_SQL_PREFERRED_ZONE + Select cloud sql preferred zone, supported for Composer 2 Environments. + --disk-size=DISK_SIZE The disk size for each VM node in the environment. The minimum size is 20GB, and the maximum is 64TB. Specified value must be an integer @@ -176,6 +181,10 @@ FLAGS If a service account is not specified, the "default" Compute Engine service account for the project is used. Cannot be updated. + --storage-bucket=STORAGE_BUCKET + Name of an exisiting Cloud Storage bucket to be used by the + environment. Supported only for Composer 2.4.X and above. + --tags=[TAG,...] The set of instance tags applied to all node VMs. Tags are used to identify valid sources or targets for network firewalls. Each tag diff --git a/gcloud/compute/network-attachments/help b/gcloud/compute/network-attachments/help index 99e496e19..c8f427cf7 100644 --- a/gcloud/compute/network-attachments/help +++ b/gcloud/compute/network-attachments/help @@ -28,6 +28,9 @@ COMMANDS list List Google Compute Engine network attachments. + update + Update a Google Compute Engine network attachment. + NOTES These variants are also available: diff --git a/gcloud/compute/network-attachments/update b/gcloud/compute/network-attachments/update new file mode 100644 index 000000000..155a6a9c2 --- /dev/null +++ b/gcloud/compute/network-attachments/update @@ -0,0 +1,91 @@ +NAME + gcloud compute network-attachments update - update a Google Compute Engine + network attachment + +SYNOPSIS + gcloud compute network-attachments update NAME [--description=DESCRIPTION] + [--producer-accept-list=[ACCEPT_LIST,...]] + [--producer-reject-list=[REJECT_LIST,...]] [--region=REGION] + [--subnets=SUBNETS,[SUBNETS,...]] [--subnets-region=SUBNETS_REGION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + gcloud compute network-attachments update is used to update network + attachments. You can update the following fields: description, subnets, + producer-accept-list and producer-reject-list. If you update the + producer-accept-list or producer-reject-list, the full new list should be + specified. + +EXAMPLES + To update all the parameters with the new list, run: + + $ gcloud compute network-attachments update \ + NETWORK_ATTACHMENT_NAME --region=us-central1 \ + --subnets=MY_SUBNET2 \ + --description='default network attachment' \ + --producer-accept-list=PROJECT5,PROJECT6 \ + --producer-reject-list=PROJECT7,PROJECT8 + + To update a network attachment to change only the subnet to MY_SUBNET3, + run: + + $ gcloud compute network-attachments update \ + NETWORK_ATTACHMENT_NAME --region=us-central1 \ + --subnets=MY_SUBNET3 + +POSITIONAL ARGUMENTS + NAME + Name of the network attachment to update. + +FLAGS + --description=DESCRIPTION + An optional, textual description for the network attachment. + + --producer-accept-list=[ACCEPT_LIST,...] + Projects that are allowed to connect to this network attachment. + + --producer-reject-list=[REJECT_LIST,...] + Projects that are not allowed to connect to this network attachment. + + --region=REGION + Region of the network attachment to update. 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. + + --subnets=SUBNETS,[SUBNETS,...] + The subnetworks provided by the consumer for the producers + + --subnets-region=SUBNETS_REGION + Region of the subnetworks to operate on. Overrides the default + compute/region property value for this command invocation. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha compute network-attachments update + + $ gcloud beta compute network-attachments update + diff --git a/gcloud/compute/network-endpoint-groups/create b/gcloud/compute/network-endpoint-groups/create index 519d32718..a45c2ba00 100644 --- a/gcloud/compute/network-endpoint-groups/create +++ b/gcloud/compute/network-endpoint-groups/create @@ -52,7 +52,8 @@ FLAGS network is used if unspecified. This is only supported for NEGs with endpoint type gce-vm-ip-port, - non-gcp-private-ip-port, gce-vm-ip, or private-service-connect. + non-gcp-private-ip-port, gce-vm-ip, private-service-connect, + internet-ip-port, or internet-fqdn-port. For Private Service Connect NEGs, you can optionally specify --network and --subnet if --psc-target-service points to a published service. If diff --git a/gcloud/compute/network-endpoint-groups/list-network-endpoints b/gcloud/compute/network-endpoint-groups/list-network-endpoints index c7b182e61..335bb5b40 100644 --- a/gcloud/compute/network-endpoint-groups/list-network-endpoints +++ b/gcloud/compute/network-endpoint-groups/list-network-endpoints @@ -4,8 +4,9 @@ NAME SYNOPSIS gcloud compute network-endpoint-groups list-network-endpoints NAME - [--global | --zone=ZONE] [--filter=EXPRESSION] [--limit=LIMIT] - [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + [--global | --region=REGION | --zone=ZONE] [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION List network endpoints in a network endpoint group. @@ -27,6 +28,26 @@ FLAGS --global If set, the network endpoint group is global. + --region=REGION + Region of the network endpoint group to operate on. 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 network endpoint group to operate on. If not specified and the compute/zone property isn't set, you might be prompted to diff --git a/gcloud/compute/network-endpoint-groups/update b/gcloud/compute/network-endpoint-groups/update index 859524eed..f12239fe0 100644 --- a/gcloud/compute/network-endpoint-groups/update +++ b/gcloud/compute/network-endpoint-groups/update @@ -6,8 +6,8 @@ SYNOPSIS gcloud compute network-endpoint-groups update NAME (--add-endpoint=[fqdn=FQDN],[instance=INSTANCE],[ip=IP],[port=PORT] | --remove-endpoint=[fqdn=FQDN], - [instance=INSTANCE],[ip=IP],[port=PORT]) [--global | --zone=ZONE] - [GCLOUD_WIDE_FLAG ...] + [instance=INSTANCE],[ip=IP],[port=PORT]) + [--global | --region=REGION | --zone=ZONE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION Update a Compute Engine network endpoint group. @@ -160,6 +160,26 @@ OPTIONAL FLAGS --global If set, the network endpoint group is global. + --region=REGION + Region of the network endpoint group to operate on. 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 network endpoint group to operate on. If not specified and the compute/zone property isn't set, you might be prompted to diff --git a/gcloud/compute/networks/vpc-access/connectors/help b/gcloud/compute/networks/vpc-access/connectors/help index 37005e7a1..946cceab3 100644 --- a/gcloud/compute/networks/vpc-access/connectors/help +++ b/gcloud/compute/networks/vpc-access/connectors/help @@ -29,6 +29,9 @@ COMMANDS list List VPC Access connectors. + update + Update a VPC Access connector. + NOTES This variant is also available: diff --git a/gcloud/compute/networks/vpc-access/connectors/update b/gcloud/compute/networks/vpc-access/connectors/update new file mode 100644 index 000000000..ce070a34d --- /dev/null +++ b/gcloud/compute/networks/vpc-access/connectors/update @@ -0,0 +1,97 @@ +NAME + gcloud compute networks vpc-access connectors update - update a VPC Access + connector + +SYNOPSIS + gcloud compute networks vpc-access connectors update + (CONNECTOR : --region=REGION) [--async] [--machine-type=MACHINE_TYPE] + [--max-instances=MAX_INSTANCES] [--min-instances=MIN_INSTANCES] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Update an existing VPC Access connector with the given name. + + This command can fail for the following reasons: + ▪ Invalid parameters are passed to this command. + ▪ The active account does not have permission to update instances. + +EXAMPLES + The following command updates a VPC Access connector with name + my-vpc-connector in region us-central1: + + $ gcloud compute networks vpc-access connectors update \ + my-vpc-connector --region=us-central1 --min-instances=3 \ + --max-instances=5 + +POSITIONAL ARGUMENTS + Connector resource - Arguments and flags that specify the VPC Access + connector you want 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 connector 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. + + CONNECTOR + ID of the connector or fully qualified identifier for the connector. + + To set the connector attribute: + ▸ provide the argument connector on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Compute region (e.g. us-central1) for the connector. + + To set the region attribute: + ▸ provide the argument connector 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. + + --machine-type=MACHINE_TYPE + If set, updates the machine type of VMs underlying the connector. + Accepted values are "e2-micro", "f1-micro", and "e2-standard-4". + + --max-instances=MAX_INSTANCES + If set, updates the maximum number of instances within an autoscaling + group underlying the connector. Value must be between 3 and 10, + inclusive, greater than or equal to the currently set maximum number of + instances, and greater than the value specified by --min-instances. + --min-instances must be provided. + + --min-instances=MIN_INSTANCES + If set, updates the minimum number of instances within an autoscaling + group underlying the connector. Value must be between 2 and 9, + inclusive, greater than or equal to the currently set minimum number of + instances, and less than the value specified by --max-instances. + --max-instances must be provided + +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 vpcaccess/v1 API. The full documentation for this API + can be found at: + https://cloud.google.com/vpc/docs/configure-serverless-vpc-access + +NOTES + This variant is also available: + + $ gcloud beta compute networks vpc-access connectors update + diff --git a/gcloud/compute/routers/nats/create b/gcloud/compute/routers/nats/create index 29a2638d8..ff839e064 100644 --- a/gcloud/compute/routers/nats/create +++ b/gcloud/compute/routers/nats/create @@ -132,10 +132,13 @@ OPTIONAL FLAGS For VM Endpoints ENDPOINT_TYPE_SWG For Secure Web Gateway Endpoints + ENDPOINT_TYPE_MANAGED_PROXY_LB + For regional Application Load Balancers (internal and external) and regional proxy Network Load Balancers (internal and external) endpoints The default is ENDPOINT_TYPE_VM. - ENDPOINT_TYPE must be one of: ENDPOINT_TYPE_VM, ENDPOINT_TYPE_SWG. + ENDPOINT_TYPE must be one of: ENDPOINT_TYPE_VM, ENDPOINT_TYPE_SWG, + ENDPOINT_TYPE_MANAGED_PROXY_LB. --icmp-idle-timeout=ICMP_IDLE_TIMEOUT Timeout for ICMP connections. See diff --git a/gcloud/compute/tpus/tpu-vm/update b/gcloud/compute/tpus/tpu-vm/update index 6d935dee1..c61e6b38a 100644 --- a/gcloud/compute/tpus/tpu-vm/update +++ b/gcloud/compute/tpus/tpu-vm/update @@ -2,8 +2,10 @@ NAME gcloud compute tpus tpu-vm update - update a Cloud TPU VM node SYNOPSIS - gcloud compute tpus tpu-vm update (TPU : --zone=ZONE) [--async] - [--description=DESCRIPTION] [--internal-ips] [GCLOUD_WIDE_FLAG ...] + gcloud compute tpus tpu-vm update (TPU : --zone=ZONE) + [--add-tags=[TAGS,...]] [--async] [--description=DESCRIPTION] + [--internal-ips] [--clear-tags | --remove-tags=[TAG,...]] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION Update a Cloud TPU VM node. @@ -50,6 +52,12 @@ POSITIONAL ARGUMENTS ▸ set the property compute/zone. FLAGS + --add-tags=[TAGS,...] + Tags to add to the TPU Node. Tags are used to identify valid sources or + targets for network firewalls. See + https://cloud.google.com/vpc/docs/add-remove-network-tags for more + details. + --async Return immediately, without waiting for the operation in progress to complete. @@ -62,6 +70,25 @@ FLAGS default is that external IP addresses will be associated with the TPU workers. + At most one of these can be specified: + + --clear-tags + Remove all tags. If --add-tags is also specified then --clear-tags is + applied first. + + For example, to remove all tags: + + $ gcloud compute tpus tpu-vm update --clear-tags + + To remove all existing tags and create two new tags, 'foo' and 'bar': + + $ gcloud compute tpus tpu-vm update --clear-tags --add-tags foo,bar + + --remove-tags=[TAG,...] + List of tags to remove. If a tag does not exist it is silently + ignored. If --add-tags is also specified then --add-tags is applied + first. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/config/get b/gcloud/config/get index 354698f49..612486311 100644 --- a/gcloud/config/get +++ b/gcloud/config/get @@ -1395,6 +1395,22 @@ AVAILABLE PROPERTIES When a --region flag is required but not provided, the command will fall back to this value, if set. + workstations + cluster + Default cluster to use when working with Workstations resources. + When a --cluster flag is required but not provided, the command + will fall back to this value, if set. + + config + Default configuration to use when working with Workstations + resources. When a --config flag is required but not provided, the + command will fall back to this value, if set. + + region + Default region to use when working with Workstations resources. + When a --region flag is required but not provided, the command will + fall back to this value, if set. + NOTES These variants are also available: diff --git a/gcloud/config/help b/gcloud/config/help index 62f138468..4a8bb3b81 100644 --- a/gcloud/config/help +++ b/gcloud/config/help @@ -1427,6 +1427,22 @@ AVAILABLE PROPERTIES When a --region flag is required but not provided, the command will fall back to this value, if set. + workstations + cluster + Default cluster to use when working with Workstations resources. + When a --cluster flag is required but not provided, the command + will fall back to this value, if set. + + config + Default configuration to use when working with Workstations + resources. When a --config flag is required but not provided, the + command will fall back to this value, if set. + + region + Default region to use when working with Workstations resources. + When a --region flag is required but not provided, the command will + fall back to this value, if set. + NOTES These variants are also available: diff --git a/gcloud/config/list b/gcloud/config/list index f0e190ef8..b7456a66a 100644 --- a/gcloud/config/list +++ b/gcloud/config/list @@ -1439,6 +1439,22 @@ AVAILABLE PROPERTIES When a --region flag is required but not provided, the command will fall back to this value, if set. + workstations + cluster + Default cluster to use when working with Workstations resources. + When a --cluster flag is required but not provided, the command + will fall back to this value, if set. + + config + Default configuration to use when working with Workstations + resources. When a --config flag is required but not provided, the + command will fall back to this value, if set. + + region + Default region to use when working with Workstations resources. + When a --region flag is required but not provided, the command will + fall back to this value, if set. + NOTES These variants are also available: diff --git a/gcloud/config/set b/gcloud/config/set index 54b2f08e6..63dcdf150 100644 --- a/gcloud/config/set +++ b/gcloud/config/set @@ -1442,6 +1442,22 @@ AVAILABLE PROPERTIES When a --region flag is required but not provided, the command will fall back to this value, if set. + workstations + cluster + Default cluster to use when working with Workstations resources. + When a --cluster flag is required but not provided, the command + will fall back to this value, if set. + + config + Default configuration to use when working with Workstations + resources. When a --config flag is required but not provided, the + command will fall back to this value, if set. + + region + Default region to use when working with Workstations resources. + When a --region flag is required but not provided, the command will + fall back to this value, if set. + NOTES These variants are also available: diff --git a/gcloud/config/unset b/gcloud/config/unset index 9909cf2c2..b3db835d7 100644 --- a/gcloud/config/unset +++ b/gcloud/config/unset @@ -1403,6 +1403,22 @@ AVAILABLE PROPERTIES When a --region flag is required but not provided, the command will fall back to this value, if set. + workstations + cluster + Default cluster to use when working with Workstations resources. + When a --cluster flag is required but not provided, the command + will fall back to this value, if set. + + config + Default configuration to use when working with Workstations + resources. When a --config flag is required but not provided, the + command will fall back to this value, if set. + + region + Default region to use when working with Workstations resources. + When a --region flag is required but not provided, the command will + fall back to this value, if set. + NOTES These variants are also available: diff --git a/gcloud/container/clusters/create b/gcloud/container/clusters/create index 8c6a30cb0..3a6d57d5f 100644 --- a/gcloud/container/clusters/create +++ b/gcloud/container/clusters/create @@ -386,10 +386,10 @@ FLAGS Size for node VM boot disks in GB. Defaults to 100GB. --disk-type=DISK_TYPE - Type of the node VM boot disk. For version 1.24.0+, defaults to - pd-balanced. Before version 1.24.0, defaults to pd-standard. DISK_TYPE - must be one of: pd-standard, pd-ssd, pd-balanced, hyperdisk-balanced, - hyperdisk-extreme, hyperdisk-throughput. + Type of the node VM boot disk. For version 1.24 and later, defaults to + pd-balanced. For versions earlier than 1.24, defaults to pd-standard. + DISK_TYPE must be one of: pd-standard, pd-ssd, pd-balanced, + hyperdisk-balanced, hyperdisk-extreme, hyperdisk-throughput. --enable-autorepair Enable node autorepair feature for a cluster's default node pool(s). @@ -656,9 +656,9 @@ FLAGS $ gcloud compute machine-types list - You can also specify custom machine types with the string - "custom-CPUS-RAM" where "CPUS" is the number of virtual CPUs and "RAM" - is the amount of RAM in MiB. + You can also specify custom machine types by providing a string with + the format "custom-CPUS-RAM" where "CPUS" is the number of virtual CPUs + and "RAM" is the amount of RAM in MiB. For example, to create a node pool using custom machines with 2 vCPUs and 12 GB of RAM: diff --git a/gcloud/container/fleet/mesh/disable b/gcloud/container/fleet/mesh/disable index ec0eb1b8c..fd3c8f376 100644 --- a/gcloud/container/fleet/mesh/disable +++ b/gcloud/container/fleet/mesh/disable @@ -12,6 +12,10 @@ EXAMPLES $ gcloud container fleet mesh disable + To delete the fleet-level default Membership configuration, run: + + $ gcloud container fleet mesh disable --fleet-default-member-config + FLAGS --force Disable this feature, even if it is currently in use. Force disablement diff --git a/gcloud/container/fleet/mesh/enable b/gcloud/container/fleet/mesh/enable index 21d8135e3..c0c6eef46 100644 --- a/gcloud/container/fleet/mesh/enable +++ b/gcloud/container/fleet/mesh/enable @@ -12,6 +12,12 @@ EXAMPLES $ gcloud container fleet mesh enable + To enable the Service Mesh Feature with a fleet-level default Membership + configuration, run: + + $ gcloud container fleet mesh enable \ + --fleet-default-member-config=/path/to/service-mesh.yaml + 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/container/fleet/mesh/update b/gcloud/container/fleet/mesh/update index 489b8b011..f67553d9b 100644 --- a/gcloud/container/fleet/mesh/update +++ b/gcloud/container/fleet/mesh/update @@ -4,8 +4,8 @@ NAME SYNOPSIS gcloud container fleet mesh update - (--control-plane=CONTROL_PLANE --management=MANAGEMENT) - [--memberships=[MEMBERSHIPS,...] : --location=LOCATION] + ([(--control-plane=CONTROL_PLANE --management=MANAGEMENT) + : [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]]) [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -20,50 +20,51 @@ EXAMPLES --control-plane=CONTROL_PLANE REQUIRED FLAGS - At least one of these must be specified: + Exactly one of these must be specified: - --control-plane=CONTROL_PLANE - (DEPRECATED) Control plane management to update to. + At least one of these must be specified: - The --control-plane flag is now deprecated. Please use --management - instead. See - https://cloud.google.com/service-mesh/docs/managed/provision-managed-anthos-service-mesh. - CONTROL_PLANE must be one of: automatic, manual. + --control-plane=CONTROL_PLANE + (DEPRECATED) Control plane management to update to. - --management=MANAGEMENT - The management mode to update to. MANAGEMENT must be one of: - automatic, manual. + The --control-plane flag is now deprecated. Please use --management + instead. See + https://cloud.google.com/service-mesh/docs/managed/provision-managed-anthos-service-mesh. + CONTROL_PLANE must be one of: automatic, manual. -OPTIONAL FLAGS - Membership resource - The group of arguments defining one or more - memberships. The arguments in this group can be used to specify the - attributes of this resource. (NOTE) Some attributes are not given - arguments in this group but can be set in other ways. + --management=MANAGEMENT + The management mode to update to. MANAGEMENT must be one of: + automatic, manual. - To set the project attribute: - ◆ provide the argument --memberships on the command line with a fully - specified name; - ◆ provide the argument --project on the command line; - ◆ set the property core/project. + Membership resource - The group of arguments defining one or more + memberships. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. - --memberships=[MEMBERSHIPS,...] - IDs of the memberships or fully qualified identifiers for the - memberships. + To set the project attribute: + ▸ provide the argument --memberships on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. - To set the memberships attribute: - ▸ provide the argument --memberships on the command line. + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. - This flag argument must be specified if any of the other arguments in - this group are specified. + To set the memberships attribute: + ▫ provide the argument --memberships on the command line. - --location=LOCATION - Location for the memberships. + This flag argument must be specified if any of the other arguments + in this group are specified. - To set the location attribute: - ▸ provide the argument --memberships on the command line with a - fully specified name; - ▸ provide the argument --location on the command line; - ▸ set the property gkehub/location. + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --location on the command line; + ▫ set the property gkehub/location. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/container/hub/mesh/disable b/gcloud/container/hub/mesh/disable index f68bdfe80..e73e147c0 100644 --- a/gcloud/container/hub/mesh/disable +++ b/gcloud/container/hub/mesh/disable @@ -12,6 +12,10 @@ EXAMPLES $ gcloud container hub mesh disable + To delete the fleet-level default Membership configuration, run: + + $ gcloud container hub mesh disable --fleet-default-member-config + FLAGS --force Disable this feature, even if it is currently in use. Force disablement diff --git a/gcloud/container/hub/mesh/enable b/gcloud/container/hub/mesh/enable index ab199d42a..72dd739e0 100644 --- a/gcloud/container/hub/mesh/enable +++ b/gcloud/container/hub/mesh/enable @@ -12,6 +12,12 @@ EXAMPLES $ gcloud container hub mesh enable + To enable the Service Mesh Feature with a fleet-level default Membership + configuration, run: + + $ gcloud container hub mesh enable \ + --fleet-default-member-config=/path/to/service-mesh.yaml + 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/container/hub/mesh/update b/gcloud/container/hub/mesh/update index e22a90da6..709a41dd6 100644 --- a/gcloud/container/hub/mesh/update +++ b/gcloud/container/hub/mesh/update @@ -4,8 +4,8 @@ NAME SYNOPSIS gcloud container hub mesh update - (--control-plane=CONTROL_PLANE --management=MANAGEMENT) - [--memberships=[MEMBERSHIPS,...] : --location=LOCATION] + ([(--control-plane=CONTROL_PLANE --management=MANAGEMENT) + : [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]]) [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -20,50 +20,51 @@ EXAMPLES --control-plane=CONTROL_PLANE REQUIRED FLAGS - At least one of these must be specified: + Exactly one of these must be specified: - --control-plane=CONTROL_PLANE - (DEPRECATED) Control plane management to update to. + At least one of these must be specified: - The --control-plane flag is now deprecated. Please use --management - instead. See - https://cloud.google.com/service-mesh/docs/managed/provision-managed-anthos-service-mesh. - CONTROL_PLANE must be one of: automatic, manual. + --control-plane=CONTROL_PLANE + (DEPRECATED) Control plane management to update to. - --management=MANAGEMENT - The management mode to update to. MANAGEMENT must be one of: - automatic, manual. + The --control-plane flag is now deprecated. Please use --management + instead. See + https://cloud.google.com/service-mesh/docs/managed/provision-managed-anthos-service-mesh. + CONTROL_PLANE must be one of: automatic, manual. -OPTIONAL FLAGS - Membership resource - The group of arguments defining one or more - memberships. The arguments in this group can be used to specify the - attributes of this resource. (NOTE) Some attributes are not given - arguments in this group but can be set in other ways. + --management=MANAGEMENT + The management mode to update to. MANAGEMENT must be one of: + automatic, manual. - To set the project attribute: - ◆ provide the argument --memberships on the command line with a fully - specified name; - ◆ provide the argument --project on the command line; - ◆ set the property core/project. + Membership resource - The group of arguments defining one or more + memberships. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. - --memberships=[MEMBERSHIPS,...] - IDs of the memberships or fully qualified identifiers for the - memberships. + To set the project attribute: + ▸ provide the argument --memberships on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. - To set the memberships attribute: - ▸ provide the argument --memberships on the command line. + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. - This flag argument must be specified if any of the other arguments in - this group are specified. + To set the memberships attribute: + ▫ provide the argument --memberships on the command line. - --location=LOCATION - Location for the memberships. + This flag argument must be specified if any of the other arguments + in this group are specified. - To set the location attribute: - ▸ provide the argument --memberships on the command line with a - fully specified name; - ▸ provide the argument --location on the command line; - ▸ set the property gkehub/location. + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --location on the command line; + ▫ set the property gkehub/location. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/container/node-pools/create b/gcloud/container/node-pools/create index 007f28f59..06a24c92c 100644 --- a/gcloud/container/node-pools/create +++ b/gcloud/container/node-pools/create @@ -182,10 +182,10 @@ FLAGS Size for node VM boot disks in GB. Defaults to 100GB. --disk-type=DISK_TYPE - Type of the node VM boot disk. For version 1.24.0+, defaults to - pd-balanced. Before version 1.24.0, defaults to pd-standard. DISK_TYPE - must be one of: pd-standard, pd-ssd, pd-balanced, hyperdisk-balanced, - hyperdisk-extreme, hyperdisk-throughput. + Type of the node VM boot disk. For version 1.24 and later, defaults to + pd-balanced. For versions earlier than 1.24, defaults to pd-standard. + DISK_TYPE must be one of: pd-standard, pd-ssd, pd-balanced, + hyperdisk-balanced, hyperdisk-extreme, hyperdisk-throughput. --enable-autoprovisioning Enables Cluster Autoscaler to treat the node pool as if it was @@ -286,9 +286,9 @@ FLAGS $ gcloud compute machine-types list - You can also specify custom machine types with the string - "custom-CPUS-RAM" where "CPUS" is the number of virtual CPUs and "RAM" - is the amount of RAM in MiB. + You can also specify custom machine types by providing a string with + the format "custom-CPUS-RAM" where "CPUS" is the number of virtual CPUs + and "RAM" is the amount of RAM in MiB. For example, to create a node pool using custom machines with 2 vCPUs and 12 GB of RAM: diff --git a/gcloud/container/node-pools/update b/gcloud/container/node-pools/update index 49cf74641..bb95e3bbc 100644 --- a/gcloud/container/node-pools/update +++ b/gcloud/container/node-pools/update @@ -12,9 +12,11 @@ SYNOPSIS | --node-taints=[NODE_TAINT,...] | --system-config-from-file=SYSTEM_CONFIG_FROM_FILE | --tags=[TAG,...] | --windows-os-version=WINDOWS_OS_VERSION - | --workload-metadata=WORKLOAD_METADATA | --enable-autoprovisioning - --enable-autoscaling --location-policy=LOCATION_POLICY - --max-nodes=MAX_NODES --min-nodes=MIN_NODES + | --workload-metadata=WORKLOAD_METADATA | --disk-size=DISK_SIZE + --disk-type=DISK_TYPE --machine-type=MACHINE_TYPE + | --enable-autoprovisioning --enable-autoscaling + --location-policy=LOCATION_POLICY --max-nodes=MAX_NODES + --min-nodes=MIN_NODES --total-max-nodes=TOTAL_MAX_NODES --total-min-nodes=TOTAL_MIN_NODES | --enable-autorepair --enable-autoupgrade | --enable-blue-green-upgrade --enable-surge-upgrade @@ -248,6 +250,35 @@ REQUIRED FLAGS This feature can only be enabled if Workload Identity is enabled at the cluster level. + Node config + + --disk-size=DISK_SIZE + Size for node VM boot disks in GB. Defaults to 100GB. + + --disk-type=DISK_TYPE + Type of the node VM boot disk. For version 1.24 and later, defaults + to pd-balanced. For versions earlier than 1.24, defaults to + pd-standard. DISK_TYPE must be one of: pd-standard, pd-ssd, + pd-balanced, hyperdisk-balanced, hyperdisk-extreme, + hyperdisk-throughput. + + --machine-type=MACHINE_TYPE + The type of machine to use for nodes. Defaults to e2-medium. The + list of predefined machine types is available using the following + command: + + $ gcloud compute machine-types list + + You can also specify custom machine types by providing a string + with the format "custom-CPUS-RAM" where "CPUS" is the number of + virtual CPUs and "RAM" is the amount of RAM in MiB. + + For example, to create a node pool using custom machines with 2 + vCPUs and 12 GB of RAM: + + $ gcloud container node-pools update high-mem-pool \ + --machine-type=custom-2-12288 + Cluster autoscaling --enable-autoprovisioning diff --git a/gcloud/container/vmware/clusters/create b/gcloud/container/vmware/clusters/create index 1a298a7ed..c0740bba8 100644 --- a/gcloud/container/vmware/clusters/create +++ b/gcloud/container/vmware/clusters/create @@ -29,7 +29,9 @@ SYNOPSIS [ips=IPS],[netmask=NETMASK]) [--admin-users=ADMIN_USERS] [--annotations=[KEY=VALUE,...]] [--async] [--description=DESCRIPTION] [--disable-aag-config] [--disable-vsphere-csi] [--enable-auto-repair] - [--enable-vm-tracking] [--validate-only] + [--enable-vm-tracking] + [--upgrade-policy=[control-plane-only=CONTROL-PLANE-ONLY]] + [--validate-only] [--cpus=CPUS --enable-auto-resize --memory=MEMORY --replicas=REPLICAS] [--disable-control-plane-v2 | --enable-control-plane-v2] [--enable-advanced-networking --enable-dataplane-v2] @@ -333,6 +335,40 @@ OPTIONAL FLAGS --enable-vm-tracking If set, enable VM tracking. + Upgrade policy for the cluster. + + --upgrade-policy=[control-plane-only=CONTROL-PLANE-ONLY] + If not specified, control-plane-only is set to False. In the next + upgrade operation, all worker node pools will be upgraded together + with the control plane. + + Example: + + To upgrade the control plane only and keep worker node pools version unchanged, first specify the policy: + + $ gcloud container vmware clusters create CLUSTER \ + --upgrade-policy control-plane-only=True + + Then to start the upgrade operation using the specified policy, run: + + $ gcloud container vmware clusters upgrade CLUSTER --version=VERSION + + After upgrading only the cluster control plane, to upgrade an individual node pool, run: + + $ gcloud container vmware node-pools update NODE_POOL \ + --version=VERSION + + Example: + + Alternatively, to upgrade both the control plane and all worker node pools, first specify the policy: + + $ gcloud container vmware clusters create CLUSTER \ + --upgrade-policy control-plane-only=False + + Then to start the upgrade operation using the specified policy, run: + + $ gcloud container vmware clusters upgrade CLUSTER --version=VERSION + --validate-only If set, only validate the request, but do not actually perform the operation. diff --git a/gcloud/container/vmware/clusters/update b/gcloud/container/vmware/clusters/update index 0b0efea39..bbcb278a2 100644 --- a/gcloud/container/vmware/clusters/update +++ b/gcloud/container/vmware/clusters/update @@ -9,7 +9,9 @@ SYNOPSIS [avoid-buggy-ips=AVOID-BUGGY-IPS], [manual-assign=MANUAL-ASSIGN],[pool=POOL]] [--static-ip-config-ip-blocks=[gateway=GATEWAY], - [ips=IPS],[netmask=NETMASK]] [--validate-only] [--version=VERSION] + [ips=IPS],[netmask=NETMASK]] + [--upgrade-policy=[control-plane-only=CONTROL-PLANE-ONLY]] + [--validate-only] [--version=VERSION] [--add-annotations=[KEY1=VALUE1,KEY2=VALUE2,...] | --remove-annotations=[KEY1,KEY2,...]] [--cpus=CPUS --memory=MEMORY --disable-auto-resize @@ -130,6 +132,40 @@ FLAGS Use quote around the flag value to escape semicolon in the terminal. + Upgrade policy for the cluster. + + --upgrade-policy=[control-plane-only=CONTROL-PLANE-ONLY] + If not specified, control-plane-only is set to False. In the next + upgrade operation, all worker node pools will be upgraded together + with the control plane. + + Example: + + To upgrade the control plane only and keep worker node pools version unchanged, first specify the policy: + + $ gcloud container vmware clusters update CLUSTER \ + --upgrade-policy control-plane-only=True + + Then to start the upgrade operation using the specified policy, run: + + $ gcloud container vmware clusters upgrade CLUSTER --version=VERSION + + After upgrading only the cluster control plane, to upgrade an individual node pool, run: + + $ gcloud container vmware node-pools update NODE_POOL \ + --version=VERSION + + Example: + + Alternatively, to upgrade both the control plane and all worker node pools, first specify the policy: + + $ gcloud container vmware clusters update CLUSTER \ + --upgrade-policy control-plane-only=False + + Then to start the upgrade operation using the specified policy, run: + + $ gcloud container vmware clusters upgrade CLUSTER --version=VERSION + --validate-only If set, only validate the request, but do not actually perform the operation. diff --git a/gcloud/dataproc/jobs/submit/flink b/gcloud/dataproc/jobs/submit/flink index 34d3f8e1c..dccaf5d6e 100644 --- a/gcloud/dataproc/jobs/submit/flink +++ b/gcloud/dataproc/jobs/submit/flink @@ -5,7 +5,9 @@ SYNOPSIS gcloud dataproc jobs submit flink (--class=MAIN_CLASS | --jar=MAIN_JAR) (--cluster=CLUSTER | --cluster-labels=[KEY=VALUE,...]) [--async] [--bucket=BUCKET] [--driver-log-levels=[PACKAGE=LEVEL,...]] - [--jars=[JAR,...]] [--labels=[KEY=VALUE,...]] + [--driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB] + [--driver-required-vcores=DRIVER_REQUIRED_VCORES] [--jars=[JAR,...]] + [--labels=[KEY=VALUE,...]] [--max-failures-per-hour=MAX_FAILURES_PER_HOUR] [--max-failures-total=MAX_FAILURES_TOTAL] [--properties=[PROPERTY=VALUE,...]] [--properties-file=PROPERTIES_FILE] @@ -78,6 +80,16 @@ OPTIONAL FLAGS List of package to log4j log level pairs to configure driver logging. For example: root=FATAL,com.example=INFO. + --driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB + The memory allocation requested by the job driver in megabytes (MB) for + execution on the driver node group (it is used only by clusters with a + driver node group). + + --driver-required-vcores=DRIVER_REQUIRED_VCORES + The vCPU allocation requested by the job driver for execution on the + driver node group (it is used only by clusters with a driver node + group). + --jars=[JAR,...] Comma-separated list of jar files to provide to the task manager classpaths. diff --git a/gcloud/dataproc/jobs/submit/hadoop b/gcloud/dataproc/jobs/submit/hadoop index 71ed3c33e..76b3d1c8e 100644 --- a/gcloud/dataproc/jobs/submit/hadoop +++ b/gcloud/dataproc/jobs/submit/hadoop @@ -5,7 +5,9 @@ SYNOPSIS gcloud dataproc jobs submit hadoop (--class=MAIN_CLASS | --jar=MAIN_JAR) (--cluster=CLUSTER | --cluster-labels=[KEY=VALUE,...]) [--archives=[ARCHIVE,...]] [--async] [--bucket=BUCKET] - [--driver-log-levels=[PACKAGE=LEVEL,...]] [--files=[FILE,...]] + [--driver-log-levels=[PACKAGE=LEVEL,...]] + [--driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB] + [--driver-required-vcores=DRIVER_REQUIRED_VCORES] [--files=[FILE,...]] [--jars=[JAR,...]] [--labels=[KEY=VALUE,...]] [--max-failures-per-hour=MAX_FAILURES_PER_HOUR] [--max-failures-total=MAX_FAILURES_TOTAL] @@ -82,6 +84,16 @@ OPTIONAL FLAGS A list of package to log4j log level pairs to configure driver logging. For example: root=FATAL,com.example=INFO + --driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB + The memory allocation requested by the job driver in megabytes (MB) for + execution on the driver node group (it is used only by clusters with a + driver node group). + + --driver-required-vcores=DRIVER_REQUIRED_VCORES + The vCPU allocation requested by the job driver for execution on the + driver node group (it is used only by clusters with a driver node + group). + --files=[FILE,...] Comma separated list of file paths to be provided to the job. A file path can either be a path to a local file or a path to a file already diff --git a/gcloud/dataproc/jobs/submit/hive b/gcloud/dataproc/jobs/submit/hive index 8d404b10b..e3c7a2dd5 100644 --- a/gcloud/dataproc/jobs/submit/hive +++ b/gcloud/dataproc/jobs/submit/hive @@ -5,7 +5,9 @@ SYNOPSIS gcloud dataproc jobs submit hive (--cluster=CLUSTER | --cluster-labels=[KEY=VALUE,...]) (--execute=QUERY, -e QUERY | --file=FILE, -f FILE) [--async] - [--bucket=BUCKET] [--continue-on-failure] [--jars=[JAR,...]] + [--bucket=BUCKET] [--continue-on-failure] + [--driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB] + [--driver-required-vcores=DRIVER_REQUIRED_VCORES] [--jars=[JAR,...]] [--labels=[KEY=VALUE,...]] [--max-failures-per-hour=MAX_FAILURES_PER_HOUR] [--max-failures-total=MAX_FAILURES_TOTAL] [--params=[PARAM=VALUE,...]] @@ -63,6 +65,16 @@ OPTIONAL FLAGS --continue-on-failure Whether to continue if a single query fails. + --driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB + The memory allocation requested by the job driver in megabytes (MB) for + execution on the driver node group (it is used only by clusters with a + driver node group). + + --driver-required-vcores=DRIVER_REQUIRED_VCORES + The vCPU allocation requested by the job driver for execution on the + driver node group (it is used only by clusters with a driver node + group). + --jars=[JAR,...] Comma separated list of jar files to be provided to the Hive and MR. May contain UDFs. diff --git a/gcloud/dataproc/jobs/submit/pig b/gcloud/dataproc/jobs/submit/pig index cec5c0191..e487f8eca 100644 --- a/gcloud/dataproc/jobs/submit/pig +++ b/gcloud/dataproc/jobs/submit/pig @@ -6,7 +6,9 @@ SYNOPSIS (--cluster=CLUSTER | --cluster-labels=[KEY=VALUE,...]) (--execute=QUERY, -e QUERY | --file=FILE, -f FILE) [--async] [--bucket=BUCKET] [--continue-on-failure] - [--driver-log-levels=[PACKAGE=LEVEL,...]] [--jars=[JAR,...]] + [--driver-log-levels=[PACKAGE=LEVEL,...]] + [--driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB] + [--driver-required-vcores=DRIVER_REQUIRED_VCORES] [--jars=[JAR,...]] [--labels=[KEY=VALUE,...]] [--max-failures-per-hour=MAX_FAILURES_PER_HOUR] [--max-failures-total=MAX_FAILURES_TOTAL] [--params=[PARAM=VALUE,...]] @@ -71,6 +73,16 @@ OPTIONAL FLAGS A list of package to log4j log level pairs to configure driver logging. For example: root=FATAL,com.example=INFO + --driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB + The memory allocation requested by the job driver in megabytes (MB) for + execution on the driver node group (it is used only by clusters with a + driver node group). + + --driver-required-vcores=DRIVER_REQUIRED_VCORES + The vCPU allocation requested by the job driver for execution on the + driver node group (it is used only by clusters with a driver node + group). + --jars=[JAR,...] Comma separated list of jar files to be provided to Pig and MR. May contain UDFs. diff --git a/gcloud/dataproc/jobs/submit/presto b/gcloud/dataproc/jobs/submit/presto index c5e22a473..cdbdfd5d0 100644 --- a/gcloud/dataproc/jobs/submit/presto +++ b/gcloud/dataproc/jobs/submit/presto @@ -7,6 +7,8 @@ SYNOPSIS (--execute=QUERY, -e QUERY | --file=FILE, -f FILE) [--async] [--bucket=BUCKET] [--client-tags=[CLIENT_TAG,...]] [--continue-on-failure] [--driver-log-levels=[PACKAGE=LEVEL,...]] + [--driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB] + [--driver-required-vcores=DRIVER_REQUIRED_VCORES] [--labels=[KEY=VALUE,...]] [--max-failures-per-hour=MAX_FAILURES_PER_HOUR] [--max-failures-total=MAX_FAILURES_TOTAL] @@ -71,6 +73,16 @@ OPTIONAL FLAGS A list of package-to-log4j log level pairs to configure driver logging. For example: root=FATAL,com.example=INFO + --driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB + The memory allocation requested by the job driver in megabytes (MB) for + execution on the driver node group (it is used only by clusters with a + driver node group). + + --driver-required-vcores=DRIVER_REQUIRED_VCORES + The vCPU allocation requested by the job driver for execution on the + driver node group (it is used only by clusters with a driver node + group). + --labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to add. diff --git a/gcloud/dataproc/jobs/submit/pyspark b/gcloud/dataproc/jobs/submit/pyspark index 4d5f342d6..e222fa635 100644 --- a/gcloud/dataproc/jobs/submit/pyspark +++ b/gcloud/dataproc/jobs/submit/pyspark @@ -5,7 +5,9 @@ SYNOPSIS gcloud dataproc jobs submit pyspark PY_FILE (--cluster=CLUSTER | --cluster-labels=[KEY=VALUE,...]) [--archives=[ARCHIVE,...]] [--async] [--bucket=BUCKET] - [--driver-log-levels=[PACKAGE=LEVEL,...]] [--files=[FILE,...]] + [--driver-log-levels=[PACKAGE=LEVEL,...]] + [--driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB] + [--driver-required-vcores=DRIVER_REQUIRED_VCORES] [--files=[FILE,...]] [--jars=[JAR,...]] [--labels=[KEY=VALUE,...]] [--max-failures-per-hour=MAX_FAILURES_PER_HOUR] [--max-failures-total=MAX_FAILURES_TOTAL] @@ -73,6 +75,16 @@ OPTIONAL FLAGS package and value is the log4j log level. For example: root=FATAL,com.example=INFO + --driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB + The memory allocation requested by the job driver in megabytes (MB) for + execution on the driver node group (it is used only by clusters with a + driver node group). + + --driver-required-vcores=DRIVER_REQUIRED_VCORES + The vCPU allocation requested by the job driver for execution on the + driver node group (it is used only by clusters with a driver node + group). + --files=[FILE,...] Comma separated list of files to be placed in the working directory of both the app master and executors. diff --git a/gcloud/dataproc/jobs/submit/spark b/gcloud/dataproc/jobs/submit/spark index c4fd4d80c..81e92009f 100644 --- a/gcloud/dataproc/jobs/submit/spark +++ b/gcloud/dataproc/jobs/submit/spark @@ -5,7 +5,9 @@ SYNOPSIS gcloud dataproc jobs submit spark (--class=MAIN_CLASS | --jar=MAIN_JAR) (--cluster=CLUSTER | --cluster-labels=[KEY=VALUE,...]) [--archives=[ARCHIVE,...]] [--async] [--bucket=BUCKET] - [--driver-log-levels=[PACKAGE=LEVEL,...]] [--files=[FILE,...]] + [--driver-log-levels=[PACKAGE=LEVEL,...]] + [--driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB] + [--driver-required-vcores=DRIVER_REQUIRED_VCORES] [--files=[FILE,...]] [--jars=[JAR,...]] [--labels=[KEY=VALUE,...]] [--max-failures-per-hour=MAX_FAILURES_PER_HOUR] [--max-failures-total=MAX_FAILURES_TOTAL] @@ -84,6 +86,16 @@ OPTIONAL FLAGS List of package to log4j log level pairs to configure driver logging. For example: root=FATAL,com.example=INFO + --driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB + The memory allocation requested by the job driver in megabytes (MB) for + execution on the driver node group (it is used only by clusters with a + driver node group). + + --driver-required-vcores=DRIVER_REQUIRED_VCORES + The vCPU allocation requested by the job driver for execution on the + driver node group (it is used only by clusters with a driver node + group). + --files=[FILE,...] Comma separated list of files to be placed in the working directory of both the app master and executors. diff --git a/gcloud/dataproc/jobs/submit/spark-r b/gcloud/dataproc/jobs/submit/spark-r index ee0467c1e..0ba7f22b8 100644 --- a/gcloud/dataproc/jobs/submit/spark-r +++ b/gcloud/dataproc/jobs/submit/spark-r @@ -5,7 +5,9 @@ SYNOPSIS gcloud dataproc jobs submit spark-r R_FILE (--cluster=CLUSTER | --cluster-labels=[KEY=VALUE,...]) [--archives=[ARCHIVE,...]] [--async] [--bucket=BUCKET] - [--driver-log-levels=[PACKAGE=LEVEL,...]] [--files=[FILE,...]] + [--driver-log-levels=[PACKAGE=LEVEL,...]] + [--driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB] + [--driver-required-vcores=DRIVER_REQUIRED_VCORES] [--files=[FILE,...]] [--labels=[KEY=VALUE,...]] [--max-failures-per-hour=MAX_FAILURES_PER_HOUR] [--max-failures-total=MAX_FAILURES_TOTAL] @@ -71,6 +73,16 @@ OPTIONAL FLAGS package and value is the log4j log level. For example: root=FATAL,com.example=INFO + --driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB + The memory allocation requested by the job driver in megabytes (MB) for + execution on the driver node group (it is used only by clusters with a + driver node group). + + --driver-required-vcores=DRIVER_REQUIRED_VCORES + The vCPU allocation requested by the job driver for execution on the + driver node group (it is used only by clusters with a driver node + group). + --files=[FILE,...] Comma separated list of files to be placed in the working directory of both the app master and executors. diff --git a/gcloud/dataproc/jobs/submit/spark-sql b/gcloud/dataproc/jobs/submit/spark-sql index a8c7b49ed..1cac69ebf 100644 --- a/gcloud/dataproc/jobs/submit/spark-sql +++ b/gcloud/dataproc/jobs/submit/spark-sql @@ -6,7 +6,9 @@ SYNOPSIS (--cluster=CLUSTER | --cluster-labels=[KEY=VALUE,...]) (--execute=QUERY, -e QUERY | --file=FILE, -f FILE) [--async] [--bucket=BUCKET] [--driver-log-levels=[PACKAGE=LEVEL,...]] - [--jars=[JAR,...]] [--labels=[KEY=VALUE,...]] + [--driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB] + [--driver-required-vcores=DRIVER_REQUIRED_VCORES] [--jars=[JAR,...]] + [--labels=[KEY=VALUE,...]] [--max-failures-per-hour=MAX_FAILURES_PER_HOUR] [--max-failures-total=MAX_FAILURES_TOTAL] [--params=[PARAM=VALUE,...]] [--properties=[PROPERTY=VALUE,...]] [--properties-file=PROPERTIES_FILE] @@ -64,6 +66,16 @@ OPTIONAL FLAGS A list of package to log4j log level pairs to configure driver logging. For example: root=FATAL,com.example=INFO + --driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB + The memory allocation requested by the job driver in megabytes (MB) for + execution on the driver node group (it is used only by clusters with a + driver node group). + + --driver-required-vcores=DRIVER_REQUIRED_VCORES + The vCPU allocation requested by the job driver for execution on the + driver node group (it is used only by clusters with a driver node + group). + --jars=[JAR,...] Comma separated list of jar files to be provided to the executor and driver classpaths. May contain UDFs. diff --git a/gcloud/dataproc/jobs/submit/trino b/gcloud/dataproc/jobs/submit/trino index 110c6a3a7..7a69cb98a 100644 --- a/gcloud/dataproc/jobs/submit/trino +++ b/gcloud/dataproc/jobs/submit/trino @@ -7,6 +7,8 @@ SYNOPSIS (--execute=QUERY, -e QUERY | --file=FILE, -f FILE) [--async] [--bucket=BUCKET] [--client-tags=[CLIENT_TAG,...]] [--continue-on-failure] [--driver-log-levels=[PACKAGE=LEVEL,...]] + [--driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB] + [--driver-required-vcores=DRIVER_REQUIRED_VCORES] [--labels=[KEY=VALUE,...]] [--max-failures-per-hour=MAX_FAILURES_PER_HOUR] [--max-failures-total=MAX_FAILURES_TOTAL] @@ -71,6 +73,16 @@ OPTIONAL FLAGS A list of package-to-log4j log level pairs to configure driver logging. For example: root=FATAL,com.example=INFO + --driver-required-memory-mb=DRIVER_REQUIRED_MEMORY_MB + The memory allocation requested by the job driver in megabytes (MB) for + execution on the driver node group (it is used only by clusters with a + driver node group). + + --driver-required-vcores=DRIVER_REQUIRED_VCORES + The vCPU allocation requested by the job driver for execution on the + driver node group (it is used only by clusters with a driver node + group). + --labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to add. diff --git a/gcloud/domains/registrations/configure/contacts b/gcloud/domains/registrations/configure/contacts index 3314af661..9f24a578c 100644 --- a/gcloud/domains/registrations/configure/contacts +++ b/gcloud/domains/registrations/configure/contacts @@ -136,10 +136,12 @@ COMMONLY USED FLAGS domain. CONTACT_PRIVACY must be one of: private-contact-data - Your contact info won't be available to the public. To help protect - your info and prevent spam, a third party provides alternate - (proxy) contact info for your domain in the public directory at no - extra cost. They will forward received messages to you. + (DEPRECATED) Your contact info won't be available to the public. To + help protect your info and prevent spam, a third party provides + alternate (proxy) contact info for your domain in the public + directory at no extra cost. They will forward received messages to + you. The private-contact-data option is deprecated; See + https://cloud.google.com/domains/docs/deprecations/feature-deprecations. public-contact-data All the data from contact config is publicly available. To set this value, you must also pass the --notices flag with value diff --git a/gcloud/domains/registrations/configure/dns b/gcloud/domains/registrations/configure/dns index 600abae84..0dc2e8a0b 100644 --- a/gcloud/domains/registrations/configure/dns +++ b/gcloud/domains/registrations/configure/dns @@ -128,9 +128,12 @@ COMMONLY USED FLAGS List of DNS name servers for the domain. --use-google-domains-dns - Use free name servers provided by Google Domains. If the zone is - signed, DNSSEC will be enabled by default unless you pass - --disable-dnssec. + (DEPRECATED) Use free name servers provided by Google Domains. If + the zone is signed, DNSSEC will be enabled by default unless you + pass --disable-dnssec. + + The --use-google-domains-dns option is deprecated; See + https://cloud.google.com/domains/docs/deprecations/feature-deprecations. OTHER FLAGS --async diff --git a/gcloud/domains/registrations/export b/gcloud/domains/registrations/export index 9b8f05b54..ba585e4ee 100644 --- a/gcloud/domains/registrations/export +++ b/gcloud/domains/registrations/export @@ -6,6 +6,11 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) Export a Cloud Domains registration. + + This command is deprecated. See + https://cloud.google.com/domains/docs/deprecations/feature-deprecations. + Export the domain to direct management by Google Domains. The domain remains valid until expiry. diff --git a/gcloud/domains/registrations/help b/gcloud/domains/registrations/help index 68b100def..f5e15b14e 100644 --- a/gcloud/domains/registrations/help +++ b/gcloud/domains/registrations/help @@ -35,7 +35,7 @@ COMMANDS Describe an existing Cloud Domains registration. export - Export a Cloud Domains registration. + (DEPRECATED) Export a Cloud Domains registration. get-register-parameters Get register parameters (including availability) of a specific domain. @@ -44,7 +44,8 @@ COMMANDS Get transfer parameters of a specific domain. import - Import a domain from Google Domains registrar to Cloud Domains. + (DEPRECATED) Import a domain from Google Domains registrar to Cloud + Domains. list List Cloud Domains registrations. @@ -59,7 +60,7 @@ COMMANDS Search for available domains. transfer - Transfer a domain from another registrar. + (DEPRECATED) Transfer a domain from another registrar. update Update a Cloud Domains registration. diff --git a/gcloud/domains/registrations/import b/gcloud/domains/registrations/import index 68ddc53e8..3e8d248f9 100644 --- a/gcloud/domains/registrations/import +++ b/gcloud/domains/registrations/import @@ -7,6 +7,12 @@ SYNOPSIS [--labels=[KEY=VALUE,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) Import a domain from Google Domains registrar to Cloud + Domains. + + This command is deprecated. See + https://cloud.google.com/domains/docs/deprecations/feature-deprecations. + Create a new Cloud Domains registration resource by importing an existing domain from Google Domains registrar. The new resource's ID will be equal to the domain name. diff --git a/gcloud/domains/registrations/register b/gcloud/domains/registrations/register index 5690c0f48..380a3aee9 100644 --- a/gcloud/domains/registrations/register +++ b/gcloud/domains/registrations/register @@ -137,10 +137,12 @@ COMMONLY USED FLAGS domain. CONTACT_PRIVACY must be one of: private-contact-data - Your contact info won't be available to the public. To help protect - your info and prevent spam, a third party provides alternate - (proxy) contact info for your domain in the public directory at no - extra cost. They will forward received messages to you. + (DEPRECATED) Your contact info won't be available to the public. To + help protect your info and prevent spam, a third party provides + alternate (proxy) contact info for your domain in the public + directory at no extra cost. They will forward received messages to + you. The private-contact-data option is deprecated; See + https://cloud.google.com/domains/docs/deprecations/feature-deprecations. public-contact-data All the data from contact config is publicly available. To set this value, you must also pass the --notices flag with value @@ -170,10 +172,13 @@ COMMONLY USED FLAGS List of DNS name servers for the domain. --use-google-domains-dns - Use free name servers provided by Google Domains. If the zone is - signed, DNSSEC will be enabled by default unless you pass + (DEPRECATED) Use free name servers provided by Google Domains. If the + zone is signed, DNSSEC will be enabled by default unless you pass --disable-dnssec. + The --use-google-domains-dns option is deprecated; See + https://cloud.google.com/domains/docs/deprecations/feature-deprecations. + OTHER FLAGS --async Return immediately, without waiting for the operation in progress to diff --git a/gcloud/domains/registrations/transfer b/gcloud/domains/registrations/transfer index 2721d6109..5ddf4f6c2 100644 --- a/gcloud/domains/registrations/transfer +++ b/gcloud/domains/registrations/transfer @@ -13,6 +13,11 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) Transfer a domain from another registrar. + + This command is deprecated. See + https://cloud.google.com/domains/docs/deprecations/feature-deprecations. + Create a new Cloud Domains registration resource by transferring an existing domain from another registrar. The new resource's ID will be equal to the domain name. @@ -142,10 +147,12 @@ COMMONLY USED FLAGS domain. CONTACT_PRIVACY must be one of: private-contact-data - Your contact info won't be available to the public. To help protect - your info and prevent spam, a third party provides alternate - (proxy) contact info for your domain in the public directory at no - extra cost. They will forward received messages to you. + (DEPRECATED) Your contact info won't be available to the public. To + help protect your info and prevent spam, a third party provides + alternate (proxy) contact info for your domain in the public + directory at no extra cost. They will forward received messages to + you. The private-contact-data option is deprecated; See + https://cloud.google.com/domains/docs/deprecations/feature-deprecations. public-contact-data All the data from contact config is publicly available. To set this value, you must also pass the --notices flag with value @@ -192,10 +199,13 @@ COMMONLY USED FLAGS case for DNS services provided for free by the registrar. --use-google-domains-dns - Use free name servers provided by Google Domains. This blank-slate - option cannot be configured before transfer. DNSSEC will be - disabled and will need to be enabled after the transfer completes, - if desired. + (DEPRECATED) Use free name servers provided by Google Domains. This + blank-slate option cannot be configured before transfer. DNSSEC + will be disabled and will need to be enabled after the transfer + completes, if desired. + + The --use-google-domains-dns option is deprecated; See + https://cloud.google.com/domains/docs/deprecations/feature-deprecations. OTHER FLAGS --async diff --git a/gcloud/iam/workload-identity-pools/create-cred-config b/gcloud/iam/workload-identity-pools/create-cred-config index da2a60f25..3a11528b5 100644 --- a/gcloud/iam/workload-identity-pools/create-cred-config +++ b/gcloud/iam/workload-identity-pools/create-cred-config @@ -75,7 +75,7 @@ EXAMPLES POSITIONAL ARGUMENTS AUDIENCE - The workload identity pool provider resource name. + The workload identity pool provider resource ID. REQUIRED FLAGS --output-file=OUTPUT_FILE diff --git a/gcloud/infra-manager/deployments/apply b/gcloud/infra-manager/deployments/apply index ef129d2c8..c81c8324f 100644 --- a/gcloud/infra-manager/deployments/apply +++ b/gcloud/infra-manager/deployments/apply @@ -4,9 +4,8 @@ NAME SYNOPSIS gcloud infra-manager deployments apply (DEPLOYMENT : --location=LOCATION) [--artifacts-gcs-bucket=ARTIFACTS_GCS_BUCKET] [--async] - [--import-existing-resources=IMPORT_EXISTING_RESOURCES] - [--labels=[KEY=VALUE,...]] [--service-account=SERVICE_ACCOUNT] - [--worker-pool=WORKER_POOL] + [--import-existing-resources] [--labels=[KEY=VALUE,...]] + [--service-account=SERVICE_ACCOUNT] [--worker-pool=WORKER_POOL] [--gcs-source=GCS_SOURCE | --git-source-directory=GIT_SOURCE_DIRECTORY --git-source-ref=GIT_SOURCE_REF --git-source-repo=GIT_SOURCE_REPO | --ignore-file=IGNORE_FILE @@ -86,7 +85,7 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. - --import-existing-resources=IMPORT_EXISTING_RESOURCES + --import-existing-resources By default, Infrastructure Manager will return a failure when Terraform encounters a 409 code (resource conflict error) during actuation. If this flag is set to true, Infrastructure Manager will instead attempt diff --git a/gcloud/netapp/storage-pools/create b/gcloud/netapp/storage-pools/create index 486277932..857e79be1 100644 --- a/gcloud/netapp/storage-pools/create +++ b/gcloud/netapp/storage-pools/create @@ -89,6 +89,10 @@ REQUIRED FLAGS Premium Service Level for Cloud NetApp Storage Pool. The Premium Service Level has a throughput per TiB of allocated volume size of 64 MiB/s. + standard + Standard Service Level for Cloud NetApp Storage Pool. The Standard + Service Level has a throughput per TiB of allocated volume size of + 128 MiB/s. OPTIONAL FLAGS Active directory resource - The Active Directory to attach to the Storage diff --git a/gcloud/notebooks/runtimes/help b/gcloud/notebooks/runtimes/help index 52da3166e..f26591d71 100644 --- a/gcloud/notebooks/runtimes/help +++ b/gcloud/notebooks/runtimes/help @@ -30,6 +30,9 @@ COMMANDS list Request for listing runtimes. + migrate + Request for migrating runtimes. + reset Request for resetting runtimes. diff --git a/gcloud/notebooks/runtimes/migrate b/gcloud/notebooks/runtimes/migrate new file mode 100644 index 000000000..3da42e6d2 --- /dev/null +++ b/gcloud/notebooks/runtimes/migrate @@ -0,0 +1,149 @@ +NAME + gcloud notebooks runtimes migrate - request for migrating runtimes + +SYNOPSIS + gcloud notebooks runtimes migrate (RUNTIME : --location=LOCATION) [--async] + [--post-startup-script-option=POST_STARTUP_SCRIPT_OPTION; + default="POST_STARTUP_SCRIPT_OPTION_UNSPECIFIED"] + [--service-account=SERVICE_ACCOUNT] + [--network=NETWORK [--subnet=SUBNET : --subnet-region=SUBNET_REGION]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Request for migrating notebook runtimes. + +EXAMPLES + To migrate a runtime, run: + + $ gcloud notebooks runtimes migrate example-runtime \ + --location=us-central1 + + To migrate a runtime with a new custom network, run: + + $ gcloud notebooks runtimes migrate example-runtime \ + --location=us-central1 \ + --network=projects/example-project/global/networks/\ + example-network \ + --subnet=projects/example-project/regions/us-central1/\ + subnetworks/example-subnetwork + + To migrate a runtime and reuse the post-startup script, run: + + $ gcloud notebooks runtimes migrate example-runtime \ + --location=us-central1 \ + --post-startup-script-option=POST_STARTUP_SCRIPT_OPTION_RERUN + +POSITIONAL ARGUMENTS + Runtime resource - User-defined unique name of this runtime. The runtime + name must be 1 to 63 characters long and contain only lowercase letters, + numeric characters, and dashes. The first character must be a lowercase + letter and the last character cannot be a dash. 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 runtime 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. + + RUNTIME + ID of the runtime or fully qualified identifier for the runtime. + + To set the runtime attribute: + ▸ provide the argument runtime on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Google Cloud location of this runtime + https://cloud.google.com/compute/docs/regions-zones/#locations. + + To set the location attribute: + ▸ provide the argument runtime on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property notebooks/location. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --post-startup-script-option=POST_STARTUP_SCRIPT_OPTION; default="POST_STARTUP_SCRIPT_OPTION_UNSPECIFIED" + Specifies the behavior of post startup script during migration. + POST_STARTUP_SCRIPT_OPTION must be one of: + POST_STARTUP_SCRIPT_OPTION_UNSPECIFIED, + POST_STARTUP_SCRIPT_OPTION_SKIP, POST_STARTUP_SCRIPT_OPTION_RERUN. + + --service-account=SERVICE_ACCOUNT + The service account to be included in the Compute Engine instance of + the new Workbench Instance when the Runtime uses single user only mode + for permission. If not specified, the Compute Engine default service + account + (https://cloud.google.com/compute/docs/access/service-accounts#default_service_account) + is used. When the Runtime uses service account mode for permission, it + will reuse the same service account, and this field must be empty. + + Network configs. + + Network resource - The name of the VPC that this instance is in. Format: + projects/{project_id}/global/networks/{network_id}. 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 subnet that this instance is in. + Format: + projects/{project_id}/regions/{region}/subnetworks/{subnetwork_id}. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group + but can be set in other ways. + + To set the project attribute: + ▸ provide the argument --subnet on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + --subnet=SUBNET + ID of the subnetwork or fully qualified identifier for the + subnetwork. + + To set the subnet attribute: + ▫ provide the argument --subnet on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --subnet-region=SUBNET_REGION + Google Cloud region of this subnetwork + https://cloud.google.com/compute/docs/regions-zones/#locations. + + To set the subnet-region attribute: + ▫ provide the argument --subnet on the command line with a fully + specified name; + ▫ provide the argument --subnet-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. diff --git a/gcloud/pubsub/subscriptions/create b/gcloud/pubsub/subscriptions/create index 33e03d9d8..6fed802d4 100644 --- a/gcloud/pubsub/subscriptions/create +++ b/gcloud/pubsub/subscriptions/create @@ -91,12 +91,14 @@ OPTIONAL FLAGS message with a given value of message_id on this subscription: The message sent to a subscriber is guaranteed not to be resent before the message's acknowledgment deadline expires. An acknowledged message will - not be resent to a subscriber. + not be resent to a subscriber. Use --no-enable-exactly-once-delivery to + disable this flag. --enable-message-ordering Whether to receive messages with the same ordering key in order. If set, messages with the same ordering key are sent to subscribers in the - order that Pub/Sub receives them. + order that Pub/Sub receives them. Use --no-enable-message-ordering to + disable this flag. --expiration-period=EXPIRATION_PERIOD The subscription will expire if it is inactive for the given period. @@ -146,7 +148,8 @@ OPTIONAL FLAGS Whether or not to retain acknowledged messages. If true, messages are not expunged from the subscription's backlog until they fall out of the --message-retention-duration window. Acknowledged messages are not - retained by default. + retained by default. Use --no-retain-acked-messages to disable this + flag. At most one of these can be specified: @@ -166,11 +169,13 @@ OPTIONAL FLAGS When --use-topic-schema is set, whether or not to ignore fields in the topic schema that do not appear in the BigQuery schema. If false, then the BigQuery schema must contain all fields that are - also present in the topic schema. + also present in the topic schema. Use --no-drop-unknown-fields to + disable this flag. --use-topic-schema Whether or not to use the schema for the subscription's topic (if - it exists) when writing messages to BigQuery. + it exists) when writing messages to BigQuery. Use + --no-use-topic-schema to disable this flag. --write-metadata Whether or not to write message metadata including message ID, @@ -178,7 +183,8 @@ OPTIONAL FLAGS subscription name, message_id, and publish_time fields are put in their own columns while all other message properties other than data (for example, an ordering_key, if present) are written to a - JSON object in the attributes column. + JSON object in the attributes column. Use --no-write-metadata to + disable this flag. Cloud Storage Config Options. The Cloud Pub/Sub service account associated with the enclosing subscription's parent project (i.e., @@ -225,7 +231,8 @@ OPTIONAL FLAGS properties other than data (for example, an ordering_key, if present) are added as entries in the attributes map. This has an effect only for subscriptions with - --cloud-storage-output-format=avro. + --cloud-storage-output-format=avro. Use + --no-cloud-storage-write-metadata to disable this flag. Dead Letter Queue Options. The Cloud Pub/Sub service account associated with the enclosing subscription's parent project (i.e., @@ -284,6 +291,7 @@ OPTIONAL FLAGS --push-no-wrapper When set, the message data is delivered directly as the HTTP body. + Use --no-push-no-wrapper to disable this flag. This flag argument must be specified if any of the other arguments in this group are specified. @@ -292,7 +300,8 @@ OPTIONAL FLAGS When true, writes the Pub/Sub message metadata to x-goog-pubsub-: headers of the HTTP request. Writes the Pub/Sub message attributes to : headers of the HTTP - request. + request. Use --no-push-no-wrapper-write-metadata to disable this + flag. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/pubsub/subscriptions/modify-push-config b/gcloud/pubsub/subscriptions/modify-push-config index d67175b6f..a23bc1003 100644 --- a/gcloud/pubsub/subscriptions/modify-push-config +++ b/gcloud/pubsub/subscriptions/modify-push-config @@ -51,6 +51,7 @@ OPTIONAL FLAGS --push-no-wrapper When set, the message data is delivered directly as the HTTP body. + Use --no-push-no-wrapper to disable this flag. This flag argument must be specified if any of the other arguments in this group are specified. @@ -59,7 +60,8 @@ OPTIONAL FLAGS When true, writes the Pub/Sub message metadata to x-goog-pubsub-: headers of the HTTP request. Writes the Pub/Sub message attributes to : headers of the HTTP - request. + request. Use --no-push-no-wrapper-write-metadata to disable this + flag. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/pubsub/subscriptions/pull b/gcloud/pubsub/subscriptions/pull index 8c8567c43..4d5e3b31e 100644 --- a/gcloud/pubsub/subscriptions/pull +++ b/gcloud/pubsub/subscriptions/pull @@ -41,7 +41,8 @@ POSITIONAL ARGUMENTS FLAGS --auto-ack - Automatically ACK every message pulled from this subscription. + Automatically ACK every message pulled from this subscription. Use + --no-auto-ack to disable this flag. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/pubsub/subscriptions/update b/gcloud/pubsub/subscriptions/update index f88e9c94a..a1a70bb04 100644 --- a/gcloud/pubsub/subscriptions/update +++ b/gcloud/pubsub/subscriptions/update @@ -66,7 +66,8 @@ FLAGS message sent to a subscriber is guaranteed not to be resent before the message's acknowledgment deadline expires. An acknowledged message will not be resent to a subscriber. To disable exactly-once delivery use - --no-enable-exactly-once-delivery. + --no-enable-exactly-once-delivery. Use + --no-enable-exactly-once-delivery to disable this flag. --expiration-period=EXPIRATION_PERIOD The subscription will expire if it is inactive for the given period. @@ -101,7 +102,8 @@ FLAGS Whether or not to retain acknowledged messages. If true, messages are not expunged from the subscription's backlog until they fall out of the --message-retention-duration window. Acknowledged messages are not - retained by default. + retained by default. Use --no-retain-acked-messages to disable this + flag. --update-labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to update. If a label exists, its value @@ -117,7 +119,8 @@ FLAGS At most one of these can be specified: --clear-bigquery-config - If set, clear the BigQuery config from the subscription. + If set, clear the BigQuery config from the subscription. Use + --no-clear-bigquery-config to disable this flag. BigQuery Config Options. The Cloud Pub/Sub service account associated with the enclosing subscription's parent project (i.e., @@ -136,11 +139,13 @@ FLAGS When --use-topic-schema is set, whether or not to ignore fields in the topic schema that do not appear in the BigQuery schema. If false, then the BigQuery schema must contain all fields that are - also present in the topic schema. + also present in the topic schema. Use --no-drop-unknown-fields to + disable this flag. --use-topic-schema Whether or not to use the schema for the subscription's topic (if - it exists) when writing messages to BigQuery. + it exists) when writing messages to BigQuery. Use + --no-use-topic-schema to disable this flag. --write-metadata Whether or not to write message metadata including message ID, @@ -148,12 +153,14 @@ FLAGS subscription name, message_id, and publish_time fields are put in their own columns while all other message properties other than data (for example, an ordering_key, if present) are written to a - JSON object in the attributes column. + JSON object in the attributes column. Use --no-write-metadata to + disable this flag. At most one of these can be specified: --clear-cloud-storage-config - If set, clear the Cloud Storage config from the subscription. + If set, clear the Cloud Storage config from the subscription. Use + --no-clear-cloud-storage-config to disable this flag. Cloud Storage Config Options. The Cloud Pub/Sub service account associated with the enclosing subscription's parent project (i.e., @@ -204,12 +211,14 @@ FLAGS message properties other than data (for example, an ordering_key, if present) are added as entries in the attributes map. This has an effect only for subscriptions with - --cloud-storage-output-format=avro. + --cloud-storage-output-format=avro. Use + --no-cloud-storage-write-metadata to disable this flag. At most one of these can be specified: --clear-dead-letter-policy - If set, clear the dead letter policy from the subscription. + If set, clear the dead letter policy from the subscription. Use + --no-clear-dead-letter-policy to disable this flag. Dead Letter Queue Options. The Cloud Pub/Sub service account associated with the enclosing subscription's parent project (i.e., @@ -270,12 +279,14 @@ FLAGS At most one of these can be specified: --clear-push-no-wrapper-config - If set, clear the NoWrapper config from the subscription. + If set, clear the NoWrapper config from the subscription. Use + --no-clear-push-no-wrapper-config to disable this flag. NoWrapper Config Options. --push-no-wrapper When set, the message data is delivered directly as the HTTP body. + Use --no-push-no-wrapper to disable this flag. This flag argument must be specified if any of the other arguments in this group are specified. @@ -284,12 +295,14 @@ FLAGS When true, writes the Pub/Sub message metadata to x-goog-pubsub-: headers of the HTTP request. Writes the Pub/Sub message attributes to : headers of the HTTP - request. + request. Use --no-push-no-wrapper-write-metadata to disable this + flag. At most one of these can be specified: --clear-retry-policy - If set, clear the retry policy from the subscription. + If set, clear the retry policy from the subscription. Use + --no-clear-retry-policy to disable this flag. Retry Policy Options. Retry policy specifies how Cloud Pub/Sub retries message delivery for this subscription. diff --git a/gcloud/pubsub/topics/update b/gcloud/pubsub/topics/update index e0c0251f4..19b24d61e 100644 --- a/gcloud/pubsub/topics/update +++ b/gcloud/pubsub/topics/update @@ -117,7 +117,8 @@ FLAGS At most one of these can be specified: --clear-message-retention-duration - If set, clear the message retention duration from the topic. + If set, clear the message retention duration from the topic. Use + --no-clear-message-retention-duration to disable this flag. --message-retention-duration=MESSAGE_RETENTION_DURATION Indicates the minimum duration to retain a message after it is @@ -135,7 +136,8 @@ FLAGS At most one of these can be specified: --clear-schema-settings - If set, clear the Schema Settings from the topic. + If set, clear the Schema Settings from the topic. Use + --no-clear-schema-settings to disable this flag. Schema settings. The schema that messages published to this topic must conform to and the expected message encoding. diff --git a/gcloud/spanner/instances/create b/gcloud/spanner/instances/create index 0e6e38257..8cf92e1e1 100644 --- a/gcloud/spanner/instances/create +++ b/gcloud/spanner/instances/create @@ -5,7 +5,8 @@ SYNOPSIS gcloud spanner instances create INSTANCE --config=CONFIG --description=DESCRIPTION [--async] [--expire-behavior=EXPIRE_BEHAVIOR] [--instance-type=INSTANCE_TYPE] - [--nodes=NODES | --processing-units=PROCESSING_UNITS] + [--nodes=NODES | --processing-units=PROCESSING_UNITS + | --autoscaling-high-priority-cpu-target=AUTOSCALING_HIGH_PRIORITY_CPU_TARGET --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET (--autoscaling-max-nodes=AUTOSCALING_MAX_NODES --autoscaling-min-nodes=AUTOSCALING_MIN_NODES | --autoscaling-max-processing-units=AUTOSCALING_MAX_PROCESSING_UNITS --autoscaling-min-processing-units=AUTOSCALING_MIN_PROCESSING_UNITS)] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -67,6 +68,52 @@ OPTIONAL FLAGS --processing-units=PROCESSING_UNITS Number of processing units for the instance. + Autoscaling + + --autoscaling-high-priority-cpu-target=AUTOSCALING_HIGH_PRIORITY_CPU_TARGET + Specifies the target percentage of high-priority CPU the autoscaled + instance can utilize. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET + Specifies the target percentage of storage the autoscaled instance + can utilize. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + Exactly one of these must be specified: + + Autoscaling limits in nodes + + --autoscaling-max-nodes=AUTOSCALING_MAX_NODES + Maximum number of nodes for the autoscaled instance. + + This flag argument must be specified if any of the other + arguments in this group are specified. + + --autoscaling-min-nodes=AUTOSCALING_MIN_NODES + Minimum number of nodes for the autoscaled instance. + + This flag argument must be specified if any of the other + arguments in this group are specified. + + Autoscaling limits in processing units + + --autoscaling-max-processing-units=AUTOSCALING_MAX_PROCESSING_UNITS + Maximum number of processing units for the autoscaled instance. + + This flag argument must be specified if any of the other + arguments in this group are specified. + + --autoscaling-min-processing-units=AUTOSCALING_MIN_PROCESSING_UNITS + Minimum number of processing units for the autoscaled instance. + + This flag argument must be specified if any of the other + arguments in this group are specified. + 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/spanner/instances/update b/gcloud/spanner/instances/update index b88ec0ff4..4d0a4d283 100644 --- a/gcloud/spanner/instances/update +++ b/gcloud/spanner/instances/update @@ -5,7 +5,8 @@ SYNOPSIS gcloud spanner instances update INSTANCE [--async] [--description=DESCRIPTION] [--expire-behavior=EXPIRE_BEHAVIOR] [--instance-type=INSTANCE_TYPE] - [--nodes=NODES | --processing-units=PROCESSING_UNITS] + [--nodes=NODES | --processing-units=PROCESSING_UNITS + | --autoscaling-high-priority-cpu-target=AUTOSCALING_HIGH_PRIORITY_CPU_TARGET --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET --autoscaling-max-nodes=AUTOSCALING_MAX_NODES --autoscaling-min-nodes=AUTOSCALING_MIN_NODES | --autoscaling-max-processing-units=AUTOSCALING_MAX_PROCESSING_UNITS --autoscaling-min-processing-units=AUTOSCALING_MIN_PROCESSING_UNITS] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -64,6 +65,34 @@ FLAGS --processing-units=PROCESSING_UNITS Number of processing units for the instance. + Autoscaling + + --autoscaling-high-priority-cpu-target=AUTOSCALING_HIGH_PRIORITY_CPU_TARGET + Specifies the target percentage of high-priority CPU the autoscaled + instance can utilize. + + --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET + Specifies the target percentage of storage the autoscaled instance + can utilize. + + At most one of these can be specified: + + Autoscaling limits in nodes + + --autoscaling-max-nodes=AUTOSCALING_MAX_NODES + Maximum number of nodes for the autoscaled instance. + + --autoscaling-min-nodes=AUTOSCALING_MIN_NODES + Minimum number of nodes for the autoscaled instance. + + Autoscaling limits in processing units + + --autoscaling-max-processing-units=AUTOSCALING_MAX_PROCESSING_UNITS + Maximum number of processing units for the autoscaled instance. + + --autoscaling-min-processing-units=AUTOSCALING_MIN_PROCESSING_UNITS + Minimum number of processing units for the autoscaled instance. + 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/sql/instances/create b/gcloud/sql/instances/create index 1df43f71e..b92b8ae24 100644 --- a/gcloud/sql/instances/create +++ b/gcloud/sql/instances/create @@ -43,10 +43,11 @@ SYNOPSIS [--replica-type=REPLICA_TYPE] [--replication=REPLICATION] [--require-ssl] [--retained-backups-count=RETAINED_BACKUPS_COUNT] [--retained-transaction-log-days=RETAINED_TRANSACTION_LOG_DAYS] - [--root-password=ROOT_PASSWORD] [--[no-]storage-auto-increase] - [--storage-size=STORAGE_SIZE] [--storage-type=STORAGE_TYPE] - [--threads-per-core=THREADS_PER_CORE] [--tier=TIER, -t TIER] - [--time-zone=TIME_ZONE] [--timeout=TIMEOUT; default=3600] + [--root-password=ROOT_PASSWORD] [--ssl-mode=SSL_MODE] + [--[no-]storage-auto-increase] [--storage-size=STORAGE_SIZE] + [--storage-type=STORAGE_TYPE] [--threads-per-core=THREADS_PER_CORE] + [--tier=TIER, -t TIER] [--time-zone=TIME_ZONE] + [--timeout=TIMEOUT; default=3600] [--allowed-psc-projects=PROJECT,[PROJECT,...] --enable-private-service-connect] [--disk-encryption-key=DISK_ENCRYPTION_KEY @@ -383,6 +384,18 @@ FLAGS --root-password=ROOT_PASSWORD Root Cloud SQL user's password. + --ssl-mode=SSL_MODE + Set the SSL mode of the instance. SSL_MODE must be one of: + + ALLOW_UNENCRYPTED_AND_ENCRYPTED + Allow non-SSL and SSL connections. For SSL connections, client + certificate will not be verified. + ENCRYPTED_ONLY + Only allow connections encrypted with SSL/TLS. + TRUSTED_CLIENT_CERTIFICATE_REQUIRED + Only allow connections encrypted with SSL/TLS and with valid client + certificates. + --[no-]storage-auto-increase Storage size can be increased, but it cannot be decreased; storage increases are permanent for the life of the instance. With this setting diff --git a/gcloud/sql/instances/patch b/gcloud/sql/instances/patch index 94651e051..8fd383dd9 100644 --- a/gcloud/sql/instances/patch +++ b/gcloud/sql/instances/patch @@ -36,9 +36,9 @@ SYNOPSIS [--pricing-plan=PRICING_PLAN, -p PRICING_PLAN] [--[no-]recreate-replicas-on-primary-crash] [--remove-deny-maintenance-period] [--replication=REPLICATION] - [--[no-]require-ssl] [--[no-]storage-auto-increase] - [--storage-size=STORAGE_SIZE] [--threads-per-core=THREADS_PER_CORE] - [--tier=TIER, -t TIER] + [--[no-]require-ssl] [--ssl-mode=SSL_MODE] + [--[no-]storage-auto-increase] [--storage-size=STORAGE_SIZE] + [--threads-per-core=THREADS_PER_CORE] [--tier=TIER, -t TIER] [--allowed-psc-projects=PROJECT,[PROJECT,...] | --clear-allowed-psc-projects] [--authorized-gae-apps=APP,[APP,...] | --clear-gae-apps] @@ -331,6 +331,18 @@ FLAGS mysqld should default to 'REQUIRE X509' for users connecting over IP. Use --require-ssl to enable and --no-require-ssl to disable. + --ssl-mode=SSL_MODE + Set the SSL mode of the instance. SSL_MODE must be one of: + + ALLOW_UNENCRYPTED_AND_ENCRYPTED + Allow non-SSL and SSL connections. For SSL connections, client + certificate will not be verified. + ENCRYPTED_ONLY + Only allow connections encrypted with SSL/TLS. + TRUSTED_CLIENT_CERTIFICATE_REQUIRED + Only allow connections encrypted with SSL/TLS and with valid client + certificates. + --[no-]storage-auto-increase Storage size can be increased, but it cannot be decreased; storage increases are permanent for the life of the instance. With this setting diff --git a/gcloud/storage/help b/gcloud/storage/help index 0071c82c3..9b2c693fc 100644 --- a/gcloud/storage/help +++ b/gcloud/storage/help @@ -32,6 +32,9 @@ GROUPS objects Manage Cloud Storage objects. + operations + Manage storage operations. + COMMANDS COMMAND is one of the following: diff --git a/gcloud/storage/operations/cancel b/gcloud/storage/operations/cancel new file mode 100644 index 000000000..10ba788c0 --- /dev/null +++ b/gcloud/storage/operations/cancel @@ -0,0 +1,34 @@ +NAME + gcloud storage operations cancel - cancel a storage operation + +SYNOPSIS + gcloud storage operations cancel OPERATION_NAME [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Cancel a storage operation. Since operations are asynchronous, this request + is best effort and may fail in cases such as when the operation is already + complete. + +EXAMPLES + To cancel the operation "C894F35J" on bucket "my-bucket", run: + + $ gcloud storage operations cancel \ + projects/_/buckets/my-bucket/operations/C894F35J + +POSITIONAL ARGUMENTS + OPERATION_NAME + The operation name including the Cloud Storage bucket and operation ID. + +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 alpha storage operations cancel + diff --git a/gcloud/storage/operations/describe b/gcloud/storage/operations/describe new file mode 100644 index 000000000..a077c968b --- /dev/null +++ b/gcloud/storage/operations/describe @@ -0,0 +1,33 @@ +NAME + gcloud storage operations describe - get configuration and latest storage + operation details + +SYNOPSIS + gcloud storage operations describe OPERATION_NAME [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Get details about a specific storage operation. + +EXAMPLES + To describe an operation "C894F35J" on bucket "my-bucket", run: + + $ gcloud storage operations describe \ + projects/_/buckets/my-bucket/operations/C894F35J + +POSITIONAL ARGUMENTS + OPERATION_NAME + The operation name including the Cloud Storage bucket and operation ID. + +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 alpha storage operations describe + diff --git a/gcloud/storage/operations/help b/gcloud/storage/operations/help new file mode 100644 index 000000000..d301780bf --- /dev/null +++ b/gcloud/storage/operations/help @@ -0,0 +1,31 @@ +NAME + gcloud storage operations - manage storage operations + +SYNOPSIS + gcloud storage operations COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage storage operations. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + cancel + Cancel a storage operation. + + describe + Get configuration and latest storage operation details. + + list + List storage operations. + +NOTES + This variant is also available: + + $ gcloud alpha storage operations + diff --git a/gcloud/storage/operations/list b/gcloud/storage/operations/list new file mode 100644 index 000000000..af247829e --- /dev/null +++ b/gcloud/storage/operations/list @@ -0,0 +1,81 @@ +NAME + gcloud storage operations list - list storage operations + +SYNOPSIS + gcloud storage operations list OPERATION_NAME + [--server-filter=SERVER_FILTER] [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List storage operations. + +EXAMPLES + To list all storage operations that belong to the bucket "my-bucket", run: + + $ gcloud storage operations list projects/_/buckets/my-bucket + + To list operations in JSON format, run: + + $ gcloud storage operations list projects/_/buckets/my-bucket \ + --format=json + + An alternative bucket format is available: + + $ gcloud storage operations list gs://my-bucket + +POSITIONAL ARGUMENTS + OPERATION_NAME + The operation name including the Cloud Storage bucket and operation ID. + +FLAGS + --server-filter=SERVER_FILTER + Server-side filter string used to determine what operations to return. + Example: (done = true AND complete_time >= "2023-01-01T00:00:00Z") OR + requested_cancellation = true + +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 alpha storage operations list + diff --git a/gcloud/workbench/instances/create b/gcloud/workbench/instances/create index 67c5cf2c1..1f0318697 100644 --- a/gcloud/workbench/instances/create +++ b/gcloud/workbench/instances/create @@ -43,22 +43,22 @@ EXAMPLES To create an instance from a VmImage family, run: $ gcloud workbench instances create example-instance \ - --vm-image-project=deeplearning-platform-release \ - --vm-image-family=workbench-image-family \ + --vm-image-project=cloud-notebooks-managed \ + --vm-image-family=workbench-instances \ --machine-type=n1-standard-4 --location=us-central1-b To create an instance from a VmImage name, run: $ gcloud workbench instances create example-instance \ - --vm-image-project=deeplearning-platform-release \ - --vm-image-name=workbench-image-name \ + --vm-image-project=cloud-notebooks-managed \ + --vm-image-name=workbench-instances-v20230925-debian-11-py310 \ --machine-type=n1-standard-4 --location=us-central1-b To create an instance from a Container Repository, run: $ gcloud workbench instances create example-instance \ --container-repository=gcr.io/deeplearning-platform-release/\ - base-cpu --container-tag=test-tag --machine-type=n1-standard-4 \ + base-cpu --container-tag=latest --machine-type=n1-standard-4 \ --location=us-central1-b POSITIONAL ARGUMENTS diff --git a/gcloud/workstations/clusters/create b/gcloud/workstations/clusters/create index 91936a042..b2769e057 100644 --- a/gcloud/workstations/clusters/create +++ b/gcloud/workstations/clusters/create @@ -50,7 +50,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument cluster on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. FLAGS --async diff --git a/gcloud/workstations/clusters/delete b/gcloud/workstations/clusters/delete index cd0b5180b..3405b65a0 100644 --- a/gcloud/workstations/clusters/delete +++ b/gcloud/workstations/clusters/delete @@ -42,7 +42,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument cluster on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. FLAGS --async diff --git a/gcloud/workstations/clusters/describe b/gcloud/workstations/clusters/describe index ec0b08778..5156a1f95 100644 --- a/gcloud/workstations/clusters/describe +++ b/gcloud/workstations/clusters/describe @@ -42,7 +42,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument cluster on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/workstations/configs/create b/gcloud/workstations/configs/create index e989fd6db..75b93efbd 100644 --- a/gcloud/workstations/configs/create +++ b/gcloud/workstations/configs/create @@ -82,7 +82,8 @@ POSITIONAL ARGUMENTS To set the cluster attribute: ▸ provide the argument config on the command line with a fully specified name; - ▸ provide the argument --cluster on the command line. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster. --region=REGION The location for the config. @@ -90,7 +91,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument config on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. FLAGS --async diff --git a/gcloud/workstations/configs/delete b/gcloud/workstations/configs/delete index 792cce65c..b975eb6c0 100644 --- a/gcloud/workstations/configs/delete +++ b/gcloud/workstations/configs/delete @@ -43,7 +43,8 @@ POSITIONAL ARGUMENTS To set the cluster attribute: ▸ provide the argument config on the command line with a fully specified name; - ▸ provide the argument --cluster on the command line. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster. --region=REGION The name of the region of the config. @@ -51,7 +52,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument config on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. FLAGS --async diff --git a/gcloud/workstations/configs/describe b/gcloud/workstations/configs/describe index 6dfbc04c5..4f5bd0912 100644 --- a/gcloud/workstations/configs/describe +++ b/gcloud/workstations/configs/describe @@ -42,7 +42,8 @@ POSITIONAL ARGUMENTS To set the cluster attribute: ▸ provide the argument config on the command line with a fully specified name; - ▸ provide the argument --cluster on the command line. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster. --region=REGION The name of the region of the config. @@ -50,7 +51,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument config on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/workstations/configs/get-iam-policy b/gcloud/workstations/configs/get-iam-policy index 24ced645f..66bdadba0 100644 --- a/gcloud/workstations/configs/get-iam-policy +++ b/gcloud/workstations/configs/get-iam-policy @@ -50,7 +50,8 @@ POSITIONAL ARGUMENTS To set the cluster attribute: ▸ provide the argument config on the command line with a fully specified name; - ▸ provide the argument --cluster on the command line. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster. --region=REGION The name of the region of the config. @@ -58,7 +59,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument config on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/workstations/configs/list b/gcloud/workstations/configs/list index bbe81cbeb..88d17f24e 100644 --- a/gcloud/workstations/configs/list +++ b/gcloud/workstations/configs/list @@ -43,7 +43,8 @@ REQUIRED FLAGS To set the region attribute: ▸ provide the argument --cluster on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/workstations/configs/set-iam-policy b/gcloud/workstations/configs/set-iam-policy index 6852954dc..3083df9b9 100644 --- a/gcloud/workstations/configs/set-iam-policy +++ b/gcloud/workstations/configs/set-iam-policy @@ -49,7 +49,8 @@ POSITIONAL ARGUMENTS To set the cluster attribute: ▸ provide the argument config on the command line with a fully specified name; - ▸ provide the argument --cluster on the command line. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster. --region=REGION The name of the region of the config. @@ -57,7 +58,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument config on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. POLICY_FILE Path to a local JSON or YAML formatted file containing a valid policy. diff --git a/gcloud/workstations/configs/update b/gcloud/workstations/configs/update index 91c309d97..69df64cdf 100644 --- a/gcloud/workstations/configs/update +++ b/gcloud/workstations/configs/update @@ -69,7 +69,8 @@ POSITIONAL ARGUMENTS To set the cluster attribute: ▸ provide the argument config on the command line with a fully specified name; - ▸ provide the argument --cluster on the command line. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster. --region=REGION The location for the config. @@ -77,7 +78,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument config on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. FLAGS --async diff --git a/gcloud/workstations/create b/gcloud/workstations/create index f2e1596af..ba777dd4b 100644 --- a/gcloud/workstations/create +++ b/gcloud/workstations/create @@ -44,7 +44,8 @@ POSITIONAL ARGUMENTS To set the cluster attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --cluster on the command line. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster. --config=CONFIG The name of the config containing the workstation. @@ -52,7 +53,8 @@ POSITIONAL ARGUMENTS To set the config attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --config on the command line. + ▸ provide the argument --config on the command line; + ▸ set the property workstations/config. --region=REGION The name of the region of the workstation. @@ -60,7 +62,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. FLAGS --async diff --git a/gcloud/workstations/delete b/gcloud/workstations/delete index 43035628f..f90b21765 100644 --- a/gcloud/workstations/delete +++ b/gcloud/workstations/delete @@ -44,7 +44,8 @@ POSITIONAL ARGUMENTS To set the cluster attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --cluster on the command line. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster. --config=CONFIG The name of the config containing the workstation. @@ -52,7 +53,8 @@ POSITIONAL ARGUMENTS To set the config attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --config on the command line. + ▸ provide the argument --config on the command line; + ▸ set the property workstations/config. --region=REGION The name of the region of the workstation. @@ -60,7 +62,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. FLAGS --async diff --git a/gcloud/workstations/describe b/gcloud/workstations/describe index 99aadf471..c11abfa32 100644 --- a/gcloud/workstations/describe +++ b/gcloud/workstations/describe @@ -44,7 +44,8 @@ POSITIONAL ARGUMENTS To set the cluster attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --cluster on the command line. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster. --config=CONFIG The name of the config containing the workstation. @@ -52,7 +53,8 @@ POSITIONAL ARGUMENTS To set the config attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --config on the command line. + ▸ provide the argument --config on the command line; + ▸ set the property workstations/config. --region=REGION The name of the region of the workstation. @@ -60,7 +62,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/workstations/get-iam-policy b/gcloud/workstations/get-iam-policy index 5bd18dd2e..2d22be27b 100644 --- a/gcloud/workstations/get-iam-policy +++ b/gcloud/workstations/get-iam-policy @@ -49,7 +49,8 @@ POSITIONAL ARGUMENTS To set the cluster attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --cluster on the command line. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster. --config=CONFIG The name of the config containing the workstation. @@ -57,7 +58,8 @@ POSITIONAL ARGUMENTS To set the config attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --config on the command line. + ▸ provide the argument --config on the command line; + ▸ set the property workstations/config. --region=REGION The name of the region of the workstation. @@ -65,7 +67,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/workstations/list b/gcloud/workstations/list index a06f06177..7ca7c03ac 100644 --- a/gcloud/workstations/list +++ b/gcloud/workstations/list @@ -44,7 +44,8 @@ REQUIRED FLAGS To set the cluster attribute: ▸ provide the argument --config on the command line with a fully specified name; - ▸ provide the argument --cluster on the command line. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster. --region=REGION The name of the region of the config. @@ -52,7 +53,8 @@ REQUIRED FLAGS To set the region attribute: ▸ provide the argument --config on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/workstations/list-usable b/gcloud/workstations/list-usable index e240119ab..5c9fea7da 100644 --- a/gcloud/workstations/list-usable +++ b/gcloud/workstations/list-usable @@ -44,7 +44,8 @@ REQUIRED FLAGS To set the cluster attribute: ▸ provide the argument --config on the command line with a fully specified name; - ▸ provide the argument --cluster on the command line. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster. --region=REGION The location for the config. @@ -52,7 +53,8 @@ REQUIRED FLAGS To set the region attribute: ▸ provide the argument --config on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/workstations/set-iam-policy b/gcloud/workstations/set-iam-policy index e0373437a..ce4077dd1 100644 --- a/gcloud/workstations/set-iam-policy +++ b/gcloud/workstations/set-iam-policy @@ -49,7 +49,8 @@ POSITIONAL ARGUMENTS To set the cluster attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --cluster on the command line. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster. --config=CONFIG The name of the config containing the workstation. @@ -57,7 +58,8 @@ POSITIONAL ARGUMENTS To set the config attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --config on the command line. + ▸ provide the argument --config on the command line; + ▸ set the property workstations/config. --region=REGION The name of the region of the workstation. @@ -65,7 +67,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. POLICY_FILE Path to a local JSON or YAML formatted file containing a valid policy. diff --git a/gcloud/workstations/ssh b/gcloud/workstations/ssh index 83198768c..9a3aafaa7 100644 --- a/gcloud/workstations/ssh +++ b/gcloud/workstations/ssh @@ -56,7 +56,8 @@ POSITIONAL ARGUMENTS To set the cluster attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --cluster on the command line. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster. --config=CONFIG The config for the workstation. @@ -64,7 +65,8 @@ POSITIONAL ARGUMENTS To set the config attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --config on the command line. + ▸ provide the argument --config on the command line; + ▸ set the property workstations/config. --region=REGION The location for the workstation. @@ -72,7 +74,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. [-- SSH_ARGS ...] Flags and positionals passed to the underlying ssh implementation. diff --git a/gcloud/workstations/start b/gcloud/workstations/start index 7823a5dbf..b1aef2408 100644 --- a/gcloud/workstations/start +++ b/gcloud/workstations/start @@ -44,7 +44,8 @@ POSITIONAL ARGUMENTS To set the cluster attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --cluster on the command line. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster. --config=CONFIG The config for the workstation. @@ -52,7 +53,8 @@ POSITIONAL ARGUMENTS To set the config attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --config on the command line. + ▸ provide the argument --config on the command line; + ▸ set the property workstations/config. --region=REGION The location for the workstation. @@ -60,7 +62,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. FLAGS --async diff --git a/gcloud/workstations/start-tcp-tunnel b/gcloud/workstations/start-tcp-tunnel index 1d7818af2..4fed16ec5 100644 --- a/gcloud/workstations/start-tcp-tunnel +++ b/gcloud/workstations/start-tcp-tunnel @@ -50,7 +50,8 @@ POSITIONAL ARGUMENTS To set the cluster attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --cluster on the command line. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster. --config=CONFIG The config for the workstation. @@ -58,7 +59,8 @@ POSITIONAL ARGUMENTS To set the config attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --config on the command line. + ▸ provide the argument --config on the command line; + ▸ set the property workstations/config. --region=REGION The location for the workstation. @@ -66,7 +68,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. WORKSTATION_PORT The port on the workstation to which traffic should be sent. diff --git a/gcloud/workstations/stop b/gcloud/workstations/stop index 78c3886c6..5999be2ed 100644 --- a/gcloud/workstations/stop +++ b/gcloud/workstations/stop @@ -44,7 +44,8 @@ POSITIONAL ARGUMENTS To set the cluster attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --cluster on the command line. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster. --config=CONFIG The config for the workstation. @@ -52,7 +53,8 @@ POSITIONAL ARGUMENTS To set the config attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --config on the command line. + ▸ provide the argument --config on the command line; + ▸ set the property workstations/config. --region=REGION The location for the workstation. @@ -60,7 +62,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument workstation on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region. FLAGS --async