From 978ed239f6c0fa3b61c1ac7a7c02fb1e3d36543b Mon Sep 17 00:00:00 2001 From: Automated Date: Wed, 24 Aug 2022 09:45:53 +0000 Subject: [PATCH] gcloud: Wed Aug 24 09:45:53 UTC 2022 --- gcloud/_version | 8 +- gcloud/alpha/alloydb/clusters/help | 3 +- gcloud/alpha/alloydb/clusters/restore | 46 +++++-- gcloud/alpha/alloydb/operations/list | 10 +- gcloud/alpha/builds/triggers/create/manual | 15 +-- gcloud/alpha/builds/triggers/create/pubsub | 15 +-- gcloud/alpha/builds/triggers/create/webhook | 15 +-- gcloud/alpha/compute/disks/create | 7 +- gcloud/alpha/compute/disks/update | 9 +- .../alpha/compute/future-reservations/create | 17 ++- .../alpha/compute/future-reservations/update | 98 ++++++++++++--- gcloud/alpha/compute/images/create | 7 +- gcloud/alpha/compute/images/update | 7 +- .../create/disk-consistency-group | 58 +++++++++ .../compute/resource-policies/create/help | 3 + gcloud/alpha/compute/scp | 7 +- gcloud/alpha/config/help | 11 ++ gcloud/alpha/config/list | 11 ++ gcloud/alpha/config/set | 11 ++ gcloud/alpha/config/unset | 11 ++ .../container/backup-restore/restores/create | 4 +- .../fleet/memberships/generate-gateway-rbac | 14 ++- .../hub/memberships/generate-gateway-rbac | 14 ++- .../test/android/list-device-capacities | 8 +- gcloud/alpha/firestore/databases/create | 32 ++--- gcloud/alpha/firestore/databases/help | 3 +- gcloud/alpha/functions/deploy | 2 +- .../policy-based-routes/create | 39 +++--- .../alpha/network-services/tls-routes/delete | 10 +- .../network-services/tls-routes/describe | 6 +- .../alpha/network-services/tls-routes/export | 10 +- gcloud/alpha/network-services/tls-routes/help | 4 +- .../alpha/network-services/tls-routes/import | 10 +- gcloud/alpha/network-services/tls-routes/list | 9 +- gcloud/alpha/spanner/instances/create | 22 ++-- gcloud/alpha/spanner/instances/update | 22 ++-- gcloud/alpha/spanner/samples/backend | 6 +- gcloud/alpha/spanner/samples/help | 6 +- gcloud/alpha/spanner/samples/init | 6 +- gcloud/alpha/spanner/samples/list | 11 +- gcloud/alpha/spanner/samples/run | 6 +- gcloud/alpha/spanner/samples/workload | 6 +- gcloud/alpha/storage/cp | 24 ++-- gcloud/alpha/storage/objects/compose | 56 +++++++++ gcloud/alpha/storage/objects/help | 3 + gcloud/alpha/storage/objects/update | 26 ++-- gcloud/alpha/storage/rm | 25 ++-- gcloud/alpha/transfer/agents/install | 8 +- gcloud/asset/get-effective-iam-policy | 75 +++++++++++ gcloud/asset/help | 4 + gcloud/beta/alloydb/clusters/help | 3 +- gcloud/beta/alloydb/clusters/restore | 46 +++++-- gcloud/beta/alloydb/operations/list | 10 +- gcloud/beta/compute/disks/create | 10 +- gcloud/beta/compute/disks/update | 12 ++ gcloud/beta/compute/images/create | 9 +- gcloud/beta/compute/images/update | 11 +- gcloud/beta/compute/scp | 7 +- gcloud/beta/config/get | 11 ++ gcloud/beta/config/help | 11 ++ gcloud/beta/config/list | 11 ++ gcloud/beta/config/set | 11 ++ gcloud/beta/config/unset | 11 ++ .../container/backup-restore/restores/create | 4 +- .../fleet/memberships/generate-gateway-rbac | 14 ++- .../hub/memberships/generate-gateway-rbac | 14 ++- gcloud/beta/dataflow/flex-template/build | 13 +- gcloud/beta/functions/deploy | 2 +- .../connectivity-tests/create | 6 +- .../connectivity-tests/update | 10 ++ gcloud/beta/spanner/help | 3 + gcloud/beta/spanner/instances/create | 40 ++++-- gcloud/beta/spanner/instances/update | 26 +++- gcloud/beta/spanner/samples/backend | 65 ++++++++++ gcloud/beta/spanner/samples/help | 50 ++++++++ gcloud/beta/spanner/samples/init | 44 +++++++ gcloud/beta/spanner/samples/list | 64 ++++++++++ gcloud/beta/spanner/samples/run | 62 +++++++++ gcloud/beta/spanner/samples/workload | 56 +++++++++ gcloud/compute/disks/create | 9 +- gcloud/compute/disks/update | 12 ++ gcloud/compute/images/create | 9 +- gcloud/compute/images/update | 11 +- gcloud/compute/scp | 7 +- gcloud/config/get | 11 ++ gcloud/config/help | 11 ++ gcloud/config/list | 11 ++ gcloud/config/set | 11 ++ gcloud/config/unset | 11 ++ .../fleet/memberships/generate-gateway-rbac | 14 ++- .../hub/memberships/generate-gateway-rbac | 14 ++- gcloud/dataflow/flex-template/build | 13 +- gcloud/functions/deploy | 2 +- gcloud/network-services/help | 3 + gcloud/network-services/tls-routes/delete | 66 ++++++++++ gcloud/network-services/tls-routes/describe | 61 +++++++++ gcloud/network-services/tls-routes/export | 69 ++++++++++ gcloud/network-services/tls-routes/help | 37 ++++++ gcloud/network-services/tls-routes/import | 76 +++++++++++ gcloud/network-services/tls-routes/list | 82 ++++++++++++ gcloud/notebooks/help | 3 + gcloud/notebooks/runtimes/create | 119 ++++++++++++++++++ gcloud/notebooks/runtimes/delete | 60 +++++++++ gcloud/notebooks/runtimes/describe | 55 ++++++++ gcloud/notebooks/runtimes/help | 40 ++++++ gcloud/notebooks/runtimes/list | 72 +++++++++++ gcloud/notebooks/runtimes/reset | 60 +++++++++ gcloud/notebooks/runtimes/start | 60 +++++++++ gcloud/notebooks/runtimes/stop | 60 +++++++++ gcloud/notebooks/runtimes/switch | 75 +++++++++++ gcloud/org-policies/delete-custom-constraint | 32 +++++ .../org-policies/describe-custom-constraint | 33 +++++ gcloud/org-policies/help | 12 ++ gcloud/org-policies/list-custom-constraints | 60 +++++++++ gcloud/org-policies/set-custom-constraint | 29 +++++ gcloud/privateca/templates/create | 7 +- gcloud/privateca/templates/update | 7 +- gcloud/spanner/help | 3 + gcloud/spanner/instances/create | 40 ++++-- gcloud/spanner/instances/update | 26 +++- gcloud/spanner/samples/backend | 63 ++++++++++ gcloud/spanner/samples/help | 48 +++++++ gcloud/spanner/samples/init | 43 +++++++ gcloud/spanner/samples/list | 63 ++++++++++ gcloud/spanner/samples/run | 61 +++++++++ gcloud/spanner/samples/workload | 53 ++++++++ gcloud/transfer/agents/install | 8 +- 127 files changed, 2957 insertions(+), 251 deletions(-) create mode 100644 gcloud/alpha/compute/resource-policies/create/disk-consistency-group create mode 100644 gcloud/alpha/storage/objects/compose create mode 100644 gcloud/asset/get-effective-iam-policy create mode 100644 gcloud/beta/spanner/samples/backend create mode 100644 gcloud/beta/spanner/samples/help create mode 100644 gcloud/beta/spanner/samples/init create mode 100644 gcloud/beta/spanner/samples/list create mode 100644 gcloud/beta/spanner/samples/run create mode 100644 gcloud/beta/spanner/samples/workload create mode 100644 gcloud/network-services/tls-routes/delete create mode 100644 gcloud/network-services/tls-routes/describe create mode 100644 gcloud/network-services/tls-routes/export create mode 100644 gcloud/network-services/tls-routes/help create mode 100644 gcloud/network-services/tls-routes/import create mode 100644 gcloud/network-services/tls-routes/list create mode 100644 gcloud/notebooks/runtimes/create create mode 100644 gcloud/notebooks/runtimes/delete create mode 100644 gcloud/notebooks/runtimes/describe create mode 100644 gcloud/notebooks/runtimes/help create mode 100644 gcloud/notebooks/runtimes/list create mode 100644 gcloud/notebooks/runtimes/reset create mode 100644 gcloud/notebooks/runtimes/start create mode 100644 gcloud/notebooks/runtimes/stop create mode 100644 gcloud/notebooks/runtimes/switch create mode 100644 gcloud/org-policies/delete-custom-constraint create mode 100644 gcloud/org-policies/describe-custom-constraint create mode 100644 gcloud/org-policies/list-custom-constraints create mode 100644 gcloud/org-policies/set-custom-constraint create mode 100644 gcloud/spanner/samples/backend create mode 100644 gcloud/spanner/samples/help create mode 100644 gcloud/spanner/samples/init create mode 100644 gcloud/spanner/samples/list create mode 100644 gcloud/spanner/samples/run create mode 100644 gcloud/spanner/samples/workload diff --git a/gcloud/_version b/gcloud/_version index 9d8fd0128..92da9dc0e 100644 --- a/gcloud/_version +++ b/gcloud/_version @@ -1,7 +1,7 @@ -Google Cloud SDK 398.0.0 -alpha 2022.08.12 -beta 2022.08.12 +Google Cloud SDK 399.0.0 +alpha 2022.08.19 +beta 2022.08.19 bq 2.0.75 -core 2022.08.12 +core 2022.08.19 gcloud-crc32c 1.0.0 gsutil 5.12 diff --git a/gcloud/alpha/alloydb/clusters/help b/gcloud/alpha/alloydb/clusters/help index 26300ff81..cdb23f28f 100644 --- a/gcloud/alpha/alloydb/clusters/help +++ b/gcloud/alpha/alloydb/clusters/help @@ -30,7 +30,8 @@ COMMANDS (ALPHA) Lists AlloyDB clusters in a given project and region. restore - (ALPHA) Restores an AlloyDB cluster from a given backup. + (ALPHA) Restores an AlloyDB cluster from a given backup or a source + cluster at a specific point in time. update (ALPHA) Updates an AlloyDB cluster within a given project and region. diff --git a/gcloud/alpha/alloydb/clusters/restore b/gcloud/alpha/alloydb/clusters/restore index d54998883..34112383a 100644 --- a/gcloud/alpha/alloydb/clusters/restore +++ b/gcloud/alpha/alloydb/clusters/restore @@ -1,31 +1,37 @@ NAME gcloud alpha alloydb clusters restore - restores an AlloyDB cluster from a - given backup + given backup or a source cluster at a specific point in time SYNOPSIS - gcloud alpha alloydb clusters restore CLUSTER --backup=BACKUP - --region=REGION [--async] [--network=NETWORK] + gcloud alpha alloydb clusters restore CLUSTER --region=REGION [--async] + [--network=NETWORK] + [--backup=BACKUP + : --point-in-time=POINT_IN_TIME --source-cluster=SOURCE_CLUSTER] [--kms-key=KMS_KEY : --kms-keyring=KMS_KEYRING --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Restores an AlloyDB cluster from a given backup. + (ALPHA) Restores an AlloyDB cluster from a given backup or a source cluster + at a specific point in time. EXAMPLES To restore a cluster from a backup, run: $ gcloud alpha alloydb clusters restore my-cluster \ - --region=us-central1 --backup=my-backup + --region=us-central1 --backup=my-backup + + To restore a cluster back to a point in time, run: + + $ gcloud alpha alloydb clusters restore my-cluster \ + --region=us-central1 --source-cluster=my-source-cluster \ + --point-in-time=2003-09-25T10:49:41.519Z POSITIONAL ARGUMENTS CLUSTER AlloyDB cluster ID REQUIRED FLAGS - --backup=BACKUP - AlloyDB backup ID - --region=REGION Regional location (e.g. asia-east1, us-east1). See the full list of regions at https://cloud.google.com/sql/docs/instance-locations. @@ -42,6 +48,30 @@ OPTIONAL FLAGS network, 'testsharednetwork', this would be of the form:--network=projects/testproject/global/networks/testsharednetwork + RestoreCluster source types. + + At most one of these can be specified: + + Restore a cluster using a specific backup as the source. + + --backup=BACKUP + AlloyDB backup ID + + Restore a cluster from a source cluster at a given point in time. + + --point-in-time=POINT_IN_TIME + Point in time to restore to, in RFC 3339 format. For example, + 2012-11-15T16:19:00.094Z. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --source-cluster=SOURCE_CLUSTER + Source cluster name. + + This flag argument must be specified if any of the other arguments + in this group are specified. + Key resource - The Cloud KMS (Key Management Service) cryptokey that will be used to protect the cluster. The 'AlloyDB Service Agent' service account must hold permission 'Cloud KMS CryptoKey Encrypter/Decrypter'. diff --git a/gcloud/alpha/alloydb/operations/list b/gcloud/alpha/alloydb/operations/list index 63616cd24..1e4189d21 100644 --- a/gcloud/alpha/alloydb/operations/list +++ b/gcloud/alpha/alloydb/operations/list @@ -2,9 +2,10 @@ NAME gcloud alpha alloydb operations list - lists AlloyDB operations SYNOPSIS - gcloud alpha alloydb operations list [--region=REGION; default="-"] - [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] - [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + gcloud alpha alloydb operations list [--cluster=CLUSTER] + [--region=REGION; default="-"] [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Lists AlloyDB operations. @@ -15,6 +16,9 @@ EXAMPLES $ gcloud alpha alloydb operations list --region=us-central1 FLAGS + --cluster=CLUSTER + AlloyDB cluster ID + --region=REGION; default="-" Regional location (e.g. asia-east1, us-east1). See the full list of regions at https://cloud.google.com/sql/docs/instance-locations. diff --git a/gcloud/alpha/builds/triggers/create/manual b/gcloud/alpha/builds/triggers/create/manual index 58c047e0f..a6cab8dec 100644 --- a/gcloud/alpha/builds/triggers/create/manual +++ b/gcloud/alpha/builds/triggers/create/manual @@ -7,8 +7,9 @@ SYNOPSIS (--trigger-config=PATH | [(--build-config=PATH | --inline-config=PATH | --dockerfile=DOCKERFILE --dockerfile-dir=DOCKERFILE_DIR; default="/" --dockerfile-image=DOCKERFILE_IMAGE) - : --description=DESCRIPTION --filter=FILTER --name=NAME - --require-approval --service-account=SERVICE_ACCOUNT + : --description=DESCRIPTION --name=NAME --require-approval + --service-account=SERVICE_ACCOUNT + --subscription-filter=SUBSCRIPTION_FILTER --substitutions=[KEY=VALUE,...] --repo=REPO --repo-type=REPO_TYPE (--branch=BRANCH | --tag=TAG)]) [GCLOUD_WIDE_FLAG ...] @@ -38,11 +39,6 @@ REQUIRED FLAGS --description=DESCRIPTION Build trigger description. - --filter=FILTER - CEL filter expression for the trigger. See - https://cloud.google.com/build/docs/filter-build-events-using-cel - for more details. - --name=NAME Build trigger name. @@ -57,6 +53,11 @@ REQUIRED FLAGS used instead. Format: projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT_ID_OR_EMAIL}. + --subscription-filter=SUBSCRIPTION_FILTER + CEL filter expression for the trigger. See + https://cloud.google.com/build/docs/filter-build-events-using-cel + for more details. + --substitutions=[KEY=VALUE,...] Parameters to be substituted in the build specification. diff --git a/gcloud/alpha/builds/triggers/create/pubsub b/gcloud/alpha/builds/triggers/create/pubsub index e8a92569d..19a8f1aee 100644 --- a/gcloud/alpha/builds/triggers/create/pubsub +++ b/gcloud/alpha/builds/triggers/create/pubsub @@ -8,8 +8,9 @@ SYNOPSIS | --inline-config=PATH | --dockerfile=DOCKERFILE --dockerfile-dir=DOCKERFILE_DIR; default="/" --dockerfile-image=DOCKERFILE_IMAGE) - : --description=DESCRIPTION --filter=FILTER --name=NAME - --require-approval --service-account=SERVICE_ACCOUNT + : --description=DESCRIPTION --name=NAME --require-approval + --service-account=SERVICE_ACCOUNT + --subscription-filter=SUBSCRIPTION_FILTER --substitutions=[KEY=VALUE,...] --repo=REPO --repo-type=REPO_TYPE (--branch=BRANCH | --tag=TAG)]) [GCLOUD_WIDE_FLAG ...] @@ -48,11 +49,6 @@ REQUIRED FLAGS --description=DESCRIPTION Build trigger description. - --filter=FILTER - CEL filter expression for the trigger. See - https://cloud.google.com/build/docs/filter-build-events-using-cel - for more details. - --name=NAME Build trigger name. @@ -67,6 +63,11 @@ REQUIRED FLAGS used instead. Format: projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT_ID_OR_EMAIL}. + --subscription-filter=SUBSCRIPTION_FILTER + CEL filter expression for the trigger. See + https://cloud.google.com/build/docs/filter-build-events-using-cel + for more details. + --substitutions=[KEY=VALUE,...] Parameters to be substituted in the build specification. diff --git a/gcloud/alpha/builds/triggers/create/webhook b/gcloud/alpha/builds/triggers/create/webhook index 78edf0d77..5d747e483 100644 --- a/gcloud/alpha/builds/triggers/create/webhook +++ b/gcloud/alpha/builds/triggers/create/webhook @@ -8,8 +8,9 @@ SYNOPSIS | --inline-config=PATH | --dockerfile=DOCKERFILE --dockerfile-dir=DOCKERFILE_DIR; default="/" --dockerfile-image=DOCKERFILE_IMAGE) - : --description=DESCRIPTION --filter=FILTER --name=NAME - --require-approval --service-account=SERVICE_ACCOUNT + : --description=DESCRIPTION --name=NAME --require-approval + --service-account=SERVICE_ACCOUNT + --subscription-filter=SUBSCRIPTION_FILTER --substitutions=[KEY=VALUE,...] --repo=REPO --repo-type=REPO_TYPE (--branch=BRANCH | --tag=TAG)]) [GCLOUD_WIDE_FLAG ...] @@ -51,11 +52,6 @@ REQUIRED FLAGS --description=DESCRIPTION Build trigger description. - --filter=FILTER - CEL filter expression for the trigger. See - https://cloud.google.com/build/docs/filter-build-events-using-cel - for more details. - --name=NAME Build trigger name. @@ -70,6 +66,11 @@ REQUIRED FLAGS used instead. Format: projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT_ID_OR_EMAIL}. + --subscription-filter=SUBSCRIPTION_FILTER + CEL filter expression for the trigger. See + https://cloud.google.com/build/docs/filter-build-events-using-cel + for more details. + --substitutions=[KEY=VALUE,...] Parameters to be substituted in the build specification. diff --git a/gcloud/alpha/compute/disks/create b/gcloud/alpha/compute/disks/create index 52709b7ed..62e20031f 100644 --- a/gcloud/alpha/compute/disks/create +++ b/gcloud/alpha/compute/disks/create @@ -59,9 +59,10 @@ POSITIONAL ARGUMENTS FLAGS --architecture=ARCHITECTURE - Storage resources can be used to create boot disks compatible with - different machine architectures. ARCHITECTURE must be one of: ARM64, - X86_64. + Specifies the architecture or processor type that this disk can + support. For available processor types on Compute Engine, see + https://cloud.google.com/compute/docs/cpu-platforms. ARCHITECTURE must + be one of: ARM64, X86_64. --csek-key-file=FILE Path to a Customer-Supplied Encryption Key (CSEK) key file that maps diff --git a/gcloud/alpha/compute/disks/update b/gcloud/alpha/compute/disks/update index b03087a4b..610f8b2a2 100644 --- a/gcloud/alpha/compute/disks/update +++ b/gcloud/alpha/compute/disks/update @@ -50,12 +50,13 @@ FLAGS At most one of these can be specified: --clear-architecture - Remove the architecture annotation on a disk. + Removes the architecture or processor type annotation from the disk. --update-architecture=UPDATE_ARCHITECTURE - Storage resources can be used to create boot disks compatible with - different machine architectures. UPDATE_ARCHITECTURE must be one of: - ARM64, X86_64. + Updates the architecture or processor type that this disk can + support. For available processor types on Compute Engine, see + https://cloud.google.com/compute/docs/cpu-platforms. + UPDATE_ARCHITECTURE must be one of: ARM64, X86_64. At most one of these can be specified: diff --git a/gcloud/alpha/compute/future-reservations/create b/gcloud/alpha/compute/future-reservations/create index 9ac7e1756..2921e35df 100644 --- a/gcloud/alpha/compute/future-reservations/create +++ b/gcloud/alpha/compute/future-reservations/create @@ -11,7 +11,8 @@ SYNOPSIS --maintenance-interval=MAINTENANCE_INTERVAL --min-cpu-platform=MIN_CPU_PLATFORM) (--start-time=START_TIME (--duration=DURATION | --end-time=END_TIME)) - [--description=DESCRIPTION] [--name-prefix=NAME_PREFIX] [--zone=ZONE] + [--description=DESCRIPTION] [--name-prefix=NAME_PREFIX] + [--planning-status=PLANNING_STATUS] [--zone=ZONE] [--share-setting=SHARE_SETTING --share-with=PROJECT,[PROJECT,...]] [GCLOUD_WIDE_FLAG ...] @@ -126,6 +127,20 @@ OPTIONAL FLAGS User provided name prefix for system generated reservations when capacity is delivered at start time. + --planning-status=PLANNING_STATUS + The planning status of the future reservation. The default value is + DRAFT. While in DRAFT, any changes to the future reservation's + properties will be allowed. If set to SUBMITTED, the future reservation + will submit and its procurementStatus will change to PENDING_APPROVAL. + Once the future reservation is pending approval, changes to the future + reservation's properties will not be allowed. PLANNING_STATUS must be + one of: + + DRAFT + Default planning status value. + SUBMITTED + Planning status value to immediately submit the future reservation. + --zone=ZONE Zone of the future reservation to create. If not specified and the compute/zone property isn't set, you might be prompted to select a zone diff --git a/gcloud/alpha/compute/future-reservations/update b/gcloud/alpha/compute/future-reservations/update index 1c6ff76c7..8f8c01665 100644 --- a/gcloud/alpha/compute/future-reservations/update +++ b/gcloud/alpha/compute/future-reservations/update @@ -4,8 +4,15 @@ NAME SYNOPSIS gcloud alpha compute future-reservations update FUTURE_RESERVATION - [--start-time=START_TIME] [--total-count=TOTAL_COUNT] [--zone=ZONE] - [--duration=DURATION | --end-time=END_TIME] [GCLOUD_WIDE_FLAG ...] + [--planning-status=PLANNING_STATUS] [--total-count=TOTAL_COUNT] + [--zone=ZONE] + [--accelerator=[count=COUNT],[type=TYPE] + --local-ssd=[interface=INTERFACE],[size=SIZE] + --machine-type=MACHINE_TYPE + --maintenance-interval=MAINTENANCE_INTERVAL + --min-cpu-platform=MIN_CPU_PLATFORM] + [--start-time=START_TIME --duration=DURATION | --end-time=END_TIME] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Update Compute Engine future reservations. @@ -24,12 +31,19 @@ POSITIONAL ARGUMENTS Name of the future reservation to update. FLAGS - --start-time=START_TIME - Start time of the Future Reservation. The start time must be an RFC3339 - valid string formatted by date, time, and timezone or - "YYYY-MM-DDTHH:MM:SSZ"; where YYYY = year, MM = month, DD = day, HH = - hours, MM = minutes, SS = seconds, and Z = timezone (i.e. - 2021-11-20T07:00:00Z). + --planning-status=PLANNING_STATUS + The planning status of the future reservation. The default value is + DRAFT. While in DRAFT, any changes to the future reservation's + properties will be allowed. If set to SUBMITTED, the future reservation + will submit and its procurementStatus will change to PENDING_APPROVAL. + Once the future reservation is pending approval, changes to the future + reservation's properties will not be allowed. PLANNING_STATUS must be + one of: + + DRAFT + Default planning status value. + SUBMITTED + Planning status value to immediately submit the future reservation. --total-count=TOTAL_COUNT The total number of instances for which capacity assurance is requested @@ -56,19 +70,73 @@ FLAGS Alternatively, the zone can be stored in the environment variable CLOUDSDK_COMPUTE_ZONE. - At most one of these can be specified: + Manage the specific SKU reservation properties. - --duration=DURATION - Alternate way of specifying time in the number of seconds to - terminate capacity request relative to the start time of a request. + --accelerator=[count=COUNT],[type=TYPE] + Manage the configuration of the type and number of accelerator cards + attached. + count + The number of accelerators to attach to each instance in the + reservation. + type + The specific type (e.g. nvidia-tesla-k80 for nVidia Tesla K80) of + accelerator to attach to instances in the reservation. Use gcloud + compute accelerator-types list to learn about all available + accelerator types. - --end-time=END_TIME - End time of the Future Reservation. The end time must be an RFC3339 - valid string formatted by date, time, and timezone or + --local-ssd=[interface=INTERFACE],[size=SIZE] + Manage the size and the interface of local SSD to use. See + https://cloud.google.com/compute/docs/disks/local-ssd for more + information. + interface + The kind of disk interface exposed to the VM for this SSD. Valid + values are scsi and nvme. SCSI is the default and is supported by + more guest operating systems. NVME may provide higher + performance. + size + The size of the local SSD in base-2 GB. + + --machine-type=MACHINE_TYPE + The type of machine (name only) which has a fixed number of vCPUs and + a fixed amount of memory. This also includes specifying custom + machine type following custom-number_of_CPUs-amount_of_memory + pattern, e.g. custom-32-29440. + + --maintenance-interval=MAINTENANCE_INTERVAL + Specifies how infrastructure upgrades should be applied to the VM. + MAINTENANCE_INTERVAL must be (currently only one value is supported): + + PERIODIC + VMs receive infrastructure and hypervisor updates on a periodic + basis, minimizing the number of maintenance operations (live + migrations or terminations) on an individual VM. Security updates + will still be applied as soon as they are available. + + --min-cpu-platform=MIN_CPU_PLATFORM + Optional minimum CPU platform of the reservation to create. + + Manage the time specific properties for requesting future capacity + + --start-time=START_TIME + Start time of the Future Reservation. The start time must be an + RFC3339 valid string formatted by date, time, and timezone or "YYYY-MM-DDTHH:MM:SSZ"; where YYYY = year, MM = month, DD = day, HH = hours, MM = minutes, SS = seconds, and Z = timezone (i.e. 2021-11-20T07:00:00Z). + At most one of these can be specified: + + --duration=DURATION + Alternate way of specifying time in the number of seconds to + terminate capacity request relative to the start time of a request. + + --end-time=END_TIME + End time of the Future Reservation. The end time must be an RFC3339 + valid string formatted by date, time, and timezone or + "YYYY-MM-DDTHH:MM:SSZ"; where YYYY = year, MM = month, DD = day, HH + = hours, MM = minutes, SS = seconds, and Z = timezone (i.e. + 2021-11-20T07:00:00Z). + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/compute/images/create b/gcloud/alpha/compute/images/create index f222fbe95..8b636b638 100644 --- a/gcloud/alpha/compute/images/create +++ b/gcloud/alpha/compute/images/create @@ -106,9 +106,10 @@ REQUIRED FLAGS OPTIONAL FLAGS --architecture=ARCHITECTURE - Storage resources can be used to create boot disks compatible with - different machine architectures. ARCHITECTURE must be one of: ARM64, - X86_64. + Specifies the architecture or processor type that this image can + support. For available processor types on Compute Engine, see + https://cloud.google.com/compute/docs/cpu-platforms. ARCHITECTURE must + be one of: ARM64, X86_64. --csek-key-file=FILE Path to a Customer-Supplied Encryption Key (CSEK) key file that maps diff --git a/gcloud/alpha/compute/images/update b/gcloud/alpha/compute/images/update index 6cee2a473..484dd696a 100644 --- a/gcloud/alpha/compute/images/update +++ b/gcloud/alpha/compute/images/update @@ -36,9 +36,10 @@ POSITIONAL ARGUMENTS FLAGS --architecture=ARCHITECTURE - Image resources can be used to create boot disks compatible with - different machine architectures. ARCHITECTURE must be one of: ARM64, - X86_64. + Specifies the architecture or processor type that this image can + support. For available processor types on Compute Engine, see + https://cloud.google.com/compute/docs/cpu-platforms. ARCHITECTURE must + be one of: ARM64, X86_64. --description=DESCRIPTION An optional text description for the image. diff --git a/gcloud/alpha/compute/resource-policies/create/disk-consistency-group b/gcloud/alpha/compute/resource-policies/create/disk-consistency-group new file mode 100644 index 000000000..8bc794ee5 --- /dev/null +++ b/gcloud/alpha/compute/resource-policies/create/disk-consistency-group @@ -0,0 +1,58 @@ +NAME + gcloud alpha compute resource-policies create disk-consistency-group - + create a Compute Engine Disk Consistency Group resource policy + +SYNOPSIS + gcloud alpha compute resource-policies create disk-consistency-group NAME + [--description=DESCRIPTION] [--region=REGION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create a Compute Engine Disk Consistency Group Resource Policy. + +EXAMPLES + To create a Compute Engine Disk Consistency Group policy, run: $ gcloud + alpha compute resource-policies create disk-consistency-group + my-resource-policy --region=REGION + +POSITIONAL ARGUMENTS + NAME + Name of the resource policy to operate on. + +FLAGS + --description=DESCRIPTION + An optional, textual description for the backend. + + --region=REGION + Region of the resource policy 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. + +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/compute/resource-policies/create/help b/gcloud/alpha/compute/resource-policies/create/help index 7feada732..2a8b704b7 100644 --- a/gcloud/alpha/compute/resource-policies/create/help +++ b/gcloud/alpha/compute/resource-policies/create/help @@ -23,6 +23,9 @@ GROUPS COMMANDS COMMAND is one of the following: + disk-consistency-group + (ALPHA) Create a Compute Engine Disk Consistency Group resource policy. + group-placement (ALPHA) Create a Compute Engine group placement resource policy. diff --git a/gcloud/alpha/compute/scp b/gcloud/alpha/compute/scp index f0cba24cb..d84b47624 100644 --- a/gcloud/alpha/compute/scp +++ b/gcloud/alpha/compute/scp @@ -15,8 +15,11 @@ SYNOPSIS DESCRIPTION (ALPHA) gcloud alpha compute scp securely copies files between a virtual - machine instance and your local machine using the scp command. This command - does not work for Windows VMs. + machine instance and your local machine using the scp command. + + This command works for Linux VMs and Windows Server 2019 and later VMs that + have SSH enabled + (https://cloud.google.com/compute/docs/connect/windows-ssh). In order to set up a successful transfer, follow these guidelines: ▪ Prefix remote file names with the virtual machine instance name diff --git a/gcloud/alpha/config/help b/gcloud/alpha/config/help index 18b824b39..186cb4f4c 100644 --- a/gcloud/alpha/config/help +++ b/gcloud/alpha/config/help @@ -185,6 +185,10 @@ AVAILABLE PROPERTIES anthosevents Overrides API endpoint for gcloud anthos command group. + anthospolicycontrollerstatus_pa + Overrides API endpoint for gcloud container fleet policycontroller + command group. + apigateway Overrides API endpoint for gcloud api-gateway command group. @@ -1115,6 +1119,13 @@ AVAILABLE PROPERTIES upload_chunk_size Chunk size used for uploading to clouds. + use_gcloud_crc32c + If True, data integrity checks use a binary subprocess to calculate + CRC32C hashes with the included gcloud-crc32c tool rather than the + google-crc32c Python library. This behavior is also triggered when + the google-crc32c Python library is unavailable even if this + property is False. + use_gsutil If True, use the deprecated upload implementation which uses gsutil. diff --git a/gcloud/alpha/config/list b/gcloud/alpha/config/list index d015c73b6..42e707c26 100644 --- a/gcloud/alpha/config/list +++ b/gcloud/alpha/config/list @@ -194,6 +194,10 @@ AVAILABLE PROPERTIES anthosevents Overrides API endpoint for gcloud anthos command group. + anthospolicycontrollerstatus_pa + Overrides API endpoint for gcloud container fleet policycontroller + command group. + apigateway Overrides API endpoint for gcloud api-gateway command group. @@ -1124,6 +1128,13 @@ AVAILABLE PROPERTIES upload_chunk_size Chunk size used for uploading to clouds. + use_gcloud_crc32c + If True, data integrity checks use a binary subprocess to calculate + CRC32C hashes with the included gcloud-crc32c tool rather than the + google-crc32c Python library. This behavior is also triggered when + the google-crc32c Python library is unavailable even if this + property is False. + use_gsutil If True, use the deprecated upload implementation which uses gsutil. diff --git a/gcloud/alpha/config/set b/gcloud/alpha/config/set index 58a699f47..33c9a15e1 100644 --- a/gcloud/alpha/config/set +++ b/gcloud/alpha/config/set @@ -203,6 +203,10 @@ AVAILABLE PROPERTIES anthosevents Overrides API endpoint for gcloud anthos command group. + anthospolicycontrollerstatus_pa + Overrides API endpoint for gcloud container fleet policycontroller + command group. + apigateway Overrides API endpoint for gcloud api-gateway command group. @@ -1133,6 +1137,13 @@ AVAILABLE PROPERTIES upload_chunk_size Chunk size used for uploading to clouds. + use_gcloud_crc32c + If True, data integrity checks use a binary subprocess to calculate + CRC32C hashes with the included gcloud-crc32c tool rather than the + google-crc32c Python library. This behavior is also triggered when + the google-crc32c Python library is unavailable even if this + property is False. + use_gsutil If True, use the deprecated upload implementation which uses gsutil. diff --git a/gcloud/alpha/config/unset b/gcloud/alpha/config/unset index bc9255f8d..70b3ae0a8 100644 --- a/gcloud/alpha/config/unset +++ b/gcloud/alpha/config/unset @@ -164,6 +164,10 @@ AVAILABLE PROPERTIES anthosevents Overrides API endpoint for gcloud anthos command group. + anthospolicycontrollerstatus_pa + Overrides API endpoint for gcloud container fleet policycontroller + command group. + apigateway Overrides API endpoint for gcloud api-gateway command group. @@ -1094,6 +1098,13 @@ AVAILABLE PROPERTIES upload_chunk_size Chunk size used for uploading to clouds. + use_gcloud_crc32c + If True, data integrity checks use a binary subprocess to calculate + CRC32C hashes with the included gcloud-crc32c tool rather than the + google-crc32c Python library. This behavior is also triggered when + the google-crc32c Python library is unavailable even if this + property is False. + use_gsutil If True, use the deprecated upload implementation which uses gsutil. diff --git a/gcloud/alpha/container/backup-restore/restores/create b/gcloud/alpha/container/backup-restore/restores/create index 1b3f5504c..e7a7fbbf9 100644 --- a/gcloud/alpha/container/backup-restore/restores/create +++ b/gcloud/alpha/container/backup-restore/restores/create @@ -16,7 +16,9 @@ EXAMPLES $ gcloud alpha container backup-restore restores create my-restore \ --project=my-project --location=us-central1 \ - --restore-plan=my-restore-plan + --restore-plan=my-restore-plan \ + --backup=projects/my-project/locations/us-east1/backupPlans/\ + my-backup-plan/backups/my-backup POSITIONAL ARGUMENTS Restore resource - Name of the restore to create. Once the restore is diff --git a/gcloud/alpha/container/fleet/memberships/generate-gateway-rbac b/gcloud/alpha/container/fleet/memberships/generate-gateway-rbac index e2cf1588e..0712520f8 100644 --- a/gcloud/alpha/container/fleet/memberships/generate-gateway-rbac +++ b/gcloud/alpha/container/fleet/memberships/generate-gateway-rbac @@ -52,7 +52,7 @@ EXAMPLES --membership=my-cluster \ --users=foo@example.com,\ test-acct@test-project.iam.gserviceaccount.com \ - --role=clusterrole/cluster-admin --context=my-cluster-contex \ + --role=clusterrole/cluster-admin --context=my-cluster-context \ --kubeconfig=/home/user/custom_kubeconfig --apply Revoke mode, revoke the RBAC policy for the specified users: @@ -61,9 +61,19 @@ EXAMPLES --membership=my-cluster \ --users=foo@example.com,\ test-acct@test-project.iam.gserviceaccount.com \ - --role=clusterrole/cluster-admin --context=my-cluster-contex \ + --role=clusterrole/cluster-admin --context=my-cluster-context \ --kubeconfig=/home/user/custom_kubeconfig --revoke + The role to be granted to the users can either be cluster-scoped or + namespace-scoped. To grant a namespace-scoped role to the users in dry run + mode, run: + + $ gcloud alpha container fleet memberships generate-gateway-rbac \ + --membership=my-cluster \ + --users=foo@example.com,\ + test-acct@test-project.iam.gserviceaccount.com \ + --role=role/mynamespace/namespace-reader + FLAGS --anthos-support If specified, this command will generate RBAC policy file for anthos diff --git a/gcloud/alpha/container/hub/memberships/generate-gateway-rbac b/gcloud/alpha/container/hub/memberships/generate-gateway-rbac index 4a0128943..356595b31 100644 --- a/gcloud/alpha/container/hub/memberships/generate-gateway-rbac +++ b/gcloud/alpha/container/hub/memberships/generate-gateway-rbac @@ -52,7 +52,7 @@ EXAMPLES --membership=my-cluster \ --users=foo@example.com,\ test-acct@test-project.iam.gserviceaccount.com \ - --role=clusterrole/cluster-admin --context=my-cluster-contex \ + --role=clusterrole/cluster-admin --context=my-cluster-context \ --kubeconfig=/home/user/custom_kubeconfig --apply Revoke mode, revoke the RBAC policy for the specified users: @@ -61,9 +61,19 @@ EXAMPLES --membership=my-cluster \ --users=foo@example.com,\ test-acct@test-project.iam.gserviceaccount.com \ - --role=clusterrole/cluster-admin --context=my-cluster-contex \ + --role=clusterrole/cluster-admin --context=my-cluster-context \ --kubeconfig=/home/user/custom_kubeconfig --revoke + The role to be granted to the users can either be cluster-scoped or + namespace-scoped. To grant a namespace-scoped role to the users in dry run + mode, run: + + $ gcloud alpha container hub memberships generate-gateway-rbac \ + --membership=my-cluster \ + --users=foo@example.com,\ + test-acct@test-project.iam.gserviceaccount.com \ + --role=role/mynamespace/namespace-reader + FLAGS --anthos-support If specified, this command will generate RBAC policy file for anthos diff --git a/gcloud/alpha/firebase/test/android/list-device-capacities b/gcloud/alpha/firebase/test/android/list-device-capacities index 4d0e87949..301269492 100644 --- a/gcloud/alpha/firebase/test/android/list-device-capacities +++ b/gcloud/alpha/firebase/test/android/list-device-capacities @@ -22,15 +22,15 @@ EXAMPLES $ gcloud alpha firebase test android list-device-capacities - To list only models made by Samsung, run: + To list capacity only for model named redfin, run: $ gcloud alpha firebase test android list-device-capacities \ - --filter=Samsung + --filter=redfin - To list only physical device models, run: + To list capacity only for API version 30, run: $ gcloud alpha firebase test android list-device-capacities \ - --filter=physical + --filter=30 LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/alpha/firestore/databases/create b/gcloud/alpha/firestore/databases/create index 8a5bc9f78..3ef644093 100644 --- a/gcloud/alpha/firestore/databases/create +++ b/gcloud/alpha/firestore/databases/create @@ -1,31 +1,23 @@ NAME gcloud alpha firestore databases create - create a Google Cloud Firestore - Native database + Native database via Firestore API SYNOPSIS - gcloud alpha firestore databases create [--region=REGION] - [GCLOUD_WIDE_FLAG ...] + gcloud alpha firestore databases create [--location=LOCATION] + [--type=TYPE; default="firestore-native"] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Create a Google Cloud Firestore Native database. - -EXAMPLES - To create Google Cloud Firestore Native database - - $ gcloud alpha firestore databases create - - To create an app in the nam5 region (multi-region), run: - - $ gcloud alpha firestore databases create --region=nam5 - - To create an app in the us-east1 region, run: - - $ gcloud alpha firestore databases create --region=us-east1 + (ALPHA) Create a Google Cloud Firestore Native database via Firestore API. FLAGS - --region=REGION - The region to create the Google Cloud Firestore Native database within. - Use gcloud app regions list to list available regions. + --location=LOCATION + The location to create the Google Cloud Firestore Native database + within. Available databases are listed at + https://cloud.google.com/firestore/docs/locations. + + --type=TYPE; default="firestore-native" + The type of the database. TYPE must be one of: firestore-native, + datastore-mode. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/firestore/databases/help b/gcloud/alpha/firestore/databases/help index 84f77cb0f..c61d31015 100644 --- a/gcloud/alpha/firestore/databases/help +++ b/gcloud/alpha/firestore/databases/help @@ -17,7 +17,8 @@ COMMANDS COMMAND is one of the following: create - (ALPHA) Create a Google Cloud Firestore Native database. + (ALPHA) Create a Google Cloud Firestore Native database via Firestore + API. describe (ALPHA) Describe a Google Cloud Firestore database. diff --git a/gcloud/alpha/functions/deploy b/gcloud/alpha/functions/deploy index 24a2b8da8..da158e5be 100644 --- a/gcloud/alpha/functions/deploy +++ b/gcloud/alpha/functions/deploy @@ -182,7 +182,7 @@ FLAGS ◆ python37: Python 3.7 ◆ python38: Python 3.8 ◆ python39: Python 3.9 - ◆ python310: Python 3.10 (preview) + ◆ python310: Python 3.10 ◆ go111: Go 1.11 ◆ go113: Go 1.13 ◆ go116: Go 1.16 diff --git a/gcloud/alpha/network-connectivity/policy-based-routes/create b/gcloud/alpha/network-connectivity/policy-based-routes/create index 149da8fe5..899c805ae 100644 --- a/gcloud/alpha/network-connectivity/policy-based-routes/create +++ b/gcloud/alpha/network-connectivity/policy-based-routes/create @@ -6,13 +6,12 @@ SYNOPSIS gcloud alpha network-connectivity policy-based-routes create POLICY_BASED_ROUTE --network=NETWORK --next-hop-ilb-ip=NEXT_HOP_ILB_IP [--async] [--description=DESCRIPTION] - [--destination-range=DESTINATION_RANGE] - [--interconnect-attachment-region=INTERCONNECT_ATTACHMENT_REGION] - [--ip-protocol=IP_PROTOCOL] [--labels=[KEY=VALUE,...]] - [--priority=PRIORITY] + [--destination-range=DESTINATION_RANGE] [--ip-protocol=IP_PROTOCOL] + [--labels=[KEY=VALUE,...]] [--priority=PRIORITY] [--protocol-version=PROTOCOL_VERSION; default="IPv4"] - [--source-range=SOURCE_RANGE] [--tags=[TAGS,...]] - [GCLOUD_WIDE_FLAG ...] + [--source-range=SOURCE_RANGE] + [--interconnect-attachment-region=INTERCONNECT_ATTACHMENT_REGION + | --tags=[TAGS,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Create a new policy based route with the given name. @@ -64,13 +63,6 @@ OPTIONAL FLAGS Destination IP range of outgoing packets that this policy based route applies to. - --interconnect-attachment-region=INTERCONNECT_ATTACHMENT_REGION - Cloud region to install this policy based route on interconnect - attachment. Use all to install it on all interconnect attachments. Note - if both --tags and --interconnect-attachment-region are not set, then - the policy based route will be installed in all network endpoints, - including VMs, VPNs, and Interconnects, in the network. - --ip-protocol=IP_PROTOCOL IP protocol that this policy based route applies to. Valid values are TCP, UDP, and ALL. Default is ALL. @@ -101,11 +93,22 @@ OPTIONAL FLAGS Source IP range of outgoing packets that this policy based route applies to. - --tags=[TAGS,...] - List of VM instance tags to which this route applies to. Note if both - --tags and --interconnect-attachment-region are not set, then the - policy based route will be installed in all endpoints, including VMs, - VPNs, and Interconnects, in the network. + At most one of these can be specified: + + --interconnect-attachment-region=INTERCONNECT_ATTACHMENT_REGION + Cloud region to install this policy based route on interconnect + attachment. Use all to install it on all interconnect attachments. + Note if both --tags and --interconnect-attachment-region are not set, + then the policy based route will be installed in all network + endpoints, including VMs, VPNs, and Interconnect attachements, in the + network. + + --tags=[TAGS,...] + List of VM instance tags to which this route applies to. VM instances + that have ANY of tags specified here will install this route. Note if + both --tags and --interconnect-attachment-region are not set, then + the policy based route will be installed in all endpoints, including + VMs, VPNs, and Interconnect attachements, in the network. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/network-services/tls-routes/delete b/gcloud/alpha/network-services/tls-routes/delete index 665dcbdd4..100b02338 100644 --- a/gcloud/alpha/network-services/tls-routes/delete +++ b/gcloud/alpha/network-services/tls-routes/delete @@ -8,6 +8,12 @@ SYNOPSIS DESCRIPTION (ALPHA) Delete the specified tls route. +EXAMPLES + To delete a tls route named my-tls-route, run: + + $ gcloud alpha network-services tls-routes delete my-tls-route \ + --location=global + POSITIONAL ARGUMENTS Tls route resource - Name of the tls route you want to delete. The arguments in this group can be used to specify the attributes of this @@ -57,5 +63,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 network-services tls-routes delete diff --git a/gcloud/alpha/network-services/tls-routes/describe b/gcloud/alpha/network-services/tls-routes/describe index 436d12435..4d700af12 100644 --- a/gcloud/alpha/network-services/tls-routes/describe +++ b/gcloud/alpha/network-services/tls-routes/describe @@ -9,7 +9,7 @@ DESCRIPTION (ALPHA) Show details of a tls route. EXAMPLES - Show details about a tls route named 'my-tls-route'. + Show details about a tls route named my-tls-route. $ gcloud alpha network-services tls-routes describe my-tls-route \ --location=global @@ -58,5 +58,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 network-services tls-routes describe diff --git a/gcloud/alpha/network-services/tls-routes/export b/gcloud/alpha/network-services/tls-routes/export index 6e0a610f0..f5939452c 100644 --- a/gcloud/alpha/network-services/tls-routes/export +++ b/gcloud/alpha/network-services/tls-routes/export @@ -9,6 +9,12 @@ SYNOPSIS DESCRIPTION (ALPHA) Export a tls route. +EXAMPLES + To export a tls route named my-tls-route to a YAML file, run: + + $ gcloud alpha network-services tls-routes export my-tls-route \ + --destination=my-tls-route.yaml --location=global + POSITIONAL ARGUMENTS Tls route resource - Name of the tls route to export. The arguments in this group can be used to specify the attributes of this resource. (NOTE) @@ -61,5 +67,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 network-services tls-routes export diff --git a/gcloud/alpha/network-services/tls-routes/help b/gcloud/alpha/network-services/tls-routes/help index 6069e13e3..7601a49e0 100644 --- a/gcloud/alpha/network-services/tls-routes/help +++ b/gcloud/alpha/network-services/tls-routes/help @@ -35,5 +35,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud network-services tls-routes diff --git a/gcloud/alpha/network-services/tls-routes/import b/gcloud/alpha/network-services/tls-routes/import index f7bbc5175..ff316947a 100644 --- a/gcloud/alpha/network-services/tls-routes/import +++ b/gcloud/alpha/network-services/tls-routes/import @@ -9,6 +9,12 @@ SYNOPSIS DESCRIPTION (ALPHA) Import a tls route. +EXAMPLES + To import a tls route named my-tls-route from a YAML file, run: + + $ gcloud alpha network-services tls-routes import my-tls-route \ + --source=my-tls-route.yaml --location=global + POSITIONAL ARGUMENTS Tls route resource - Name of the tls route to import. The arguments in this group can be used to specify the attributes of this resource. (NOTE) @@ -68,5 +74,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 network-services tls-routes import diff --git a/gcloud/alpha/network-services/tls-routes/list b/gcloud/alpha/network-services/tls-routes/list index 882ae6e39..5ae7e7485 100644 --- a/gcloud/alpha/network-services/tls-routes/list +++ b/gcloud/alpha/network-services/tls-routes/list @@ -10,6 +10,11 @@ DESCRIPTION (ALPHA) List all tls routes in the specified location of the current project. +EXAMPLES + To list tls routes in the current project, run: + + $ gcloud alpha network-services tls-routes list --location=global + REQUIRED FLAGS Location resource - The project of the tls routes to display. This represents a Cloud resource. (NOTE) Some attributes are not given @@ -75,5 +80,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 network-services tls-routes list diff --git a/gcloud/alpha/spanner/instances/create b/gcloud/alpha/spanner/instances/create index 65f127014..2adcfe8c2 100644 --- a/gcloud/alpha/spanner/instances/create +++ b/gcloud/alpha/spanner/instances/create @@ -37,25 +37,27 @@ OPTIONAL FLAGS complete. --expire-behavior=EXPIRE_BEHAVIOR - The expire behavior of a free instance. EXPIRE_BEHAVIOR must be one of: + The expire behavior of a free trial instance. EXPIRE_BEHAVIOR must be + one of: free-to-provisioned - When the free instance expires, upgrade the instance to a - provisioned instance + When the free trial instance expires, upgrade the instance to a + provisioned instance. remove-after-grace-period - When the free instance expires, disable the instance, and delete it - after the grace period passes if it has not been upgraded. + When the free trial instance expires, disable the instance, and + delete it after the grace period passes if it has not been upgraded + to a provisioned instance. --instance-type=INSTANCE_TYPE - The type of this instance. INSTANCE_TYPE must be one of: + Specifies the type for this instance. INSTANCE_TYPE must be one of: free-instance - Free instances provide no guarantee for dedicated resources, - [node_count, processing_units] should be 0. They come with stricter - usage limits and limited support. + Free trial instances provide no guarantees for dedicated resources, + both node_count and processing_units should be 0. They come with + stricter usage limits and limited support. provisioned Provisioned instances have dedicated resources, standard usage - limits and support + limits, and support. At most one of these can be specified: diff --git a/gcloud/alpha/spanner/instances/update b/gcloud/alpha/spanner/instances/update index fe20dac5d..911cc6da0 100644 --- a/gcloud/alpha/spanner/instances/update +++ b/gcloud/alpha/spanner/instances/update @@ -34,25 +34,27 @@ FLAGS Description of the instance. --expire-behavior=EXPIRE_BEHAVIOR - The expire behavior of a free instance. EXPIRE_BEHAVIOR must be one of: + The expire behavior of a free trial instance. EXPIRE_BEHAVIOR must be + one of: free-to-provisioned - When the free instance expires, upgrade the instance to a - provisioned instance + When the free trial instance expires, upgrade the instance to a + provisioned instance. remove-after-grace-period - When the free instance expires, disable the instance, and delete it - after the grace period passes if it has not been upgraded. + When the free trial instance expires, disable the instance, and + delete it after the grace period passes if it has not been upgraded + to a provisioned instance. --instance-type=INSTANCE_TYPE - The type of this instance. INSTANCE_TYPE must be one of: + Specifies the type for this instance. INSTANCE_TYPE must be one of: free-instance - Free instances provide no guarantee for dedicated resources, - [node_count, processing_units] should be 0. They come with stricter - usage limits and limited support. + Free trial instances provide no guarantees for dedicated resources, + both node_count and processing_units should be 0. They come with + stricter usage limits and limited support. provisioned Provisioned instances have dedicated resources, standard usage - limits and support + limits, and support. At most one of these can be specified: diff --git a/gcloud/alpha/spanner/samples/backend b/gcloud/alpha/spanner/samples/backend index a0ca45e49..59f0c6eb2 100644 --- a/gcloud/alpha/spanner/samples/backend +++ b/gcloud/alpha/spanner/samples/backend @@ -59,5 +59,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. These variants are also available: + + $ gcloud spanner samples backend + + $ gcloud beta spanner samples backend diff --git a/gcloud/alpha/spanner/samples/help b/gcloud/alpha/spanner/samples/help index 8eed1dde2..9b8fb9f36 100644 --- a/gcloud/alpha/spanner/samples/help +++ b/gcloud/alpha/spanner/samples/help @@ -44,5 +44,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 spanner samples + + $ gcloud beta spanner samples diff --git a/gcloud/alpha/spanner/samples/init b/gcloud/alpha/spanner/samples/init index 3bc89a491..32f60fd4e 100644 --- a/gcloud/alpha/spanner/samples/init +++ b/gcloud/alpha/spanner/samples/init @@ -38,5 +38,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 spanner samples init + + $ gcloud beta spanner samples init diff --git a/gcloud/alpha/spanner/samples/list b/gcloud/alpha/spanner/samples/list index 04330c671..46dfdcbed 100644 --- a/gcloud/alpha/spanner/samples/list +++ b/gcloud/alpha/spanner/samples/list @@ -9,6 +9,11 @@ SYNOPSIS DESCRIPTION (ALPHA) List available sample applications. +EXAMPLES + To list available sample applications, run: + + $ gcloud alpha spanner samples list + LIST COMMAND FLAGS --filter=EXPRESSION Apply a Boolean filter EXPRESSION to each resource item to be listed. @@ -53,5 +58,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. These variants are also available: + + $ gcloud spanner samples list + + $ gcloud beta spanner samples list diff --git a/gcloud/alpha/spanner/samples/run b/gcloud/alpha/spanner/samples/run index f30cd97df..5a128f4a8 100644 --- a/gcloud/alpha/spanner/samples/run +++ b/gcloud/alpha/spanner/samples/run @@ -56,5 +56,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 spanner samples run + + $ gcloud beta spanner samples run diff --git a/gcloud/alpha/spanner/samples/workload b/gcloud/alpha/spanner/samples/workload index 573a812dc..8c67dcfa8 100644 --- a/gcloud/alpha/spanner/samples/workload +++ b/gcloud/alpha/spanner/samples/workload @@ -50,5 +50,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 spanner samples workload + + $ gcloud beta spanner samples workload diff --git a/gcloud/alpha/storage/cp b/gcloud/alpha/storage/cp index 7b090eb4a..49e25b937 100644 --- a/gcloud/alpha/storage/cp +++ b/gcloud/alpha/storage/cp @@ -10,8 +10,7 @@ SYNOPSIS [--content-type=CONTENT_TYPE] [--continue-on-error, -c] [--custom-time=CUSTOM_TIME] [--daisy-chain, -D] [--decryption-keys=[DECRYPTION_KEY,...]] [--do-not-decompress] - [--encryption-key=ENCRYPTION_KEY] [--if-generation-match=GENERATION] - [--if-metageneration-match=METAGENERATION] [--ignore-symlinks] + [--encryption-key=ENCRYPTION_KEY] [--ignore-symlinks] [--manifest-path=MANIFEST_PATH, -L MANIFEST_PATH] [--preserve-posix, -P] [--print-created-message, -v] [--read-paths-from-stdin, -I] [--recursive, -R, -r] @@ -27,7 +26,9 @@ SYNOPSIS [--gzip-in-flight=[FILE_EXTENSIONS,...], -j [FILE_EXTENSIONS,...] | --gzip-in-flight-all, -J | --gzip-local=[FILE_EXTENSIONS,...], -z [FILE_EXTENSIONS,...] - | --gzip-local-all, -Z] [GCLOUD_WIDE_FLAG ...] + | --gzip-local-all, -Z] + [--if-generation-match=GENERATION + --if-metageneration-match=METAGENERATION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Copy data between your local file system and the cloud, within the @@ -136,14 +137,6 @@ FLAGS a new location. Using this flag in an objects update command triggers a rewrite of target objects. - --if-generation-match=GENERATION - Execute only if the generation matches the generation of the requested - object. - - --if-metageneration-match=METAGENERATION - Execute only if the metageneration matches the metageneration of the - requested object. - --ignore-symlinks Ignore file symlinks instead of copying what they point to. Symlinks pointing to directories will always be ignored. @@ -300,6 +293,15 @@ FLAGS binary data, using this option may result in files taking up more space in the cloud than they would if left uncompressed. +PRECONDITION FLAGS + --if-generation-match=GENERATION + Execute only if the generation matches the generation of the requested + object. + + --if-metageneration-match=METAGENERATION + Execute only if the metageneration matches the metageneration of the + requested object. + 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/storage/objects/compose b/gcloud/alpha/storage/objects/compose new file mode 100644 index 000000000..73312d496 --- /dev/null +++ b/gcloud/alpha/storage/objects/compose @@ -0,0 +1,56 @@ +NAME + gcloud alpha storage objects compose - concatenate a sequence of objects + into a new composite object + +SYNOPSIS + gcloud alpha storage objects compose SOURCE [SOURCE ...] DESTINATION + [--if-generation-match=GENERATION + --if-metageneration-match=METAGENERATION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) gcloud alpha storage objects compose creates a new object whose + content is the concatenation of a given sequence of source objects in the + same bucket. For more information, please see: composite objects + documentation (https://cloud.google.com/storage/docs/composite-objects). + + There is a limit (currently 32) to the number of components that can be + composed in a single operation. + +EXAMPLES + The following command creates a new object target.txt by concatenating + a.txt and b.txt: + + $ gcloud alpha storage objects compose gs://bucket/a.txt \ + gs://bucket/b.txt gs://bucket/target.txt + +POSITIONAL ARGUMENTS + SOURCE [SOURCE ...] + The list of source objects that will be concatenated into a single + object. + + DESTINATION + The destination object. + +PRECONDITION FLAGS + --if-generation-match=GENERATION + Execute only if the generation matches the generation of the requested + object. + + --if-metageneration-match=METAGENERATION + Execute only if the metageneration matches the metageneration of the + requested object. + +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/storage/objects/help b/gcloud/alpha/storage/objects/help index f1e4b7174..03ef4338e 100644 --- a/gcloud/alpha/storage/objects/help +++ b/gcloud/alpha/storage/objects/help @@ -15,6 +15,9 @@ GCLOUD WIDE FLAGS COMMANDS COMMAND is one of the following: + compose + (ALPHA) Concatenate a sequence of objects into a new composite object. + describe (ALPHA) Describe a Cloud Storage object. diff --git a/gcloud/alpha/storage/objects/update b/gcloud/alpha/storage/objects/update index 5b6fc7cf3..0919b9f58 100644 --- a/gcloud/alpha/storage/objects/update +++ b/gcloud/alpha/storage/objects/update @@ -13,16 +13,15 @@ SYNOPSIS [--content-type=CONTENT_TYPE] [--continue-on-error, -c] [--custom-time=CUSTOM_TIME] [--decryption-keys=[DECRYPTION_KEY,...]] [--encryption-key=ENCRYPTION_KEY] [--[no-]event-based-hold] - [--if-generation-match=GENERATION] - [--if-metageneration-match=METAGENERATION] [--preserve-acl, -p] - [--read-paths-from-stdin, -I] [--recursive, -R, -r] - [--storage-class=STORAGE_CLASS, -s STORAGE_CLASS] + [--preserve-acl, -p] [--read-paths-from-stdin, -I] + [--recursive, -R, -r] [--storage-class=STORAGE_CLASS, -s STORAGE_CLASS] [--[no-]temporary-hold] [--clear-custom-metadata | --custom-metadata=[CUSTOM_METADATA_KEYS_AND_VALUES,...] | --remove-custom-metadata=[METADATA_KEYS,...] --update-custom-metadata=[CUSTOM_METADATA_KEYS_AND_VALUES,...]] - [GCLOUD_WIDE_FLAG ...] + [--if-generation-match=GENERATION + --if-metageneration-match=METAGENERATION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Update Cloud Storage objects. @@ -127,14 +126,6 @@ FLAGS Enables or disables an event-based hold on objects. Use --event-based-hold to enable and --no-event-based-hold to disable. - --if-generation-match=GENERATION - Execute only if the generation matches the generation of the requested - object. - - --if-metageneration-match=METAGENERATION - Execute only if the metageneration matches the metageneration of the - requested object. - --preserve-acl, -p Preserves ACLs when copying in the cloud. This feature is supported for only Google Cloud Storage and requires OWNER access to all copied @@ -187,6 +178,15 @@ FLAGS keys overlap with those provided by --preserve-posix, values specified by this flag are used. +PRECONDITION FLAGS + --if-generation-match=GENERATION + Execute only if the generation matches the generation of the requested + object. + + --if-metageneration-match=METAGENERATION + Execute only if the metageneration matches the metageneration of the + requested object. + 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/storage/rm b/gcloud/alpha/storage/rm index 0549714b1..46a04a8c4 100644 --- a/gcloud/alpha/storage/rm +++ b/gcloud/alpha/storage/rm @@ -3,10 +3,10 @@ NAME SYNOPSIS gcloud alpha storage rm [URLS ...] [--all-versions, -a] - [--continue-on-error, -c] [--if-generation-match=GENERATION] - [--if-metageneration-match=METAGENERATION] - [--read-paths-from-stdin, -I] [--recursive, -R, -r] - [GCLOUD_WIDE_FLAG ...] + [--continue-on-error, -c] [--read-paths-from-stdin, -I] + [--recursive, -R, -r] + [--if-generation-match=GENERATION + --if-metageneration-match=METAGENERATION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Delete objects and buckets. @@ -62,14 +62,6 @@ FLAGS flag takes effect only in sequential execution mode (i.e. processor and thread count are set to 1). Parallelism is default. - --if-generation-match=GENERATION - Execute only if the generation matches the generation of the requested - object. - - --if-metageneration-match=METAGENERATION - Execute only if the metageneration matches the metageneration of the - requested object. - --read-paths-from-stdin, -I Read the list of resources to remove from stdin. @@ -80,6 +72,15 @@ FLAGS option. If you want to delete only live object versions, use the ``**'' wildcard instead. +PRECONDITION FLAGS + --if-generation-match=GENERATION + Execute only if the generation matches the generation of the requested + object. + + --if-metageneration-match=METAGENERATION + Execute only if the metageneration matches the metageneration of the + requested object. + 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/transfer/agents/install b/gcloud/alpha/transfer/agents/install index dc7563a55..2fa80b427 100644 --- a/gcloud/alpha/transfer/agents/install +++ b/gcloud/alpha/transfer/agents/install @@ -3,7 +3,7 @@ NAME SYNOPSIS gcloud alpha transfer agents install --pool=POOL [--count=COUNT] - [--creds-file=CREDS_FILE] [--id-prefix=ID_PREFIX] + [--creds-file=CREDS_FILE] [--enable-multipart] [--id-prefix=ID_PREFIX] [--logs-directory=LOGS_DIRECTORY; default="/tmp"] [--memlock-limit=MEMLOCK_LIMIT; default=64000000] [--mount-directories=[MOUNT-DIRECTORIES,...]] [--proxy=PROXY] @@ -49,6 +49,12 @@ OPTIONAL FLAGS Note that the credentials location will be mounted to the agent container. + --enable-multipart + Split up files and transfer the resulting chunks in parallel before + merging them at the destination. Can be used make transfers of large + files faster as long as the network and disk speed are not limiting + factors. + --id-prefix=ID_PREFIX An optional prefix to add to the agent ID to help identify the agent. diff --git a/gcloud/asset/get-effective-iam-policy b/gcloud/asset/get-effective-iam-policy new file mode 100644 index 000000000..e7b0f4220 --- /dev/null +++ b/gcloud/asset/get-effective-iam-policy @@ -0,0 +1,75 @@ +NAME + gcloud asset get-effective-iam-policy - get effective IAM policies for a + specified list of resources within accessible scope, such as a project, + folder or organization + +SYNOPSIS + gcloud asset get-effective-iam-policy --names=NAMES,[NAMES,...] + --scope=SCOPE [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Batch get effective IAM policies that match a request. + +EXAMPLES + To list effective IAM policies of 1 resource in an organization, run: + + $ gcloud asset get-effective-iam-policy \ + --scope=organizations/YOUR_ORG_ID --names=RESOURCE_NAME1 + + To list effective IAM policies of 2 resources in a folder, run: + + $ gcloud asset get-effective-iam-policy \ + --scope=folders/YOUR_FOLDER_ID \ + --names=RESOURCE_NAME1,RESOURCE_NAME2 + + To list effective IAM policies of 3 resources in a project using project + ID, run: + + $ gcloud asset get-effective-iam-policy \ + --scope=projects/YOUR_PROJECT_ID \ + --names=RESOURCE_NAME1,RESOURCE_NAME2,RESOURCE_NAME3 + + To list effective IAM policies of 2 resources in a project using project + number, run: + + $ gcloud asset get-effective-iam-policy \ + --scope=projects/YOUR_PROJECT_NUMBER \ + --names=RESOURCE_NAME1,RESOURCE_NAME2 + +REQUIRED FLAGS + --names=NAMES,[NAMES,...] + Names refer to a list of full resource names + (https://cloud.google.com/asset-inventory/docs/resource-name-format) of + searchable asset types + (https://cloud.google.com/asset-inventory/docs/supported-asset-types#searchable_asset_types). + For each batch call, total number of names provided is between 1 and + 20. + + The example value is: + + ◆ //cloudsql.googleapis.com/projects/{PROJECT_ID}/instances/{INSTANCE} + (e.g. + //cloudsql.googleapis.com/projects/probe-per-rt-project/instances/instance1) + + --scope=SCOPE + Scope can be a project, a folder, or an organization. The search is + limited to the IAM policies within this scope. The caller must be + granted the cloudasset.assets.analyzeIamPolicy, + cloudasset.assets.searchAllResources, + cloudasset.assets.searchAllIamPolicies permissions on the desired + scope. + + The allowed values are: + + ◆ projects/{PROJECT_ID} (e.g. projects/foo-bar) + ◆ projects/{PROJECT_NUMBER} (e.g. projects/12345678) + ◆ folders/{FOLDER_NUMBER} (e.g. folders/1234567) + ◆ organizations/{ORGANIZATION_NUMBER} (e.g. organizations/123456) + +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/asset/help b/gcloud/asset/help index 5ef30603a..5155250c2 100644 --- a/gcloud/asset/help +++ b/gcloud/asset/help @@ -37,6 +37,10 @@ COMMANDS export Export the cloud assets to Google Cloud Storage/BigQuery. + get-effective-iam-policy + Get effective IAM policies for a specified list of resources within + accessible scope, such as a project, folder or organization. + get-history Get the update history of assets that overlaps a time window. diff --git a/gcloud/beta/alloydb/clusters/help b/gcloud/beta/alloydb/clusters/help index bd18d378e..41c6b22c8 100644 --- a/gcloud/beta/alloydb/clusters/help +++ b/gcloud/beta/alloydb/clusters/help @@ -30,7 +30,8 @@ COMMANDS (BETA) Lists AlloyDB clusters in a given project and region. restore - (BETA) Restores an AlloyDB cluster from a given backup. + (BETA) Restores an AlloyDB cluster from a given backup or a source + cluster at a specific point in time. update (BETA) Updates an AlloyDB cluster within a given project and region. diff --git a/gcloud/beta/alloydb/clusters/restore b/gcloud/beta/alloydb/clusters/restore index 5e3688451..fbd4b6f21 100644 --- a/gcloud/beta/alloydb/clusters/restore +++ b/gcloud/beta/alloydb/clusters/restore @@ -1,31 +1,37 @@ NAME gcloud beta alloydb clusters restore - restores an AlloyDB cluster from a - given backup + given backup or a source cluster at a specific point in time SYNOPSIS - gcloud beta alloydb clusters restore CLUSTER --backup=BACKUP - --region=REGION [--async] [--network=NETWORK] + gcloud beta alloydb clusters restore CLUSTER --region=REGION [--async] + [--network=NETWORK] + [--backup=BACKUP + : --point-in-time=POINT_IN_TIME --source-cluster=SOURCE_CLUSTER] [--kms-key=KMS_KEY : --kms-keyring=KMS_KEYRING --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Restores an AlloyDB cluster from a given backup. + (BETA) Restores an AlloyDB cluster from a given backup or a source cluster + at a specific point in time. EXAMPLES To restore a cluster from a backup, run: $ gcloud beta alloydb clusters restore my-cluster \ - --region=us-central1 --backup=my-backup + --region=us-central1 --backup=my-backup + + To restore a cluster back to a point in time, run: + + $ gcloud beta alloydb clusters restore my-cluster \ + --region=us-central1 --source-cluster=my-source-cluster \ + --point-in-time=2003-09-25T10:49:41.519Z POSITIONAL ARGUMENTS CLUSTER AlloyDB cluster ID REQUIRED FLAGS - --backup=BACKUP - AlloyDB backup ID - --region=REGION Regional location (e.g. asia-east1, us-east1). See the full list of regions at https://cloud.google.com/sql/docs/instance-locations. @@ -42,6 +48,30 @@ OPTIONAL FLAGS network, 'testsharednetwork', this would be of the form:--network=projects/testproject/global/networks/testsharednetwork + RestoreCluster source types. + + At most one of these can be specified: + + Restore a cluster using a specific backup as the source. + + --backup=BACKUP + AlloyDB backup ID + + Restore a cluster from a source cluster at a given point in time. + + --point-in-time=POINT_IN_TIME + Point in time to restore to, in RFC 3339 format. For example, + 2012-11-15T16:19:00.094Z. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --source-cluster=SOURCE_CLUSTER + Source cluster name. + + This flag argument must be specified if any of the other arguments + in this group are specified. + Key resource - The Cloud KMS (Key Management Service) cryptokey that will be used to protect the cluster. The 'AlloyDB Service Agent' service account must hold permission 'Cloud KMS CryptoKey Encrypter/Decrypter'. diff --git a/gcloud/beta/alloydb/operations/list b/gcloud/beta/alloydb/operations/list index 53c480edd..5cc4a0337 100644 --- a/gcloud/beta/alloydb/operations/list +++ b/gcloud/beta/alloydb/operations/list @@ -2,9 +2,10 @@ NAME gcloud beta alloydb operations list - lists AlloyDB operations SYNOPSIS - gcloud beta alloydb operations list [--region=REGION; default="-"] - [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] - [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + gcloud beta alloydb operations list [--cluster=CLUSTER] + [--region=REGION; default="-"] [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Lists AlloyDB operations. @@ -15,6 +16,9 @@ EXAMPLES $ gcloud beta alloydb operations list --region=us-central1 FLAGS + --cluster=CLUSTER + AlloyDB cluster ID + --region=REGION; default="-" Regional location (e.g. asia-east1, us-east1). See the full list of regions at https://cloud.google.com/sql/docs/instance-locations. diff --git a/gcloud/beta/compute/disks/create b/gcloud/beta/compute/disks/create index a0f53745d..de4b9a6cb 100644 --- a/gcloud/beta/compute/disks/create +++ b/gcloud/beta/compute/disks/create @@ -3,8 +3,8 @@ NAME SYNOPSIS gcloud beta compute disks create DISK_NAME [DISK_NAME ...] - [--csek-key-file=FILE] [--description=DESCRIPTION] - [--erase-windows-vss-signature] + [--architecture=ARCHITECTURE] [--csek-key-file=FILE] + [--description=DESCRIPTION] [--erase-windows-vss-signature] [--guest-os-features=[GUEST_OS_FEATURE,...]] [--interface=INTERFACE] [--labels=[KEY=VALUE,...]] [--licenses=[LICENSE,...]] [--multi-writer] [--physical-block-size=PHYSICAL_BLOCK_SIZE; default="4096"] @@ -53,6 +53,12 @@ POSITIONAL ARGUMENTS https://cloud.google.com/compute/docs/naming-resources FLAGS + --architecture=ARCHITECTURE + Specifies the architecture or processor type that this disk can + support. For available processor types on Compute Engine, see + https://cloud.google.com/compute/docs/cpu-platforms. ARCHITECTURE must + be one of: ARM64, X86_64. + --csek-key-file=FILE Path to a Customer-Supplied Encryption Key (CSEK) key file that maps Compute Engine resources to user managed keys to be used when creating, diff --git a/gcloud/beta/compute/disks/update b/gcloud/beta/compute/disks/update index 26ef59f85..a9031ef13 100644 --- a/gcloud/beta/compute/disks/update +++ b/gcloud/beta/compute/disks/update @@ -4,6 +4,7 @@ NAME SYNOPSIS gcloud beta compute disks update DISK_NAME [--update-labels=[KEY=VALUE,...]] + [--clear-architecture | --update-architecture=UPDATE_ARCHITECTURE] [--clear-labels | --remove-labels=[KEY,...]] [--clear-user-licenses | --update-user-licenses=[LICENSE,...]] [--region=REGION | --zone=ZONE] [GCLOUD_WIDE_FLAG ...] @@ -46,6 +47,17 @@ FLAGS contain only hyphens (-), underscores (_), lowercase characters, and numbers. + At most one of these can be specified: + + --clear-architecture + Removes the architecture or processor type annotation from the disk. + + --update-architecture=UPDATE_ARCHITECTURE + Updates the architecture or processor type that this disk can + support. For available processor types on Compute Engine, see + https://cloud.google.com/compute/docs/cpu-platforms. + UPDATE_ARCHITECTURE must be one of: ARM64, X86_64. + At most one of these can be specified: --clear-labels diff --git a/gcloud/beta/compute/images/create b/gcloud/beta/compute/images/create index 0feae1169..0b95ffdb7 100644 --- a/gcloud/beta/compute/images/create +++ b/gcloud/beta/compute/images/create @@ -6,7 +6,8 @@ SYNOPSIS (--source-disk=SOURCE_DISK | --source-image=SOURCE_IMAGE | --source-image-family=SOURCE_IMAGE_FAMILY | --source-snapshot=SOURCE_SNAPSHOT | --source-uri=SOURCE_URI) - [--csek-key-file=FILE] [--description=DESCRIPTION] [--family=FAMILY] + [--architecture=ARCHITECTURE] [--csek-key-file=FILE] + [--description=DESCRIPTION] [--family=FAMILY] [--forbidden-database-file=[DBX_VALUE,...]] [--force] [--force-create] [--guest-os-features=[GUEST_OS_FEATURE,...]] [--key-exchange-key-file=[KEK_VALUE,...]] [--labels=[KEY=VALUE,...]] @@ -104,6 +105,12 @@ REQUIRED FLAGS https://cloud.google.com/storage/docs/request-endpoints#json-api. OPTIONAL FLAGS + --architecture=ARCHITECTURE + Specifies the architecture or processor type that this image can + support. For available processor types on Compute Engine, see + https://cloud.google.com/compute/docs/cpu-platforms. ARCHITECTURE must + be one of: ARM64, X86_64. + --csek-key-file=FILE Path to a Customer-Supplied Encryption Key (CSEK) key file that maps Compute Engine images to user managed keys to be used when creating, diff --git a/gcloud/beta/compute/images/update b/gcloud/beta/compute/images/update index 8dc545507..818c8bbbf 100644 --- a/gcloud/beta/compute/images/update +++ b/gcloud/beta/compute/images/update @@ -2,8 +2,9 @@ NAME gcloud beta compute images update - update a Compute Engine image SYNOPSIS - gcloud beta compute images update IMAGE_NAME [--description=DESCRIPTION] - [--family=FAMILY] [--update-labels=[KEY=VALUE,...]] + gcloud beta compute images update IMAGE_NAME [--architecture=ARCHITECTURE] + [--description=DESCRIPTION] [--family=FAMILY] + [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] [--clear-user-licenses | --update-user-licenses=[LICENSE,...]] [GCLOUD_WIDE_FLAG ...] @@ -34,6 +35,12 @@ POSITIONAL ARGUMENTS Name of the disk image to update. FLAGS + --architecture=ARCHITECTURE + Specifies the architecture or processor type that this image can + support. For available processor types on Compute Engine, see + https://cloud.google.com/compute/docs/cpu-platforms. ARCHITECTURE must + be one of: ARM64, X86_64. + --description=DESCRIPTION An optional text description for the image. diff --git a/gcloud/beta/compute/scp b/gcloud/beta/compute/scp index 2dea97b29..76f320353 100644 --- a/gcloud/beta/compute/scp +++ b/gcloud/beta/compute/scp @@ -15,8 +15,11 @@ SYNOPSIS DESCRIPTION (BETA) gcloud beta compute scp securely copies files between a virtual - machine instance and your local machine using the scp command. This command - does not work for Windows VMs. + machine instance and your local machine using the scp command. + + This command works for Linux VMs and Windows Server 2019 and later VMs that + have SSH enabled + (https://cloud.google.com/compute/docs/connect/windows-ssh). In order to set up a successful transfer, follow these guidelines: ▪ Prefix remote file names with the virtual machine instance name diff --git a/gcloud/beta/config/get b/gcloud/beta/config/get index 3c58c3542..e62832075 100644 --- a/gcloud/beta/config/get +++ b/gcloud/beta/config/get @@ -156,6 +156,10 @@ AVAILABLE PROPERTIES anthosevents Overrides API endpoint for gcloud anthos command group. + anthospolicycontrollerstatus_pa + Overrides API endpoint for gcloud container fleet policycontroller + command group. + apigateway Overrides API endpoint for gcloud api-gateway command group. @@ -1086,6 +1090,13 @@ AVAILABLE PROPERTIES upload_chunk_size Chunk size used for uploading to clouds. + use_gcloud_crc32c + If True, data integrity checks use a binary subprocess to calculate + CRC32C hashes with the included gcloud-crc32c tool rather than the + google-crc32c Python library. This behavior is also triggered when + the google-crc32c Python library is unavailable even if this + property is False. + use_gsutil If True, use the deprecated upload implementation which uses gsutil. diff --git a/gcloud/beta/config/help b/gcloud/beta/config/help index 4f01c41f1..417812259 100644 --- a/gcloud/beta/config/help +++ b/gcloud/beta/config/help @@ -188,6 +188,10 @@ AVAILABLE PROPERTIES anthosevents Overrides API endpoint for gcloud anthos command group. + anthospolicycontrollerstatus_pa + Overrides API endpoint for gcloud container fleet policycontroller + command group. + apigateway Overrides API endpoint for gcloud api-gateway command group. @@ -1118,6 +1122,13 @@ AVAILABLE PROPERTIES upload_chunk_size Chunk size used for uploading to clouds. + use_gcloud_crc32c + If True, data integrity checks use a binary subprocess to calculate + CRC32C hashes with the included gcloud-crc32c tool rather than the + google-crc32c Python library. This behavior is also triggered when + the google-crc32c Python library is unavailable even if this + property is False. + use_gsutil If True, use the deprecated upload implementation which uses gsutil. diff --git a/gcloud/beta/config/list b/gcloud/beta/config/list index 29379d42f..92066cdf2 100644 --- a/gcloud/beta/config/list +++ b/gcloud/beta/config/list @@ -194,6 +194,10 @@ AVAILABLE PROPERTIES anthosevents Overrides API endpoint for gcloud anthos command group. + anthospolicycontrollerstatus_pa + Overrides API endpoint for gcloud container fleet policycontroller + command group. + apigateway Overrides API endpoint for gcloud api-gateway command group. @@ -1124,6 +1128,13 @@ AVAILABLE PROPERTIES upload_chunk_size Chunk size used for uploading to clouds. + use_gcloud_crc32c + If True, data integrity checks use a binary subprocess to calculate + CRC32C hashes with the included gcloud-crc32c tool rather than the + google-crc32c Python library. This behavior is also triggered when + the google-crc32c Python library is unavailable even if this + property is False. + use_gsutil If True, use the deprecated upload implementation which uses gsutil. diff --git a/gcloud/beta/config/set b/gcloud/beta/config/set index 9f7349e1a..b74c7fc7e 100644 --- a/gcloud/beta/config/set +++ b/gcloud/beta/config/set @@ -203,6 +203,10 @@ AVAILABLE PROPERTIES anthosevents Overrides API endpoint for gcloud anthos command group. + anthospolicycontrollerstatus_pa + Overrides API endpoint for gcloud container fleet policycontroller + command group. + apigateway Overrides API endpoint for gcloud api-gateway command group. @@ -1133,6 +1137,13 @@ AVAILABLE PROPERTIES upload_chunk_size Chunk size used for uploading to clouds. + use_gcloud_crc32c + If True, data integrity checks use a binary subprocess to calculate + CRC32C hashes with the included gcloud-crc32c tool rather than the + google-crc32c Python library. This behavior is also triggered when + the google-crc32c Python library is unavailable even if this + property is False. + use_gsutil If True, use the deprecated upload implementation which uses gsutil. diff --git a/gcloud/beta/config/unset b/gcloud/beta/config/unset index 285dbedfe..2d7187fa9 100644 --- a/gcloud/beta/config/unset +++ b/gcloud/beta/config/unset @@ -164,6 +164,10 @@ AVAILABLE PROPERTIES anthosevents Overrides API endpoint for gcloud anthos command group. + anthospolicycontrollerstatus_pa + Overrides API endpoint for gcloud container fleet policycontroller + command group. + apigateway Overrides API endpoint for gcloud api-gateway command group. @@ -1094,6 +1098,13 @@ AVAILABLE PROPERTIES upload_chunk_size Chunk size used for uploading to clouds. + use_gcloud_crc32c + If True, data integrity checks use a binary subprocess to calculate + CRC32C hashes with the included gcloud-crc32c tool rather than the + google-crc32c Python library. This behavior is also triggered when + the google-crc32c Python library is unavailable even if this + property is False. + use_gsutil If True, use the deprecated upload implementation which uses gsutil. diff --git a/gcloud/beta/container/backup-restore/restores/create b/gcloud/beta/container/backup-restore/restores/create index c48e3e342..2c6273dfb 100644 --- a/gcloud/beta/container/backup-restore/restores/create +++ b/gcloud/beta/container/backup-restore/restores/create @@ -16,7 +16,9 @@ EXAMPLES $ gcloud beta container backup-restore restores create my-restore \ --project=my-project --location=us-central1 \ - --restore-plan=my-restore-plan + --restore-plan=my-restore-plan \ + --backup=projects/my-project/locations/us-east1/backupPlans/\ + my-backup-plan/backups/my-backup POSITIONAL ARGUMENTS Restore resource - Name of the restore to create. Once the restore is diff --git a/gcloud/beta/container/fleet/memberships/generate-gateway-rbac b/gcloud/beta/container/fleet/memberships/generate-gateway-rbac index 8e0ce3a24..2a59f7402 100644 --- a/gcloud/beta/container/fleet/memberships/generate-gateway-rbac +++ b/gcloud/beta/container/fleet/memberships/generate-gateway-rbac @@ -52,7 +52,7 @@ EXAMPLES --membership=my-cluster \ --users=foo@example.com,\ test-acct@test-project.iam.gserviceaccount.com \ - --role=clusterrole/cluster-admin --context=my-cluster-contex \ + --role=clusterrole/cluster-admin --context=my-cluster-context \ --kubeconfig=/home/user/custom_kubeconfig --apply Revoke mode, revoke the RBAC policy for the specified users: @@ -61,9 +61,19 @@ EXAMPLES --membership=my-cluster \ --users=foo@example.com,\ test-acct@test-project.iam.gserviceaccount.com \ - --role=clusterrole/cluster-admin --context=my-cluster-contex \ + --role=clusterrole/cluster-admin --context=my-cluster-context \ --kubeconfig=/home/user/custom_kubeconfig --revoke + The role to be granted to the users can either be cluster-scoped or + namespace-scoped. To grant a namespace-scoped role to the users in dry run + mode, run: + + $ gcloud beta container fleet memberships generate-gateway-rbac \ + --membership=my-cluster \ + --users=foo@example.com,\ + test-acct@test-project.iam.gserviceaccount.com \ + --role=role/mynamespace/namespace-reader + FLAGS --anthos-support If specified, this command will generate RBAC policy file for anthos diff --git a/gcloud/beta/container/hub/memberships/generate-gateway-rbac b/gcloud/beta/container/hub/memberships/generate-gateway-rbac index fbc2afc50..fb6e3a5b8 100644 --- a/gcloud/beta/container/hub/memberships/generate-gateway-rbac +++ b/gcloud/beta/container/hub/memberships/generate-gateway-rbac @@ -52,7 +52,7 @@ EXAMPLES --membership=my-cluster \ --users=foo@example.com,\ test-acct@test-project.iam.gserviceaccount.com \ - --role=clusterrole/cluster-admin --context=my-cluster-contex \ + --role=clusterrole/cluster-admin --context=my-cluster-context \ --kubeconfig=/home/user/custom_kubeconfig --apply Revoke mode, revoke the RBAC policy for the specified users: @@ -61,9 +61,19 @@ EXAMPLES --membership=my-cluster \ --users=foo@example.com,\ test-acct@test-project.iam.gserviceaccount.com \ - --role=clusterrole/cluster-admin --context=my-cluster-contex \ + --role=clusterrole/cluster-admin --context=my-cluster-context \ --kubeconfig=/home/user/custom_kubeconfig --revoke + The role to be granted to the users can either be cluster-scoped or + namespace-scoped. To grant a namespace-scoped role to the users in dry run + mode, run: + + $ gcloud beta container hub memberships generate-gateway-rbac \ + --membership=my-cluster \ + --users=foo@example.com,\ + test-acct@test-project.iam.gserviceaccount.com \ + --role=role/mynamespace/namespace-reader + FLAGS --anthos-support If specified, this command will generate RBAC policy file for anthos diff --git a/gcloud/beta/dataflow/flex-template/build b/gcloud/beta/dataflow/flex-template/build index e88b8402a..505e722fc 100644 --- a/gcloud/beta/dataflow/flex-template/build +++ b/gcloud/beta/dataflow/flex-template/build @@ -7,8 +7,8 @@ SYNOPSIS --sdk-language=SDK_LANGUAGE (--image=IMAGE | --env=[ENV,...] --flex-template-base-image=FLEX_TEMPLATE_BASE_IMAGE - --image-gcr-path=IMAGE_GCR_PATH (--jar=[JAR,...] - | --py-path=[PY_PATH,...])) + --image-gcr-path=IMAGE_GCR_PATH (--go-binary-path=GO_BINARY_PATH + | --jar=[JAR,...] | --py-path=[PY_PATH,...])) [--additional-experiments=[ADDITIONAL_EXPERIMENTS,...]] [--additional-user-labels=[ADDITIONAL_USER_LABELS,...]] [--dataflow-kms-key=DATAFLOW_KMS_KEY] [--disable-public-ips] @@ -64,7 +64,7 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS --sdk-language=SDK_LANGUAGE SDK language of the flex template job. SDK_LANGUAGE must be one of: - JAVA, PYTHON. + JAVA, PYTHON, GO. Exactly one of these must be specified: @@ -105,6 +105,13 @@ REQUIRED FLAGS Exactly one of these must be specified: + --go-binary-path=GO_BINARY_PATH + Local path to your compiled dataflow pipeline Go binary. The binary + should be compiled to run on the target worker architecture + (usually linux-amd64). See + https://beam.apache.org/documentation/sdks/go-cross-compilation/ + for more information. + --jar=[JAR,...] Local path to your dataflow pipeline jar file and all their dependent jar files required for the flex template classpath. You diff --git a/gcloud/beta/functions/deploy b/gcloud/beta/functions/deploy index 8111c0b0d..b1b16f2be 100644 --- a/gcloud/beta/functions/deploy +++ b/gcloud/beta/functions/deploy @@ -179,7 +179,7 @@ FLAGS ◆ python37: Python 3.7 ◆ python38: Python 3.8 ◆ python39: Python 3.9 - ◆ python310: Python 3.10 (preview) + ◆ python310: Python 3.10 ◆ go111: Go 1.11 ◆ go113: Go 1.13 ◆ go116: Go 1.16 diff --git a/gcloud/beta/network-management/connectivity-tests/create b/gcloud/beta/network-management/connectivity-tests/create index 887c7fe55..7ce7d8dcd 100644 --- a/gcloud/beta/network-management/connectivity-tests/create +++ b/gcloud/beta/network-management/connectivity-tests/create @@ -8,7 +8,8 @@ SYNOPSIS --destination-gke-master-cluster=DESTINATION_GKE_MASTER_CLUSTER --destination-instance=DESTINATION_INSTANCE --destination-ip-address=DESTINATION_IP_ADDRESS) - (--source-cloud-sql-instance=SOURCE_CLOUD_SQL_INSTANCE + (--source-cloud-function=SOURCE_CLOUD_FUNCTION + --source-cloud-sql-instance=SOURCE_CLOUD_SQL_INSTANCE --source-gke-master-cluster=SOURCE_GKE_MASTER_CLUSTER --source-instance=SOURCE_INSTANCE --source-ip-address=SOURCE_IP_ADDRESS) [--async] @@ -71,6 +72,9 @@ REQUIRED FLAGS At least one of these must be specified: + --source-cloud-function=SOURCE_CLOUD_FUNCTION + A Cloud function URI as the source endpoint. + --source-cloud-sql-instance=SOURCE_CLOUD_SQL_INSTANCE A Cloud SQL instance URI as the source endpoint. diff --git a/gcloud/beta/network-management/connectivity-tests/update b/gcloud/beta/network-management/connectivity-tests/update index aee967ff7..bb73b8899 100644 --- a/gcloud/beta/network-management/connectivity-tests/update +++ b/gcloud/beta/network-management/connectivity-tests/update @@ -20,6 +20,8 @@ SYNOPSIS | --destination-instance=DESTINATION_INSTANCE] [--clear-destination-ip-address | --destination-ip-address=DESTINATION_IP_ADDRESS] + [--clear-source-cloud-function + | --source-cloud-function=SOURCE_CLOUD_FUNCTION] [--clear-source-cloud-sql-instance | --source-cloud-sql-instance=SOURCE_CLOUD_SQL_INSTANCE] [--clear-source-gke-master-cluster @@ -135,6 +137,14 @@ FLAGS internal IP. An IPv6 address is only allowed when the test's destination is a global load balancer VIP. + At most one of these can be specified: + + --clear-source-cloud-function + Clear existing source Cloud function. + + --source-cloud-function=SOURCE_CLOUD_FUNCTION + A Cloud function URI as the source endpoint. + At most one of these can be specified: --clear-source-cloud-sql-instance diff --git a/gcloud/beta/spanner/help b/gcloud/beta/spanner/help index 703898f1b..bbee8a924 100644 --- a/gcloud/beta/spanner/help +++ b/gcloud/beta/spanner/help @@ -33,6 +33,9 @@ GROUPS rows (BETA) Manage the rows in Cloud Spanner databases. + samples + (BETA) Cloud Spanner sample apps. + NOTES This command is currently in beta and might change without notice. These variants are also available: diff --git a/gcloud/beta/spanner/instances/create b/gcloud/beta/spanner/instances/create index 74af2aac2..39aa32fbd 100644 --- a/gcloud/beta/spanner/instances/create +++ b/gcloud/beta/spanner/instances/create @@ -3,8 +3,9 @@ NAME SYNOPSIS gcloud beta spanner instances create INSTANCE --config=CONFIG - --description=DESCRIPTION - (--nodes=NODES | --processing-units=PROCESSING_UNITS) [--async] + --description=DESCRIPTION [--async] [--expire-behavior=EXPIRE_BEHAVIOR] + [--instance-type=INSTANCE_TYPE] + [--nodes=NODES | --processing-units=PROCESSING_UNITS] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -30,7 +31,35 @@ REQUIRED FLAGS --description=DESCRIPTION Description of the instance. - Exactly one of these must be specified: +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --expire-behavior=EXPIRE_BEHAVIOR + The expire behavior of a free trial instance. EXPIRE_BEHAVIOR must be + one of: + + free-to-provisioned + When the free trial instance expires, upgrade the instance to a + provisioned instance. + remove-after-grace-period + When the free trial instance expires, disable the instance, and + delete it after the grace period passes if it has not been upgraded + to a provisioned instance. + + --instance-type=INSTANCE_TYPE + Specifies the type for this instance. INSTANCE_TYPE must be one of: + + free-instance + Free trial instances provide no guarantees for dedicated resources, + both node_count and processing_units should be 0. They come with + stricter usage limits and limited support. + provisioned + Provisioned instances have dedicated resources, standard usage + limits, and support. + + At most one of these can be specified: --nodes=NODES Number of nodes for the instance. @@ -38,11 +67,6 @@ REQUIRED FLAGS --processing-units=PROCESSING_UNITS Number of processing units for the instance. -OPTIONAL FLAGS - --async - Return immediately, without waiting for the operation in progress to - complete. - GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/beta/spanner/instances/update b/gcloud/beta/spanner/instances/update index 9a355699e..4791ad903 100644 --- a/gcloud/beta/spanner/instances/update +++ b/gcloud/beta/spanner/instances/update @@ -3,7 +3,8 @@ NAME SYNOPSIS gcloud beta spanner instances update INSTANCE [--async] - [--description=DESCRIPTION] + [--description=DESCRIPTION] [--expire-behavior=EXPIRE_BEHAVIOR] + [--instance-type=INSTANCE_TYPE] [--nodes=NODES | --processing-units=PROCESSING_UNITS] [GCLOUD_WIDE_FLAG ...] @@ -32,6 +33,29 @@ FLAGS --description=DESCRIPTION Description of the instance. + --expire-behavior=EXPIRE_BEHAVIOR + The expire behavior of a free trial instance. EXPIRE_BEHAVIOR must be + one of: + + free-to-provisioned + When the free trial instance expires, upgrade the instance to a + provisioned instance. + remove-after-grace-period + When the free trial instance expires, disable the instance, and + delete it after the grace period passes if it has not been upgraded + to a provisioned instance. + + --instance-type=INSTANCE_TYPE + Specifies the type for this instance. INSTANCE_TYPE must be one of: + + free-instance + Free trial instances provide no guarantees for dedicated resources, + both node_count and processing_units should be 0. They come with + stricter usage limits and limited support. + provisioned + Provisioned instances have dedicated resources, standard usage + limits, and support. + At most one of these can be specified: --nodes=NODES diff --git a/gcloud/beta/spanner/samples/backend b/gcloud/beta/spanner/samples/backend new file mode 100644 index 000000000..ca3ebb1a1 --- /dev/null +++ b/gcloud/beta/spanner/samples/backend @@ -0,0 +1,65 @@ +NAME + gcloud beta spanner samples backend - run the backend gRPC service for the + given Cloud Spanner sample app + +SYNOPSIS + gcloud beta spanner samples backend APPNAME --instance-id=INSTANCE_ID + [--database-id=DATABASE_ID] [--duration=DURATION; default="1h"] + [--port=PORT] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) This command starts the backend gRPC service for the given sample + application. Before starting the service, create the database and load any + initial data with: + + $ gcloud beta spanner samples init APPNAME --instance-id=INSTANCE_ID + + After starting the service, generate traffic with: + + $ gcloud beta spanner samples workload APPNAME + + To run all three steps together, use: + + $ gcloud beta spanner samples run APPNAME --instance-id=INSTANCE_ID + +EXAMPLES + To run the backend gRPC service for the 'finance' sample app using instance + 'my-instance', run: + + $ gcloud beta spanner samples backend finance \ + --instance-id=my-instance + +POSITIONAL ARGUMENTS + APPNAME + The sample app name, e.g. "finance". + +REQUIRED FLAGS + --instance-id=INSTANCE_ID + The Cloud Spanner instance ID for the sample app. + +OPTIONAL FLAGS + --database-id=DATABASE_ID + The Cloud Spanner database ID for the sample app. + + --duration=DURATION; default="1h" + Duration of time allowed to run before stopping the service. + + --port=PORT + Port on which to receive gRPC requests. + +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 spanner samples backend + + $ gcloud alpha spanner samples backend + diff --git a/gcloud/beta/spanner/samples/help b/gcloud/beta/spanner/samples/help new file mode 100644 index 000000000..ecae9b212 --- /dev/null +++ b/gcloud/beta/spanner/samples/help @@ -0,0 +1,50 @@ +NAME + gcloud beta spanner samples - cloud Spanner sample apps + +SYNOPSIS + gcloud beta spanner samples COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Each Cloud Spanner sample application includes a backend gRPC + service backed by a Cloud Spanner database and a workload script that + generates service traffic. + + These sample apps are open source and available at + https://github.com/GoogleCloudPlatform/cloud-spanner-samples. + + To see a list of available sample apps, run: + + $ gcloud spanner samples list + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + backend + (BETA) Run the backend gRPC service for the given Cloud Spanner sample + app. + + init + (BETA) Initialize a Cloud Spanner sample app. + + list + (BETA) List available sample applications. + + run + (BETA) Run the given Cloud Spanner sample app. + + workload + (BETA) Generate gRPC traffic for a given sample app's backend service. + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud spanner samples + + $ gcloud alpha spanner samples + diff --git a/gcloud/beta/spanner/samples/init b/gcloud/beta/spanner/samples/init new file mode 100644 index 000000000..c098c36cb --- /dev/null +++ b/gcloud/beta/spanner/samples/init @@ -0,0 +1,44 @@ +NAME + gcloud beta spanner samples init - initialize a Cloud Spanner sample app + +SYNOPSIS + gcloud beta spanner samples init APPNAME --instance-id=INSTANCE_ID + [--database-id=DATABASE_ID] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) This command creates a Cloud Spanner database in the given instance + for the sample app and loads any initial data required by the application. + +EXAMPLES + To initialize the 'finance' sample app using instance 'my-instance', run: + + $ gcloud beta spanner samples init finance --instance-id=my-instance + +POSITIONAL ARGUMENTS + APPNAME + The sample app name, e.g. "finance". + +REQUIRED FLAGS + --instance-id=INSTANCE_ID + The Cloud Spanner instance ID for the sample app. + +OPTIONAL FLAGS + --database-id=DATABASE_ID + ID of the new Cloud Spanner database to create for the sample app. + +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 spanner samples init + + $ gcloud alpha spanner samples init + diff --git a/gcloud/beta/spanner/samples/list b/gcloud/beta/spanner/samples/list new file mode 100644 index 000000000..2301276d5 --- /dev/null +++ b/gcloud/beta/spanner/samples/list @@ -0,0 +1,64 @@ +NAME + gcloud beta spanner samples list - list available sample applications + +SYNOPSIS + gcloud beta spanner samples list [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) List available sample applications. + +EXAMPLES + To list available sample applications, run: + + $ gcloud beta spanner samples list + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud spanner samples list + + $ gcloud alpha spanner samples list + diff --git a/gcloud/beta/spanner/samples/run b/gcloud/beta/spanner/samples/run new file mode 100644 index 000000000..58d93380a --- /dev/null +++ b/gcloud/beta/spanner/samples/run @@ -0,0 +1,62 @@ +NAME + gcloud beta spanner samples run - run the given Cloud Spanner sample app + +SYNOPSIS + gcloud beta spanner samples run APPNAME --instance-id=INSTANCE_ID + [--no-cleanup] [--database-id=DATABASE_ID] + [--duration=DURATION; default="1h"] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Each Cloud Spanner sample application includes a backend gRPC + service backed by a Cloud Spanner database and a workload script that + generates service traffic. This command creates and initializes the Cloud + Spanner database and runs both the backend service and workload script. + + These sample apps are open source and available at + https://github.com/GoogleCloudPlatform/cloud-spanner-samples. + + To see a list of available sample apps, run: + + $ gcloud beta spanner samples list + +EXAMPLES + To run the 'finance' sample app using instance 'my-instance', run: + + $ gcloud beta spanner samples run finance --instance-id=my-instance + +POSITIONAL ARGUMENTS + APPNAME + The sample app name, e.g. "finance". + +REQUIRED FLAGS + --instance-id=INSTANCE_ID + The Cloud Spanner instance ID for the sample app. + +OPTIONAL FLAGS + --cleanup + Delete the instance after running the sample app. Enabled by default, + use --no-cleanup to disable. + + --database-id=DATABASE_ID + ID of the new Cloud Spanner database to create for the sample app. + + --duration=DURATION; default="1h" + Duration of time allowed to run the sample app before stopping the + service. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud spanner samples run + + $ gcloud alpha spanner samples run + diff --git a/gcloud/beta/spanner/samples/workload b/gcloud/beta/spanner/samples/workload new file mode 100644 index 000000000..073651722 --- /dev/null +++ b/gcloud/beta/spanner/samples/workload @@ -0,0 +1,56 @@ +NAME + gcloud beta spanner samples workload - generate gRPC traffic for a given + sample app's backend service + +SYNOPSIS + gcloud beta spanner samples workload APPNAME + [--duration=DURATION; default="1h"] [--port=PORT] + [--target-qps=TARGET_QPS] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Before sending traffic to the backend service, create the database + and start the service with: + + $ gcloud beta spanner samples init APPNAME --instance-id=INSTANCE_ID + $ gcloud beta spanner samples backend APPNAME \ + --instance-id=INSTANCE_ID + + To run all three steps together, use: + + $ gcloud beta spanner samples run APPNAME --instance-id=INSTANCE_ID + +EXAMPLES + To generate traffic for the 'finance' sample app, run: + + $ gcloud beta spanner samples workload finance + +POSITIONAL ARGUMENTS + APPNAME + The sample app name, e.g. "finance". + +FLAGS + --duration=DURATION; default="1h" + Duration of time allowed to run before stopping the workload. + + --port=PORT + Port of the running backend service. + + --target-qps=TARGET_QPS + Target requests per second. + +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 spanner samples workload + + $ gcloud alpha spanner samples workload + diff --git a/gcloud/compute/disks/create b/gcloud/compute/disks/create index 9902799d5..31e00eaa3 100644 --- a/gcloud/compute/disks/create +++ b/gcloud/compute/disks/create @@ -3,7 +3,8 @@ NAME SYNOPSIS gcloud compute disks create DISK_NAME [DISK_NAME ...] - [--csek-key-file=FILE] [--description=DESCRIPTION] + [--architecture=ARCHITECTURE] [--csek-key-file=FILE] + [--description=DESCRIPTION] [--guest-os-features=[GUEST_OS_FEATURE,...]] [--labels=[KEY=VALUE,...]] [--licenses=[LICENSE,...]] [--provisioned-iops=PROVISIONED_IOPS] [--replica-zones=ZONE,ZONE] [--no-require-csek-key-create] @@ -49,6 +50,12 @@ POSITIONAL ARGUMENTS https://cloud.google.com/compute/docs/naming-resources FLAGS + --architecture=ARCHITECTURE + Specifies the architecture or processor type that this disk can + support. For available processor types on Compute Engine, see + https://cloud.google.com/compute/docs/cpu-platforms. ARCHITECTURE must + be one of: ARM64, X86_64. + --csek-key-file=FILE Path to a Customer-Supplied Encryption Key (CSEK) key file that maps Compute Engine resources to user managed keys to be used when creating, diff --git a/gcloud/compute/disks/update b/gcloud/compute/disks/update index 89372a429..c57c3bf97 100644 --- a/gcloud/compute/disks/update +++ b/gcloud/compute/disks/update @@ -3,6 +3,7 @@ NAME SYNOPSIS gcloud compute disks update DISK_NAME [--update-labels=[KEY=VALUE,...]] + [--clear-architecture | --update-architecture=UPDATE_ARCHITECTURE] [--clear-labels | --remove-labels=[KEY,...]] [--region=REGION | --zone=ZONE] [GCLOUD_WIDE_FLAG ...] @@ -42,6 +43,17 @@ FLAGS contain only hyphens (-), underscores (_), lowercase characters, and numbers. + At most one of these can be specified: + + --clear-architecture + Removes the architecture or processor type annotation from the disk. + + --update-architecture=UPDATE_ARCHITECTURE + Updates the architecture or processor type that this disk can + support. For available processor types on Compute Engine, see + https://cloud.google.com/compute/docs/cpu-platforms. + UPDATE_ARCHITECTURE must be one of: ARM64, X86_64. + At most one of these can be specified: --clear-labels diff --git a/gcloud/compute/images/create b/gcloud/compute/images/create index 4d2e03c45..f63b3630d 100644 --- a/gcloud/compute/images/create +++ b/gcloud/compute/images/create @@ -6,7 +6,8 @@ SYNOPSIS (--source-disk=SOURCE_DISK | --source-image=SOURCE_IMAGE | --source-image-family=SOURCE_IMAGE_FAMILY | --source-snapshot=SOURCE_SNAPSHOT | --source-uri=SOURCE_URI) - [--csek-key-file=FILE] [--description=DESCRIPTION] [--family=FAMILY] + [--architecture=ARCHITECTURE] [--csek-key-file=FILE] + [--description=DESCRIPTION] [--family=FAMILY] [--forbidden-database-file=[DBX_VALUE,...]] [--force] [--guest-os-features=[GUEST_OS_FEATURE,...]] [--key-exchange-key-file=[KEK_VALUE,...]] [--labels=[KEY=VALUE,...]] @@ -104,6 +105,12 @@ REQUIRED FLAGS https://cloud.google.com/storage/docs/request-endpoints#json-api. OPTIONAL FLAGS + --architecture=ARCHITECTURE + Specifies the architecture or processor type that this image can + support. For available processor types on Compute Engine, see + https://cloud.google.com/compute/docs/cpu-platforms. ARCHITECTURE must + be one of: ARM64, X86_64. + --csek-key-file=FILE Path to a Customer-Supplied Encryption Key (CSEK) key file that maps Compute Engine images to user managed keys to be used when creating, diff --git a/gcloud/compute/images/update b/gcloud/compute/images/update index fddf9c37a..971080779 100644 --- a/gcloud/compute/images/update +++ b/gcloud/compute/images/update @@ -2,8 +2,9 @@ NAME gcloud compute images update - update a Compute Engine image SYNOPSIS - gcloud compute images update IMAGE_NAME [--description=DESCRIPTION] - [--family=FAMILY] [--update-labels=[KEY=VALUE,...]] + gcloud compute images update IMAGE_NAME [--architecture=ARCHITECTURE] + [--description=DESCRIPTION] [--family=FAMILY] + [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -31,6 +32,12 @@ POSITIONAL ARGUMENTS Name of the disk image to update. FLAGS + --architecture=ARCHITECTURE + Specifies the architecture or processor type that this image can + support. For available processor types on Compute Engine, see + https://cloud.google.com/compute/docs/cpu-platforms. ARCHITECTURE must + be one of: ARM64, X86_64. + --description=DESCRIPTION An optional text description for the image. diff --git a/gcloud/compute/scp b/gcloud/compute/scp index 77a4c9c52..c8df0bfa0 100644 --- a/gcloud/compute/scp +++ b/gcloud/compute/scp @@ -15,8 +15,11 @@ SYNOPSIS DESCRIPTION gcloud compute scp securely copies files between a virtual machine instance - and your local machine using the scp command. This command does not work - for Windows VMs. + and your local machine using the scp command. + + This command works for Linux VMs and Windows Server 2019 and later VMs that + have SSH enabled + (https://cloud.google.com/compute/docs/connect/windows-ssh). In order to set up a successful transfer, follow these guidelines: ▪ Prefix remote file names with the virtual machine instance name diff --git a/gcloud/config/get b/gcloud/config/get index 7442ab3cb..9fe9e04b4 100644 --- a/gcloud/config/get +++ b/gcloud/config/get @@ -156,6 +156,10 @@ AVAILABLE PROPERTIES anthosevents Overrides API endpoint for gcloud anthos command group. + anthospolicycontrollerstatus_pa + Overrides API endpoint for gcloud container fleet policycontroller + command group. + apigateway Overrides API endpoint for gcloud api-gateway command group. @@ -1086,6 +1090,13 @@ AVAILABLE PROPERTIES upload_chunk_size Chunk size used for uploading to clouds. + use_gcloud_crc32c + If True, data integrity checks use a binary subprocess to calculate + CRC32C hashes with the included gcloud-crc32c tool rather than the + google-crc32c Python library. This behavior is also triggered when + the google-crc32c Python library is unavailable even if this + property is False. + use_gsutil If True, use the deprecated upload implementation which uses gsutil. diff --git a/gcloud/config/help b/gcloud/config/help index ccea75e71..60926eee7 100644 --- a/gcloud/config/help +++ b/gcloud/config/help @@ -188,6 +188,10 @@ AVAILABLE PROPERTIES anthosevents Overrides API endpoint for gcloud anthos command group. + anthospolicycontrollerstatus_pa + Overrides API endpoint for gcloud container fleet policycontroller + command group. + apigateway Overrides API endpoint for gcloud api-gateway command group. @@ -1118,6 +1122,13 @@ AVAILABLE PROPERTIES upload_chunk_size Chunk size used for uploading to clouds. + use_gcloud_crc32c + If True, data integrity checks use a binary subprocess to calculate + CRC32C hashes with the included gcloud-crc32c tool rather than the + google-crc32c Python library. This behavior is also triggered when + the google-crc32c Python library is unavailable even if this + property is False. + use_gsutil If True, use the deprecated upload implementation which uses gsutil. diff --git a/gcloud/config/list b/gcloud/config/list index b7c52ceb8..95061945b 100644 --- a/gcloud/config/list +++ b/gcloud/config/list @@ -193,6 +193,10 @@ AVAILABLE PROPERTIES anthosevents Overrides API endpoint for gcloud anthos command group. + anthospolicycontrollerstatus_pa + Overrides API endpoint for gcloud container fleet policycontroller + command group. + apigateway Overrides API endpoint for gcloud api-gateway command group. @@ -1123,6 +1127,13 @@ AVAILABLE PROPERTIES upload_chunk_size Chunk size used for uploading to clouds. + use_gcloud_crc32c + If True, data integrity checks use a binary subprocess to calculate + CRC32C hashes with the included gcloud-crc32c tool rather than the + google-crc32c Python library. This behavior is also triggered when + the google-crc32c Python library is unavailable even if this + property is False. + use_gsutil If True, use the deprecated upload implementation which uses gsutil. diff --git a/gcloud/config/set b/gcloud/config/set index 2f6ad050d..c2b243bb8 100644 --- a/gcloud/config/set +++ b/gcloud/config/set @@ -203,6 +203,10 @@ AVAILABLE PROPERTIES anthosevents Overrides API endpoint for gcloud anthos command group. + anthospolicycontrollerstatus_pa + Overrides API endpoint for gcloud container fleet policycontroller + command group. + apigateway Overrides API endpoint for gcloud api-gateway command group. @@ -1133,6 +1137,13 @@ AVAILABLE PROPERTIES upload_chunk_size Chunk size used for uploading to clouds. + use_gcloud_crc32c + If True, data integrity checks use a binary subprocess to calculate + CRC32C hashes with the included gcloud-crc32c tool rather than the + google-crc32c Python library. This behavior is also triggered when + the google-crc32c Python library is unavailable even if this + property is False. + use_gsutil If True, use the deprecated upload implementation which uses gsutil. diff --git a/gcloud/config/unset b/gcloud/config/unset index 6e806dbe8..0fac80824 100644 --- a/gcloud/config/unset +++ b/gcloud/config/unset @@ -164,6 +164,10 @@ AVAILABLE PROPERTIES anthosevents Overrides API endpoint for gcloud anthos command group. + anthospolicycontrollerstatus_pa + Overrides API endpoint for gcloud container fleet policycontroller + command group. + apigateway Overrides API endpoint for gcloud api-gateway command group. @@ -1094,6 +1098,13 @@ AVAILABLE PROPERTIES upload_chunk_size Chunk size used for uploading to clouds. + use_gcloud_crc32c + If True, data integrity checks use a binary subprocess to calculate + CRC32C hashes with the included gcloud-crc32c tool rather than the + google-crc32c Python library. This behavior is also triggered when + the google-crc32c Python library is unavailable even if this + property is False. + use_gsutil If True, use the deprecated upload implementation which uses gsutil. diff --git a/gcloud/container/fleet/memberships/generate-gateway-rbac b/gcloud/container/fleet/memberships/generate-gateway-rbac index 7685fc657..b0bb29878 100644 --- a/gcloud/container/fleet/memberships/generate-gateway-rbac +++ b/gcloud/container/fleet/memberships/generate-gateway-rbac @@ -51,7 +51,7 @@ EXAMPLES --membership=my-cluster \ --users=foo@example.com,\ test-acct@test-project.iam.gserviceaccount.com \ - --role=clusterrole/cluster-admin --context=my-cluster-contex \ + --role=clusterrole/cluster-admin --context=my-cluster-context \ --kubeconfig=/home/user/custom_kubeconfig --apply Revoke mode, revoke the RBAC policy for the specified users: @@ -60,9 +60,19 @@ EXAMPLES --membership=my-cluster \ --users=foo@example.com,\ test-acct@test-project.iam.gserviceaccount.com \ - --role=clusterrole/cluster-admin --context=my-cluster-contex \ + --role=clusterrole/cluster-admin --context=my-cluster-context \ --kubeconfig=/home/user/custom_kubeconfig --revoke + The role to be granted to the users can either be cluster-scoped or + namespace-scoped. To grant a namespace-scoped role to the users in dry run + mode, run: + + $ gcloud container fleet memberships generate-gateway-rbac \ + --membership=my-cluster \ + --users=foo@example.com,\ + test-acct@test-project.iam.gserviceaccount.com \ + --role=role/mynamespace/namespace-reader + FLAGS --anthos-support If specified, this command will generate RBAC policy file for anthos diff --git a/gcloud/container/hub/memberships/generate-gateway-rbac b/gcloud/container/hub/memberships/generate-gateway-rbac index f3f1a8019..fe058dac5 100644 --- a/gcloud/container/hub/memberships/generate-gateway-rbac +++ b/gcloud/container/hub/memberships/generate-gateway-rbac @@ -51,7 +51,7 @@ EXAMPLES --membership=my-cluster \ --users=foo@example.com,\ test-acct@test-project.iam.gserviceaccount.com \ - --role=clusterrole/cluster-admin --context=my-cluster-contex \ + --role=clusterrole/cluster-admin --context=my-cluster-context \ --kubeconfig=/home/user/custom_kubeconfig --apply Revoke mode, revoke the RBAC policy for the specified users: @@ -60,9 +60,19 @@ EXAMPLES --membership=my-cluster \ --users=foo@example.com,\ test-acct@test-project.iam.gserviceaccount.com \ - --role=clusterrole/cluster-admin --context=my-cluster-contex \ + --role=clusterrole/cluster-admin --context=my-cluster-context \ --kubeconfig=/home/user/custom_kubeconfig --revoke + The role to be granted to the users can either be cluster-scoped or + namespace-scoped. To grant a namespace-scoped role to the users in dry run + mode, run: + + $ gcloud container hub memberships generate-gateway-rbac \ + --membership=my-cluster \ + --users=foo@example.com,\ + test-acct@test-project.iam.gserviceaccount.com \ + --role=role/mynamespace/namespace-reader + FLAGS --anthos-support If specified, this command will generate RBAC policy file for anthos diff --git a/gcloud/dataflow/flex-template/build b/gcloud/dataflow/flex-template/build index 966695c4b..839d5b33d 100644 --- a/gcloud/dataflow/flex-template/build +++ b/gcloud/dataflow/flex-template/build @@ -7,8 +7,8 @@ SYNOPSIS --sdk-language=SDK_LANGUAGE (--image=IMAGE | --env=[ENV,...] --flex-template-base-image=FLEX_TEMPLATE_BASE_IMAGE - --image-gcr-path=IMAGE_GCR_PATH (--jar=[JAR,...] - | --py-path=[PY_PATH,...])) + --image-gcr-path=IMAGE_GCR_PATH (--go-binary-path=GO_BINARY_PATH + | --jar=[JAR,...] | --py-path=[PY_PATH,...])) [--additional-experiments=[ADDITIONAL_EXPERIMENTS,...]] [--additional-user-labels=[ADDITIONAL_USER_LABELS,...]] [--dataflow-kms-key=DATAFLOW_KMS_KEY] [--disable-public-ips] @@ -62,7 +62,7 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS --sdk-language=SDK_LANGUAGE SDK language of the flex template job. SDK_LANGUAGE must be one of: - JAVA, PYTHON. + JAVA, PYTHON, GO. Exactly one of these must be specified: @@ -103,6 +103,13 @@ REQUIRED FLAGS Exactly one of these must be specified: + --go-binary-path=GO_BINARY_PATH + Local path to your compiled dataflow pipeline Go binary. The binary + should be compiled to run on the target worker architecture + (usually linux-amd64). See + https://beam.apache.org/documentation/sdks/go-cross-compilation/ + for more information. + --jar=[JAR,...] Local path to your dataflow pipeline jar file and all their dependent jar files required for the flex template classpath. You diff --git a/gcloud/functions/deploy b/gcloud/functions/deploy index bec336e5f..301d10df2 100644 --- a/gcloud/functions/deploy +++ b/gcloud/functions/deploy @@ -170,7 +170,7 @@ FLAGS ◆ python37: Python 3.7 ◆ python38: Python 3.8 ◆ python39: Python 3.9 - ◆ python310: Python 3.10 (preview) + ◆ python310: Python 3.10 ◆ go111: Go 1.11 ◆ go113: Go 1.13 ◆ go116: Go 1.16 diff --git a/gcloud/network-services/help b/gcloud/network-services/help index 892223f01..06bdfec42 100644 --- a/gcloud/network-services/help +++ b/gcloud/network-services/help @@ -36,6 +36,9 @@ GROUPS tcp-routes Manage Network Services TcpRoutes. + tls-routes + Manage Network Services TlsRoutes. + NOTES These variants are also available: diff --git a/gcloud/network-services/tls-routes/delete b/gcloud/network-services/tls-routes/delete new file mode 100644 index 000000000..450ca62d6 --- /dev/null +++ b/gcloud/network-services/tls-routes/delete @@ -0,0 +1,66 @@ +NAME + gcloud network-services tls-routes delete - delete tls route + +SYNOPSIS + gcloud network-services tls-routes delete (TLS_ROUTE : --location=LOCATION) + [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete the specified tls route. + +EXAMPLES + To delete a tls route named my-tls-route, run: + + $ gcloud network-services tls-routes delete my-tls-route \ + --location=global + +POSITIONAL ARGUMENTS + Tls route resource - Name of the tls route 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 tls_route 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. + + TLS_ROUTE + ID of the tls route or fully qualified identifier for the tls route. + To set the tls_route attribute: + ▸ provide the argument tls_route on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument tls_route 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 networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + This variant is also available: + + $ gcloud alpha network-services tls-routes delete + diff --git a/gcloud/network-services/tls-routes/describe b/gcloud/network-services/tls-routes/describe new file mode 100644 index 000000000..40eeb2e77 --- /dev/null +++ b/gcloud/network-services/tls-routes/describe @@ -0,0 +1,61 @@ +NAME + gcloud network-services tls-routes describe - describe a tls route + +SYNOPSIS + gcloud network-services tls-routes describe + (TLS_ROUTE : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Show details of a tls route. + +EXAMPLES + Show details about a tls route named my-tls-route. + + $ gcloud network-services tls-routes describe my-tls-route \ + --location=global + +POSITIONAL ARGUMENTS + Tls route resource - Name of the tls route to be described. 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 tls_route 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. + + TLS_ROUTE + ID of the tls route or fully qualified identifier for the tls route. + To set the tls_route attribute: + ▸ provide the argument tls_route on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument tls_route 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 networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + This variant is also available: + + $ gcloud alpha network-services tls-routes describe + diff --git a/gcloud/network-services/tls-routes/export b/gcloud/network-services/tls-routes/export new file mode 100644 index 000000000..5c69b9c83 --- /dev/null +++ b/gcloud/network-services/tls-routes/export @@ -0,0 +1,69 @@ +NAME + gcloud network-services tls-routes export - export tls route + +SYNOPSIS + gcloud network-services tls-routes export (TLS_ROUTE : --location=LOCATION) + [--destination=DESTINATION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Export a tls route. + +EXAMPLES + To export a tls route named my-tls-route to a YAML file, run: + + $ gcloud network-services tls-routes export my-tls-route \ + --destination=my-tls-route.yaml --location=global + +POSITIONAL ARGUMENTS + Tls route resource - Name of the tls route to export. 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 tls_route 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. + + TLS_ROUTE + ID of the tls route or fully qualified identifier for the tls route. + To set the tls_route attribute: + ▸ provide the argument tls_route on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument tls_route on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --destination=DESTINATION + Path to a YAML file where the configuration will be exported. The + exported data will not contain any output-only fields. Alternatively, + you may omit this flag to write to standard output. For a schema + describing the export/import format, see + $CLOUDSDKROOT/lib/googlecloudsdk/schemas/... + +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 networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + This variant is also available: + + $ gcloud alpha network-services tls-routes export + diff --git a/gcloud/network-services/tls-routes/help b/gcloud/network-services/tls-routes/help new file mode 100644 index 000000000..658d479ba --- /dev/null +++ b/gcloud/network-services/tls-routes/help @@ -0,0 +1,37 @@ +NAME + gcloud network-services tls-routes - manage Network Services TlsRoutes + +SYNOPSIS + gcloud network-services tls-routes COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Network Services TlsRoutes. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + delete + Delete tls route. + + describe + Describe a tls route. + + export + Export tls route. + + import + Import tls route. + + list + List tls routes. + +NOTES + This variant is also available: + + $ gcloud alpha network-services tls-routes + diff --git a/gcloud/network-services/tls-routes/import b/gcloud/network-services/tls-routes/import new file mode 100644 index 000000000..dec00aa6a --- /dev/null +++ b/gcloud/network-services/tls-routes/import @@ -0,0 +1,76 @@ +NAME + gcloud network-services tls-routes import - import tls route + +SYNOPSIS + gcloud network-services tls-routes import (TLS_ROUTE : --location=LOCATION) + [--async] [--source=SOURCE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Import a tls route. + +EXAMPLES + To import a tls route named my-tls-route from a YAML file, run: + + $ gcloud network-services tls-routes import my-tls-route \ + --source=my-tls-route.yaml --location=global + +POSITIONAL ARGUMENTS + Tls route resource - Name of the tls route to import. 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 tls_route 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. + + TLS_ROUTE + ID of the tls route or fully qualified identifier for the tls route. + To set the tls_route attribute: + ▸ provide the argument tls_route on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument tls_route 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. + + --source=SOURCE + Path to a YAML file containing the configuration export data. The YAML + file must not contain any output-only fields. Alternatively, you may + omit this flag to read from standard input. For a schema describing the + export/import format, see: $CLOUDSDKROOT/lib/googlecloudsdk/schemas/... + + $CLOUDSDKROOT is can be obtained with the following command: + + $ gcloud info --format='value(installation.sdk_root)' + +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 networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + This variant is also available: + + $ gcloud alpha network-services tls-routes import + diff --git a/gcloud/network-services/tls-routes/list b/gcloud/network-services/tls-routes/list new file mode 100644 index 000000000..77ec2ceb4 --- /dev/null +++ b/gcloud/network-services/tls-routes/list @@ -0,0 +1,82 @@ +NAME + gcloud network-services tls-routes list - list tls routes + +SYNOPSIS + gcloud network-services tls-routes list --location=LOCATION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List all tls routes in the specified location of the current project. + +EXAMPLES + To list tls routes in the current project, run: + + $ gcloud network-services tls-routes list --location=global + +REQUIRED FLAGS + Location resource - The project of the tls routes to display. 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. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + This variant is also available: + + $ gcloud alpha network-services tls-routes list + diff --git a/gcloud/notebooks/help b/gcloud/notebooks/help index bd16684e0..0b3b5e8ad 100644 --- a/gcloud/notebooks/help +++ b/gcloud/notebooks/help @@ -24,6 +24,9 @@ GROUPS locations View locations available for a project. + runtimes + Notebooks Runtimes command group. + NOTES These variants are also available: diff --git a/gcloud/notebooks/runtimes/create b/gcloud/notebooks/runtimes/create new file mode 100644 index 000000000..35eeb3bb3 --- /dev/null +++ b/gcloud/notebooks/runtimes/create @@ -0,0 +1,119 @@ +NAME + gcloud notebooks runtimes create - request for creating an runtime + +SYNOPSIS + gcloud notebooks runtimes create (RUNTIME : --location=LOCATION) + (--runtime-access-type=RUNTIME_ACCESS_TYPE + --runtime-owner=RUNTIME_OWNER) + (--runtime-type=RUNTIME_TYPE | [--machine-type=MACHINE_TYPE + : --interface=INTERFACE --mode=MODE --source=SOURCE --type=TYPE]) + [--async] + [--custom-gpu-driver-path=CUSTOM_GPU_DRIVER_PATH + --idle-shutdown-timeout=IDLE_SHUTDOWN_TIMEOUT + --install-gpu-driver=INSTALL_GPU_DRIVER + --post-startup-script=POST_STARTUP_SCRIPT + --post-startup-script-behavior=POST_STARTUP_SCRIPT_BEHAVIOR] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Request for creating notebook runtimes. + +EXAMPLES + To create a runtime, run: + + $ gcloud notebooks runtimes create example-runtime \ + --runtime-access-type=SINGLE_USER \ + --runtime-owner=example@google.com \ + --machine-type=n1-standard-4 --location=us-central1-b + +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 rumtime 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. + +REQUIRED FLAGS + At least one of these must be specified: + + --runtime-access-type=RUNTIME_ACCESS_TYPE + access type + + --runtime-owner=RUNTIME_OWNER + runtime owner + + Exactly one of these must be specified: + + --runtime-type=RUNTIME_TYPE + runtime type + + --machine-type=MACHINE_TYPE + machine type + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --interface=INTERFACE + runtime interface + + --mode=MODE + runtime mode + + --source=SOURCE + runtime source + + --type=TYPE + runtime type + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --custom-gpu-driver-path=CUSTOM_GPU_DRIVER_PATH + custom gpu driver path + + --idle-shutdown-timeout=IDLE_SHUTDOWN_TIMEOUT + idle shutdown timeout + + --install-gpu-driver=INSTALL_GPU_DRIVER + install gpu driver + + --post-startup-script=POST_STARTUP_SCRIPT + post startup script + + --post-startup-script-behavior=POST_STARTUP_SCRIPT_BEHAVIOR + post startup script behavior + +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/notebooks/runtimes/delete b/gcloud/notebooks/runtimes/delete new file mode 100644 index 000000000..7f4a187bc --- /dev/null +++ b/gcloud/notebooks/runtimes/delete @@ -0,0 +1,60 @@ +NAME + gcloud notebooks runtimes delete - request for deleting runtimes + +SYNOPSIS + gcloud notebooks runtimes delete (RUNTIME : --location=LOCATION) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Request for deleting notebook runtimes. + +EXAMPLES + To delete a runtime, run: + + $ gcloud notebooks runtimes delete example-runtime \ + --location=us-central1-b + +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 rumtime 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. + +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/notebooks/runtimes/describe b/gcloud/notebooks/runtimes/describe new file mode 100644 index 000000000..0ab1e0190 --- /dev/null +++ b/gcloud/notebooks/runtimes/describe @@ -0,0 +1,55 @@ +NAME + gcloud notebooks runtimes describe - request for describing runtimes + +SYNOPSIS + gcloud notebooks runtimes describe (RUNTIME : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Request for describing notebook runtimes. + +EXAMPLES + To describe a runtime, run: + + $ gcloud notebooks runtimes describe example-runtime \ + --location=us-central1-b + +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 rumtime 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. + +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/notebooks/runtimes/help b/gcloud/notebooks/runtimes/help new file mode 100644 index 000000000..a8df1387c --- /dev/null +++ b/gcloud/notebooks/runtimes/help @@ -0,0 +1,40 @@ +NAME + gcloud notebooks runtimes - notebooks Runtimes command group + +SYNOPSIS + gcloud notebooks runtimes COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Notebooks Runtimes command group. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + Request for creating an runtime. + + delete + Request for deleting runtimes. + + describe + Request for describing runtimes. + + list + Request for listing runtimes. + + reset + Request for resetting runtimes. + + start + Request for starting runtimes. + + stop + Request for stopping runtimes. + + switch + Request for switching runtimes. diff --git a/gcloud/notebooks/runtimes/list b/gcloud/notebooks/runtimes/list new file mode 100644 index 000000000..74a1d57a3 --- /dev/null +++ b/gcloud/notebooks/runtimes/list @@ -0,0 +1,72 @@ +NAME + gcloud notebooks runtimes list - request for listing runtimes + +SYNOPSIS + gcloud notebooks runtimes list [--location=LOCATION] [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Request for listing runtimes. + +EXAMPLES + To list runtimes in a particular location, run: + + $ gcloud notebooks runtimes list --location=us-central1-a + +FLAGS + Location resource - Location of this runtime. For example, us-central1-a + 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 notebooks/location 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; + ▸ set the property notebooks/location. + +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. diff --git a/gcloud/notebooks/runtimes/reset b/gcloud/notebooks/runtimes/reset new file mode 100644 index 000000000..a2d74cd19 --- /dev/null +++ b/gcloud/notebooks/runtimes/reset @@ -0,0 +1,60 @@ +NAME + gcloud notebooks runtimes reset - request for resetting runtimes + +SYNOPSIS + gcloud notebooks runtimes reset (RUNTIME : --location=LOCATION) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Request for resetting notebook runtimes. + +EXAMPLES + To reset a runtime, run: + + $ gcloud notebooks runtimes reset example-runtime \ + --location=us-central1-a + +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 rumtime 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. + +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/notebooks/runtimes/start b/gcloud/notebooks/runtimes/start new file mode 100644 index 000000000..26815235a --- /dev/null +++ b/gcloud/notebooks/runtimes/start @@ -0,0 +1,60 @@ +NAME + gcloud notebooks runtimes start - request for starting runtimes + +SYNOPSIS + gcloud notebooks runtimes start (RUNTIME : --location=LOCATION) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Request for starting notebook runtimes. + +EXAMPLES + To start a runtime, run: + + $ gcloud notebooks runtimes start example-runtime \ + --location=us-central1-a + +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 rumtime 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. + +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/notebooks/runtimes/stop b/gcloud/notebooks/runtimes/stop new file mode 100644 index 000000000..a138ac2a0 --- /dev/null +++ b/gcloud/notebooks/runtimes/stop @@ -0,0 +1,60 @@ +NAME + gcloud notebooks runtimes stop - request for stopping runtimes + +SYNOPSIS + gcloud notebooks runtimes stop (RUNTIME : --location=LOCATION) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Request for stopping notebook runtimes. + +EXAMPLES + To stop a runtime, run: + + $ gcloud notebooks runtimes stop example-runtime \ + --location=us-central1-a + +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 rumtime 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. + +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/notebooks/runtimes/switch b/gcloud/notebooks/runtimes/switch new file mode 100644 index 000000000..3d3f1fbf8 --- /dev/null +++ b/gcloud/notebooks/runtimes/switch @@ -0,0 +1,75 @@ +NAME + gcloud notebooks runtimes switch - request for switching runtimes + +SYNOPSIS + gcloud notebooks runtimes switch (RUNTIME : --location=LOCATION) [--async] + [--machine-type=MACHINE_TYPE] + [--accelerator-core-count=ACCELERATOR_CORE_COUNT + --accelerator-type=ACCELERATOR_TYPE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Request for switching notebook runtimes. + +EXAMPLES + To switch a runtime, run: + + $ gcloud notebooks runtimes switch example-runtime \ + --machine-type=n1-standard-4 + +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 rumtime 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. + + --machine-type=MACHINE_TYPE + machine type + + --accelerator-core-count=ACCELERATOR_CORE_COUNT + Count of cores of this accelerator. + + --accelerator-type=ACCELERATOR_TYPE + Type of this accelerator. ACCELERATOR_TYPE must be one of: + NVIDIA_TESLA_A100, NVIDIA_TESLA_K80, NVIDIA_TESLA_P100, + NVIDIA_TESLA_V100, NVIDIA_TESLA_P4, NVIDIA_TESLA_T4, + NVIDIA_TESLA_T4_VWS, NVIDIA_TESLA_P100_VWS, NVIDIA_TESLA_P4_VWS, + TPU_V2, TPU_V3. + +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/org-policies/delete-custom-constraint b/gcloud/org-policies/delete-custom-constraint new file mode 100644 index 000000000..1548f607c --- /dev/null +++ b/gcloud/org-policies/delete-custom-constraint @@ -0,0 +1,32 @@ +NAME + gcloud org-policies delete-custom-constraint - deletes a custom constraint + +SYNOPSIS + gcloud org-policies delete-custom-constraint CUSTOM_CONSTRAINT + --organization=ORGANIZATION_ID [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Deletes a custom constraint. + +EXAMPLES + To delete the custom constraint 'custom.myCustomConstraint' associated with + the Organization '1234', run: + + $ gcloud org-policies delete-custom-constraint \ + custom.myCustomConstraint --organization=1234 + +POSITIONAL ARGUMENTS + CUSTOM_CONSTRAINT + Name of the custom constraint. + +REQUIRED FLAGS + --organization=ORGANIZATION_ID + Organization 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. diff --git a/gcloud/org-policies/describe-custom-constraint b/gcloud/org-policies/describe-custom-constraint new file mode 100644 index 000000000..deb15b997 --- /dev/null +++ b/gcloud/org-policies/describe-custom-constraint @@ -0,0 +1,33 @@ +NAME + gcloud org-policies describe-custom-constraint - describe a custom + constraint + +SYNOPSIS + gcloud org-policies describe-custom-constraint CUSTOM_CONSTRAINT + --organization=ORGANIZATION_ID [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describes a custom constraint. + +EXAMPLES + To describe the custom constraint 'custom.myCustomConstraint' associated + with the Organization '1234', run: + + $ gcloud org-policies describe-custom-constraint \ + custom.myCustomConstraint --organization=1234 + +POSITIONAL ARGUMENTS + CUSTOM_CONSTRAINT + Name of the custom constraint. + +REQUIRED FLAGS + --organization=ORGANIZATION_ID + Organization 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. diff --git a/gcloud/org-policies/help b/gcloud/org-policies/help index e9a1e063c..324595d60 100644 --- a/gcloud/org-policies/help +++ b/gcloud/org-policies/help @@ -27,14 +27,26 @@ COMMANDS delete Delete an organization policy. + delete-custom-constraint + Deletes a custom constraint. + describe Describe an organization policy. + describe-custom-constraint + Describe a custom constraint. + list List the policies set on a resource. + list-custom-constraints + Lists the custom constraints set on an organization. + reset Reset the policy to the default for the constraint. + set-custom-constraint + Set a custom constraint from a JSON or YAML file. + set-policy Set an organization policy from a JSON or YAML file. diff --git a/gcloud/org-policies/list-custom-constraints b/gcloud/org-policies/list-custom-constraints new file mode 100644 index 000000000..3a00dbf61 --- /dev/null +++ b/gcloud/org-policies/list-custom-constraints @@ -0,0 +1,60 @@ +NAME + gcloud org-policies list-custom-constraints - lists the custom constraints + set on an organization + +SYNOPSIS + gcloud org-policies list-custom-constraints --organization=ORGANIZATION_ID + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Lists the custom constraints set on an organization. + +EXAMPLES + To list the custom constraints set on the Organization '1234', run: + + $ gcloud org-policies list-custom-constraints --organization=1234 + +REQUIRED FLAGS + --organization=ORGANIZATION_ID + Organization ID. + +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. diff --git a/gcloud/org-policies/set-custom-constraint b/gcloud/org-policies/set-custom-constraint new file mode 100644 index 000000000..d364a7b1f --- /dev/null +++ b/gcloud/org-policies/set-custom-constraint @@ -0,0 +1,29 @@ +NAME + gcloud org-policies set-custom-constraint - set a custom constraint from a + JSON or YAML file + +SYNOPSIS + gcloud org-policies set-custom-constraint CUSTOM_CONSTRAINT_FILE + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Sets a Custom Constraint from a JSON or YAML file. The custom constraint + will be created if it does not exist, or updated if it already exists. + +EXAMPLES + To set the custom constraint from the file on the path './sample_path', + run: + + $ gcloud org-policies set-custom-constraint ./sample_path + +POSITIONAL ARGUMENTS + CUSTOM_CONSTRAINT_FILE + Path to JSON or YAML file that contains the organization policy. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. diff --git a/gcloud/privateca/templates/create b/gcloud/privateca/templates/create index 3b84a6c72..fd57984b1 100644 --- a/gcloud/privateca/templates/create +++ b/gcloud/privateca/templates/create @@ -114,7 +114,12 @@ OPTIONAL FLAGS A YAML file describing any predefined X.509 values set by this template. The provided extensions will be copied over to any certificate requests that use this template, taking precedent over any - allowed extensions in the certificate request. + allowed extensions in the certificate request. The format of this file + should be a YAML representation of the X509Parameters message, which is + defined here: + https://cloud.google.com/certificate-authority-service/docs/reference/rest/v1/X509Parameters. + Some examples can be found here: + https://cloud.google.com/certificate-authority-service/docs/creating-certificate-template Constraints on requested X.509 extensions. If unspecified, all extensions from certificate request will be ignored when signing the certificate. diff --git a/gcloud/privateca/templates/update b/gcloud/privateca/templates/update index 5162cb0d3..7e1ce6ba5 100644 --- a/gcloud/privateca/templates/update +++ b/gcloud/privateca/templates/update @@ -97,7 +97,12 @@ FLAGS A YAML file describing any predefined X.509 values set by this template. The provided extensions will be copied over to any certificate requests that use this template, taking precedent over any - allowed extensions in the certificate request. + allowed extensions in the certificate request. The format of this file + should be a YAML representation of the X509Parameters message, which is + defined here: + https://cloud.google.com/certificate-authority-service/docs/reference/rest/v1/X509Parameters. + Some examples can be found here: + https://cloud.google.com/certificate-authority-service/docs/creating-certificate-template --update-labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to update. If a label exists, its value diff --git a/gcloud/spanner/help b/gcloud/spanner/help index 6cfa8afda..aba15d7e5 100644 --- a/gcloud/spanner/help +++ b/gcloud/spanner/help @@ -33,6 +33,9 @@ GROUPS rows Manage the rows in Cloud Spanner databases. + samples + Cloud Spanner sample apps. + NOTES These variants are also available: diff --git a/gcloud/spanner/instances/create b/gcloud/spanner/instances/create index e641a497f..0e6e38257 100644 --- a/gcloud/spanner/instances/create +++ b/gcloud/spanner/instances/create @@ -3,8 +3,9 @@ NAME SYNOPSIS gcloud spanner instances create INSTANCE --config=CONFIG - --description=DESCRIPTION - (--nodes=NODES | --processing-units=PROCESSING_UNITS) [--async] + --description=DESCRIPTION [--async] [--expire-behavior=EXPIRE_BEHAVIOR] + [--instance-type=INSTANCE_TYPE] + [--nodes=NODES | --processing-units=PROCESSING_UNITS] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -30,7 +31,35 @@ REQUIRED FLAGS --description=DESCRIPTION Description of the instance. - Exactly one of these must be specified: +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --expire-behavior=EXPIRE_BEHAVIOR + The expire behavior of a free trial instance. EXPIRE_BEHAVIOR must be + one of: + + free-to-provisioned + When the free trial instance expires, upgrade the instance to a + provisioned instance. + remove-after-grace-period + When the free trial instance expires, disable the instance, and + delete it after the grace period passes if it has not been upgraded + to a provisioned instance. + + --instance-type=INSTANCE_TYPE + Specifies the type for this instance. INSTANCE_TYPE must be one of: + + free-instance + Free trial instances provide no guarantees for dedicated resources, + both node_count and processing_units should be 0. They come with + stricter usage limits and limited support. + provisioned + Provisioned instances have dedicated resources, standard usage + limits, and support. + + At most one of these can be specified: --nodes=NODES Number of nodes for the instance. @@ -38,11 +67,6 @@ REQUIRED FLAGS --processing-units=PROCESSING_UNITS Number of processing units for the instance. -OPTIONAL FLAGS - --async - Return immediately, without waiting for the operation in progress to - complete. - GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/spanner/instances/update b/gcloud/spanner/instances/update index 8463931b7..b88ec0ff4 100644 --- a/gcloud/spanner/instances/update +++ b/gcloud/spanner/instances/update @@ -3,7 +3,8 @@ NAME SYNOPSIS gcloud spanner instances update INSTANCE [--async] - [--description=DESCRIPTION] + [--description=DESCRIPTION] [--expire-behavior=EXPIRE_BEHAVIOR] + [--instance-type=INSTANCE_TYPE] [--nodes=NODES | --processing-units=PROCESSING_UNITS] [GCLOUD_WIDE_FLAG ...] @@ -32,6 +33,29 @@ FLAGS --description=DESCRIPTION Description of the instance. + --expire-behavior=EXPIRE_BEHAVIOR + The expire behavior of a free trial instance. EXPIRE_BEHAVIOR must be + one of: + + free-to-provisioned + When the free trial instance expires, upgrade the instance to a + provisioned instance. + remove-after-grace-period + When the free trial instance expires, disable the instance, and + delete it after the grace period passes if it has not been upgraded + to a provisioned instance. + + --instance-type=INSTANCE_TYPE + Specifies the type for this instance. INSTANCE_TYPE must be one of: + + free-instance + Free trial instances provide no guarantees for dedicated resources, + both node_count and processing_units should be 0. They come with + stricter usage limits and limited support. + provisioned + Provisioned instances have dedicated resources, standard usage + limits, and support. + At most one of these can be specified: --nodes=NODES diff --git a/gcloud/spanner/samples/backend b/gcloud/spanner/samples/backend new file mode 100644 index 000000000..0eced5a09 --- /dev/null +++ b/gcloud/spanner/samples/backend @@ -0,0 +1,63 @@ +NAME + gcloud spanner samples backend - run the backend gRPC service for the given + Cloud Spanner sample app + +SYNOPSIS + gcloud spanner samples backend APPNAME --instance-id=INSTANCE_ID + [--database-id=DATABASE_ID] [--duration=DURATION; default="1h"] + [--port=PORT] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + This command starts the backend gRPC service for the given sample + application. Before starting the service, create the database and load any + initial data with: + + $ gcloud spanner samples init APPNAME --instance-id=INSTANCE_ID + + After starting the service, generate traffic with: + + $ gcloud spanner samples workload APPNAME + + To run all three steps together, use: + + $ gcloud spanner samples run APPNAME --instance-id=INSTANCE_ID + +EXAMPLES + To run the backend gRPC service for the 'finance' sample app using instance + 'my-instance', run: + + $ gcloud spanner samples backend finance --instance-id=my-instance + +POSITIONAL ARGUMENTS + APPNAME + The sample app name, e.g. "finance". + +REQUIRED FLAGS + --instance-id=INSTANCE_ID + The Cloud Spanner instance ID for the sample app. + +OPTIONAL FLAGS + --database-id=DATABASE_ID + The Cloud Spanner database ID for the sample app. + + --duration=DURATION; default="1h" + Duration of time allowed to run before stopping the service. + + --port=PORT + Port on which to receive gRPC requests. + +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 spanner samples backend + + $ gcloud beta spanner samples backend + diff --git a/gcloud/spanner/samples/help b/gcloud/spanner/samples/help new file mode 100644 index 000000000..bf9c9dde5 --- /dev/null +++ b/gcloud/spanner/samples/help @@ -0,0 +1,48 @@ +NAME + gcloud spanner samples - cloud Spanner sample apps + +SYNOPSIS + gcloud spanner samples COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Each Cloud Spanner sample application includes a backend gRPC service + backed by a Cloud Spanner database and a workload script that generates + service traffic. + + These sample apps are open source and available at + https://github.com/GoogleCloudPlatform/cloud-spanner-samples. + + To see a list of available sample apps, run: + + $ gcloud spanner samples list + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + backend + Run the backend gRPC service for the given Cloud Spanner sample app. + + init + Initialize a Cloud Spanner sample app. + + list + List available sample applications. + + run + Run the given Cloud Spanner sample app. + + workload + Generate gRPC traffic for a given sample app's backend service. + +NOTES + These variants are also available: + + $ gcloud alpha spanner samples + + $ gcloud beta spanner samples + diff --git a/gcloud/spanner/samples/init b/gcloud/spanner/samples/init new file mode 100644 index 000000000..dec10a1c7 --- /dev/null +++ b/gcloud/spanner/samples/init @@ -0,0 +1,43 @@ +NAME + gcloud spanner samples init - initialize a Cloud Spanner sample app + +SYNOPSIS + gcloud spanner samples init APPNAME --instance-id=INSTANCE_ID + [--database-id=DATABASE_ID] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + This command creates a Cloud Spanner database in the given instance for the + sample app and loads any initial data required by the application. + +EXAMPLES + To initialize the 'finance' sample app using instance 'my-instance', run: + + $ gcloud spanner samples init finance --instance-id=my-instance + +POSITIONAL ARGUMENTS + APPNAME + The sample app name, e.g. "finance". + +REQUIRED FLAGS + --instance-id=INSTANCE_ID + The Cloud Spanner instance ID for the sample app. + +OPTIONAL FLAGS + --database-id=DATABASE_ID + ID of the new Cloud Spanner database to create for the sample app. + +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 spanner samples init + + $ gcloud beta spanner samples init + diff --git a/gcloud/spanner/samples/list b/gcloud/spanner/samples/list new file mode 100644 index 000000000..6ef6c7a3a --- /dev/null +++ b/gcloud/spanner/samples/list @@ -0,0 +1,63 @@ +NAME + gcloud spanner samples list - list available sample applications + +SYNOPSIS + gcloud spanner samples list [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List available sample applications. + +EXAMPLES + To list available sample applications, run: + + $ gcloud spanner samples list + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha spanner samples list + + $ gcloud beta spanner samples list + diff --git a/gcloud/spanner/samples/run b/gcloud/spanner/samples/run new file mode 100644 index 000000000..4681c6995 --- /dev/null +++ b/gcloud/spanner/samples/run @@ -0,0 +1,61 @@ +NAME + gcloud spanner samples run - run the given Cloud Spanner sample app + +SYNOPSIS + gcloud spanner samples run APPNAME --instance-id=INSTANCE_ID [--no-cleanup] + [--database-id=DATABASE_ID] [--duration=DURATION; default="1h"] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Each Cloud Spanner sample application includes a backend gRPC service + backed by a Cloud Spanner database and a workload script that generates + service traffic. This command creates and initializes the Cloud Spanner + database and runs both the backend service and workload script. + + These sample apps are open source and available at + https://github.com/GoogleCloudPlatform/cloud-spanner-samples. + + To see a list of available sample apps, run: + + $ gcloud spanner samples list + +EXAMPLES + To run the 'finance' sample app using instance 'my-instance', run: + + $ gcloud spanner samples run finance --instance-id=my-instance + +POSITIONAL ARGUMENTS + APPNAME + The sample app name, e.g. "finance". + +REQUIRED FLAGS + --instance-id=INSTANCE_ID + The Cloud Spanner instance ID for the sample app. + +OPTIONAL FLAGS + --cleanup + Delete the instance after running the sample app. Enabled by default, + use --no-cleanup to disable. + + --database-id=DATABASE_ID + ID of the new Cloud Spanner database to create for the sample app. + + --duration=DURATION; default="1h" + Duration of time allowed to run the sample app before stopping the + service. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha spanner samples run + + $ gcloud beta spanner samples run + diff --git a/gcloud/spanner/samples/workload b/gcloud/spanner/samples/workload new file mode 100644 index 000000000..124ecf7b9 --- /dev/null +++ b/gcloud/spanner/samples/workload @@ -0,0 +1,53 @@ +NAME + gcloud spanner samples workload - generate gRPC traffic for a given sample + app's backend service + +SYNOPSIS + gcloud spanner samples workload APPNAME [--duration=DURATION; default="1h"] + [--port=PORT] [--target-qps=TARGET_QPS] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Before sending traffic to the backend service, create the database and + start the service with: + + $ gcloud spanner samples init APPNAME --instance-id=INSTANCE_ID + $ gcloud spanner samples backend APPNAME --instance-id=INSTANCE_ID + + To run all three steps together, use: + + $ gcloud spanner samples run APPNAME --instance-id=INSTANCE_ID + +EXAMPLES + To generate traffic for the 'finance' sample app, run: + + $ gcloud spanner samples workload finance + +POSITIONAL ARGUMENTS + APPNAME + The sample app name, e.g. "finance". + +FLAGS + --duration=DURATION; default="1h" + Duration of time allowed to run before stopping the workload. + + --port=PORT + Port of the running backend service. + + --target-qps=TARGET_QPS + Target requests per second. + +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 spanner samples workload + + $ gcloud beta spanner samples workload + diff --git a/gcloud/transfer/agents/install b/gcloud/transfer/agents/install index 47da40703..02ef8ed0a 100644 --- a/gcloud/transfer/agents/install +++ b/gcloud/transfer/agents/install @@ -3,7 +3,7 @@ NAME SYNOPSIS gcloud transfer agents install --pool=POOL [--count=COUNT] - [--creds-file=CREDS_FILE] [--id-prefix=ID_PREFIX] + [--creds-file=CREDS_FILE] [--enable-multipart] [--id-prefix=ID_PREFIX] [--logs-directory=LOGS_DIRECTORY; default="/tmp"] [--memlock-limit=MEMLOCK_LIMIT; default=64000000] [--mount-directories=[MOUNT-DIRECTORIES,...]] [--proxy=PROXY] @@ -48,6 +48,12 @@ OPTIONAL FLAGS Note that the credentials location will be mounted to the agent container. + --enable-multipart + Split up files and transfer the resulting chunks in parallel before + merging them at the destination. Can be used make transfers of large + files faster as long as the network and disk speed are not limiting + factors. + --id-prefix=ID_PREFIX An optional prefix to add to the agent ID to help identify the agent.