From e7bec9b31b12551c504e89763f5d58e46164c083 Mon Sep 17 00:00:00 2001 From: Automated Date: Thu, 8 Sep 2022 09:21:50 +0000 Subject: [PATCH] gcloud: Thu Sep 8 09:21:50 UTC 2022 --- gcloud/_version | 8 +- gcloud/alpha/alloydb/instances/describe | 8 +- .../alpha/bigtable/app-profiles/config/export | 3 +- .../bigtable/backups/add-iam-policy-binding | 5 +- gcloud/alpha/bigtable/backups/copy | 10 +- gcloud/alpha/bigtable/backups/create | 5 +- gcloud/alpha/bigtable/backups/delete | 5 +- gcloud/alpha/bigtable/backups/describe | 5 +- gcloud/alpha/bigtable/backups/get-iam-policy | 5 +- .../backups/remove-iam-policy-binding | 5 +- gcloud/alpha/bigtable/backups/set-iam-policy | 5 +- gcloud/alpha/bigtable/backups/update | 5 +- .../instances/tables/add-iam-policy-binding | 3 +- .../bigtable/instances/tables/config/export | 3 +- gcloud/alpha/bigtable/instances/tables/create | 109 ++++++++++++ .../alpha/bigtable/instances/tables/describe | 3 +- .../bigtable/instances/tables/get-iam-policy | 3 +- gcloud/alpha/bigtable/instances/tables/help | 3 + .../tables/remove-iam-policy-binding | 3 +- .../alpha/bigtable/instances/tables/restore | 8 +- .../bigtable/instances/tables/set-iam-policy | 3 +- .../alpha/bigtable/instances/tables/undelete | 5 +- gcloud/alpha/compute/disks/help | 3 + .../disks/stop-group-async-replication | 96 ++++++++++ gcloud/alpha/compute/firewall-rules/migrate | 4 +- gcloud/alpha/compute/instances/create | 15 ++ .../instances/network-interfaces/update | 18 +- gcloud/alpha/compute/security-policies/update | 8 + gcloud/alpha/compute/tpus/tpu-vm/create | 46 +++-- gcloud/alpha/config/help | 4 + gcloud/alpha/config/list | 4 + gcloud/alpha/config/set | 4 + gcloud/alpha/config/unset | 4 + gcloud/alpha/container/aws/clusters/update | 22 +++ gcloud/alpha/container/azure/clusters/create | 11 +- gcloud/alpha/container/azure/clusters/update | 25 ++- gcloud/alpha/dataproc/clusters/create | 2 +- .../workflow-templates/set-managed-cluster | 2 +- .../container/vpn-connections/create | 18 +- gcloud/alpha/functions/deploy | 24 +-- gcloud/alpha/logging/buckets/create | 5 + gcloud/alpha/logging/buckets/update | 5 + gcloud/alpha/logging/copy | 10 +- gcloud/alpha/logging/metrics/create | 6 + gcloud/alpha/logging/metrics/update | 5 + gcloud/alpha/logging/operations/cancel | 6 +- gcloud/alpha/logging/operations/describe | 6 +- gcloud/alpha/logging/operations/help | 6 +- gcloud/alpha/logging/operations/list | 6 +- gcloud/alpha/logging/settings/describe | 38 ++-- gcloud/alpha/logging/settings/help | 6 +- gcloud/alpha/logging/settings/update | 6 +- gcloud/alpha/storage/cat | 21 +-- gcloud/alpha/storage/cp | 165 ++++++++--------- gcloud/alpha/storage/ls | 21 +-- gcloud/alpha/storage/mv | 165 ++++++++--------- gcloud/alpha/storage/objects/describe | 4 +- gcloud/alpha/storage/objects/list | 4 +- gcloud/alpha/storage/objects/update | 166 +++++++++--------- gcloud/beta/alloydb/instances/describe | 8 +- .../bigtable/backups/add-iam-policy-binding | 5 +- gcloud/beta/bigtable/backups/create | 5 +- gcloud/beta/bigtable/backups/delete | 5 +- gcloud/beta/bigtable/backups/describe | 5 +- gcloud/beta/bigtable/backups/get-iam-policy | 5 +- .../backups/remove-iam-policy-binding | 5 +- gcloud/beta/bigtable/backups/set-iam-policy | 5 +- gcloud/beta/bigtable/backups/update | 5 +- .../instances/tables/add-iam-policy-binding | 3 +- .../beta/bigtable/instances/tables/describe | 3 +- .../bigtable/instances/tables/get-iam-policy | 3 +- .../tables/remove-iam-policy-binding | 3 +- gcloud/beta/bigtable/instances/tables/restore | 8 +- .../bigtable/instances/tables/set-iam-policy | 3 +- .../beta/bigtable/instances/tables/undelete | 5 +- gcloud/beta/compute/firewall-rules/help | 4 + gcloud/beta/compute/firewall-rules/migrate | 57 ++++++ gcloud/beta/compute/security-policies/update | 8 + gcloud/beta/compute/snapshots/create | 9 +- gcloud/beta/config/get | 4 + gcloud/beta/config/help | 4 + gcloud/beta/config/list | 4 + gcloud/beta/config/set | 4 + gcloud/beta/config/unset | 4 + gcloud/beta/dataproc/clusters/create | 2 +- .../workflow-templates/set-managed-cluster | 2 +- gcloud/beta/functions/deploy | 24 +-- gcloud/beta/logging/buckets/create | 11 +- gcloud/beta/logging/buckets/update | 12 +- gcloud/beta/logging/copy | 84 +++++++++ gcloud/beta/logging/help | 9 + gcloud/beta/logging/metrics/create | 13 +- gcloud/beta/logging/metrics/update | 12 +- gcloud/beta/logging/operations/cancel | 70 ++++++++ gcloud/beta/logging/operations/describe | 71 ++++++++ gcloud/beta/logging/operations/help | 34 ++++ gcloud/beta/logging/operations/list | 121 +++++++++++++ gcloud/beta/logging/settings/describe | 73 ++++++++ gcloud/beta/logging/settings/help | 32 ++++ gcloud/beta/logging/settings/update | 136 ++++++++++++++ gcloud/beta/secrets/versions/access | 3 +- .../bigtable/backups/add-iam-policy-binding | 5 +- gcloud/bigtable/backups/create | 5 +- gcloud/bigtable/backups/delete | 5 +- gcloud/bigtable/backups/describe | 5 +- gcloud/bigtable/backups/get-iam-policy | 5 +- .../backups/remove-iam-policy-binding | 5 +- gcloud/bigtable/backups/set-iam-policy | 5 +- gcloud/bigtable/backups/update | 5 +- .../instances/tables/add-iam-policy-binding | 3 +- gcloud/bigtable/instances/tables/describe | 3 +- .../bigtable/instances/tables/get-iam-policy | 3 +- .../tables/remove-iam-policy-binding | 3 +- gcloud/bigtable/instances/tables/restore | 8 +- .../bigtable/instances/tables/set-iam-policy | 3 +- gcloud/bigtable/instances/tables/undelete | 5 +- gcloud/compute/images/import | 8 + gcloud/compute/instances/create | 7 +- gcloud/compute/instances/import | 15 +- gcloud/compute/machine-images/import | 16 +- gcloud/compute/security-policies/update | 11 +- gcloud/compute/snapshots/create | 10 +- .../compute/sole-tenancy/node-groups/create | 17 +- gcloud/compute/sole-tenancy/node-groups/list | 10 +- .../compute/sole-tenancy/node-groups/update | 17 +- gcloud/config/get | 4 + gcloud/config/help | 4 + gcloud/config/list | 4 + gcloud/config/set | 4 + gcloud/config/unset | 4 + gcloud/container/aws/clusters/update | 22 +++ gcloud/container/azure/clusters/create | 11 +- gcloud/container/azure/clusters/update | 25 ++- gcloud/dataproc/clusters/create | 2 +- .../workflow-templates/set-managed-cluster | 2 +- .../container/vpn-connections/create | 8 +- gcloud/functions/deploy | 24 +-- gcloud/logging/buckets/create | 11 +- gcloud/logging/buckets/update | 12 +- gcloud/logging/copy | 82 +++++++++ gcloud/logging/help | 9 + gcloud/logging/metrics/create | 13 +- gcloud/logging/metrics/update | 12 +- gcloud/logging/operations/cancel | 68 +++++++ gcloud/logging/operations/describe | 69 ++++++++ gcloud/logging/operations/help | 33 ++++ gcloud/logging/operations/list | 120 +++++++++++++ gcloud/logging/settings/describe | 71 ++++++++ gcloud/logging/settings/help | 31 ++++ gcloud/logging/settings/update | 133 ++++++++++++++ gcloud/network-connectivity/hubs/help | 2 +- .../connectivity-tests/create | 6 +- .../connectivity-tests/update | 10 ++ gcloud/secrets/versions/access | 3 +- 154 files changed, 2457 insertions(+), 577 deletions(-) create mode 100644 gcloud/alpha/bigtable/instances/tables/create create mode 100644 gcloud/alpha/compute/disks/stop-group-async-replication create mode 100644 gcloud/beta/compute/firewall-rules/migrate create mode 100644 gcloud/beta/logging/copy create mode 100644 gcloud/beta/logging/operations/cancel create mode 100644 gcloud/beta/logging/operations/describe create mode 100644 gcloud/beta/logging/operations/help create mode 100644 gcloud/beta/logging/operations/list create mode 100644 gcloud/beta/logging/settings/describe create mode 100644 gcloud/beta/logging/settings/help create mode 100644 gcloud/beta/logging/settings/update create mode 100644 gcloud/logging/copy create mode 100644 gcloud/logging/operations/cancel create mode 100644 gcloud/logging/operations/describe create mode 100644 gcloud/logging/operations/help create mode 100644 gcloud/logging/operations/list create mode 100644 gcloud/logging/settings/describe create mode 100644 gcloud/logging/settings/help create mode 100644 gcloud/logging/settings/update diff --git a/gcloud/_version b/gcloud/_version index e4a10ac42..d3a8737d4 100644 --- a/gcloud/_version +++ b/gcloud/_version @@ -1,7 +1,7 @@ -Google Cloud SDK 400.0.0 -alpha 2022.08.26 -beta 2022.08.26 +Google Cloud SDK 401.0.0 +alpha 2022.09.03 +beta 2022.09.03 bq 2.0.75 -core 2022.08.26 +core 2022.09.03 gcloud-crc32c 1.0.0 gsutil 5.12 diff --git a/gcloud/alpha/alloydb/instances/describe b/gcloud/alpha/alloydb/instances/describe index 873fe2935..7f57b9ec7 100644 --- a/gcloud/alpha/alloydb/instances/describe +++ b/gcloud/alpha/alloydb/instances/describe @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud alpha alloydb instances describe INSTANCE --cluster=CLUSTER - --region=REGION [GCLOUD_WIDE_FLAG ...] + --region=REGION [--view=VIEW] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Describes an AlloyDB instance within a given cluster. @@ -13,7 +13,7 @@ EXAMPLES To describe an instance, run: $ gcloud alpha alloydb instances describe my-instance \ - --cluster=my-cluster --region=us-central1 + --cluster=my-cluster --region=us-central1 --view=BASIC/FULL POSITIONAL ARGUMENTS INSTANCE @@ -27,6 +27,10 @@ REQUIRED FLAGS Regional location (e.g. asia-east1, us-east1). See the full list of regions at https://cloud.google.com/sql/docs/instance-locations. +OPTIONAL FLAGS + --view=VIEW + View of the instance to return. VIEW must be one of: basic, full. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/bigtable/app-profiles/config/export b/gcloud/alpha/bigtable/app-profiles/config/export index 1975999ca..84e97f5b4 100644 --- a/gcloud/alpha/bigtable/app-profiles/config/export +++ b/gcloud/alpha/bigtable/app-profiles/config/export @@ -61,8 +61,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - The name of the Cloud Bigtable instance. To set the instance - attribute: + Name of the Cloud Bigtable instance. To set the instance attribute: ▫ provide the argument app_profile on the command line with a fully specified name; ▫ provide the argument --instance on the command line. diff --git a/gcloud/alpha/bigtable/backups/add-iam-policy-binding b/gcloud/alpha/bigtable/backups/add-iam-policy-binding index 0bb8400a0..4ee8c705c 100644 --- a/gcloud/alpha/bigtable/backups/add-iam-policy-binding +++ b/gcloud/alpha/bigtable/backups/add-iam-policy-binding @@ -58,14 +58,13 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --cluster=CLUSTER - The name of the Cloud Bigtable cluster. To set the cluster attribute: + Name of the Cloud Bigtable cluster. To set the cluster attribute: ▸ provide the argument backup on the command line with a fully specified name; ▸ provide the argument --cluster on the command line. --instance=INSTANCE - The name of the Cloud Bigtable instance. To set the instance - attribute: + Name of the Cloud Bigtable instance. To set the instance attribute: ▸ provide the argument backup on the command line with a fully specified name; ▸ provide the argument --instance on the command line. diff --git a/gcloud/alpha/bigtable/backups/copy b/gcloud/alpha/bigtable/backups/copy index f1b77534f..17f96e9d7 100644 --- a/gcloud/alpha/bigtable/backups/copy +++ b/gcloud/alpha/bigtable/backups/copy @@ -66,14 +66,13 @@ REQUIRED FLAGS this group are specified. --destination-cluster=DESTINATION_CLUSTER - The name of the Cloud Bigtable cluster. To set the cluster attribute: + Name of the Cloud Bigtable cluster. To set the cluster attribute: ▸ provide the argument --destination on the command line with a fully specified name; ▸ provide the argument --destination-cluster on the command line. --destination-instance=DESTINATION_INSTANCE - The name of the Cloud Bigtable instance. To set the instance - attribute: + Name of the Cloud Bigtable instance. To set the instance attribute: ▸ provide the argument --destination on the command line with a fully specified name; ▸ provide the argument --destination-instance on the command line; @@ -111,14 +110,13 @@ REQUIRED FLAGS this group are specified. --source-cluster=SOURCE_CLUSTER - The name of the Cloud Bigtable cluster. To set the cluster attribute: + Name of the Cloud Bigtable cluster. To set the cluster attribute: ▸ provide the argument --source on the command line with a fully specified name; ▸ provide the argument --source-cluster on the command line. --source-instance=SOURCE_INSTANCE - The name of the Cloud Bigtable instance. To set the instance - attribute: + Name of the Cloud Bigtable instance. To set the instance attribute: ▸ provide the argument --source on the command line with a fully specified name; ▸ provide the argument --source-instance on the command line; diff --git a/gcloud/alpha/bigtable/backups/create b/gcloud/alpha/bigtable/backups/create index 77e84403c..c14d7c149 100644 --- a/gcloud/alpha/bigtable/backups/create +++ b/gcloud/alpha/bigtable/backups/create @@ -49,14 +49,13 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --cluster=CLUSTER - The name of the Cloud Bigtable cluster. To set the cluster attribute: + Name of the Cloud Bigtable cluster. To set the cluster attribute: ▸ provide the argument backup on the command line with a fully specified name; ▸ provide the argument --cluster on the command line. --instance=INSTANCE - The name of the Cloud Bigtable instance. To set the instance - attribute: + Name of the Cloud Bigtable instance. To set the instance attribute: ▸ provide the argument backup on the command line with a fully specified name; ▸ provide the argument --instance on the command line. diff --git a/gcloud/alpha/bigtable/backups/delete b/gcloud/alpha/bigtable/backups/delete index fe7a88397..1cc65975f 100644 --- a/gcloud/alpha/bigtable/backups/delete +++ b/gcloud/alpha/bigtable/backups/delete @@ -35,14 +35,13 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --cluster=CLUSTER - The name of the Cloud Bigtable cluster. To set the cluster attribute: + Name of the Cloud Bigtable cluster. To set the cluster attribute: ▸ provide the argument backup on the command line with a fully specified name; ▸ provide the argument --cluster on the command line. --instance=INSTANCE - The name of the Cloud Bigtable instance. To set the instance - attribute: + Name of the Cloud Bigtable instance. To set the instance attribute: ▸ provide the argument backup on the command line with a fully specified name; ▸ provide the argument --instance on the command line. diff --git a/gcloud/alpha/bigtable/backups/describe b/gcloud/alpha/bigtable/backups/describe index 2f5981ec3..fcbfdb140 100644 --- a/gcloud/alpha/bigtable/backups/describe +++ b/gcloud/alpha/bigtable/backups/describe @@ -36,14 +36,13 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --cluster=CLUSTER - The name of the Cloud Bigtable cluster. To set the cluster attribute: + Name of the Cloud Bigtable cluster. To set the cluster attribute: ▸ provide the argument backup on the command line with a fully specified name; ▸ provide the argument --cluster on the command line. --instance=INSTANCE - The name of the Cloud Bigtable instance. To set the instance - attribute: + Name of the Cloud Bigtable instance. To set the instance attribute: ▸ provide the argument backup on the command line with a fully specified name; ▸ provide the argument --instance on the command line. diff --git a/gcloud/alpha/bigtable/backups/get-iam-policy b/gcloud/alpha/bigtable/backups/get-iam-policy index 5bb3b1391..1033f54be 100644 --- a/gcloud/alpha/bigtable/backups/get-iam-policy +++ b/gcloud/alpha/bigtable/backups/get-iam-policy @@ -42,14 +42,13 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --cluster=CLUSTER - The name of the Cloud Bigtable cluster. To set the cluster attribute: + Name of the Cloud Bigtable cluster. To set the cluster attribute: ▸ provide the argument backup on the command line with a fully specified name; ▸ provide the argument --cluster on the command line. --instance=INSTANCE - The name of the Cloud Bigtable instance. To set the instance - attribute: + Name of the Cloud Bigtable instance. To set the instance attribute: ▸ provide the argument backup on the command line with a fully specified name; ▸ provide the argument --instance on the command line. diff --git a/gcloud/alpha/bigtable/backups/remove-iam-policy-binding b/gcloud/alpha/bigtable/backups/remove-iam-policy-binding index 114fc2625..f1c8d6be7 100644 --- a/gcloud/alpha/bigtable/backups/remove-iam-policy-binding +++ b/gcloud/alpha/bigtable/backups/remove-iam-policy-binding @@ -59,14 +59,13 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --cluster=CLUSTER - The name of the Cloud Bigtable cluster. To set the cluster attribute: + Name of the Cloud Bigtable cluster. To set the cluster attribute: ▸ provide the argument backup on the command line with a fully specified name; ▸ provide the argument --cluster on the command line. --instance=INSTANCE - The name of the Cloud Bigtable instance. To set the instance - attribute: + Name of the Cloud Bigtable instance. To set the instance attribute: ▸ provide the argument backup on the command line with a fully specified name; ▸ provide the argument --instance on the command line. diff --git a/gcloud/alpha/bigtable/backups/set-iam-policy b/gcloud/alpha/bigtable/backups/set-iam-policy index 6fc7af3bc..1ba743b38 100644 --- a/gcloud/alpha/bigtable/backups/set-iam-policy +++ b/gcloud/alpha/bigtable/backups/set-iam-policy @@ -41,14 +41,13 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --cluster=CLUSTER - The name of the Cloud Bigtable cluster. To set the cluster attribute: + Name of the Cloud Bigtable cluster. To set the cluster attribute: ▸ provide the argument backup on the command line with a fully specified name; ▸ provide the argument --cluster on the command line. --instance=INSTANCE - The name of the Cloud Bigtable instance. To set the instance - attribute: + Name of the Cloud Bigtable instance. To set the instance attribute: ▸ provide the argument backup on the command line with a fully specified name; ▸ provide the argument --instance on the command line. diff --git a/gcloud/alpha/bigtable/backups/update b/gcloud/alpha/bigtable/backups/update index 494a5918b..e09cd9cb4 100644 --- a/gcloud/alpha/bigtable/backups/update +++ b/gcloud/alpha/bigtable/backups/update @@ -40,14 +40,13 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --cluster=CLUSTER - The name of the Cloud Bigtable cluster. To set the cluster attribute: + Name of the Cloud Bigtable cluster. To set the cluster attribute: ▸ provide the argument backup on the command line with a fully specified name; ▸ provide the argument --cluster on the command line. --instance=INSTANCE - The name of the Cloud Bigtable instance. To set the instance - attribute: + Name of the Cloud Bigtable instance. To set the instance attribute: ▸ provide the argument backup on the command line with a fully specified name; ▸ provide the argument --instance on the command line. diff --git a/gcloud/alpha/bigtable/instances/tables/add-iam-policy-binding b/gcloud/alpha/bigtable/instances/tables/add-iam-policy-binding index f5ba59191..e2efb8655 100644 --- a/gcloud/alpha/bigtable/instances/tables/add-iam-policy-binding +++ b/gcloud/alpha/bigtable/instances/tables/add-iam-policy-binding @@ -56,8 +56,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - The name of the Cloud Bigtable instance. To set the instance - attribute: + Name of the Cloud Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully specified name; ▸ provide the argument --instance on the command line. diff --git a/gcloud/alpha/bigtable/instances/tables/config/export b/gcloud/alpha/bigtable/instances/tables/config/export index 04de4c33f..a1e55ed4a 100644 --- a/gcloud/alpha/bigtable/instances/tables/config/export +++ b/gcloud/alpha/bigtable/instances/tables/config/export @@ -60,8 +60,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - The name of the Cloud Bigtable instance. To set the instance - attribute: + Name of the Cloud Bigtable instance. To set the instance attribute: ▫ provide the argument table on the command line with a fully specified name; ▫ provide the argument --instance on the command line. diff --git a/gcloud/alpha/bigtable/instances/tables/create b/gcloud/alpha/bigtable/instances/tables/create new file mode 100644 index 000000000..e8d2f0328 --- /dev/null +++ b/gcloud/alpha/bigtable/instances/tables/create @@ -0,0 +1,109 @@ +NAME + gcloud alpha bigtable instances tables create - create a new Cloud Bigtable + table + +SYNOPSIS + gcloud alpha bigtable instances tables create (TABLE : --instance=INSTANCE) + --column-families=[COLUMN_FAMILIES,...] + [--change-stream-retention-period=CHANGE_STREAM_RETENTION_PERIOD] + [--splits=[SPLITS,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create a new Cloud Bigtable table. + +EXAMPLES + To create a table my-table in instance my-instance with a column family + my-family, run: + + $ gcloud alpha bigtable instances tables create my-table \ + --instance=my-instance --column-families="my-family" + + To create a table that has a column family named my-instance, a garbage + collection policy that lets data expire after 864,000 seconds, and initial + table splits on row keys car and key, run: + + $ gcloud alpha bigtable instances tables create my-table \ + --instance=my-instance \ + --column-families="my-family:maxage=864000s" --splits=car,key + + To create a table my-table in instance my-instance that lets data in column + family my-family1 expire after 10 days and keeps a maximum of 5 cells per + column in column family my-family-2 if the data is less than 5 days old, + run: + + $ gcloud alpha bigtable instances tables create my-table \ + --instance=my-instance \ + --column-families="my-family-1:maxage=10d,my-family-2:maxversion\ + s=5||maxage=5d" + + To create a table my-table that has one column family my-family that lets + data expire after 10 days, and to enable a change stream for the table to + be kept for 7 days, run: + + $ gcloud alpha bigtable instances tables create my-table \ + --instance=my-instance \ + --column-families="my-family:maxage=10d" \ + --change-stream-retention-period=7d + +POSITIONAL ARGUMENTS + Table resource - Cloud Bigtable table to create. The arguments in this + group can be used to specify the attributes of this resource. (NOTE) Some + attributes are not given arguments in this group but can be set in other + ways. To set the project attribute: + ◆ provide the argument table 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. + + TABLE + ID of the table or fully qualified identifier for the table. To set + the table attribute: + ▸ provide the argument table on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --instance=INSTANCE + Name of the Cloud Bigtable instance. To set the instance attribute: + ▸ provide the argument table on the command line with a fully + specified name; + ▸ provide the argument --instance on the command line. + +REQUIRED FLAGS + --column-families=[COLUMN_FAMILIES,...] + A double-quote (") wrapped list of family name and corresponding + garbage collection rules concatenated by :, where the rules are + optional. For example: \ + "family_1,family_2:maxage=5d&&maxversions=2,family_3:maxage=10d||maxversions=5" + +OPTIONAL FLAGS + --change-stream-retention-period=CHANGE_STREAM_RETENTION_PERIOD + Once a value is passed in, the Bigtable table is created with a change + stream enabled; the value indicates how long the replication logs are + kept and should be in the range of [1 day, 7 days]. For example: 5d or + 48h + + --splits=[SPLITS,...] + Row keys where the table should initially be split. For example: + car,key + +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 bigtableadmin/v2 API. The full documentation for this + API can be found at: https://cloud.google.com/bigtable/ + +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/bigtable/instances/tables/describe b/gcloud/alpha/bigtable/instances/tables/describe index aea570b01..6f495eb70 100644 --- a/gcloud/alpha/bigtable/instances/tables/describe +++ b/gcloud/alpha/bigtable/instances/tables/describe @@ -37,8 +37,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - The name of the Cloud Bigtable instance. To set the instance - attribute: + Name of the Cloud Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully specified name; ▸ provide the argument --instance on the command line. diff --git a/gcloud/alpha/bigtable/instances/tables/get-iam-policy b/gcloud/alpha/bigtable/instances/tables/get-iam-policy index b5bcdff62..43c8b2ea6 100644 --- a/gcloud/alpha/bigtable/instances/tables/get-iam-policy +++ b/gcloud/alpha/bigtable/instances/tables/get-iam-policy @@ -41,8 +41,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - The name of the Cloud Bigtable instance. To set the instance - attribute: + Name of the Cloud Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully specified name; ▸ provide the argument --instance on the command line. diff --git a/gcloud/alpha/bigtable/instances/tables/help b/gcloud/alpha/bigtable/instances/tables/help index faf59acd9..d536582bd 100644 --- a/gcloud/alpha/bigtable/instances/tables/help +++ b/gcloud/alpha/bigtable/instances/tables/help @@ -25,6 +25,9 @@ COMMANDS add-iam-policy-binding (ALPHA) Add an IAM policy binding to a Cloud Bigtable table. + create + (ALPHA) Create a new Cloud Bigtable table. + describe (ALPHA) Retrieve information about a table. diff --git a/gcloud/alpha/bigtable/instances/tables/remove-iam-policy-binding b/gcloud/alpha/bigtable/instances/tables/remove-iam-policy-binding index b988ea018..13f292856 100644 --- a/gcloud/alpha/bigtable/instances/tables/remove-iam-policy-binding +++ b/gcloud/alpha/bigtable/instances/tables/remove-iam-policy-binding @@ -56,8 +56,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - The name of the Cloud Bigtable instance. To set the instance - attribute: + Name of the Cloud Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully specified name; ▸ provide the argument --instance on the command line. diff --git a/gcloud/alpha/bigtable/instances/tables/restore b/gcloud/alpha/bigtable/instances/tables/restore index 561ea5290..8498617fd 100644 --- a/gcloud/alpha/bigtable/instances/tables/restore +++ b/gcloud/alpha/bigtable/instances/tables/restore @@ -51,8 +51,7 @@ REQUIRED FLAGS this group are specified. --destination-instance=DESTINATION_INSTANCE - The name of the Cloud Bigtable instance. To set the instance - attribute: + Name of the Cloud Bigtable instance. To set the instance attribute: ▸ provide the argument --destination on the command line with a fully specified name; ▸ provide the argument --destination-instance on the command line; @@ -78,14 +77,13 @@ REQUIRED FLAGS this group are specified. --source-cluster=SOURCE_CLUSTER - The name of the Cloud Bigtable cluster. To set the cluster attribute: + Name of the Cloud Bigtable cluster. To set the cluster attribute: ▸ provide the argument --source on the command line with a fully specified name; ▸ provide the argument --source-cluster on the command line. --source-instance=SOURCE_INSTANCE - The name of the Cloud Bigtable instance. To set the instance - attribute: + Name of the Cloud Bigtable instance. To set the instance attribute: ▸ provide the argument --source on the command line with a fully specified name; ▸ provide the argument --source-instance on the command line; diff --git a/gcloud/alpha/bigtable/instances/tables/set-iam-policy b/gcloud/alpha/bigtable/instances/tables/set-iam-policy index e6eebd769..d62758842 100644 --- a/gcloud/alpha/bigtable/instances/tables/set-iam-policy +++ b/gcloud/alpha/bigtable/instances/tables/set-iam-policy @@ -40,8 +40,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - The name of the Cloud Bigtable instance. To set the instance - attribute: + Name of the Cloud Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully specified name; ▸ provide the argument --instance on the command line. diff --git a/gcloud/alpha/bigtable/instances/tables/undelete b/gcloud/alpha/bigtable/instances/tables/undelete index 01064fb18..f6cdbc4e3 100644 --- a/gcloud/alpha/bigtable/instances/tables/undelete +++ b/gcloud/alpha/bigtable/instances/tables/undelete @@ -10,7 +10,7 @@ DESCRIPTION (ALPHA) Undelete a previously deleted Cloud Bigtable table. EXAMPLES - To undelete the table 'my-table' in instance 'my-instance', run: + To undelete the table my-table in instance my-instance, run: $ gcloud alpha bigtable instances tables undelete my-table \ --instance=my-instance @@ -36,8 +36,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - The name of the Cloud Bigtable instance. To set the instance - attribute: + Name of the Cloud Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully specified name; ▸ provide the argument --instance on the command line. diff --git a/gcloud/alpha/compute/disks/help b/gcloud/alpha/compute/disks/help index 82928ebb3..522f41455 100644 --- a/gcloud/alpha/compute/disks/help +++ b/gcloud/alpha/compute/disks/help @@ -79,6 +79,9 @@ COMMANDS stop-async-replication (ALPHA) Stop async replication on a Compute Engine persistent disk. + stop-group-async-replication + (ALPHA) Consistently stops a group of asynchronously replicating disks. + update (ALPHA) Update a Compute Engine persistent disk. diff --git a/gcloud/alpha/compute/disks/stop-group-async-replication b/gcloud/alpha/compute/disks/stop-group-async-replication new file mode 100644 index 000000000..7cd38bfb8 --- /dev/null +++ b/gcloud/alpha/compute/disks/stop-group-async-replication @@ -0,0 +1,96 @@ +NAME + gcloud alpha compute disks stop-group-async-replication - consistently + stops a group of asynchronously replicating disks + +SYNOPSIS + gcloud alpha compute disks stop-group-async-replication + DISK_CONSISTENCY_GROUP_POLICY [--region=REGION | --zone=ZONE] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) gcloud alpha compute disks stop-group-async-replication + consistently stops a group of asynchronously replicating disks. This + command can be invoked in either in the primary or secondary scope of the + replicating disks. + +EXAMPLES + To stop group replication in the primary scope, include the zone or region + of the primary disks. The URL of the disk consistency group resource policy + always uses the region of the primary disks: + + $ gcloud alpha compute disks stop-group-async-replication \ + projects/my-project/regions/us-west1/resourcePolicies/\ + my-policy --zone=us-west1-a + + Alternatively, you can stop replication in the secondary scope. Include the + region or zone of the secondary disks. The URL of the disk consistency + group resource policy always uses the region of the primary disks: + + $ gcloud alpha compute disks stop-group-async-replication \ + projects/my-project/regions/us-west1/resourcePolicies/\ + my-policy --zone=us-west2-a + +POSITIONAL ARGUMENTS + DISK_CONSISTENCY_GROUP_POLICY + URL of the disk consistency group resource policy. The resourcepolicy + is always in the region of the primary disks. + +FLAGS + At most one of these can be specified: + + --region=REGION + Region of the consistency group's primary or secondary disks. If not + specified, you might be prompted to select a region (interactive mode + only). + + To avoid prompting when this flag is omitted, you can set the + compute/region property: + + $ gcloud config set compute/region REGION + + A list of regions can be fetched by running: + + $ gcloud compute regions list + + To unset the property, run: + + $ gcloud config unset compute/region + + Alternatively, the region can be stored in the environment variable + CLOUDSDK_COMPUTE_REGION. + + --zone=ZONE + Zone of the consistency group's primary or secondary disks. If not + specified and the compute/zone property isn't set, you might be + prompted to select a zone (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/zone property: + + $ gcloud config set compute/zone ZONE + + A list of zones can be fetched by running: + + $ gcloud compute zones list + + To unset the property, run: + + $ gcloud config unset compute/zone + + Alternatively, the zone can be stored in the environment variable + CLOUDSDK_COMPUTE_ZONE. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in 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/firewall-rules/migrate b/gcloud/alpha/compute/firewall-rules/migrate index 999959305..fb9c1c560 100644 --- a/gcloud/alpha/compute/firewall-rules/migrate +++ b/gcloud/alpha/compute/firewall-rules/migrate @@ -53,5 +53,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta compute firewall-rules migrate diff --git a/gcloud/alpha/compute/instances/create b/gcloud/alpha/compute/instances/create index 6c0562bdf..215d48608 100644 --- a/gcloud/alpha/compute/instances/create +++ b/gcloud/alpha/compute/instances/create @@ -19,6 +19,8 @@ SYNOPSIS [--host-error-timeout-seconds=HOST_ERROR_TIMEOUT_SECONDS] [--hostname=HOSTNAME] [--instance-termination-action=INSTANCE_TERMINATION_ACTION] + [--internal-ipv6-address=INTERNAL_IPV6_ADDRESS] + [--internal-ipv6-prefix-length=INTERNAL_IPV6_PREFIX_LENGTH] [--ipv6-address=IPV6_ADDRESS] [--ipv6-network-tier=IPV6_NETWORK_TIER] [--ipv6-prefix-length=IPV6_PREFIX_LENGTH] [--ipv6-public-ptr-domain=IPV6_PUBLIC_PTR_DOMAIN] @@ -481,6 +483,19 @@ FLAGS Default. Stop the VM without preserving memory. The VM can be restarted later. + --internal-ipv6-address=INTERNAL_IPV6_ADDRESS + Assigns the given internal IPv6 address or range to the instance that + is created. The address must be the first IP in the range or a IP range + with /96. This option can only be used when creating a single instance. + + --internal-ipv6-prefix-length=INTERNAL_IPV6_PREFIX_LENGTH + Optional field that indicates the prefix length of the internal IPv6 + address range, should be used together with + --internal-ipv6-address=fd20::. Currently only /96 is supported and the + default value is 96. If not set, the prefix length from + --internal-ipv6-address=fd20::/96 will be used or assigned a default + value of 96. + --ipv6-address=IPV6_ADDRESS Assigns the given external IPv6 address to the instance that is created. The address must be the first IP in the range. This option can diff --git a/gcloud/alpha/compute/instances/network-interfaces/update b/gcloud/alpha/compute/instances/network-interfaces/update index da68c3c99..969c2e0f9 100644 --- a/gcloud/alpha/compute/instances/network-interfaces/update +++ b/gcloud/alpha/compute/instances/network-interfaces/update @@ -4,8 +4,9 @@ NAME SYNOPSIS gcloud alpha compute instances network-interfaces update INSTANCE_NAME - [--aliases=ALIASES] [--ipv6-address=IPV6_ADDRESS] - [--ipv6-network-tier=IPV6_NETWORK_TIER] + [--aliases=ALIASES] [--internal-ipv6-address=INTERNAL_IPV6_ADDRESS] + [--internal-ipv6-prefix-length=INTERNAL_IPV6_PREFIX_LENGTH] + [--ipv6-address=IPV6_ADDRESS] [--ipv6-network-tier=IPV6_NETWORK_TIER] [--ipv6-prefix-length=IPV6_PREFIX_LENGTH] [--network=NETWORK] [--network-interface=NETWORK_INTERFACE; default="nic0"] [--private-network-ip=PRIVATE_NETWORK_IP] [--stack-type=STACK_TYPE] @@ -43,6 +44,19 @@ FLAGS --aliases="10.128.1.0/24;r1:/32" + --internal-ipv6-address=INTERNAL_IPV6_ADDRESS + Assigns the given internal IPv6 address or range to an instance. The + address must be the first IP in the range or a IP range with /96. This + option can only be used on a dual stack instance network interface. + + --internal-ipv6-prefix-length=INTERNAL_IPV6_PREFIX_LENGTH + Optional field that indicates the prefix length of the internal IPv6 + address range, should be used together with + --internal-ipv6-address=fd20::. Currently only /96 is supported and the + default value is 96. If not set, the prefix length from + --internal-ipv6-address=fd20::/96 will be used or assigned a default + value of 96. + --ipv6-address=IPV6_ADDRESS Assigns the given external IPv6 address to an instance. The address must be the first IP in the range. This option can only be used on a diff --git a/gcloud/alpha/compute/security-policies/update b/gcloud/alpha/compute/security-policies/update index d4d3577d4..95da93598 100644 --- a/gcloud/alpha/compute/security-policies/update +++ b/gcloud/alpha/compute/security-policies/update @@ -6,6 +6,7 @@ SYNOPSIS gcloud alpha compute security-policies update NAME [--ddos-protection=DDOS_PROTECTION] [--description=DESCRIPTION] [--enable-layer7-ddos-defense] [--enable-ml] + [--json-custom-content-types=[CONTENT_TYPE,...]] [--json-parsing=JSON_PARSING] [--layer7-ddos-defense-auto-deploy-confidence-threshold=LAYER7_DDOS_DEFENSE_AUTO_DEPLOY_CONFIDENCE_THRESHOLD] [--layer7-ddos-defense-auto-deploy-expiration-sec=LAYER7_DDOS_DEFENSE_AUTO_DEPLOY_EXPIRATION_SEC] @@ -45,6 +46,13 @@ FLAGS --enable-ml Whether to enable Cloud Armor Adaptive Protection + --json-custom-content-types=[CONTENT_TYPE,...] + A comma-separated list of custom Content-Type header values to apply + JSON parsing for preconfigured WAF rules. Only applicable when JSON + parsing is enabled, like --json-parsing=STANDARD. When configuring a + Content-Type header value, only the type/subtype needs to be specified, + and the parameters should be excluded. + --json-parsing=JSON_PARSING The JSON parsing behavior for this rule. Must be one of the following values: [DISABLED, STANDARD]. JSON_PARSING must be one of: DISABLED, diff --git a/gcloud/alpha/compute/tpus/tpu-vm/create b/gcloud/alpha/compute/tpus/tpu-vm/create index a03e44ae1..6258081d5 100644 --- a/gcloud/alpha/compute/tpus/tpu-vm/create +++ b/gcloud/alpha/compute/tpus/tpu-vm/create @@ -3,14 +3,16 @@ NAME SYNOPSIS gcloud alpha compute tpus tpu-vm create (TPU : --zone=ZONE) - --version=VERSION [--accelerator-type=ACCELERATOR_TYPE; default="v2-8"] - [--async] [--data-disk=DATA_DISK] [--description=DESCRIPTION] - [--internal-ips] [--labels=[LABELS,...]] [--metadata=[METADATA,...]] + --version=VERSION [--async] [--data-disk=DATA_DISK] + [--description=DESCRIPTION] [--internal-ips] [--labels=[LABELS,...]] + [--metadata=[METADATA,...]] [--metadata-from-file=[METADATA_FROM_FILE,...]] [--network=NETWORK; default="default"] [--preemptible] [--range=RANGE] [--reserved] [--scopes=[SCOPES,...]] [--service-account=SERVICE_ACCOUNT] [--shielded-secure-boot] - [--subnetwork=SUBNETWORK] [--tags=[TAGS,...]] [GCLOUD_WIDE_FLAG ...] + [--subnetwork=SUBNETWORK] [--tags=[TAGS,...]] + [--accelerator-type=ACCELERATOR_TYPE; default="v2-8" + | --topology=TOPOLOGY --type=TYPE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Create a new Cloud TPU VM node. @@ -73,14 +75,6 @@ REQUIRED FLAGS gcloud alpha compute tpus tpu-vm versions list OPTIONAL FLAGS - --accelerator-type=ACCELERATOR_TYPE; default="v2-8" - TPU accelerator type for the TPU. If not specified, this defaults to - v2-8. - - For a list of available accelerator types run: - - gcloud alpha compute tpus tpu-vm accelerator-types list - --async Return immediately, without waiting for the operation in progress to complete. @@ -176,6 +170,34 @@ OPTIONAL FLAGS https://cloud.google.com/vpc/docs/add-remove-network-tags for more details. + Specify a TPU node in either chips or cores + + At most one of these can be specified: + + Core based TPU configuration + + --accelerator-type=ACCELERATOR_TYPE; default="v2-8" + TPU accelerator type for the TPU. If not specified, this defaults + to v2-8. + + For a list of available accelerator types run: + + gcloud alpha compute tpus tpu-vm accelerator-types list + + Chip based TPU configuration + + --topology=TOPOLOGY + Chip topology for TPU. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --type=TYPE + Type of TPU. TYPE must be one of: type-unspecified, v2, v3, v4. + + This flag argument must be specified if any of the other arguments + in this group are specified. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/config/help b/gcloud/alpha/config/help index 227a65ff2..c7584f71f 100644 --- a/gcloud/alpha/config/help +++ b/gcloud/alpha/config/help @@ -350,6 +350,10 @@ AVAILABLE PROPERTIES ids Overrides API endpoint for gcloud ids command group. + krmapihosting + Overrides API endpoint for gcloud anthos config controller command + group. + language Overrides API endpoint for gcloud ml language command group. diff --git a/gcloud/alpha/config/list b/gcloud/alpha/config/list index 9d4535660..7d63e9ddb 100644 --- a/gcloud/alpha/config/list +++ b/gcloud/alpha/config/list @@ -359,6 +359,10 @@ AVAILABLE PROPERTIES ids Overrides API endpoint for gcloud ids command group. + krmapihosting + Overrides API endpoint for gcloud anthos config controller command + group. + language Overrides API endpoint for gcloud ml language command group. diff --git a/gcloud/alpha/config/set b/gcloud/alpha/config/set index 628f494c1..b7d8fc5cf 100644 --- a/gcloud/alpha/config/set +++ b/gcloud/alpha/config/set @@ -368,6 +368,10 @@ AVAILABLE PROPERTIES ids Overrides API endpoint for gcloud ids command group. + krmapihosting + Overrides API endpoint for gcloud anthos config controller command + group. + language Overrides API endpoint for gcloud ml language command group. diff --git a/gcloud/alpha/config/unset b/gcloud/alpha/config/unset index 4a228ad51..93bdaa2e3 100644 --- a/gcloud/alpha/config/unset +++ b/gcloud/alpha/config/unset @@ -329,6 +329,10 @@ AVAILABLE PROPERTIES ids Overrides API endpoint for gcloud ids command group. + krmapihosting + Overrides API endpoint for gcloud anthos config controller command + group. + language Overrides API endpoint for gcloud ml language command group. diff --git a/gcloud/alpha/container/aws/clusters/update b/gcloud/alpha/container/aws/clusters/update index a9643f5cc..4fcef8c66 100644 --- a/gcloud/alpha/container/aws/clusters/update +++ b/gcloud/alpha/container/aws/clusters/update @@ -14,6 +14,8 @@ SYNOPSIS [--root-volume-kms-key-arn=ROOT_VOLUME_KMS_KEY_ARN] [--root-volume-size=ROOT_VOLUME_SIZE] [--root-volume-type=ROOT_VOLUME_TYPE] [--validate-only] + [--annotations=ANNOTATION,[ANNOTATION,...] | --clear-annotations] + [--clear-description | --description=DESCRIPTION] [--clear-proxy-config | --proxy-secret-arn=PROXY_SECRET_ARN --proxy-secret-version-id=PROXY_SECRET_VERSION_ID] [--clear-security-group-ids @@ -114,6 +116,26 @@ FLAGS --validate-only Validate the update of the cluster, but don't actually perform it. + Annotations + + At most one of these can be specified: + + --annotations=ANNOTATION,[ANNOTATION,...] + Annotations for the cluster. + + --clear-annotations + Clear the annotations for the cluster. + + Description + + At most one of these can be specified: + + --clear-description + Clear the description for the cluster. + + --description=DESCRIPTION + Description for the cluster. + Proxy config At most one of these can be specified: diff --git a/gcloud/alpha/container/azure/clusters/create b/gcloud/alpha/container/azure/clusters/create index b922e7a42..e71fa357a 100644 --- a/gcloud/alpha/container/azure/clusters/create +++ b/gcloud/alpha/container/azure/clusters/create @@ -11,11 +11,12 @@ SYNOPSIS --resource-group-id=RESOURCE_GROUP_ID --service-address-cidr-blocks=SERVICE_ADDRESS_CIDR_BLOCKS --ssh-public-key=SSH_PUBLIC_KEY --vnet-id=VNET_ID - [--admin-users=USER,[USER,...]] [--async] + [--admin-users=USER,[USER,...]] + [--annotations=ANNOTATION,[ANNOTATION,...]] [--async] [--config-encryption-key-id=CONFIG_ENCRYPTION_KEY_ID] [--config-encryption-public-key=CONFIG_ENCRYPTION_PUBLIC_KEY] [--database-encryption-key-id=DATABASE_ENCRYPTION_KEY_ID] - [--endpoint-subnet-id=ENDPOINT_SUBNET_ID] + [--description=DESCRIPTION] [--endpoint-subnet-id=ENDPOINT_SUBNET_ID] [--logging=COMPONENT,[COMPONENT,...]] [--main-volume-size=MAIN_VOLUME_SIZE] [--replica-placements=[REPLICA_PLACEMENT,...]] @@ -120,6 +121,9 @@ OPTIONAL FLAGS Users that can perform operations as a cluster administrator. If not specified, the value of property core/account is used. + --annotations=ANNOTATION,[ANNOTATION,...] + Annotations for the cluster. + --async Return immediately, without waiting for the operation in progress to complete. @@ -136,6 +140,9 @@ OPTIONAL FLAGS URL the of the Azure Key Vault key (with its version) to use to encrypt / decrypt cluster secrets. + --description=DESCRIPTION + Description for the cluster. + --endpoint-subnet-id=ENDPOINT_SUBNET_ID ARM ID of the subnet where the control plane load balancer is deployed. When unspecified, it defaults to the control plane subnet ID. diff --git a/gcloud/alpha/container/azure/clusters/update b/gcloud/alpha/container/azure/clusters/update index 8fa3c01f2..eca1876be 100644 --- a/gcloud/alpha/container/azure/clusters/update +++ b/gcloud/alpha/container/azure/clusters/update @@ -8,7 +8,10 @@ SYNOPSIS [--admin-users=USER,[USER,...]] [--async] [--cluster-version=CLUSTER_VERSION] [--logging=COMPONENT,[COMPONENT,...]] [--ssh-public-key=SSH_PUBLIC_KEY] - [--validate-only] [--vm-size=VM_SIZE] [GCLOUD_WIDE_FLAG ...] + [--validate-only] [--vm-size=VM_SIZE] + [--annotations=ANNOTATION,[ANNOTATION,...] | --clear-annotations] + [--clear-description | --description=DESCRIPTION] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Update an Anthos cluster on Azure. @@ -95,6 +98,26 @@ FLAGS --vm-size=VM_SIZE Azure Virtual Machine Size (e.g. Standard_DS1_v). + Annotations + + At most one of these can be specified: + + --annotations=ANNOTATION,[ANNOTATION,...] + Annotations for the cluster. + + --clear-annotations + Clear the annotations for the cluster. + + Description + + At most one of these can be specified: + + --clear-description + Clear the description for the cluster. + + --description=DESCRIPTION + Description for the cluster. + 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/dataproc/clusters/create b/gcloud/alpha/dataproc/clusters/create index be9724ed3..5a31ebd08 100644 --- a/gcloud/alpha/dataproc/clusters/create +++ b/gcloud/alpha/dataproc/clusters/create @@ -690,7 +690,7 @@ FLAGS --secondary-worker-type=TYPE; default="preemptible" The type of the secondary worker group. TYPE must be one of: - preemptible, non-preemptible. + preemptible, non-preemptible, spot. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/dataproc/workflow-templates/set-managed-cluster b/gcloud/alpha/dataproc/workflow-templates/set-managed-cluster index 828ba6b3f..c4926040b 100644 --- a/gcloud/alpha/dataproc/workflow-templates/set-managed-cluster +++ b/gcloud/alpha/dataproc/workflow-templates/set-managed-cluster @@ -632,7 +632,7 @@ FLAGS --secondary-worker-type=TYPE; default="preemptible" The type of the secondary worker group. TYPE must be one of: - preemptible, non-preemptible. + preemptible, non-preemptible, spot. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/edge-cloud/container/vpn-connections/create b/gcloud/alpha/edge-cloud/container/vpn-connections/create index 46421b27e..88313344a 100644 --- a/gcloud/alpha/edge-cloud/container/vpn-connections/create +++ b/gcloud/alpha/edge-cloud/container/vpn-connections/create @@ -7,6 +7,7 @@ SYNOPSIS (VPN_CONNECTION : --location=LOCATION) --cluster=CLUSTER --vpc-network=VPC_NETWORK [--async] [--high-availability] [--labels=[KEY=VALUE,...]] [--nat-gateway-ip=NAT_GATEWAY_IP] + [--vpc-project=VPC_PROJECT] [--vpc-service-account=VPC_SERVICE_ACCOUNT] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -55,7 +56,9 @@ REQUIRED FLAGS The name of the cluster to be connected under current project. --vpc-network=VPC_NETWORK - The name of the {vpc_name_short} to be connected under current project. + The name of the VPC network to be connected. By default it is assumed + to be under the same project as cluster. If this VPC network is under a + different project, vpc-project and vpc-service-account are required. OPTIONAL FLAGS --async @@ -76,8 +79,17 @@ OPTIONAL FLAGS numbers. --nat-gateway-ip=NAT_GATEWAY_IP - The NAT gateway IP for the gateway floating IPs. Do not specify this if - no NAT is used. + The NAT gateway IP for the gateway floating IPs. Required if cluster + sits behind NAT. + + --vpc-project=VPC_PROJECT + The project of the VPC network. Required if the project of VPC network + differs from the project of the cluster. + + --vpc-service-account=VPC_SERVICE_ACCOUNT + The service account in the VPC project used to create Cloud Router and + Cloud HA VPNs when creating/deleting the VPN connection. Required if + the project of VPC network differs from the project of the cluster. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/functions/deploy b/gcloud/alpha/functions/deploy index da158e5be..28ff30886 100644 --- a/gcloud/alpha/functions/deploy +++ b/gcloud/alpha/functions/deploy @@ -171,29 +171,7 @@ FLAGS Required when deploying a new function; optional when updating an existing function. - Choices: - - ◆ nodejs10: Node.js 10 - ◆ nodejs12: Node.js 12 - ◆ nodejs14: Node.js 14 - ◆ nodejs16: Node.js 16 - ◆ php74: PHP 7.4 - ◆ php81: PHP 8.1 - ◆ python37: Python 3.7 - ◆ python38: Python 3.8 - ◆ python39: Python 3.9 - ◆ python310: Python 3.10 - ◆ go111: Go 1.11 - ◆ go113: Go 1.13 - ◆ go116: Go 1.16 - ◆ java11: Java 11 - ◆ java17: Java 17 - ◆ dotnet3: .NET Framework 3 - ◆ ruby26: Ruby 2.6 - ◆ ruby27: Ruby 2.7 - ◆ ruby30: Ruby 3.0 - ◆ nodejs6: Node.js 6 (deprecated) - ◆ nodejs8: Node.js 8 (deprecated) + For a list of available runtimes, run gcloud functions runtimes list. --security-level=SECURITY_LEVEL; default="secure-always" Security level controls whether a function's URL supports HTTPS only or diff --git a/gcloud/alpha/logging/buckets/create b/gcloud/alpha/logging/buckets/create index f1a67e211..f97eafbe7 100644 --- a/gcloud/alpha/logging/buckets/create +++ b/gcloud/alpha/logging/buckets/create @@ -33,6 +33,11 @@ EXAMPLES $ gcloud alpha logging buckets create my-bucket \ --index=fieldPath=jsonPayload.foo,type=INDEX_TYPE_STRING + To create a bucket with custom CMEK, run: + + $ gcloud alpha logging buckets create my-bucket \ + --location=us-central1 --cmek-kms-key-name=CMEK_KMS_KEY_NAME + POSITIONAL ARGUMENTS BUCKET_ID ID of the bucket to create. diff --git a/gcloud/alpha/logging/buckets/update b/gcloud/alpha/logging/buckets/update index 16e154db9..d58b2bced 100644 --- a/gcloud/alpha/logging/buckets/update +++ b/gcloud/alpha/logging/buckets/update @@ -39,6 +39,11 @@ EXAMPLES $ gcloud alpha logging buckets update my-bucket --location=global \ --update-index=fieldPath=jsonPayload.foo,type=INDEX_TYPE_INTEGER + To update a bucket in your project and update existing cmek, run: + + $ gcloud alpha logging buckets update my-bucket --location=global \ + --cmek-kms-key-name=CMEK_KEY_NAME + POSITIONAL ARGUMENTS BUCKET_ID The id of the bucket to update. diff --git a/gcloud/alpha/logging/copy b/gcloud/alpha/logging/copy index e99011889..1c9d685c5 100644 --- a/gcloud/alpha/logging/copy +++ b/gcloud/alpha/logging/copy @@ -9,8 +9,8 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) gcloud alpha logging copy copy log entries. Start a copy log - entries operation. + (ALPHA) gcloud alpha logging copy starts the process to copy log entries + from a log bucket to a destination. EXAMPLES To start a copy log entries operation, run: @@ -78,5 +78,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. These variants are also available: + + $ gcloud logging copy + + $ gcloud beta logging copy diff --git a/gcloud/alpha/logging/metrics/create b/gcloud/alpha/logging/metrics/create index 81124328c..fe492c034 100644 --- a/gcloud/alpha/logging/metrics/create +++ b/gcloud/alpha/logging/metrics/create @@ -33,6 +33,12 @@ EXAMPLES how to configure metrics can be found at: https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.metrics#LogMetric. + To create a bucket log-based metric, run: + + $ gcloud alpha logging metrics create my_bucket_metric \ + --description="DESCRIPTION" --log-filter="LOG_FILTER" \ + --bucket-name="BUCKET_NAME" + POSITIONAL ARGUMENTS METRIC_NAME The name of the new metric. diff --git a/gcloud/alpha/logging/metrics/update b/gcloud/alpha/logging/metrics/update index d8d45f5e9..da0124d91 100644 --- a/gcloud/alpha/logging/metrics/update +++ b/gcloud/alpha/logging/metrics/update @@ -38,6 +38,11 @@ EXAMPLES Any top-level fields in the LogMetric definition that aren't specified in the config file will not be updated in the metric. + To update the bucket associated with a bucket log-based metric, run: + + $ gcloud alpha logging metrics update my-bucket-metric \ + --bucket-name="NEW_BUCKET_NAME" + POSITIONAL ARGUMENTS METRIC_NAME The name of the log-based metric to update. diff --git a/gcloud/alpha/logging/operations/cancel b/gcloud/alpha/logging/operations/cancel index 4be2d46fe..8de4540c0 100644 --- a/gcloud/alpha/logging/operations/cancel +++ b/gcloud/alpha/logging/operations/cancel @@ -64,5 +64,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. These variants are also available: + + $ gcloud logging operations cancel + + $ gcloud beta logging operations cancel diff --git a/gcloud/alpha/logging/operations/describe b/gcloud/alpha/logging/operations/describe index f9802e55a..8f65e10da 100644 --- a/gcloud/alpha/logging/operations/describe +++ b/gcloud/alpha/logging/operations/describe @@ -66,5 +66,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. These variants are also available: + + $ gcloud logging operations describe + + $ gcloud beta logging operations describe diff --git a/gcloud/alpha/logging/operations/help b/gcloud/alpha/logging/operations/help index fecb6ec86..d99866cb6 100644 --- a/gcloud/alpha/logging/operations/help +++ b/gcloud/alpha/logging/operations/help @@ -28,5 +28,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 logging operations + + $ gcloud beta logging operations diff --git a/gcloud/alpha/logging/operations/list b/gcloud/alpha/logging/operations/list index 42c7e0fcc..f58ce0160 100644 --- a/gcloud/alpha/logging/operations/list +++ b/gcloud/alpha/logging/operations/list @@ -115,5 +115,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 logging operations list + + $ gcloud beta logging operations list diff --git a/gcloud/alpha/logging/settings/describe b/gcloud/alpha/logging/settings/describe index 3c4bacca0..6da9485b1 100644 --- a/gcloud/alpha/logging/settings/describe +++ b/gcloud/alpha/logging/settings/describe @@ -13,6 +13,22 @@ DESCRIPTION your project, folder, organization or billing-account. You can also find the Logs Router service account using this command. +EXAMPLES + To describe the Logs Router settings for a project, run: + + $ gcloud alpha logging settings describe --project=[PROJECT_ID] + + To describe the Logs Router settings for an organization, run: + + $ gcloud alpha logging settings describe \ + --organization=[ORGANIZATION_ID] + + kmsKeyName: + 'projects/my-project/locations/my-location/keyRings/my-keyring/cryptoKeys/key' + name: 'organizations/[ORGANIZATION_ID]/settings' + serviceAccountId: + '[SERVICE_ACCOUNT_ID]@gcp-sa-logging.iam.gserviceaccount.com' + FLAGS At most one of these can be specified: @@ -47,25 +63,13 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. -EXAMPLE - To describe the Logs Router settings for a project, run: - - $ gcloud alpha logging settings describe --project=[PROJECT_ID] - - To describe the Logs Router settings for an organization, run: - - $ gcloud alpha logging settings describe \ - --organization=[ORGANIZATION_ID] - - kmsKeyName: - 'projects/my-project/locations/my-location/keyRings/my-keyring/cryptoKeys/key' - name: 'organizations/[ORGANIZATION_ID]/settings' - serviceAccountId: - '[SERVICE_ACCOUNT_ID]@gcp-sa-logging.iam.gserviceaccount.com' - 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 logging settings describe + + $ gcloud beta logging settings describe diff --git a/gcloud/alpha/logging/settings/help b/gcloud/alpha/logging/settings/help index f5f67b845..c274c25db 100644 --- a/gcloud/alpha/logging/settings/help +++ b/gcloud/alpha/logging/settings/help @@ -26,5 +26,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. These variants are also available: + + $ gcloud logging settings + + $ gcloud beta logging settings diff --git a/gcloud/alpha/logging/settings/update b/gcloud/alpha/logging/settings/update index 648409331..76d519c7c 100644 --- a/gcloud/alpha/logging/settings/update +++ b/gcloud/alpha/logging/settings/update @@ -130,5 +130,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 logging settings update + + $ gcloud beta logging settings update diff --git a/gcloud/alpha/storage/cat b/gcloud/alpha/storage/cat index 030c41ef7..89b05dad2 100644 --- a/gcloud/alpha/storage/cat +++ b/gcloud/alpha/storage/cat @@ -3,9 +3,9 @@ NAME stdout SYNOPSIS - gcloud alpha storage cat URL [URL ...] - [--decryption-keys=[DECRYPTION_KEY,...]] [--display-url, -d] - [--range=RANGE, -r RANGE] [GCLOUD_WIDE_FLAG ...] + gcloud alpha storage cat URL [URL ...] [--display-url, -d] + [--range=RANGE, -r RANGE] [--decryption-keys=[DECRYPTION_KEY,...]] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) The cat command outputs the contents of one or more URLs to stdout. @@ -39,13 +39,6 @@ POSITIONAL ARGUMENTS The url of objects to list. FLAGS - --decryption-keys=[DECRYPTION_KEY,...] - A comma separated list of customer-supplied encryption keys (RFC 4648 - section 4 base64-encoded AES256 strings) that will be used to decrypt - Google Cloud Storage objects. Data encrypted with a customer-managed - encryption key (CMEK) is decrypted automatically, so CMEKs do not need - to be listed here. - --display-url, -d Prints the header before each object. @@ -61,6 +54,14 @@ FLAGS If the bytes are out of range of the object, then nothing is printed +ENCRYPTION FLAGS + --decryption-keys=[DECRYPTION_KEY,...] + A comma-separated list of customer-supplied encryption keys (RFC 4648 + section 4 base64-encoded AES256 strings) that will be used to decrypt + Google Cloud Storage objects. Data encrypted with a customer-managed + encryption key (CMEK) is decrypted automatically, so CMEKs do not need + to be listed here. + 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/cp b/gcloud/alpha/storage/cp index 3bb2d84d0..3474bfb47 100644 --- a/gcloud/alpha/storage/cp +++ b/gcloud/alpha/storage/cp @@ -3,14 +3,8 @@ NAME SYNOPSIS gcloud alpha storage cp [SOURCE ...] DESTINATION [--all-versions, -A] - [--cache-control=CACHE_CONTROL] [--no-clobber, -n] - [--content-disposition=CONTENT_DISPOSITION] - [--content-encoding=CONTENT_ENCODING] - [--content-language=CONTENT_LANGUAGE] [--content-md5=MD5_DIGEST] - [--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] [--ignore-symlinks] + [--no-clobber, -n] [--continue-on-error, -c] [--daisy-chain, -D] + [--do-not-decompress] [--ignore-symlinks] [--manifest-path=MANIFEST_PATH, -L MANIFEST_PATH] [--preserve-posix, -P] [--print-created-message, -v] [--read-paths-from-stdin, -I] [--recursive, -R, -r] @@ -19,14 +13,21 @@ SYNOPSIS [--canned-acl=PREDEFINED_ACL, --predefined-acl=PREDEFINED_ACL, -a PREDEFINED_ACL | --preserve-acl, -p] - [--clear-custom-metadata - | --custom-metadata=[CUSTOM_METADATA_KEYS_AND_VALUES,...] - | --remove-custom-metadata=[METADATA_KEYS,...] - --update-custom-metadata=[CUSTOM_METADATA_KEYS_AND_VALUES,...]] [--gzip-in-flight=[FILE_EXTENSIONS,...], -j [FILE_EXTENSIONS,...] | --gzip-in-flight-all, -J | --gzip-local=[FILE_EXTENSIONS,...], -z [FILE_EXTENSIONS,...] | --gzip-local-all, -Z] + [--decryption-keys=[DECRYPTION_KEY,...] + --encryption-key=ENCRYPTION_KEY] + [--cache-control=CACHE_CONTROL + --content-disposition=CONTENT_DISPOSITION + --content-encoding=CONTENT_ENCODING + --content-language=CONTENT_LANGUAGE --content-md5=MD5_DIGEST + --content-type=CONTENT_TYPE + --custom-time=CUSTOM_TIME --clear-custom-metadata + | --custom-metadata=[CUSTOM_METADATA_KEYS_AND_VALUES,...] + | --remove-custom-metadata=[METADATA_KEYS,...] + --update-custom-metadata=[CUSTOM_METADATA_KEYS_AND_VALUES,...]] [--if-generation-match=GENERATION --if-metageneration-match=METAGENERATION] [GCLOUD_WIDE_FLAG ...] @@ -84,40 +85,17 @@ FLAGS versions do not necessarily match the order of the original generation numbers. - --cache-control=CACHE_CONTROL - How caches should handle requests and responses. - --no-clobber, -n Do not overwrite existing files or objects at the destination. Skipped items will be printed. This option performs an additional GET request for cloud objects before attempting an upload. - --content-disposition=CONTENT_DISPOSITION - How content should be displayed. - - --content-encoding=CONTENT_ENCODING - How content is encoded (e.g. gzip). - - --content-language=CONTENT_LANGUAGE - Content's language (e.g. en signifies "English"). - - --content-md5=MD5_DIGEST - Manually specified MD5 hash digest for the contents of an uploaded - file. This flag cannot be used when uploading multiple files. The - custom digest is used by the cloud provider for validation. - - --content-type=CONTENT_TYPE - Type of data contained in the object (e.g. text/html). - --continue-on-error, -c If any operations are unsuccessful, the command will exit with a non-zero exit status after completing the remaining operations. This flag takes effect only in sequential execution mode (i.e. processor and thread count are set to 1). Parallelism is default. - --custom-time=CUSTOM_TIME - Custom time for Google Cloud Storage objects in RFC 3339 format. - --daisy-chain, -D Copy in "daisy chain" mode, which means copying an object by first downloading it to the machine where the command is run, then uploading @@ -128,27 +106,9 @@ FLAGS composite object into a non-composite object. Note: Daisy chain mode is automatically used when copying between providers. - --decryption-keys=[DECRYPTION_KEY,...] - A comma separated list of customer-supplied encryption keys (RFC 4648 - section 4 base64-encoded AES256 strings) that will be used to decrypt - Google Cloud Storage objects. Data encrypted with a customer-managed - encryption key (CMEK) is decrypted automatically, so CMEKs do not need - to be listed here. - --do-not-decompress Do not automatically decompress downloaded gzip files. - --encryption-key=ENCRYPTION_KEY - The encryption key to use for encrypting target objects. The specified - encryption key can be a customer-supplied encryption key (An RFC 4648 - section 4 base64-encoded AES256 string), or a customer-managed - encryption key of the form - projects/{project}/locations/{location}/keyRings/ - {key-ring}/cryptoKeys/{crypto-key}. The specified key also acts as a - decryption key, which is useful when copying or moving encryted data to - a new location. Using this flag in an objects update command triggers a - rewrite of target objects. - --ignore-symlinks Ignore file symlinks instead of copying what they point to. Symlinks pointing to directories will always be ignored. @@ -227,34 +187,6 @@ FLAGS also set a default object ACL on that bucket instead of using this flag. - At most one of these can be specified: - - --clear-custom-metadata - Clears all custom metadata on objects. When used with - --preserve-posix, POSIX attributes will still be stored in custom - metadata. - - --custom-metadata=[CUSTOM_METADATA_KEYS_AND_VALUES,...] - Sets custom metadata on objects. When used with --preserve-posix, - POSIX attributes are also stored in custom metadata. - - Flags that preserve unspecified existing metadata cannot be used with - --custom-metadata or --clear-custom-metadata, but can be specified - together: - - --remove-custom-metadata=[METADATA_KEYS,...] - Removes individual custom metadata keys from objects. This flag can - be used with --update-custom-metadata. When used with - --preserve-posix, POSIX attributes specified by this flag are not - preserved. - - --update-custom-metadata=[CUSTOM_METADATA_KEYS_AND_VALUES,...] - Adds or sets individual custom metadata key value pairs on objects. - Existing custom metadata not specified with this flag is not - changed. This flag can be used with --remove-custom-metadata. When - keys overlap with those provided by --preserve-posix, values - specified by this flag are used. - At most one of these can be specified: --gzip-in-flight=[FILE_EXTENSIONS,...], -j [FILE_EXTENSIONS,...] @@ -305,6 +237,77 @@ FLAGS binary data, using this option may result in files taking up more space in the cloud than they would if left uncompressed. +ENCRYPTION FLAGS + --decryption-keys=[DECRYPTION_KEY,...] + A comma-separated list of customer-supplied encryption keys (RFC 4648 + section 4 base64-encoded AES256 strings) that will be used to decrypt + Google Cloud Storage objects. Data encrypted with a customer-managed + encryption key (CMEK) is decrypted automatically, so CMEKs do not need + to be listed here. + + --encryption-key=ENCRYPTION_KEY + The encryption key to use for encrypting target objects. The specified + encryption key can be a customer-supplied encryption key (An RFC 4648 + section 4 base64-encoded AES256 string), or a customer-managed + encryption key of the form + projects/{project}/locations/{location}/keyRings/ + {key-ring}/cryptoKeys/{crypto-key}. The specified key also acts as a + decryption key, which is useful when copying or moving encryted data to + a new location. Using this flag in an objects update command triggers a + rewrite of target objects. + +OBJECT METADATA FLAGS + --cache-control=CACHE_CONTROL + How caches should handle requests and responses. + + --content-disposition=CONTENT_DISPOSITION + How content should be displayed. + + --content-encoding=CONTENT_ENCODING + How content is encoded (e.g. gzip). + + --content-language=CONTENT_LANGUAGE + Content's language (e.g. en signifies "English"). + + --content-md5=MD5_DIGEST + Manually specified MD5 hash digest for the contents of an uploaded + file. This flag cannot be used when uploading multiple files. The + custom digest is used by the cloud provider for validation. + + --content-type=CONTENT_TYPE + Type of data contained in the object (e.g. text/html). + + --custom-time=CUSTOM_TIME + Custom time for Google Cloud Storage objects in RFC 3339 format. + + At most one of these can be specified: + + --clear-custom-metadata + Clears all custom metadata on objects. When used with + --preserve-posix, POSIX attributes will still be stored in custom + metadata. + + --custom-metadata=[CUSTOM_METADATA_KEYS_AND_VALUES,...] + Sets custom metadata on objects. When used with --preserve-posix, + POSIX attributes are also stored in custom metadata. + + Flags that preserve unspecified existing metadata cannot be used with + --custom-metadata or --clear-custom-metadata, but can be specified + together: + + --remove-custom-metadata=[METADATA_KEYS,...] + Removes individual custom metadata keys from objects. This flag can + be used with --update-custom-metadata. When used with + --preserve-posix, POSIX attributes specified by this flag are not + preserved. + + --update-custom-metadata=[CUSTOM_METADATA_KEYS_AND_VALUES,...] + Adds or sets individual custom metadata key value pairs on objects. + Existing custom metadata not specified with this flag is not + changed. This flag can be used with --remove-custom-metadata. When + 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 diff --git a/gcloud/alpha/storage/ls b/gcloud/alpha/storage/ls index 44dd059a6..919785b15 100644 --- a/gcloud/alpha/storage/ls +++ b/gcloud/alpha/storage/ls @@ -3,9 +3,9 @@ NAME SYNOPSIS gcloud alpha storage ls [PATH ...] [--all-versions, -a] [--buckets, -b] - [--decryption-keys=[DECRYPTION_KEY,...]] [--etag, -e] [--format=FORMAT] - [--readable-sizes] [--recursive, -R, -r] - [--full, -L | --json, -j | --long, -l] [GCLOUD_WIDE_FLAG ...] + [--etag, -e] [--format=FORMAT] [--readable-sizes] [--recursive, -R, -r] + [--full, -L | --json, -j | --long, -l] + [--decryption-keys=[DECRYPTION_KEY,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) List your Cloud Storage buckets in a project and objects in a @@ -87,13 +87,6 @@ FLAGS Typically used in combination with --full to get the full metadata of buckets. - --decryption-keys=[DECRYPTION_KEY,...] - A comma separated list of customer-supplied encryption keys (RFC 4648 - section 4 base64-encoded AES256 strings) that will be used to decrypt - Google Cloud Storage objects. Data encrypted with a customer-managed - encryption key (CMEK) is decrypted automatically, so CMEKs do not need - to be listed here. - --etag, -e Include ETag metadata in listings that use the --long flag. @@ -122,6 +115,14 @@ FLAGS For objects only. List size in bytes, creation time, and URL. Note: Creation time not available for S3. +ENCRYPTION FLAGS + --decryption-keys=[DECRYPTION_KEY,...] + A comma-separated list of customer-supplied encryption keys (RFC 4648 + section 4 base64-encoded AES256 strings) that will be used to decrypt + Google Cloud Storage objects. Data encrypted with a customer-managed + encryption key (CMEK) is decrypted automatically, so CMEKs do not need + to be listed here. + 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/mv b/gcloud/alpha/storage/mv index f855d2e32..6cb1209b9 100644 --- a/gcloud/alpha/storage/mv +++ b/gcloud/alpha/storage/mv @@ -3,14 +3,8 @@ NAME SYNOPSIS gcloud alpha storage mv [SOURCE ...] DESTINATION [--all-versions, -A] - [--cache-control=CACHE_CONTROL] [--no-clobber, -n] - [--content-disposition=CONTENT_DISPOSITION] - [--content-encoding=CONTENT_ENCODING] - [--content-language=CONTENT_LANGUAGE] [--content-md5=MD5_DIGEST] - [--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] [--ignore-symlinks] + [--no-clobber, -n] [--continue-on-error, -c] [--daisy-chain, -D] + [--do-not-decompress] [--ignore-symlinks] [--manifest-path=MANIFEST_PATH, -L MANIFEST_PATH] [--preserve-posix, -P] [--print-created-message, -v] [--read-paths-from-stdin, -I] [--skip-unsupported, -U] @@ -18,14 +12,21 @@ SYNOPSIS [--canned-acl=PREDEFINED_ACL, --predefined-acl=PREDEFINED_ACL, -a PREDEFINED_ACL | --preserve-acl, -p] - [--clear-custom-metadata - | --custom-metadata=[CUSTOM_METADATA_KEYS_AND_VALUES,...] - | --remove-custom-metadata=[METADATA_KEYS,...] - --update-custom-metadata=[CUSTOM_METADATA_KEYS_AND_VALUES,...]] [--gzip-in-flight=[FILE_EXTENSIONS,...], -j [FILE_EXTENSIONS,...] | --gzip-in-flight-all, -J | --gzip-local=[FILE_EXTENSIONS,...], -z [FILE_EXTENSIONS,...] | --gzip-local-all, -Z] + [--decryption-keys=[DECRYPTION_KEY,...] + --encryption-key=ENCRYPTION_KEY] + [--cache-control=CACHE_CONTROL + --content-disposition=CONTENT_DISPOSITION + --content-encoding=CONTENT_ENCODING + --content-language=CONTENT_LANGUAGE --content-md5=MD5_DIGEST + --content-type=CONTENT_TYPE + --custom-time=CUSTOM_TIME --clear-custom-metadata + | --custom-metadata=[CUSTOM_METADATA_KEYS_AND_VALUES,...] + | --remove-custom-metadata=[METADATA_KEYS,...] + --update-custom-metadata=[CUSTOM_METADATA_KEYS_AND_VALUES,...]] [--if-generation-match=GENERATION --if-metageneration-match=METAGENERATION] [GCLOUD_WIDE_FLAG ...] @@ -95,40 +96,17 @@ FLAGS versions do not necessarily match the order of the original generation numbers. - --cache-control=CACHE_CONTROL - How caches should handle requests and responses. - --no-clobber, -n Do not overwrite existing files or objects at the destination. Skipped items will be printed. This option performs an additional GET request for cloud objects before attempting an upload. - --content-disposition=CONTENT_DISPOSITION - How content should be displayed. - - --content-encoding=CONTENT_ENCODING - How content is encoded (e.g. gzip). - - --content-language=CONTENT_LANGUAGE - Content's language (e.g. en signifies "English"). - - --content-md5=MD5_DIGEST - Manually specified MD5 hash digest for the contents of an uploaded - file. This flag cannot be used when uploading multiple files. The - custom digest is used by the cloud provider for validation. - - --content-type=CONTENT_TYPE - Type of data contained in the object (e.g. text/html). - --continue-on-error, -c If any operations are unsuccessful, the command will exit with a non-zero exit status after completing the remaining operations. This flag takes effect only in sequential execution mode (i.e. processor and thread count are set to 1). Parallelism is default. - --custom-time=CUSTOM_TIME - Custom time for Google Cloud Storage objects in RFC 3339 format. - --daisy-chain, -D Copy in "daisy chain" mode, which means copying an object by first downloading it to the machine where the command is run, then uploading @@ -139,27 +117,9 @@ FLAGS composite object into a non-composite object. Note: Daisy chain mode is automatically used when copying between providers. - --decryption-keys=[DECRYPTION_KEY,...] - A comma separated list of customer-supplied encryption keys (RFC 4648 - section 4 base64-encoded AES256 strings) that will be used to decrypt - Google Cloud Storage objects. Data encrypted with a customer-managed - encryption key (CMEK) is decrypted automatically, so CMEKs do not need - to be listed here. - --do-not-decompress Do not automatically decompress downloaded gzip files. - --encryption-key=ENCRYPTION_KEY - The encryption key to use for encrypting target objects. The specified - encryption key can be a customer-supplied encryption key (An RFC 4648 - section 4 base64-encoded AES256 string), or a customer-managed - encryption key of the form - projects/{project}/locations/{location}/keyRings/ - {key-ring}/cryptoKeys/{crypto-key}. The specified key also acts as a - decryption key, which is useful when copying or moving encryted data to - a new location. Using this flag in an objects update command triggers a - rewrite of target objects. - --ignore-symlinks Ignore file symlinks instead of copying what they point to. Symlinks pointing to directories will always be ignored. @@ -234,34 +194,6 @@ FLAGS also set a default object ACL on that bucket instead of using this flag. - At most one of these can be specified: - - --clear-custom-metadata - Clears all custom metadata on objects. When used with - --preserve-posix, POSIX attributes will still be stored in custom - metadata. - - --custom-metadata=[CUSTOM_METADATA_KEYS_AND_VALUES,...] - Sets custom metadata on objects. When used with --preserve-posix, - POSIX attributes are also stored in custom metadata. - - Flags that preserve unspecified existing metadata cannot be used with - --custom-metadata or --clear-custom-metadata, but can be specified - together: - - --remove-custom-metadata=[METADATA_KEYS,...] - Removes individual custom metadata keys from objects. This flag can - be used with --update-custom-metadata. When used with - --preserve-posix, POSIX attributes specified by this flag are not - preserved. - - --update-custom-metadata=[CUSTOM_METADATA_KEYS_AND_VALUES,...] - Adds or sets individual custom metadata key value pairs on objects. - Existing custom metadata not specified with this flag is not - changed. This flag can be used with --remove-custom-metadata. When - keys overlap with those provided by --preserve-posix, values - specified by this flag are used. - At most one of these can be specified: --gzip-in-flight=[FILE_EXTENSIONS,...], -j [FILE_EXTENSIONS,...] @@ -312,6 +244,77 @@ FLAGS binary data, using this option may result in files taking up more space in the cloud than they would if left uncompressed. +ENCRYPTION FLAGS + --decryption-keys=[DECRYPTION_KEY,...] + A comma-separated list of customer-supplied encryption keys (RFC 4648 + section 4 base64-encoded AES256 strings) that will be used to decrypt + Google Cloud Storage objects. Data encrypted with a customer-managed + encryption key (CMEK) is decrypted automatically, so CMEKs do not need + to be listed here. + + --encryption-key=ENCRYPTION_KEY + The encryption key to use for encrypting target objects. The specified + encryption key can be a customer-supplied encryption key (An RFC 4648 + section 4 base64-encoded AES256 string), or a customer-managed + encryption key of the form + projects/{project}/locations/{location}/keyRings/ + {key-ring}/cryptoKeys/{crypto-key}. The specified key also acts as a + decryption key, which is useful when copying or moving encryted data to + a new location. Using this flag in an objects update command triggers a + rewrite of target objects. + +OBJECT METADATA FLAGS + --cache-control=CACHE_CONTROL + How caches should handle requests and responses. + + --content-disposition=CONTENT_DISPOSITION + How content should be displayed. + + --content-encoding=CONTENT_ENCODING + How content is encoded (e.g. gzip). + + --content-language=CONTENT_LANGUAGE + Content's language (e.g. en signifies "English"). + + --content-md5=MD5_DIGEST + Manually specified MD5 hash digest for the contents of an uploaded + file. This flag cannot be used when uploading multiple files. The + custom digest is used by the cloud provider for validation. + + --content-type=CONTENT_TYPE + Type of data contained in the object (e.g. text/html). + + --custom-time=CUSTOM_TIME + Custom time for Google Cloud Storage objects in RFC 3339 format. + + At most one of these can be specified: + + --clear-custom-metadata + Clears all custom metadata on objects. When used with + --preserve-posix, POSIX attributes will still be stored in custom + metadata. + + --custom-metadata=[CUSTOM_METADATA_KEYS_AND_VALUES,...] + Sets custom metadata on objects. When used with --preserve-posix, + POSIX attributes are also stored in custom metadata. + + Flags that preserve unspecified existing metadata cannot be used with + --custom-metadata or --clear-custom-metadata, but can be specified + together: + + --remove-custom-metadata=[METADATA_KEYS,...] + Removes individual custom metadata keys from objects. This flag can + be used with --update-custom-metadata. When used with + --preserve-posix, POSIX attributes specified by this flag are not + preserved. + + --update-custom-metadata=[CUSTOM_METADATA_KEYS_AND_VALUES,...] + Adds or sets individual custom metadata key value pairs on objects. + Existing custom metadata not specified with this flag is not + changed. This flag can be used with --remove-custom-metadata. When + 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 diff --git a/gcloud/alpha/storage/objects/describe b/gcloud/alpha/storage/objects/describe index 83dcebddc..959a45d65 100644 --- a/gcloud/alpha/storage/objects/describe +++ b/gcloud/alpha/storage/objects/describe @@ -23,9 +23,9 @@ POSITIONAL ARGUMENTS URL Specifies URL of object to describe. -FLAGS +ENCRYPTION FLAGS --decryption-keys=[DECRYPTION_KEY,...] - A comma separated list of customer-supplied encryption keys (RFC 4648 + A comma-separated list of customer-supplied encryption keys (RFC 4648 section 4 base64-encoded AES256 strings) that will be used to decrypt Google Cloud Storage objects. Data encrypted with a customer-managed encryption key (CMEK) is decrypted automatically, so CMEKs do not need diff --git a/gcloud/alpha/storage/objects/list b/gcloud/alpha/storage/objects/list index d64fad7a7..c5b4d2ab0 100644 --- a/gcloud/alpha/storage/objects/list +++ b/gcloud/alpha/storage/objects/list @@ -32,9 +32,9 @@ POSITIONAL ARGUMENTS URLS [URLS ...] Specifies URL of objects to list. -FLAGS +ENCRYPTION FLAGS --decryption-keys=[DECRYPTION_KEY,...] - A comma separated list of customer-supplied encryption keys (RFC 4648 + A comma-separated list of customer-supplied encryption keys (RFC 4648 section 4 base64-encoded AES256 strings) that will be used to decrypt Google Cloud Storage objects. Data encrypted with a customer-managed encryption key (CMEK) is decrypted automatically, so CMEKs do not need diff --git a/gcloud/alpha/storage/objects/update b/gcloud/alpha/storage/objects/update index 0919b9f58..db2474d61 100644 --- a/gcloud/alpha/storage/objects/update +++ b/gcloud/alpha/storage/objects/update @@ -2,21 +2,21 @@ NAME gcloud alpha storage objects update - update Cloud Storage objects SYNOPSIS - gcloud alpha storage objects update [URL ...] - [--cache-control=CACHE_CONTROL] [--clear-cache-control] - [--clear-content-disposition] [--clear-content-encoding] - [--clear-content-language] [--clear-content-md5] [--clear-content-type] - [--clear-custom-time] [--clear-encryption-key] - [--content-disposition=CONTENT_DISPOSITION] - [--content-encoding=CONTENT_ENCODING] - [--content-language=CONTENT_LANGUAGE] [--content-md5=MD5_DIGEST] - [--content-type=CONTENT_TYPE] [--continue-on-error, -c] - [--custom-time=CUSTOM_TIME] [--decryption-keys=[DECRYPTION_KEY,...]] - [--encryption-key=ENCRYPTION_KEY] [--[no-]event-based-hold] - [--preserve-acl, -p] [--read-paths-from-stdin, -I] - [--recursive, -R, -r] [--storage-class=STORAGE_CLASS, -s STORAGE_CLASS] + gcloud alpha storage objects update [URL ...] [--continue-on-error, -c] + [--[no-]event-based-hold] [--preserve-acl, -p] + [--read-paths-from-stdin, -I] [--recursive, -R, -r] + [--storage-class=STORAGE_CLASS, -s STORAGE_CLASS] [--[no-]temporary-hold] - [--clear-custom-metadata + [--clear-encryption-key --decryption-keys=[DECRYPTION_KEY,...] + --encryption-key=ENCRYPTION_KEY] + [--cache-control=CACHE_CONTROL --clear-cache-control + --clear-content-disposition --clear-content-encoding + --clear-content-language --clear-content-md5 --clear-content-type + --clear-custom-time --content-disposition=CONTENT_DISPOSITION + --content-encoding=CONTENT_ENCODING + --content-language=CONTENT_LANGUAGE --content-md5=MD5_DIGEST + --content-type=CONTENT_TYPE + --custom-time=CUSTOM_TIME --clear-custom-metadata | --custom-metadata=[CUSTOM_METADATA_KEYS_AND_VALUES,...] | --remove-custom-metadata=[METADATA_KEYS,...] --update-custom-metadata=[CUSTOM_METADATA_KEYS_AND_VALUES,...]] @@ -48,80 +48,12 @@ POSITIONAL ARGUMENTS Specifies URLs of objects to update. FLAGS - --cache-control=CACHE_CONTROL - How caches should handle requests and responses. - - --clear-cache-control - Clears object cache control. - - --clear-content-disposition - Clears object content disposition. - - --clear-content-encoding - Clears content encoding. - - --clear-content-language - Clears object content language. - - --clear-content-md5 - Clears object content MD5. - - --clear-content-type - Clears object content type. - - --clear-custom-time - Clears object custom time. - - --clear-encryption-key - Clears the encryption key associated with an object. Using this flag - triggers a rewrite of affected objects, which are then encrypted using - the default encryption key set on the bucket, if one exists, or else - with a Google-managed encryption key. - - --content-disposition=CONTENT_DISPOSITION - How content should be displayed. - - --content-encoding=CONTENT_ENCODING - How content is encoded (e.g. gzip). - - --content-language=CONTENT_LANGUAGE - Content's language (e.g. en signifies "English"). - - --content-md5=MD5_DIGEST - Manually specified MD5 hash digest for the contents of an uploaded - file. This flag cannot be used when uploading multiple files. The - custom digest is used by the cloud provider for validation. - - --content-type=CONTENT_TYPE - Type of data contained in the object (e.g. text/html). - --continue-on-error, -c If any operations are unsuccessful, the command will exit with a non-zero exit status after completing the remaining operations. This flag takes effect only in sequential execution mode (i.e. processor and thread count are set to 1). Parallelism is default. - --custom-time=CUSTOM_TIME - Custom time for Google Cloud Storage objects in RFC 3339 format. - - --decryption-keys=[DECRYPTION_KEY,...] - A comma separated list of customer-supplied encryption keys (RFC 4648 - section 4 base64-encoded AES256 strings) that will be used to decrypt - Google Cloud Storage objects. Data encrypted with a customer-managed - encryption key (CMEK) is decrypted automatically, so CMEKs do not need - to be listed here. - - --encryption-key=ENCRYPTION_KEY - The encryption key to use for encrypting target objects. The specified - encryption key can be a customer-supplied encryption key (An RFC 4648 - section 4 base64-encoded AES256 string), or a customer-managed - encryption key of the form - projects/{project}/locations/{location}/keyRings/ - {key-ring}/cryptoKeys/{crypto-key}. The specified key also acts as a - decryption key, which is useful when copying or moving encryted data to - a new location. Using this flag in an objects update command triggers a - rewrite of target objects. - --[no-]event-based-hold Enables or disables an event-based hold on objects. Use --event-based-hold to enable and --no-event-based-hold to disable. @@ -150,6 +82,76 @@ FLAGS Enables or disables a temporary hold on objects. Use --temporary-hold to enable and --no-temporary-hold to disable. +ENCRYPTION FLAGS + --clear-encryption-key + Clears the encryption key associated with an object. Using this flag + triggers a rewrite of affected objects, which are then encrypted using + the default encryption key set on the bucket, if one exists, or else + with a Google-managed encryption key. + + --decryption-keys=[DECRYPTION_KEY,...] + A comma-separated list of customer-supplied encryption keys (RFC 4648 + section 4 base64-encoded AES256 strings) that will be used to decrypt + Google Cloud Storage objects. Data encrypted with a customer-managed + encryption key (CMEK) is decrypted automatically, so CMEKs do not need + to be listed here. + + --encryption-key=ENCRYPTION_KEY + The encryption key to use for encrypting target objects. The specified + encryption key can be a customer-supplied encryption key (An RFC 4648 + section 4 base64-encoded AES256 string), or a customer-managed + encryption key of the form + projects/{project}/locations/{location}/keyRings/ + {key-ring}/cryptoKeys/{crypto-key}. The specified key also acts as a + decryption key, which is useful when copying or moving encryted data to + a new location. Using this flag in an objects update command triggers a + rewrite of target objects. + +OBJECT METADATA FLAGS + --cache-control=CACHE_CONTROL + How caches should handle requests and responses. + + --clear-cache-control + Clears object cache control. + + --clear-content-disposition + Clears object content disposition. + + --clear-content-encoding + Clears content encoding. + + --clear-content-language + Clears object content language. + + --clear-content-md5 + Clears object content MD5. + + --clear-content-type + Clears object content type. + + --clear-custom-time + Clears object custom time. + + --content-disposition=CONTENT_DISPOSITION + How content should be displayed. + + --content-encoding=CONTENT_ENCODING + How content is encoded (e.g. gzip). + + --content-language=CONTENT_LANGUAGE + Content's language (e.g. en signifies "English"). + + --content-md5=MD5_DIGEST + Manually specified MD5 hash digest for the contents of an uploaded + file. This flag cannot be used when uploading multiple files. The + custom digest is used by the cloud provider for validation. + + --content-type=CONTENT_TYPE + Type of data contained in the object (e.g. text/html). + + --custom-time=CUSTOM_TIME + Custom time for Google Cloud Storage objects in RFC 3339 format. + At most one of these can be specified: --clear-custom-metadata diff --git a/gcloud/beta/alloydb/instances/describe b/gcloud/beta/alloydb/instances/describe index 7f286b97e..4febb2ec9 100644 --- a/gcloud/beta/alloydb/instances/describe +++ b/gcloud/beta/alloydb/instances/describe @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud beta alloydb instances describe INSTANCE --cluster=CLUSTER - --region=REGION [GCLOUD_WIDE_FLAG ...] + --region=REGION [--view=VIEW] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Describes an AlloyDB instance within a given cluster. @@ -13,7 +13,7 @@ EXAMPLES To describe an instance, run: $ gcloud beta alloydb instances describe my-instance \ - --cluster=my-cluster --region=us-central1 + --cluster=my-cluster --region=us-central1 --view=BASIC/FULL POSITIONAL ARGUMENTS INSTANCE @@ -27,6 +27,10 @@ REQUIRED FLAGS Regional location (e.g. asia-east1, us-east1). See the full list of regions at https://cloud.google.com/sql/docs/instance-locations. +OPTIONAL FLAGS + --view=VIEW + View of the instance to return. VIEW must be one of: basic, full. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/beta/bigtable/backups/add-iam-policy-binding b/gcloud/beta/bigtable/backups/add-iam-policy-binding index 16a7eed48..429a46c54 100644 --- a/gcloud/beta/bigtable/backups/add-iam-policy-binding +++ b/gcloud/beta/bigtable/backups/add-iam-policy-binding @@ -58,14 +58,13 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --cluster=CLUSTER - The name of the Cloud Bigtable cluster. To set the cluster attribute: + Name of the Cloud Bigtable cluster. To set the cluster attribute: ▸ provide the argument backup on the command line with a fully specified name; ▸ provide the argument --cluster on the command line. --instance=INSTANCE - The name of the Cloud Bigtable instance. To set the instance - attribute: + Name of the Cloud Bigtable instance. To set the instance attribute: ▸ provide the argument backup on the command line with a fully specified name; ▸ provide the argument --instance on the command line. diff --git a/gcloud/beta/bigtable/backups/create b/gcloud/beta/bigtable/backups/create index 9b113777e..c9c951c30 100644 --- a/gcloud/beta/bigtable/backups/create +++ b/gcloud/beta/bigtable/backups/create @@ -49,14 +49,13 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --cluster=CLUSTER - The name of the Cloud Bigtable cluster. To set the cluster attribute: + Name of the Cloud Bigtable cluster. To set the cluster attribute: ▸ provide the argument backup on the command line with a fully specified name; ▸ provide the argument --cluster on the command line. --instance=INSTANCE - The name of the Cloud Bigtable instance. To set the instance - attribute: + Name of the Cloud Bigtable instance. To set the instance attribute: ▸ provide the argument backup on the command line with a fully specified name; ▸ provide the argument --instance on the command line. diff --git a/gcloud/beta/bigtable/backups/delete b/gcloud/beta/bigtable/backups/delete index b731b3374..43aa9f080 100644 --- a/gcloud/beta/bigtable/backups/delete +++ b/gcloud/beta/bigtable/backups/delete @@ -35,14 +35,13 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --cluster=CLUSTER - The name of the Cloud Bigtable cluster. To set the cluster attribute: + Name of the Cloud Bigtable cluster. To set the cluster attribute: ▸ provide the argument backup on the command line with a fully specified name; ▸ provide the argument --cluster on the command line. --instance=INSTANCE - The name of the Cloud Bigtable instance. To set the instance - attribute: + Name of the Cloud Bigtable instance. To set the instance attribute: ▸ provide the argument backup on the command line with a fully specified name; ▸ provide the argument --instance on the command line. diff --git a/gcloud/beta/bigtable/backups/describe b/gcloud/beta/bigtable/backups/describe index e5ddfab9a..258afb57f 100644 --- a/gcloud/beta/bigtable/backups/describe +++ b/gcloud/beta/bigtable/backups/describe @@ -36,14 +36,13 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --cluster=CLUSTER - The name of the Cloud Bigtable cluster. To set the cluster attribute: + Name of the Cloud Bigtable cluster. To set the cluster attribute: ▸ provide the argument backup on the command line with a fully specified name; ▸ provide the argument --cluster on the command line. --instance=INSTANCE - The name of the Cloud Bigtable instance. To set the instance - attribute: + Name of the Cloud Bigtable instance. To set the instance attribute: ▸ provide the argument backup on the command line with a fully specified name; ▸ provide the argument --instance on the command line. diff --git a/gcloud/beta/bigtable/backups/get-iam-policy b/gcloud/beta/bigtable/backups/get-iam-policy index 11aedc544..239ed7dfa 100644 --- a/gcloud/beta/bigtable/backups/get-iam-policy +++ b/gcloud/beta/bigtable/backups/get-iam-policy @@ -42,14 +42,13 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --cluster=CLUSTER - The name of the Cloud Bigtable cluster. To set the cluster attribute: + Name of the Cloud Bigtable cluster. To set the cluster attribute: ▸ provide the argument backup on the command line with a fully specified name; ▸ provide the argument --cluster on the command line. --instance=INSTANCE - The name of the Cloud Bigtable instance. To set the instance - attribute: + Name of the Cloud Bigtable instance. To set the instance attribute: ▸ provide the argument backup on the command line with a fully specified name; ▸ provide the argument --instance on the command line. diff --git a/gcloud/beta/bigtable/backups/remove-iam-policy-binding b/gcloud/beta/bigtable/backups/remove-iam-policy-binding index d5f28942a..889bd32ae 100644 --- a/gcloud/beta/bigtable/backups/remove-iam-policy-binding +++ b/gcloud/beta/bigtable/backups/remove-iam-policy-binding @@ -59,14 +59,13 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --cluster=CLUSTER - The name of the Cloud Bigtable cluster. To set the cluster attribute: + Name of the Cloud Bigtable cluster. To set the cluster attribute: ▸ provide the argument backup on the command line with a fully specified name; ▸ provide the argument --cluster on the command line. --instance=INSTANCE - The name of the Cloud Bigtable instance. To set the instance - attribute: + Name of the Cloud Bigtable instance. To set the instance attribute: ▸ provide the argument backup on the command line with a fully specified name; ▸ provide the argument --instance on the command line. diff --git a/gcloud/beta/bigtable/backups/set-iam-policy b/gcloud/beta/bigtable/backups/set-iam-policy index d938840f9..dcb0a15e5 100644 --- a/gcloud/beta/bigtable/backups/set-iam-policy +++ b/gcloud/beta/bigtable/backups/set-iam-policy @@ -41,14 +41,13 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --cluster=CLUSTER - The name of the Cloud Bigtable cluster. To set the cluster attribute: + Name of the Cloud Bigtable cluster. To set the cluster attribute: ▸ provide the argument backup on the command line with a fully specified name; ▸ provide the argument --cluster on the command line. --instance=INSTANCE - The name of the Cloud Bigtable instance. To set the instance - attribute: + Name of the Cloud Bigtable instance. To set the instance attribute: ▸ provide the argument backup on the command line with a fully specified name; ▸ provide the argument --instance on the command line. diff --git a/gcloud/beta/bigtable/backups/update b/gcloud/beta/bigtable/backups/update index b69d7381c..9aa0761bb 100644 --- a/gcloud/beta/bigtable/backups/update +++ b/gcloud/beta/bigtable/backups/update @@ -40,14 +40,13 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --cluster=CLUSTER - The name of the Cloud Bigtable cluster. To set the cluster attribute: + Name of the Cloud Bigtable cluster. To set the cluster attribute: ▸ provide the argument backup on the command line with a fully specified name; ▸ provide the argument --cluster on the command line. --instance=INSTANCE - The name of the Cloud Bigtable instance. To set the instance - attribute: + Name of the Cloud Bigtable instance. To set the instance attribute: ▸ provide the argument backup on the command line with a fully specified name; ▸ provide the argument --instance on the command line. diff --git a/gcloud/beta/bigtable/instances/tables/add-iam-policy-binding b/gcloud/beta/bigtable/instances/tables/add-iam-policy-binding index 0572e64fb..688278edb 100644 --- a/gcloud/beta/bigtable/instances/tables/add-iam-policy-binding +++ b/gcloud/beta/bigtable/instances/tables/add-iam-policy-binding @@ -56,8 +56,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - The name of the Cloud Bigtable instance. To set the instance - attribute: + Name of the Cloud Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully specified name; ▸ provide the argument --instance on the command line. diff --git a/gcloud/beta/bigtable/instances/tables/describe b/gcloud/beta/bigtable/instances/tables/describe index 59a4bad41..0acebdac9 100644 --- a/gcloud/beta/bigtable/instances/tables/describe +++ b/gcloud/beta/bigtable/instances/tables/describe @@ -37,8 +37,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - The name of the Cloud Bigtable instance. To set the instance - attribute: + Name of the Cloud Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully specified name; ▸ provide the argument --instance on the command line. diff --git a/gcloud/beta/bigtable/instances/tables/get-iam-policy b/gcloud/beta/bigtable/instances/tables/get-iam-policy index 2c8103936..4124d0204 100644 --- a/gcloud/beta/bigtable/instances/tables/get-iam-policy +++ b/gcloud/beta/bigtable/instances/tables/get-iam-policy @@ -41,8 +41,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - The name of the Cloud Bigtable instance. To set the instance - attribute: + Name of the Cloud Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully specified name; ▸ provide the argument --instance on the command line. diff --git a/gcloud/beta/bigtable/instances/tables/remove-iam-policy-binding b/gcloud/beta/bigtable/instances/tables/remove-iam-policy-binding index 6354a94ab..a747d0b51 100644 --- a/gcloud/beta/bigtable/instances/tables/remove-iam-policy-binding +++ b/gcloud/beta/bigtable/instances/tables/remove-iam-policy-binding @@ -56,8 +56,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - The name of the Cloud Bigtable instance. To set the instance - attribute: + Name of the Cloud Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully specified name; ▸ provide the argument --instance on the command line. diff --git a/gcloud/beta/bigtable/instances/tables/restore b/gcloud/beta/bigtable/instances/tables/restore index 762c41e12..364ce6c92 100644 --- a/gcloud/beta/bigtable/instances/tables/restore +++ b/gcloud/beta/bigtable/instances/tables/restore @@ -51,8 +51,7 @@ REQUIRED FLAGS this group are specified. --destination-instance=DESTINATION_INSTANCE - The name of the Cloud Bigtable instance. To set the instance - attribute: + Name of the Cloud Bigtable instance. To set the instance attribute: ▸ provide the argument --destination on the command line with a fully specified name; ▸ provide the argument --destination-instance on the command line; @@ -78,14 +77,13 @@ REQUIRED FLAGS this group are specified. --source-cluster=SOURCE_CLUSTER - The name of the Cloud Bigtable cluster. To set the cluster attribute: + Name of the Cloud Bigtable cluster. To set the cluster attribute: ▸ provide the argument --source on the command line with a fully specified name; ▸ provide the argument --source-cluster on the command line. --source-instance=SOURCE_INSTANCE - The name of the Cloud Bigtable instance. To set the instance - attribute: + Name of the Cloud Bigtable instance. To set the instance attribute: ▸ provide the argument --source on the command line with a fully specified name; ▸ provide the argument --source-instance on the command line; diff --git a/gcloud/beta/bigtable/instances/tables/set-iam-policy b/gcloud/beta/bigtable/instances/tables/set-iam-policy index 086b20d31..53e6ce838 100644 --- a/gcloud/beta/bigtable/instances/tables/set-iam-policy +++ b/gcloud/beta/bigtable/instances/tables/set-iam-policy @@ -40,8 +40,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - The name of the Cloud Bigtable instance. To set the instance - attribute: + Name of the Cloud Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully specified name; ▸ provide the argument --instance on the command line. diff --git a/gcloud/beta/bigtable/instances/tables/undelete b/gcloud/beta/bigtable/instances/tables/undelete index 852d5ccda..98b20b9cf 100644 --- a/gcloud/beta/bigtable/instances/tables/undelete +++ b/gcloud/beta/bigtable/instances/tables/undelete @@ -10,7 +10,7 @@ DESCRIPTION (BETA) Undelete a previously deleted Cloud Bigtable table. EXAMPLES - To undelete the table 'my-table' in instance 'my-instance', run: + To undelete the table my-table in instance my-instance, run: $ gcloud beta bigtable instances tables undelete my-table \ --instance=my-instance @@ -36,8 +36,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --instance=INSTANCE - The name of the Cloud Bigtable instance. To set the instance - attribute: + Name of the Cloud Bigtable instance. To set the instance attribute: ▸ provide the argument table on the command line with a fully specified name; ▸ provide the argument --instance on the command line. diff --git a/gcloud/beta/compute/firewall-rules/help b/gcloud/beta/compute/firewall-rules/help index ffb6465f6..e6409e8b4 100644 --- a/gcloud/beta/compute/firewall-rules/help +++ b/gcloud/beta/compute/firewall-rules/help @@ -34,6 +34,10 @@ COMMANDS list (BETA) List Compute Engine firewall rules. + migrate + (BETA) Create a new Network Firewall Policy and move all customer + defined firewall rules there. + update (BETA) Update a firewall rule. diff --git a/gcloud/beta/compute/firewall-rules/migrate b/gcloud/beta/compute/firewall-rules/migrate new file mode 100644 index 000000000..ded3a20cc --- /dev/null +++ b/gcloud/beta/compute/firewall-rules/migrate @@ -0,0 +1,57 @@ +NAME + gcloud beta compute firewall-rules migrate - create a new Network Firewall + Policy and move all customer defined firewall rules there + +SYNOPSIS + gcloud beta compute firewall-rules migrate --source-network=SOURCE_NETWORK + (--export-tag-mapping + | --target-firewall-policy=TARGET_FIREWALL_POLICY) + [--tag-mapping-file=TAG_MAPPING_FILE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) gcloud beta compute firewall-rules migrate is used to create a new + Network Firewall Policy that contain all rules defined in already existing + Network Firewall Policy associated with the given VPC Network and all + customer defined VPC Firewall Rules attached to that VPC Network. + +EXAMPLES + To execute the migration for VPC Network 'my-network' which stores the + result in 'my-policy' Network Firewall Policy, run: + + $ gcloud beta compute firewall-rules migrate \ + --source-network=my-network --target-firewall-policy=my-policy + +REQUIRED FLAGS + --source-network=SOURCE_NETWORK + The VPC Network for which the migration should be performed. + + Exactly one of these must be specified: + + --export-tag-mapping + If set, migration tool will inspect all VPC Firewalls attached to + SOURCE_NETWORK, collect all source and target tags, and store them in + TAG_MAPPING_FILE. + + --target-firewall-policy=TARGET_FIREWALL_POLICY + Name of the new Network Firewall Policy used to store the migration + result. + +OPTIONAL FLAGS + --tag-mapping-file=TAG_MAPPING_FILE + Path to a JSON file with legacy tags and service accounts to secure + tags mapping. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha compute firewall-rules migrate + diff --git a/gcloud/beta/compute/security-policies/update b/gcloud/beta/compute/security-policies/update index 1d242a7e0..5d6931252 100644 --- a/gcloud/beta/compute/security-policies/update +++ b/gcloud/beta/compute/security-policies/update @@ -5,6 +5,7 @@ NAME SYNOPSIS gcloud beta compute security-policies update NAME [--description=DESCRIPTION] [--enable-layer7-ddos-defense] + [--json-custom-content-types=[CONTENT_TYPE,...]] [--json-parsing=JSON_PARSING] [--layer7-ddos-defense-auto-deploy-confidence-threshold=LAYER7_DDOS_DEFENSE_AUTO_DEPLOY_CONFIDENCE_THRESHOLD] [--layer7-ddos-defense-auto-deploy-expiration-sec=LAYER7_DDOS_DEFENSE_AUTO_DEPLOY_EXPIRATION_SEC] @@ -37,6 +38,13 @@ FLAGS --enable-layer7-ddos-defense Whether to enable Cloud Armor Layer 7 DDoS Defense Adaptive Protection. + --json-custom-content-types=[CONTENT_TYPE,...] + A comma-separated list of custom Content-Type header values to apply + JSON parsing for preconfigured WAF rules. Only applicable when JSON + parsing is enabled, like --json-parsing=STANDARD. When configuring a + Content-Type header value, only the type/subtype needs to be specified, + and the parameters should be excluded. + --json-parsing=JSON_PARSING The JSON parsing behavior for this rule. Must be one of the following values: [DISABLED, STANDARD]. JSON_PARSING must be one of: DISABLED, diff --git a/gcloud/beta/compute/snapshots/create b/gcloud/beta/compute/snapshots/create index 8930276a2..1e30efb2f 100644 --- a/gcloud/beta/compute/snapshots/create +++ b/gcloud/beta/compute/snapshots/create @@ -5,8 +5,8 @@ SYNOPSIS gcloud beta compute snapshots create NAME [--async] [--chain-name=CHAIN_NAME] [--csek-key-file=FILE] [--description=DESCRIPTION] [--guest-flush] [--labels=[KEY=VALUE,...]] - [--source-disk=SOURCE_DISK] [--source-disk-key-file=FILE] - [--storage-location=LOCATION] + [--snapshot-type=SNAPSHOT_TYPE] [--source-disk=SOURCE_DISK] + [--source-disk-key-file=FILE] [--storage-location=LOCATION] [--source-disk-region=SOURCE_DISK_REGION | --source-disk-zone=SOURCE_DISK_ZONE] [GCLOUD_WIDE_FLAG ...] @@ -65,6 +65,11 @@ FLAGS contain only hyphens (-), underscores (_), lowercase characters, and numbers. + --snapshot-type=SNAPSHOT_TYPE + Type of snapshot. If a snapshot type is not specified, a STANDARD + snapshot will be created. SNAPSHOT_TYPE must be one of: ARCHIVE, + STANDARD. + --source-disk=SOURCE_DISK Source disk used to create the snapshot. To create a snapshot from a source disk in a different project, specify the full path to the source diff --git a/gcloud/beta/config/get b/gcloud/beta/config/get index 9af9ad7e5..0f19651ac 100644 --- a/gcloud/beta/config/get +++ b/gcloud/beta/config/get @@ -321,6 +321,10 @@ AVAILABLE PROPERTIES ids Overrides API endpoint for gcloud ids command group. + krmapihosting + Overrides API endpoint for gcloud anthos config controller command + group. + language Overrides API endpoint for gcloud ml language command group. diff --git a/gcloud/beta/config/help b/gcloud/beta/config/help index fd1cf3b33..c6db09af2 100644 --- a/gcloud/beta/config/help +++ b/gcloud/beta/config/help @@ -353,6 +353,10 @@ AVAILABLE PROPERTIES ids Overrides API endpoint for gcloud ids command group. + krmapihosting + Overrides API endpoint for gcloud anthos config controller command + group. + language Overrides API endpoint for gcloud ml language command group. diff --git a/gcloud/beta/config/list b/gcloud/beta/config/list index 7b1de02e1..c15bb850e 100644 --- a/gcloud/beta/config/list +++ b/gcloud/beta/config/list @@ -359,6 +359,10 @@ AVAILABLE PROPERTIES ids Overrides API endpoint for gcloud ids command group. + krmapihosting + Overrides API endpoint for gcloud anthos config controller command + group. + language Overrides API endpoint for gcloud ml language command group. diff --git a/gcloud/beta/config/set b/gcloud/beta/config/set index e473355e8..079d3cfe2 100644 --- a/gcloud/beta/config/set +++ b/gcloud/beta/config/set @@ -368,6 +368,10 @@ AVAILABLE PROPERTIES ids Overrides API endpoint for gcloud ids command group. + krmapihosting + Overrides API endpoint for gcloud anthos config controller command + group. + language Overrides API endpoint for gcloud ml language command group. diff --git a/gcloud/beta/config/unset b/gcloud/beta/config/unset index 22c894275..602582124 100644 --- a/gcloud/beta/config/unset +++ b/gcloud/beta/config/unset @@ -329,6 +329,10 @@ AVAILABLE PROPERTIES ids Overrides API endpoint for gcloud ids command group. + krmapihosting + Overrides API endpoint for gcloud anthos config controller command + group. + language Overrides API endpoint for gcloud ml language command group. diff --git a/gcloud/beta/dataproc/clusters/create b/gcloud/beta/dataproc/clusters/create index 77ebf0b40..3f122d991 100644 --- a/gcloud/beta/dataproc/clusters/create +++ b/gcloud/beta/dataproc/clusters/create @@ -690,7 +690,7 @@ FLAGS --secondary-worker-type=TYPE; default="preemptible" The type of the secondary worker group. TYPE must be one of: - preemptible, non-preemptible. + preemptible, non-preemptible, spot. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/dataproc/workflow-templates/set-managed-cluster b/gcloud/beta/dataproc/workflow-templates/set-managed-cluster index cd1d9396e..d3513f337 100644 --- a/gcloud/beta/dataproc/workflow-templates/set-managed-cluster +++ b/gcloud/beta/dataproc/workflow-templates/set-managed-cluster @@ -632,7 +632,7 @@ FLAGS --secondary-worker-type=TYPE; default="preemptible" The type of the secondary worker group. TYPE must be one of: - preemptible, non-preemptible. + preemptible, non-preemptible, spot. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/functions/deploy b/gcloud/beta/functions/deploy index b1b16f2be..84b1ec74b 100644 --- a/gcloud/beta/functions/deploy +++ b/gcloud/beta/functions/deploy @@ -168,29 +168,7 @@ FLAGS Required when deploying a new function; optional when updating an existing function. - Choices: - - ◆ nodejs10: Node.js 10 - ◆ nodejs12: Node.js 12 - ◆ nodejs14: Node.js 14 - ◆ nodejs16: Node.js 16 - ◆ php74: PHP 7.4 - ◆ php81: PHP 8.1 - ◆ python37: Python 3.7 - ◆ python38: Python 3.8 - ◆ python39: Python 3.9 - ◆ python310: Python 3.10 - ◆ go111: Go 1.11 - ◆ go113: Go 1.13 - ◆ go116: Go 1.16 - ◆ java11: Java 11 - ◆ java17: Java 17 - ◆ dotnet3: .NET Framework 3 - ◆ ruby26: Ruby 2.6 - ◆ ruby27: Ruby 2.7 - ◆ ruby30: Ruby 3.0 - ◆ nodejs6: Node.js 6 (deprecated) - ◆ nodejs8: Node.js 8 (deprecated) + For a list of available runtimes, run gcloud functions runtimes list. --security-level=SECURITY_LEVEL; default="secure-always" Security level controls whether a function's URL supports HTTPS only or diff --git a/gcloud/beta/logging/buckets/create b/gcloud/beta/logging/buckets/create index 39cb4e205..4d7a9bbc3 100644 --- a/gcloud/beta/logging/buckets/create +++ b/gcloud/beta/logging/buckets/create @@ -3,7 +3,8 @@ NAME SYNOPSIS gcloud beta logging buckets create BUCKET_ID --location=LOCATION - [--description=DESCRIPTION] [--index=[KEY=VALUE, ...,...]] + [--cmek-kms-key-name=CMEK_KMS_KEY_NAME] [--description=DESCRIPTION] + [--index=[KEY=VALUE, ...,...]] [--restricted-fields=[RESTRICTED_FIELD,...]] [--retention-days=RETENTION_DAYS] [GCLOUD_WIDE_FLAG ...] @@ -31,6 +32,11 @@ EXAMPLES $ gcloud beta logging buckets create my-bucket \ --index=fieldPath=jsonPayload.foo,type=INDEX_TYPE_STRING + To create a bucket with custom CMEK, run: + + $ gcloud beta logging buckets create my-bucket \ + --location=us-central1 --cmek-kms-key-name=CMEK_KMS_KEY_NAME + POSITIONAL ARGUMENTS BUCKET_ID ID of the bucket to create. @@ -41,6 +47,9 @@ REQUIRED FLAGS location cannot be changed. OPTIONAL FLAGS + --cmek-kms-key-name=CMEK_KMS_KEY_NAME + A valid kms_key_name will enable CMEK for the bucket. + --description=DESCRIPTION A textual description for the bucket. diff --git a/gcloud/beta/logging/buckets/update b/gcloud/beta/logging/buckets/update index 4a08ad61f..9c722d965 100644 --- a/gcloud/beta/logging/buckets/update +++ b/gcloud/beta/logging/buckets/update @@ -4,8 +4,8 @@ NAME SYNOPSIS gcloud beta logging buckets update BUCKET_ID --location=LOCATION [--add-index=[KEY=VALUE, ...,...]] [--clear-indexes] - [--description=DESCRIPTION] [--locked] - [--remove-indexes=[FIELD PATH,...]] + [--cmek-kms-key-name=CMEK_KMS_KEY_NAME] [--description=DESCRIPTION] + [--locked] [--remove-indexes=[FIELD PATH,...]] [--restricted-fields=[RESTRICTED_FIELD,...]] [--retention-days=RETENTION_DAYS] [--update-index=[KEY=VALUE, ...,...]] [GCLOUD_WIDE_FLAG ...] @@ -39,6 +39,11 @@ EXAMPLES $ gcloud beta logging buckets update my-bucket --location=global \ --update-index=fieldPath=jsonPayload.foo,type=INDEX_TYPE_INTEGER + To update a bucket in your project and update existing cmek, run: + + $ gcloud beta logging buckets update my-bucket --location=global \ + --cmek-kms-key-name=CMEK_KEY_NAME + POSITIONAL ARGUMENTS BUCKET_ID The id of the bucket to update. @@ -67,6 +72,9 @@ OPTIONAL FLAGS --clear-indexes Remove all logging indexes from the bucket. + --cmek-kms-key-name=CMEK_KMS_KEY_NAME + A valid kms_key_name will enable CMEK for the bucket. + --description=DESCRIPTION A new description for the bucket. diff --git a/gcloud/beta/logging/copy b/gcloud/beta/logging/copy new file mode 100644 index 000000000..2c7af10d1 --- /dev/null +++ b/gcloud/beta/logging/copy @@ -0,0 +1,84 @@ +NAME + gcloud beta logging copy - copy log entries + +SYNOPSIS + gcloud beta logging copy BUCKET_ID DESTINATION --location=LOCATION + [--log-filter=LOG_FILTER] + [--billing-account=BILLING_ACCOUNT_ID | --folder=FOLDER_ID + | --organization=ORGANIZATION_ID | --project=PROJECT_ID] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) gcloud beta logging copy starts the process to copy log entries from + a log bucket to a destination. + +EXAMPLES + To start a copy log entries operation, run: + + $ gcloud beta logging copy \ + "BUCKET_ID DESTINATION --location=LOCATION" + + To copy log entries in a specific time window, run: + + $ gcloud beta logging copy \ + 'BUCKET_ID DESTINATION --location=LOCATION + --log-filter=timestamp<="2021-05-31T23:59:59Z" AND + timestamp>="2021-05-31T00:00:00Z"' + +POSITIONAL ARGUMENTS + BUCKET_ID + Id of the bucket to copy. + + DESTINATION + destination to which to copy logs. + +REQUIRED FLAGS + --location=LOCATION + Location of the bucket. + +OPTIONAL FLAGS + --log-filter=LOG_FILTER + A filter specifying which log entries to copy. The filter must be no + more than 20k characters. An empty filter matches all log entries. + + At most one of these can be specified: + + --billing-account=BILLING_ACCOUNT_ID + Copy log entries associated with this billing account. + + --folder=FOLDER_ID + Copy log entries associated with this folder. + + --organization=ORGANIZATION_ID + Copy log entries associated with this organization. + + --project=PROJECT_ID + Copy log entries associated with this project. + + The Google Cloud project ID to use for this invocation. If omitted, + then the current project is assumed; the current project can be + listed using gcloud config list --format='text(core.project)' and can + be set using gcloud config set project PROJECTID. + + --project and its fallback core/project property play two roles in + the invocation. It specifies the project of the resource to operate + on. It also specifies the project for API enablement check, quota, + and billing. To specify a different project for quota and billing, + use --billing-project or billing/quota_project property. + +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 logging copy + + $ gcloud alpha logging copy + diff --git a/gcloud/beta/logging/help b/gcloud/beta/logging/help index 04d69600d..4c8df9c4e 100644 --- a/gcloud/beta/logging/help +++ b/gcloud/beta/logging/help @@ -27,9 +27,15 @@ GROUPS metrics (BETA) Manages logs-based metrics. + operations + (BETA) Manage long running operations. + resource-descriptors (BETA) Get information about resource descriptors. + settings + (BETA) Manages the org settings for the Cloud Logging Logs Router. + sinks (BETA) Manages sinks used to route logs to storage or export destinations. @@ -40,6 +46,9 @@ GROUPS COMMANDS COMMAND is one of the following: + copy + (BETA) Copy log entries. + read (BETA) Read log entries. diff --git a/gcloud/beta/logging/metrics/create b/gcloud/beta/logging/metrics/create index 410c14ab1..c5d5e12e7 100644 --- a/gcloud/beta/logging/metrics/create +++ b/gcloud/beta/logging/metrics/create @@ -4,8 +4,8 @@ NAME SYNOPSIS gcloud beta logging metrics create METRIC_NAME (--config-from-file=CONFIG_FROM_FILE - | --description=DESCRIPTION --log-filter=LOG_FILTER) - [GCLOUD_WIDE_FLAG ...] + | [--description=DESCRIPTION --log-filter=LOG_FILTER + : --bucket-name=BUCKET_NAME]) [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Creates a logs-based metric to count the number of log entries that @@ -33,6 +33,12 @@ EXAMPLES how to configure metrics can be found at: https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.metrics#LogMetric. + To create a bucket log-based metric, run: + + $ gcloud beta logging metrics create my_bucket_metric \ + --description="DESCRIPTION" --log-filter="LOG_FILTER" \ + --bucket-name="BUCKET_NAME" + POSITIONAL ARGUMENTS METRIC_NAME The name of the new metric. @@ -60,6 +66,9 @@ REQUIRED FLAGS This flag argument must be specified if any of the other arguments in this group are specified. + --bucket-name=BUCKET_NAME + The Log Bucket name which owns the log-based metric. + 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/logging/metrics/update b/gcloud/beta/logging/metrics/update index b988b5efb..a6a6ec7d4 100644 --- a/gcloud/beta/logging/metrics/update +++ b/gcloud/beta/logging/metrics/update @@ -4,8 +4,8 @@ NAME SYNOPSIS gcloud beta logging metrics update METRIC_NAME - (--config-from-file=CONFIG_FROM_FILE - | --description=DESCRIPTION --log-filter=LOG_FILTER) + (--config-from-file=CONFIG_FROM_FILE | --bucket-name=BUCKET_NAME + --description=DESCRIPTION --log-filter=LOG_FILTER) [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -38,6 +38,11 @@ EXAMPLES Any top-level fields in the LogMetric definition that aren't specified in the config file will not be updated in the metric. + To update the bucket associated with a bucket log-based metric, run: + + $ gcloud beta logging metrics update my-bucket-metric \ + --bucket-name="NEW_BUCKET_NAME" + POSITIONAL ARGUMENTS METRIC_NAME The name of the log-based metric to update. @@ -54,6 +59,9 @@ REQUIRED FLAGS Arguments to specify information about simple counter logs-based metrics. + --bucket-name=BUCKET_NAME + The Log Bucket name which owns the log-based metric. + --description=DESCRIPTION A new description for the metric. If omitted, the description is not changed. diff --git a/gcloud/beta/logging/operations/cancel b/gcloud/beta/logging/operations/cancel new file mode 100644 index 000000000..a2d16c85f --- /dev/null +++ b/gcloud/beta/logging/operations/cancel @@ -0,0 +1,70 @@ +NAME + gcloud beta logging operations cancel - cancel a long running operation + +SYNOPSIS + gcloud beta logging operations cancel OPERATION_ID --location=LOCATION + [--billing-account=BILLING_ACCOUNT_ID | --folder=FOLDER_ID + | --organization=ORGANIZATION_ID | --project=PROJECT_ID] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Cancel a long running operation with given OPERATION_ID in given + LOCATION. This operation can be a copy_log_entries operation which is + scheduled before. + +EXAMPLES + To cancel an operation, run: + + $ gcloud beta logging operations cancel OPERATION_ID \ + --location=LOCATION + +POSITIONAL ARGUMENTS + OPERATION_ID + The Id of the operation. + +REQUIRED FLAGS + --location=LOCATION + Location of the operation. + +OPTIONAL FLAGS + At most one of these can be specified: + + --billing-account=BILLING_ACCOUNT_ID + Cancel operation associated with this billing account. + + --folder=FOLDER_ID + Cancel operation associated with this folder. + + --organization=ORGANIZATION_ID + Cancel operation associated with this organization. + + --project=PROJECT_ID + Cancel operation associated with this project. + + The Google Cloud project ID to use for this invocation. If omitted, + then the current project is assumed; the current project can be + listed using gcloud config list --format='text(core.project)' and can + be set using gcloud config set project PROJECTID. + + --project and its fallback core/project property play two roles in + the invocation. It specifies the project of the resource to operate + on. It also specifies the project for API enablement check, quota, + and billing. To specify a different project for quota and billing, + use --billing-project or billing/quota_project property. + +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 logging operations cancel + + $ gcloud alpha logging operations cancel + diff --git a/gcloud/beta/logging/operations/describe b/gcloud/beta/logging/operations/describe new file mode 100644 index 000000000..5faea5dec --- /dev/null +++ b/gcloud/beta/logging/operations/describe @@ -0,0 +1,71 @@ +NAME + gcloud beta logging operations describe - describe a long running operation + +SYNOPSIS + gcloud beta logging operations describe OPERATION_ID --location=LOCATION + [--billing-account=BILLING_ACCOUNT_ID | --folder=FOLDER_ID + | --organization=ORGANIZATION_ID | --project=PROJECT_ID] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Describe a long running operation which was scheduled before. For + example, a copy_log_entries operation scheduled by command: "gcloud alpha + logging copy BUCKET_ID DESTINATION --location=LOCATION" OPERATION_ID and + LOCATION are required to locate such operation. + +EXAMPLES + To describe an operation, run: + + $ gcloud beta logging operations describe OPERATION_ID \ + --location=LOCATION + +POSITIONAL ARGUMENTS + OPERATION_ID + The Id of the operation. + +REQUIRED FLAGS + --location=LOCATION + Location of the operation. + +OPTIONAL FLAGS + At most one of these can be specified: + + --billing-account=BILLING_ACCOUNT_ID + Describe operation associated with this billing account. + + --folder=FOLDER_ID + Describe operation associated with this folder. + + --organization=ORGANIZATION_ID + Describe operation associated with this organization. + + --project=PROJECT_ID + Describe operation associated with this project. + + The Google Cloud project ID to use for this invocation. If omitted, + then the current project is assumed; the current project can be + listed using gcloud config list --format='text(core.project)' and can + be set using gcloud config set project PROJECTID. + + --project and its fallback core/project property play two roles in + the invocation. It specifies the project of the resource to operate + on. It also specifies the project for API enablement check, quota, + and billing. To specify a different project for quota and billing, + use --billing-project or billing/quota_project property. + +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 logging operations describe + + $ gcloud alpha logging operations describe + diff --git a/gcloud/beta/logging/operations/help b/gcloud/beta/logging/operations/help new file mode 100644 index 000000000..ebdbcb629 --- /dev/null +++ b/gcloud/beta/logging/operations/help @@ -0,0 +1,34 @@ +NAME + gcloud beta logging operations - manage long running operations + +SYNOPSIS + gcloud beta logging operations COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Manage long running operations. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + cancel + (BETA) Cancel a long running operation. + + describe + (BETA) Describe a long running operation. + + list + (BETA) List long running operations. + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud logging operations + + $ gcloud alpha logging operations + diff --git a/gcloud/beta/logging/operations/list b/gcloud/beta/logging/operations/list new file mode 100644 index 000000000..0bf1a4171 --- /dev/null +++ b/gcloud/beta/logging/operations/list @@ -0,0 +1,121 @@ +NAME + gcloud beta logging operations list - list long running operations + +SYNOPSIS + gcloud beta logging operations list --location=LOCATION + --operation-filter=OPERATION_FILTER + [--billing-account=BILLING_ACCOUNT_ID | --folder=FOLDER_ID + | --organization=ORGANIZATION_ID | --project=PROJECT_ID] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Return a list of long running operation details in given LOCATION. + The operations were scheduled by other gcloud commands. For example: a + copy_log_entries operation scheduled by command: gcloud alpha logging + operations copy BUCKET_ID DESTINATION --location=LOCATION. Note: while + listing the operations, the request_type must be specified in filter. + Example: --operation-filter=request_type=CopyLogEntries, Supported + operation types are: CopyLogEntries, CreateBucket and UpdateBucket. Other + supported filter expression are: operation_start_time, + operation_finish_time and operation_state. + +EXAMPLES + To list CopyLogEntries operations, run: + + $ gcloud beta logging operations list --location=LOCATION \ + --operation-filter=request_type=CopyLogEntries + + To list CopyLogEntries operations that started after a specified time, run: + + $ gcloud beta logging operations list --location=LOCATION \ + --operation-filter=request_type=CopyLogEntries AND \ + operation_start_time>TIMESTAMP + + To list CopyLogEntries operations that finished before a specified time, + run: + + $ gcloud beta logging operations list --location=LOCATION \ + --operation-filter=request_type=CopyLogEntries AND \ + operation_finish_time.cloudbuild-logs.googleusercontent.com/ is created diff --git a/gcloud/compute/instances/create b/gcloud/compute/instances/create index 7f5bbb44e..c36a23025 100644 --- a/gcloud/compute/instances/create +++ b/gcloud/compute/instances/create @@ -27,7 +27,8 @@ SYNOPSIS [--min-cpu-platform=PLATFORM] [--min-node-cpu=MIN_NODE_CPU] [--network=NETWORK] [--network-interface=[PROPERTY=VALUE,...]] [--network-performance-configs=[PROPERTY=VALUE,...]] - [--network-tier=NETWORK_TIER] [--preemptible] + [--network-tier=NETWORK_TIER] [--node-project=NODE_PROJECT] + [--preemptible] [--private-ipv6-google-access-type=PRIVATE_IPV6_GOOGLE_ACCESS_TYPE] [--private-network-ip=PRIVATE_NETWORK_IP] [--provisioning-model=PROVISIONING_MODEL] @@ -624,6 +625,10 @@ FLAGS NETWORK_TIER must be one of: PREMIUM, STANDARD, FIXED_STANDARD. The default value is PREMIUM. + --node-project=NODE_PROJECT + The name of the project with shared sole tenant node groups to create + an instance in. + --preemptible If provided, instances will be preemptible and time-limited. Instances might be preempted to free up resources for standard VM instances, and diff --git a/gcloud/compute/instances/import b/gcloud/compute/instances/import index f73c7107a..fce32c8af 100644 --- a/gcloud/compute/instances/import +++ b/gcloud/compute/instances/import @@ -7,10 +7,10 @@ SYNOPSIS [--no-address] [--async] [--byol] [--can-ip-forward] [--compute-service-account=COMPUTE_SERVICE_ACCOUNT] [--deletion-protection] [--description=DESCRIPTION] - [--no-guest-environment] [--hostname=HOSTNAME] - [--labels=[KEY=VALUE,...]] [--log-location=LOG_LOCATION] - [--machine-type=MACHINE_TYPE] [--network=NETWORK] - [--network-tier=NETWORK_TIER] [--os=OS] + [--no-guest-environment] [--guest-os-features=[GUEST_OS_FEATURE,...]] + [--hostname=HOSTNAME] [--labels=[KEY=VALUE,...]] + [--log-location=LOG_LOCATION] [--machine-type=MACHINE_TYPE] + [--network=NETWORK] [--network-tier=NETWORK_TIER] [--os=OS] [--private-network-ip=PRIVATE_NETWORK_IP] [--no-restart-on-failure] [--subnet=SUBNET] [--tags=TAG,[TAG,...]] [--timeout=TIMEOUT; default="2h"] [--zone=ZONE] @@ -120,6 +120,13 @@ OPTIONAL FLAGS The guest environment will be installed on the instance. Enabled by default, use --no-guest-environment to disable. + --guest-os-features=[GUEST_OS_FEATURE,...] + This parameter enables one or more features for VM instances that use + the image for their boot disks. See + https://cloud.google.com/compute/docs/images/create-delete-deprecate-private-images#guest-os-features + for descriptions of the supported features. GUEST_OS_FEATURE must be + (currently only one value is supported): UEFI_COMPATIBLE. + --hostname=HOSTNAME Specify the hostname of the VM instance to be imported. The specified hostname must be RFC1035 compliant. If hostname is not specified, the diff --git a/gcloud/compute/machine-images/import b/gcloud/compute/machine-images/import index 4457d9cec..30a35bbf4 100644 --- a/gcloud/compute/machine-images/import +++ b/gcloud/compute/machine-images/import @@ -7,10 +7,11 @@ SYNOPSIS [--no-address] [--async] [--byol] [--can-ip-forward] [--compute-service-account=COMPUTE_SERVICE_ACCOUNT] [--description=DESCRIPTION] [--no-guest-environment] [--guest-flush] - [--labels=[KEY=VALUE,...]] [--log-location=LOG_LOCATION] - [--machine-type=MACHINE_TYPE] [--network=NETWORK] - [--network-tier=NETWORK_TIER] [--os=OS] [--no-restart-on-failure] - [--storage-location=LOCATION] [--subnet=SUBNET] [--tags=TAG,[TAG,...]] + [--guest-os-features=[GUEST_OS_FEATURE,...]] [--labels=[KEY=VALUE,...]] + [--log-location=LOG_LOCATION] [--machine-type=MACHINE_TYPE] + [--network=NETWORK] [--network-tier=NETWORK_TIER] [--os=OS] + [--no-restart-on-failure] [--storage-location=LOCATION] + [--subnet=SUBNET] [--tags=TAG,[TAG,...]] [--timeout=TIMEOUT; default="2h"] [--zone=ZONE] [--custom-cpu=CUSTOM_CPU --custom-memory=CUSTOM_MEMORY : --custom-extensions --custom-vm-type=CUSTOM_VM_TYPE] @@ -119,6 +120,13 @@ OPTIONAL FLAGS Create an application-consistent machine image by informing the OS to prepare for the snapshot process. + --guest-os-features=[GUEST_OS_FEATURE,...] + This parameter enables one or more features for VM instances that use + the image for their boot disks. See + https://cloud.google.com/compute/docs/images/create-delete-deprecate-private-images#guest-os-features + for descriptions of the supported features. GUEST_OS_FEATURE must be + (currently only one value is supported): UEFI_COMPATIBLE. + --labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to add. diff --git a/gcloud/compute/security-policies/update b/gcloud/compute/security-policies/update index bf7664eb7..f3cd066de 100644 --- a/gcloud/compute/security-policies/update +++ b/gcloud/compute/security-policies/update @@ -4,7 +4,9 @@ NAME SYNOPSIS gcloud compute security-policies update NAME [--description=DESCRIPTION] - [--enable-layer7-ddos-defense] [--json-parsing=JSON_PARSING] + [--enable-layer7-ddos-defense] + [--json-custom-content-types=[CONTENT_TYPE,...]] + [--json-parsing=JSON_PARSING] [--layer7-ddos-defense-rule-visibility=VISIBILITY_TYPE] [--log-level=LOG_LEVEL] [--recaptcha-redirect-site-key=RECAPTCHA_REDIRECT_SITE_KEY] @@ -31,6 +33,13 @@ FLAGS --enable-layer7-ddos-defense Whether to enable Cloud Armor Layer 7 DDoS Defense Adaptive Protection. + --json-custom-content-types=[CONTENT_TYPE,...] + A comma-separated list of custom Content-Type header values to apply + JSON parsing for preconfigured WAF rules. Only applicable when JSON + parsing is enabled, like --json-parsing=STANDARD. When configuring a + Content-Type header value, only the type/subtype needs to be specified, + and the parameters should be excluded. + --json-parsing=JSON_PARSING The JSON parsing behavior for this rule. Must be one of the following values: [DISABLED, STANDARD]. JSON_PARSING must be one of: DISABLED, diff --git a/gcloud/compute/snapshots/create b/gcloud/compute/snapshots/create index 67ed060ae..aeb8472e7 100644 --- a/gcloud/compute/snapshots/create +++ b/gcloud/compute/snapshots/create @@ -4,8 +4,9 @@ NAME SYNOPSIS gcloud compute snapshots create NAME [--async] [--chain-name=CHAIN_NAME] [--csek-key-file=FILE] [--description=DESCRIPTION] [--guest-flush] - [--labels=[KEY=VALUE,...]] [--source-disk=SOURCE_DISK] - [--source-disk-key-file=FILE] [--storage-location=LOCATION] + [--labels=[KEY=VALUE,...]] [--snapshot-type=SNAPSHOT_TYPE] + [--source-disk=SOURCE_DISK] [--source-disk-key-file=FILE] + [--storage-location=LOCATION] [--source-disk-region=SOURCE_DISK_REGION | --source-disk-zone=SOURCE_DISK_ZONE] [GCLOUD_WIDE_FLAG ...] @@ -64,6 +65,11 @@ FLAGS contain only hyphens (-), underscores (_), lowercase characters, and numbers. + --snapshot-type=SNAPSHOT_TYPE + Type of snapshot. If a snapshot type is not specified, a STANDARD + snapshot will be created. SNAPSHOT_TYPE must be one of: ARCHIVE, + STANDARD. + --source-disk=SOURCE_DISK Source disk used to create the snapshot. To create a snapshot from a source disk in a different project, specify the full path to the source diff --git a/gcloud/compute/sole-tenancy/node-groups/create b/gcloud/compute/sole-tenancy/node-groups/create index eb4d6ed27..5227de40f 100644 --- a/gcloud/compute/sole-tenancy/node-groups/create +++ b/gcloud/compute/sole-tenancy/node-groups/create @@ -8,7 +8,9 @@ SYNOPSIS [--description=DESCRIPTION] [--maintenance-policy=MAINTENANCE_POLICY] [--maintenance-window-start-time=START_TIME] [--zone=ZONE] [--autoscaler-mode=AUTOSCALER_MODE - : --max-nodes=MAX_NODES --min-nodes=MIN_NODES] [GCLOUD_WIDE_FLAG ...] + : --max-nodes=MAX_NODES --min-nodes=MIN_NODES] + [--share-setting=SHARE_SETTING : --share-with=PROJECT,[PROJECT,...]] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION Create a Compute Engine node group. @@ -100,6 +102,19 @@ OPTIONAL FLAGS The minimum size of the node group. Default is 0 and must be an integer value smaller than or equal to --max-nodes. + Manage the properties of a shared setting + + --share-setting=SHARE_SETTING + Specify if this node group is shared; and if so, the type of sharing: + share with specific projects or folders. SHARE_SETTING must be one + of: projects, organization, local. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --share-with=PROJECT,[PROJECT,...] + A list of specific projects this node group should be shared with. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/compute/sole-tenancy/node-groups/list b/gcloud/compute/sole-tenancy/node-groups/list index a1d04aae9..45f8671d2 100644 --- a/gcloud/compute/sole-tenancy/node-groups/list +++ b/gcloud/compute/sole-tenancy/node-groups/list @@ -3,9 +3,9 @@ NAME node groups SYNOPSIS - gcloud compute sole-tenancy node-groups list [--filter=EXPRESSION] - [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] - [GCLOUD_WIDE_FLAG ...] + gcloud compute sole-tenancy node-groups list [--share-settings] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION gcloud compute sole-tenancy node-groups list displays all Google Compute @@ -28,6 +28,10 @@ EXAMPLES $ gcloud compute sole-tenancy node-groups list \ --filter="region:( us-central1 europe-west1 )" +FLAGS + --share-settings + If provided, shows details for the share setting + LIST COMMAND FLAGS --filter=EXPRESSION Apply a Boolean filter EXPRESSION to each resource item to be listed. diff --git a/gcloud/compute/sole-tenancy/node-groups/update b/gcloud/compute/sole-tenancy/node-groups/update index 5be70539d..5f1920c1a 100644 --- a/gcloud/compute/sole-tenancy/node-groups/update +++ b/gcloud/compute/sole-tenancy/node-groups/update @@ -7,7 +7,9 @@ SYNOPSIS [--node-template=NODE_TEMPLATE] [--zone=ZONE] [--add-nodes=ADD_NODES | --delete-nodes=[NODE,...]] [--autoscaler-mode=AUTOSCALER_MODE - --max-nodes=MAX_NODES --min-nodes=MIN_NODES] [GCLOUD_WIDE_FLAG ...] + --max-nodes=MAX_NODES --min-nodes=MIN_NODES] + [--share-setting=SHARE_SETTING : --share-with=PROJECT,[PROJECT,...]] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION Update a Compute Engine node group. @@ -77,6 +79,19 @@ FLAGS The minimum size of the node group. Default is 0 and must be an integer value smaller than or equal to --max-nodes. + Manage the properties of a shared setting + + --share-setting=SHARE_SETTING + Specify if this node group is shared; and if so, the type of sharing: + share with specific projects or folders. SHARE_SETTING must be one + of: projects, organization, local. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --share-with=PROJECT,[PROJECT,...] + A list of specific projects this node group should be shared with. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/config/get b/gcloud/config/get index 1264632f9..18e65d85c 100644 --- a/gcloud/config/get +++ b/gcloud/config/get @@ -321,6 +321,10 @@ AVAILABLE PROPERTIES ids Overrides API endpoint for gcloud ids command group. + krmapihosting + Overrides API endpoint for gcloud anthos config controller command + group. + language Overrides API endpoint for gcloud ml language command group. diff --git a/gcloud/config/help b/gcloud/config/help index 29f3403b4..f6724d033 100644 --- a/gcloud/config/help +++ b/gcloud/config/help @@ -353,6 +353,10 @@ AVAILABLE PROPERTIES ids Overrides API endpoint for gcloud ids command group. + krmapihosting + Overrides API endpoint for gcloud anthos config controller command + group. + language Overrides API endpoint for gcloud ml language command group. diff --git a/gcloud/config/list b/gcloud/config/list index 0e24e4840..cd28b33fc 100644 --- a/gcloud/config/list +++ b/gcloud/config/list @@ -358,6 +358,10 @@ AVAILABLE PROPERTIES ids Overrides API endpoint for gcloud ids command group. + krmapihosting + Overrides API endpoint for gcloud anthos config controller command + group. + language Overrides API endpoint for gcloud ml language command group. diff --git a/gcloud/config/set b/gcloud/config/set index 61b853cc1..90dc82748 100644 --- a/gcloud/config/set +++ b/gcloud/config/set @@ -368,6 +368,10 @@ AVAILABLE PROPERTIES ids Overrides API endpoint for gcloud ids command group. + krmapihosting + Overrides API endpoint for gcloud anthos config controller command + group. + language Overrides API endpoint for gcloud ml language command group. diff --git a/gcloud/config/unset b/gcloud/config/unset index cb7dc3251..16317ad0b 100644 --- a/gcloud/config/unset +++ b/gcloud/config/unset @@ -329,6 +329,10 @@ AVAILABLE PROPERTIES ids Overrides API endpoint for gcloud ids command group. + krmapihosting + Overrides API endpoint for gcloud anthos config controller command + group. + language Overrides API endpoint for gcloud ml language command group. diff --git a/gcloud/container/aws/clusters/update b/gcloud/container/aws/clusters/update index 105da4a84..d1203ee0f 100644 --- a/gcloud/container/aws/clusters/update +++ b/gcloud/container/aws/clusters/update @@ -13,6 +13,8 @@ SYNOPSIS [--root-volume-kms-key-arn=ROOT_VOLUME_KMS_KEY_ARN] [--root-volume-size=ROOT_VOLUME_SIZE] [--root-volume-type=ROOT_VOLUME_TYPE] [--validate-only] + [--annotations=ANNOTATION,[ANNOTATION,...] | --clear-annotations] + [--clear-description | --description=DESCRIPTION] [--clear-proxy-config | --proxy-secret-arn=PROXY_SECRET_ARN --proxy-secret-version-id=PROXY_SECRET_VERSION_ID] [--clear-security-group-ids @@ -102,6 +104,26 @@ FLAGS --validate-only Validate the update of the cluster, but don't actually perform it. + Annotations + + At most one of these can be specified: + + --annotations=ANNOTATION,[ANNOTATION,...] + Annotations for the cluster. + + --clear-annotations + Clear the annotations for the cluster. + + Description + + At most one of these can be specified: + + --clear-description + Clear the description for the cluster. + + --description=DESCRIPTION + Description for the cluster. + Proxy config At most one of these can be specified: diff --git a/gcloud/container/azure/clusters/create b/gcloud/container/azure/clusters/create index 1c2bd842d..563bfd4a7 100644 --- a/gcloud/container/azure/clusters/create +++ b/gcloud/container/azure/clusters/create @@ -9,11 +9,12 @@ SYNOPSIS --resource-group-id=RESOURCE_GROUP_ID --service-address-cidr-blocks=SERVICE_ADDRESS_CIDR_BLOCKS --ssh-public-key=SSH_PUBLIC_KEY --vnet-id=VNET_ID - [--admin-users=USER,[USER,...]] [--async] + [--admin-users=USER,[USER,...]] + [--annotations=ANNOTATION,[ANNOTATION,...]] [--async] [--config-encryption-key-id=CONFIG_ENCRYPTION_KEY_ID] [--config-encryption-public-key=CONFIG_ENCRYPTION_PUBLIC_KEY] [--database-encryption-key-id=DATABASE_ENCRYPTION_KEY_ID] - [--endpoint-subnet-id=ENDPOINT_SUBNET_ID] + [--description=DESCRIPTION] [--endpoint-subnet-id=ENDPOINT_SUBNET_ID] [--main-volume-size=MAIN_VOLUME_SIZE] [--replica-placements=[REPLICA_PLACEMENT,...]] [--root-volume-size=ROOT_VOLUME_SIZE] @@ -117,6 +118,9 @@ OPTIONAL FLAGS Users that can perform operations as a cluster administrator. If not specified, the value of property core/account is used. + --annotations=ANNOTATION,[ANNOTATION,...] + Annotations for the cluster. + --async Return immediately, without waiting for the operation in progress to complete. @@ -133,6 +137,9 @@ OPTIONAL FLAGS URL the of the Azure Key Vault key (with its version) to use to encrypt / decrypt cluster secrets. + --description=DESCRIPTION + Description for the cluster. + --endpoint-subnet-id=ENDPOINT_SUBNET_ID ARM ID of the subnet where the control plane load balancer is deployed. When unspecified, it defaults to the control plane subnet ID. diff --git a/gcloud/container/azure/clusters/update b/gcloud/container/azure/clusters/update index 89dc586b8..4b7a556fc 100644 --- a/gcloud/container/azure/clusters/update +++ b/gcloud/container/azure/clusters/update @@ -5,7 +5,10 @@ SYNOPSIS gcloud container azure clusters update (CLUSTER : --location=LOCATION) --client=CLIENT [--admin-users=USER,[USER,...]] [--async] [--cluster-version=CLUSTER_VERSION] [--ssh-public-key=SSH_PUBLIC_KEY] - [--validate-only] [--vm-size=VM_SIZE] [GCLOUD_WIDE_FLAG ...] + [--validate-only] [--vm-size=VM_SIZE] + [--annotations=ANNOTATION,[ANNOTATION,...] | --clear-annotations] + [--clear-description | --description=DESCRIPTION] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION Update an Anthos cluster on Azure. @@ -81,6 +84,26 @@ FLAGS --vm-size=VM_SIZE Azure Virtual Machine Size (e.g. Standard_DS1_v). + Annotations + + At most one of these can be specified: + + --annotations=ANNOTATION,[ANNOTATION,...] + Annotations for the cluster. + + --clear-annotations + Clear the annotations for the cluster. + + Description + + At most one of these can be specified: + + --clear-description + Clear the description for the cluster. + + --description=DESCRIPTION + Description for the cluster. + 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/dataproc/clusters/create b/gcloud/dataproc/clusters/create index 139b39034..725ac7b3a 100644 --- a/gcloud/dataproc/clusters/create +++ b/gcloud/dataproc/clusters/create @@ -752,7 +752,7 @@ FLAGS --secondary-worker-type=TYPE; default="preemptible" The type of the secondary worker group. TYPE must be one of: - preemptible, non-preemptible. + preemptible, non-preemptible, spot. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/dataproc/workflow-templates/set-managed-cluster b/gcloud/dataproc/workflow-templates/set-managed-cluster index dda8cec2f..e6ba29453 100644 --- a/gcloud/dataproc/workflow-templates/set-managed-cluster +++ b/gcloud/dataproc/workflow-templates/set-managed-cluster @@ -686,7 +686,7 @@ FLAGS --secondary-worker-type=TYPE; default="preemptible" The type of the secondary worker group. TYPE must be one of: - preemptible, non-preemptible. + preemptible, non-preemptible, spot. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/edge-cloud/container/vpn-connections/create b/gcloud/edge-cloud/container/vpn-connections/create index d3563db1f..bb5554cd1 100644 --- a/gcloud/edge-cloud/container/vpn-connections/create +++ b/gcloud/edge-cloud/container/vpn-connections/create @@ -55,7 +55,9 @@ REQUIRED FLAGS The name of the cluster to be connected under current project. --vpc-network=VPC_NETWORK - The name of the {vpc_name_short} to be connected under current project. + The name of the VPC network to be connected. By default it is assumed + to be under the same project as cluster. If this VPC network is under a + different project, vpc-project and vpc-service-account are required. OPTIONAL FLAGS --async @@ -76,8 +78,8 @@ OPTIONAL FLAGS numbers. --nat-gateway-ip=NAT_GATEWAY_IP - The NAT gateway IP for the gateway floating IPs. Do not specify this if - no NAT is used. + The NAT gateway IP for the gateway floating IPs. Required if cluster + sits behind NAT. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/functions/deploy b/gcloud/functions/deploy index 301d10df2..f45bc8fe5 100644 --- a/gcloud/functions/deploy +++ b/gcloud/functions/deploy @@ -159,29 +159,7 @@ FLAGS Required when deploying a new function; optional when updating an existing function. - Choices: - - ◆ nodejs10: Node.js 10 - ◆ nodejs12: Node.js 12 - ◆ nodejs14: Node.js 14 - ◆ nodejs16: Node.js 16 - ◆ php74: PHP 7.4 - ◆ php81: PHP 8.1 - ◆ python37: Python 3.7 - ◆ python38: Python 3.8 - ◆ python39: Python 3.9 - ◆ python310: Python 3.10 - ◆ go111: Go 1.11 - ◆ go113: Go 1.13 - ◆ go116: Go 1.16 - ◆ java11: Java 11 - ◆ java17: Java 17 - ◆ dotnet3: .NET Framework 3 - ◆ ruby26: Ruby 2.6 - ◆ ruby27: Ruby 2.7 - ◆ ruby30: Ruby 3.0 - ◆ nodejs6: Node.js 6 (deprecated) - ◆ nodejs8: Node.js 8 (deprecated) + For a list of available runtimes, run gcloud functions runtimes list. --security-level=SECURITY_LEVEL; default="secure-always" Security level controls whether a function's URL supports HTTPS only or diff --git a/gcloud/logging/buckets/create b/gcloud/logging/buckets/create index f19994b9c..73eb797c1 100644 --- a/gcloud/logging/buckets/create +++ b/gcloud/logging/buckets/create @@ -3,7 +3,8 @@ NAME SYNOPSIS gcloud logging buckets create BUCKET_ID --location=LOCATION - [--description=DESCRIPTION] [--index=[KEY=VALUE, ...,...]] + [--cmek-kms-key-name=CMEK_KMS_KEY_NAME] [--description=DESCRIPTION] + [--index=[KEY=VALUE, ...,...]] [--restricted-fields=[RESTRICTED_FIELD,...]] [--retention-days=RETENTION_DAYS] [GCLOUD_WIDE_FLAG ...] @@ -30,6 +31,11 @@ EXAMPLES $ gcloud logging buckets create my-bucket \ --index=fieldPath=jsonPayload.foo,type=INDEX_TYPE_STRING + To create a bucket with custom CMEK, run: + + $ gcloud logging buckets create my-bucket --location=us-central1 \ + --cmek-kms-key-name=CMEK_KMS_KEY_NAME + POSITIONAL ARGUMENTS BUCKET_ID ID of the bucket to create. @@ -40,6 +46,9 @@ REQUIRED FLAGS location cannot be changed. OPTIONAL FLAGS + --cmek-kms-key-name=CMEK_KMS_KEY_NAME + A valid kms_key_name will enable CMEK for the bucket. + --description=DESCRIPTION A textual description for the bucket. diff --git a/gcloud/logging/buckets/update b/gcloud/logging/buckets/update index 1899cff18..ee9be022d 100644 --- a/gcloud/logging/buckets/update +++ b/gcloud/logging/buckets/update @@ -4,8 +4,8 @@ NAME SYNOPSIS gcloud logging buckets update BUCKET_ID --location=LOCATION [--add-index=[KEY=VALUE, ...,...]] [--clear-indexes] - [--description=DESCRIPTION] [--locked] - [--remove-indexes=[FIELD PATH,...]] + [--cmek-kms-key-name=CMEK_KMS_KEY_NAME] [--description=DESCRIPTION] + [--locked] [--remove-indexes=[FIELD PATH,...]] [--restricted-fields=[RESTRICTED_FIELD,...]] [--retention-days=RETENTION_DAYS] [--update-index=[KEY=VALUE, ...,...]] [GCLOUD_WIDE_FLAG ...] @@ -39,6 +39,11 @@ EXAMPLES $ gcloud logging buckets update my-bucket --location=global \ --update-index=fieldPath=jsonPayload.foo,type=INDEX_TYPE_INTEGER + To update a bucket in your project and update existing cmek, run: + + $ gcloud logging buckets update my-bucket --location=global \ + --cmek-kms-key-name=CMEK_KEY_NAME + POSITIONAL ARGUMENTS BUCKET_ID The id of the bucket to update. @@ -67,6 +72,9 @@ OPTIONAL FLAGS --clear-indexes Remove all logging indexes from the bucket. + --cmek-kms-key-name=CMEK_KMS_KEY_NAME + A valid kms_key_name will enable CMEK for the bucket. + --description=DESCRIPTION A new description for the bucket. diff --git a/gcloud/logging/copy b/gcloud/logging/copy new file mode 100644 index 000000000..bca1786b1 --- /dev/null +++ b/gcloud/logging/copy @@ -0,0 +1,82 @@ +NAME + gcloud logging copy - copy log entries + +SYNOPSIS + gcloud logging copy BUCKET_ID DESTINATION --location=LOCATION + [--log-filter=LOG_FILTER] + [--billing-account=BILLING_ACCOUNT_ID | --folder=FOLDER_ID + | --organization=ORGANIZATION_ID | --project=PROJECT_ID] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + gcloud logging copy starts the process to copy log entries from a log + bucket to a destination. + +EXAMPLES + To start a copy log entries operation, run: + + $ gcloud logging copy "BUCKET_ID DESTINATION --location=LOCATION" + + To copy log entries in a specific time window, run: + + $ gcloud logging copy \ + 'BUCKET_ID DESTINATION --location=LOCATION + --log-filter=timestamp<="2021-05-31T23:59:59Z" AND + timestamp>="2021-05-31T00:00:00Z"' + +POSITIONAL ARGUMENTS + BUCKET_ID + Id of the bucket to copy. + + DESTINATION + destination to which to copy logs. + +REQUIRED FLAGS + --location=LOCATION + Location of the bucket. + +OPTIONAL FLAGS + --log-filter=LOG_FILTER + A filter specifying which log entries to copy. The filter must be no + more than 20k characters. An empty filter matches all log entries. + + At most one of these can be specified: + + --billing-account=BILLING_ACCOUNT_ID + Copy log entries associated with this billing account. + + --folder=FOLDER_ID + Copy log entries associated with this folder. + + --organization=ORGANIZATION_ID + Copy log entries associated with this organization. + + --project=PROJECT_ID + Copy log entries associated with this project. + + The Google Cloud project ID to use for this invocation. If omitted, + then the current project is assumed; the current project can be + listed using gcloud config list --format='text(core.project)' and can + be set using gcloud config set project PROJECTID. + + --project and its fallback core/project property play two roles in + the invocation. It specifies the project of the resource to operate + on. It also specifies the project for API enablement check, quota, + and billing. To specify a different project for quota and billing, + use --billing-project or billing/quota_project property. + +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 logging copy + + $ gcloud beta logging copy + diff --git a/gcloud/logging/help b/gcloud/logging/help index 0251f6813..df2463ea9 100644 --- a/gcloud/logging/help +++ b/gcloud/logging/help @@ -27,9 +27,15 @@ GROUPS metrics Manages logs-based metrics. + operations + Manage long running operations. + resource-descriptors Get information about resource descriptors. + settings + Manages the org settings for the Cloud Logging Logs Router. + sinks Manages sinks used to route logs to storage or export destinations. @@ -39,6 +45,9 @@ GROUPS COMMANDS COMMAND is one of the following: + copy + Copy log entries. + read Read log entries. diff --git a/gcloud/logging/metrics/create b/gcloud/logging/metrics/create index 51a4e2d1e..4d4fedadd 100644 --- a/gcloud/logging/metrics/create +++ b/gcloud/logging/metrics/create @@ -4,8 +4,8 @@ NAME SYNOPSIS gcloud logging metrics create METRIC_NAME (--config-from-file=CONFIG_FROM_FILE - | --description=DESCRIPTION --log-filter=LOG_FILTER) - [GCLOUD_WIDE_FLAG ...] + | [--description=DESCRIPTION --log-filter=LOG_FILTER + : --bucket-name=BUCKET_NAME]) [GCLOUD_WIDE_FLAG ...] DESCRIPTION Creates a logs-based metric to count the number of log entries that match a @@ -33,6 +33,12 @@ EXAMPLES how to configure metrics can be found at: https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.metrics#LogMetric. + To create a bucket log-based metric, run: + + $ gcloud logging metrics create my_bucket_metric \ + --description="DESCRIPTION" --log-filter="LOG_FILTER" \ + --bucket-name="BUCKET_NAME" + POSITIONAL ARGUMENTS METRIC_NAME The name of the new metric. @@ -60,6 +66,9 @@ REQUIRED FLAGS This flag argument must be specified if any of the other arguments in this group are specified. + --bucket-name=BUCKET_NAME + The Log Bucket name which owns the log-based metric. + 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/logging/metrics/update b/gcloud/logging/metrics/update index 3d13363e5..e5a9041ca 100644 --- a/gcloud/logging/metrics/update +++ b/gcloud/logging/metrics/update @@ -4,8 +4,8 @@ NAME SYNOPSIS gcloud logging metrics update METRIC_NAME - (--config-from-file=CONFIG_FROM_FILE - | --description=DESCRIPTION --log-filter=LOG_FILTER) + (--config-from-file=CONFIG_FROM_FILE | --bucket-name=BUCKET_NAME + --description=DESCRIPTION --log-filter=LOG_FILTER) [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -38,6 +38,11 @@ EXAMPLES Any top-level fields in the LogMetric definition that aren't specified in the config file will not be updated in the metric. + To update the bucket associated with a bucket log-based metric, run: + + $ gcloud logging metrics update my-bucket-metric \ + --bucket-name="NEW_BUCKET_NAME" + POSITIONAL ARGUMENTS METRIC_NAME The name of the log-based metric to update. @@ -54,6 +59,9 @@ REQUIRED FLAGS Arguments to specify information about simple counter logs-based metrics. + --bucket-name=BUCKET_NAME + The Log Bucket name which owns the log-based metric. + --description=DESCRIPTION A new description for the metric. If omitted, the description is not changed. diff --git a/gcloud/logging/operations/cancel b/gcloud/logging/operations/cancel new file mode 100644 index 000000000..8b1ec7865 --- /dev/null +++ b/gcloud/logging/operations/cancel @@ -0,0 +1,68 @@ +NAME + gcloud logging operations cancel - cancel a long running operation + +SYNOPSIS + gcloud logging operations cancel OPERATION_ID --location=LOCATION + [--billing-account=BILLING_ACCOUNT_ID | --folder=FOLDER_ID + | --organization=ORGANIZATION_ID | --project=PROJECT_ID] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Cancel a long running operation with given OPERATION_ID in given LOCATION. + This operation can be a copy_log_entries operation which is scheduled + before. + +EXAMPLES + To cancel an operation, run: + + $ gcloud logging operations cancel OPERATION_ID --location=LOCATION + +POSITIONAL ARGUMENTS + OPERATION_ID + The Id of the operation. + +REQUIRED FLAGS + --location=LOCATION + Location of the operation. + +OPTIONAL FLAGS + At most one of these can be specified: + + --billing-account=BILLING_ACCOUNT_ID + Cancel operation associated with this billing account. + + --folder=FOLDER_ID + Cancel operation associated with this folder. + + --organization=ORGANIZATION_ID + Cancel operation associated with this organization. + + --project=PROJECT_ID + Cancel operation associated with this project. + + The Google Cloud project ID to use for this invocation. If omitted, + then the current project is assumed; the current project can be + listed using gcloud config list --format='text(core.project)' and can + be set using gcloud config set project PROJECTID. + + --project and its fallback core/project property play two roles in + the invocation. It specifies the project of the resource to operate + on. It also specifies the project for API enablement check, quota, + and billing. To specify a different project for quota and billing, + use --billing-project or billing/quota_project property. + +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 logging operations cancel + + $ gcloud beta logging operations cancel + diff --git a/gcloud/logging/operations/describe b/gcloud/logging/operations/describe new file mode 100644 index 000000000..53a4cbd8d --- /dev/null +++ b/gcloud/logging/operations/describe @@ -0,0 +1,69 @@ +NAME + gcloud logging operations describe - describe a long running operation + +SYNOPSIS + gcloud logging operations describe OPERATION_ID --location=LOCATION + [--billing-account=BILLING_ACCOUNT_ID | --folder=FOLDER_ID + | --organization=ORGANIZATION_ID | --project=PROJECT_ID] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe a long running operation which was scheduled before. For example, + a copy_log_entries operation scheduled by command: "gcloud alpha logging + copy BUCKET_ID DESTINATION --location=LOCATION" OPERATION_ID and LOCATION + are required to locate such operation. + +EXAMPLES + To describe an operation, run: + + $ gcloud logging operations describe OPERATION_ID --location=LOCATION + +POSITIONAL ARGUMENTS + OPERATION_ID + The Id of the operation. + +REQUIRED FLAGS + --location=LOCATION + Location of the operation. + +OPTIONAL FLAGS + At most one of these can be specified: + + --billing-account=BILLING_ACCOUNT_ID + Describe operation associated with this billing account. + + --folder=FOLDER_ID + Describe operation associated with this folder. + + --organization=ORGANIZATION_ID + Describe operation associated with this organization. + + --project=PROJECT_ID + Describe operation associated with this project. + + The Google Cloud project ID to use for this invocation. If omitted, + then the current project is assumed; the current project can be + listed using gcloud config list --format='text(core.project)' and can + be set using gcloud config set project PROJECTID. + + --project and its fallback core/project property play two roles in + the invocation. It specifies the project of the resource to operate + on. It also specifies the project for API enablement check, quota, + and billing. To specify a different project for quota and billing, + use --billing-project or billing/quota_project property. + +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 logging operations describe + + $ gcloud beta logging operations describe + diff --git a/gcloud/logging/operations/help b/gcloud/logging/operations/help new file mode 100644 index 000000000..01aa5d903 --- /dev/null +++ b/gcloud/logging/operations/help @@ -0,0 +1,33 @@ +NAME + gcloud logging operations - manage long running operations + +SYNOPSIS + gcloud logging operations COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage long running operations. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + cancel + Cancel a long running operation. + + describe + Describe a long running operation. + + list + List long running operations. + +NOTES + These variants are also available: + + $ gcloud alpha logging operations + + $ gcloud beta logging operations + diff --git a/gcloud/logging/operations/list b/gcloud/logging/operations/list new file mode 100644 index 000000000..5b5a365a4 --- /dev/null +++ b/gcloud/logging/operations/list @@ -0,0 +1,120 @@ +NAME + gcloud logging operations list - list long running operations + +SYNOPSIS + gcloud logging operations list --location=LOCATION + --operation-filter=OPERATION_FILTER + [--billing-account=BILLING_ACCOUNT_ID | --folder=FOLDER_ID + | --organization=ORGANIZATION_ID | --project=PROJECT_ID] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Return a list of long running operation details in given LOCATION. The + operations were scheduled by other gcloud commands. For example: a + copy_log_entries operation scheduled by command: gcloud alpha logging + operations copy BUCKET_ID DESTINATION --location=LOCATION. Note: while + listing the operations, the request_type must be specified in filter. + Example: --operation-filter=request_type=CopyLogEntries, Supported + operation types are: CopyLogEntries, CreateBucket and UpdateBucket. Other + supported filter expression are: operation_start_time, + operation_finish_time and operation_state. + +EXAMPLES + To list CopyLogEntries operations, run: + + $ gcloud logging operations list --location=LOCATION \ + --operation-filter=request_type=CopyLogEntries + + To list CopyLogEntries operations that started after a specified time, run: + + $ gcloud logging operations list --location=LOCATION \ + --operation-filter=request_type=CopyLogEntries AND \ + operation_start_time>TIMESTAMP + + To list CopyLogEntries operations that finished before a specified time, + run: + + $ gcloud logging operations list --location=LOCATION \ + --operation-filter=request_type=CopyLogEntries AND \ + operation_finish_time