From b33a8a3e6eb4e97de82662536f32b43419aa96c1 Mon Sep 17 00:00:00 2001 From: Automated Date: Thu, 20 Apr 2023 10:38:56 +0000 Subject: [PATCH] gcloud: Thu Apr 20 10:38:56 UTC 2023 --- gcloud/_version | 12 +- gcloud/alpha/auth/print-access-token | 13 +- .../compute/disks/start-async-replication | 20 +-- .../compute/tpus/queued-resources/create | 36 +++-- gcloud/alpha/compute/tpus/topologies/help | 4 +- gcloud/alpha/compute/tpus/topologies/list | 4 +- gcloud/alpha/compute/tpus/tpu-vm/create | 13 +- gcloud/alpha/config/get | 3 + gcloud/alpha/config/help | 3 + gcloud/alpha/config/list | 3 + gcloud/alpha/config/set | 3 + gcloud/alpha/config/unset | 3 + gcloud/alpha/container/aws/node-pools/create | 21 ++- gcloud/alpha/container/clusters/create | 2 +- gcloud/alpha/container/clusters/update | 45 ++++-- gcloud/alpha/container/fleet/mesh/update | 8 +- gcloud/alpha/container/hub/mesh/update | 8 +- gcloud/alpha/dataplex/assets/create | 13 +- gcloud/alpha/dataplex/assets/update | 14 +- gcloud/alpha/dataplex/lakes/authorize | 35 +++-- gcloud/alpha/dataplex/lakes/deauthorize | 39 ++--- gcloud/alpha/dataplex/lakes/help | 5 +- gcloud/alpha/datastore/databases/create | 50 ------ gcloud/alpha/datastore/databases/help | 7 - gcloud/alpha/firestore/databases/describe | 6 +- gcloud/alpha/firestore/databases/list | 12 +- gcloud/alpha/firestore/databases/update | 6 +- gcloud/alpha/logging/sinks/create | 3 +- .../metastore/services/alter-table-properties | 135 ++++++++++++++++ gcloud/alpha/metastore/services/help | 3 + gcloud/alpha/mps/help | 6 - gcloud/alpha/mps/instances/help | 20 --- .../resource-manager/tags/bindings/create | 4 +- .../resource-manager/tags/bindings/delete | 2 +- .../alpha/resource-manager/tags/bindings/help | 8 +- gcloud/alpha/resource-manager/tags/help | 5 +- .../alpha/resource-manager/tags/holds/create | 2 +- gcloud/alpha/resource-manager/tags/holds/help | 5 +- gcloud/alpha/resource-manager/tags/holds/list | 12 +- gcloud/alpha/resource-manager/tags/keys/help | 5 +- .../tags/values/add-iam-policy-binding | 5 +- .../alpha/resource-manager/tags/values/help | 5 +- .../tags/values/remove-iam-policy-binding | 5 +- .../alpha/resource-manager/tags/values/update | 4 +- gcloud/alpha/run/jobs/execute | 32 +++- gcloud/alpha/storage/help | 3 + gcloud/alpha/storage/insights/help | 28 ++++ .../storage/insights/inventory-reports/create | 105 +++++++++++++ .../storage/insights/inventory-reports/delete | 75 +++++++++ .../insights/inventory-reports/describe | 73 +++++++++ .../inventory-reports/details/describe | 82 ++++++++++ .../insights/inventory-reports/details/help | 33 ++++ .../insights/inventory-reports/details/list | 109 +++++++++++++ .../storage/insights/inventory-reports/help | 48 ++++++ .../storage/insights/inventory-reports/list | 80 ++++++++++ .../storage/insights/inventory-reports/update | 144 ++++++++++++++++++ gcloud/alpha/workstations/configs/create | 11 +- gcloud/alpha/workstations/configs/update | 19 ++- gcloud/auth/print-access-token | 13 +- gcloud/beta/auth/print-access-token | 13 +- .../compute/disks/start-async-replication | 20 +-- gcloud/beta/config/get | 3 + gcloud/beta/config/help | 3 + gcloud/beta/config/list | 3 + gcloud/beta/config/set | 3 + gcloud/beta/config/unset | 3 + gcloud/beta/container/clusters/create | 2 +- gcloud/beta/container/clusters/update | 45 ++++-- .../beta/container/fleet/memberships/register | 35 ++++- .../beta/container/hub/memberships/register | 35 ++++- gcloud/beta/datastore/databases/create | 48 ------ gcloud/beta/datastore/databases/help | 7 - gcloud/beta/events/brokers/create | 12 +- gcloud/beta/events/brokers/delete | 8 +- gcloud/beta/events/brokers/describe | 8 +- gcloud/beta/events/brokers/help | 18 ++- gcloud/beta/events/brokers/list | 5 +- gcloud/beta/events/help | 17 ++- gcloud/beta/events/init | 14 +- gcloud/beta/events/namespaces/help | 11 +- gcloud/beta/events/namespaces/init | 8 +- gcloud/beta/events/triggers/create | 8 +- gcloud/beta/events/triggers/delete | 8 +- gcloud/beta/events/triggers/describe | 8 +- gcloud/beta/events/triggers/help | 16 +- gcloud/beta/events/triggers/list | 8 +- gcloud/beta/events/types/describe | 8 +- gcloud/beta/events/types/help | 14 +- gcloud/beta/events/types/list | 8 +- gcloud/beta/events/types/sources/help | 9 +- gcloud/beta/events/types/sources/list | 8 +- gcloud/beta/firestore/databases/describe | 54 +++++++ gcloud/beta/firestore/databases/help | 9 ++ gcloud/beta/firestore/databases/list | 62 ++++++++ gcloud/beta/firestore/databases/update | 62 ++++++++ gcloud/beta/logging/sinks/create | 3 +- .../metastore/services/alter-table-properties | 133 ++++++++++++++++ gcloud/beta/metastore/services/help | 3 + .../resource-manager/tags/bindings/create | 4 +- .../resource-manager/tags/bindings/delete | 2 +- .../beta/resource-manager/tags/bindings/help | 8 +- gcloud/beta/resource-manager/tags/help | 5 +- .../beta/resource-manager/tags/holds/create | 2 +- gcloud/beta/resource-manager/tags/holds/help | 5 +- gcloud/beta/resource-manager/tags/holds/list | 12 +- gcloud/beta/resource-manager/tags/keys/help | 5 +- .../tags/values/add-iam-policy-binding | 5 +- gcloud/beta/resource-manager/tags/values/help | 5 +- .../tags/values/remove-iam-policy-binding | 5 +- .../beta/resource-manager/tags/values/update | 4 +- gcloud/beta/run/deploy | 22 +++ gcloud/beta/run/services/update | 22 +++ gcloud/beta/workstations/configs/create | 11 +- gcloud/beta/workstations/configs/update | 19 ++- gcloud/compute/tpus/help | 3 + gcloud/compute/tpus/topologies/help | 25 +++ gcloud/compute/tpus/topologies/list | 78 ++++++++++ gcloud/compute/tpus/tpu-vm/create | 4 +- gcloud/config/get | 3 + gcloud/config/help | 3 + gcloud/config/list | 3 + gcloud/config/set | 3 + gcloud/config/unset | 3 + gcloud/container/aws/node-pools/create | 6 +- gcloud/container/clusters/update | 44 ++++-- gcloud/container/fleet/memberships/register | 35 ++++- gcloud/container/fleet/mesh/update | 8 +- gcloud/container/hub/memberships/register | 35 ++++- gcloud/container/hub/mesh/update | 8 +- gcloud/dataplex/lakes/authorize | 35 +++-- gcloud/dataplex/lakes/deauthorize | 38 ++--- gcloud/dataplex/lakes/help | 4 +- gcloud/datastore/databases/create | 45 ------ gcloud/datastore/databases/help | 7 - gcloud/firestore/databases/create | 48 +++--- gcloud/firestore/databases/describe | 53 +++++++ gcloud/firestore/databases/help | 11 +- gcloud/firestore/databases/list | 61 ++++++++ gcloud/firestore/databases/update | 61 ++++++++ gcloud/logging/sinks/create | 3 +- .../service-connection-policies/create | 8 +- gcloud/resource-manager/tags/bindings/create | 4 +- gcloud/resource-manager/tags/bindings/delete | 2 +- gcloud/resource-manager/tags/bindings/help | 8 +- gcloud/resource-manager/tags/help | 5 +- gcloud/resource-manager/tags/holds/create | 2 +- gcloud/resource-manager/tags/holds/help | 5 +- gcloud/resource-manager/tags/holds/list | 12 +- gcloud/resource-manager/tags/keys/help | 5 +- .../tags/values/add-iam-policy-binding | 3 +- gcloud/resource-manager/tags/values/help | 5 +- .../tags/values/remove-iam-policy-binding | 3 +- gcloud/resource-manager/tags/values/update | 4 +- gcloud/run/deploy | 9 +- gcloud/run/services/update | 9 +- gcloud/sql/flags/list | 8 +- gcloud/sql/instances/create | 8 +- gcloud/sql/instances/patch | 8 +- gcloud/storage/help | 3 + gcloud/storage/insights/help | 25 +++ .../storage/insights/inventory-reports/create | 101 ++++++++++++ .../storage/insights/inventory-reports/delete | 72 +++++++++ .../insights/inventory-reports/describe | 70 +++++++++ .../inventory-reports/details/describe | 79 ++++++++++ .../insights/inventory-reports/details/help | 30 ++++ .../insights/inventory-reports/details/list | 106 +++++++++++++ .../storage/insights/inventory-reports/help | 45 ++++++ .../storage/insights/inventory-reports/list | 77 ++++++++++ .../storage/insights/inventory-reports/update | 141 +++++++++++++++++ 169 files changed, 3258 insertions(+), 576 deletions(-) delete mode 100644 gcloud/alpha/datastore/databases/create create mode 100644 gcloud/alpha/metastore/services/alter-table-properties delete mode 100644 gcloud/alpha/mps/instances/help create mode 100644 gcloud/alpha/storage/insights/help create mode 100644 gcloud/alpha/storage/insights/inventory-reports/create create mode 100644 gcloud/alpha/storage/insights/inventory-reports/delete create mode 100644 gcloud/alpha/storage/insights/inventory-reports/describe create mode 100644 gcloud/alpha/storage/insights/inventory-reports/details/describe create mode 100644 gcloud/alpha/storage/insights/inventory-reports/details/help create mode 100644 gcloud/alpha/storage/insights/inventory-reports/details/list create mode 100644 gcloud/alpha/storage/insights/inventory-reports/help create mode 100644 gcloud/alpha/storage/insights/inventory-reports/list create mode 100644 gcloud/alpha/storage/insights/inventory-reports/update delete mode 100644 gcloud/beta/datastore/databases/create create mode 100644 gcloud/beta/firestore/databases/describe create mode 100644 gcloud/beta/firestore/databases/list create mode 100644 gcloud/beta/firestore/databases/update create mode 100644 gcloud/beta/metastore/services/alter-table-properties create mode 100644 gcloud/compute/tpus/topologies/help create mode 100644 gcloud/compute/tpus/topologies/list delete mode 100644 gcloud/datastore/databases/create create mode 100644 gcloud/firestore/databases/describe create mode 100644 gcloud/firestore/databases/list create mode 100644 gcloud/firestore/databases/update create mode 100644 gcloud/storage/insights/help create mode 100644 gcloud/storage/insights/inventory-reports/create create mode 100644 gcloud/storage/insights/inventory-reports/delete create mode 100644 gcloud/storage/insights/inventory-reports/describe create mode 100644 gcloud/storage/insights/inventory-reports/details/describe create mode 100644 gcloud/storage/insights/inventory-reports/details/help create mode 100644 gcloud/storage/insights/inventory-reports/details/list create mode 100644 gcloud/storage/insights/inventory-reports/help create mode 100644 gcloud/storage/insights/inventory-reports/list create mode 100644 gcloud/storage/insights/inventory-reports/update diff --git a/gcloud/_version b/gcloud/_version index 64c7fdb48..3ddbdbfcb 100644 --- a/gcloud/_version +++ b/gcloud/_version @@ -1,8 +1,8 @@ -Google Cloud SDK 426.0.0 -alpha 2023.04.10 -beta 2023.04.10 -bq 2.0.90 +Google Cloud SDK 427.0.0 +alpha 2023.04.17 +beta 2023.04.17 +bq 2.0.91 bundled-python3-unix 3.9.16 -core 2023.04.10 +core 2023.04.17 gcloud-crc32c 1.0.0 -gsutil 5.21 +gsutil 5.23 diff --git a/gcloud/alpha/auth/print-access-token b/gcloud/alpha/auth/print-access-token index 05697a954..9563950f7 100644 --- a/gcloud/alpha/auth/print-access-token +++ b/gcloud/alpha/auth/print-access-token @@ -3,7 +3,8 @@ NAME specified account SYNOPSIS - gcloud alpha auth print-access-token [ACCOUNT] [GCLOUD_WIDE_FLAG ...] + gcloud alpha auth print-access-token [ACCOUNT] [--lifetime=LIFETIME] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Print an access token for the specified account. See RFC6749 @@ -34,6 +35,16 @@ POSITIONAL ARGUMENTS Account to get the access token for. If not specified, the current active account will be used. +FLAGS + --lifetime=LIFETIME + Access token lifetime. The default access token lifetime is 3600 + seconds, but you can use this flag to reduce the lifetime or extend it + up to 43200 seconds (12 hours). The org policy constraint + constraints/iam.allowServiceAccountCredentialLifetimeExtension must be + set if you want to extend the lifetime beyond 3600 seconds. Note that + this flag is for service account impersonation only, so it must be used + together with the --impersonate-service-account flag. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/compute/disks/start-async-replication b/gcloud/alpha/compute/disks/start-async-replication index 5e9e5c8e3..2e087389f 100644 --- a/gcloud/alpha/compute/disks/start-async-replication +++ b/gcloud/alpha/compute/disks/start-async-replication @@ -4,10 +4,11 @@ NAME SYNOPSIS gcloud alpha compute disks start-async-replication DISK_NAME - --secondary-disk=SECONDARY_DISK [--region=REGION | --zone=ZONE] + --secondary-disk=SECONDARY_DISK (--region=REGION | --zone=ZONE) + (--secondary-disk-region=SECONDARY_DISK_REGION + | --secondary-disk-zone=SECONDARY_DISK_ZONE) [--secondary-disk-project=SECONDARY_DISK_PROJECT] - [--secondary-disk-region=SECONDARY_DISK_REGION - | --secondary-disk-zone=SECONDARY_DISK_ZONE] [GCLOUD_WIDE_FLAG ...] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) gcloud alpha compute disks start-async-replication starts async @@ -31,8 +32,7 @@ REQUIRED FLAGS Secondary disk for asynchronous replication. This flag is required when starting replication. -FLAGS - At most one of these can be specified: + Exactly one of these must be specified: --region=REGION Region of the disk to operate on. If not specified, you might be @@ -75,11 +75,7 @@ FLAGS Alternatively, the zone can be stored in the environment variable CLOUDSDK_COMPUTE_ZONE. -SECONDARY DISK FLAGS - --secondary-disk-project=SECONDARY_DISK_PROJECT - Project of the secondary disk for asynchronous replication. - - At most one of these can be specified: + Exactly one of these must be specified: --secondary-disk-region=SECONDARY_DISK_REGION Region of the secondary disk for asynchronous replication. Overrides @@ -90,6 +86,10 @@ SECONDARY DISK FLAGS Zone of the secondary disk for asynchronous replication. Overrides the default compute/zone property value for this command invocation. +SECONDARY DISK FLAGS + --secondary-disk-project=SECONDARY_DISK_PROJECT + Project of the secondary disk for asynchronous replication. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/compute/tpus/queued-resources/create b/gcloud/alpha/compute/tpus/queued-resources/create index 72debc437..0f21c5ba1 100644 --- a/gcloud/alpha/compute/tpus/queued-resources/create +++ b/gcloud/alpha/compute/tpus/queued-resources/create @@ -6,8 +6,9 @@ SYNOPSIS gcloud alpha compute tpus queued-resources create (QUEUED_RESOURCE : --zone=ZONE) --accelerator-type=ACCELERATOR_TYPE --runtime-version=RUNTIME_VERSION - (--node-id=NODE_ID | --node-count=NODE_COUNT --node-prefix=NODE_PREFIX) - [--async] [--best-effort] [--guaranteed] [--internal-ips] + (--node-id=NODE_ID + | [--node-count=NODE_COUNT : --node-prefix=NODE_PREFIX]) [--async] + [--best-effort] [--guaranteed] [--internal-ips] [--metadata=[METADATA,...]] [--metadata-from-file=[METADATA_FROM_FILE,...]] [--network=NETWORK; default="default"] @@ -15,7 +16,8 @@ SYNOPSIS [--reservation-host-organization=RESERVATION_HOST_ORGANIZATION] [--reservation-host-project=RESERVATION_HOST_PROJECT] [--reserved] [--scopes=[SCOPES,...]] [--service-account=SERVICE_ACCOUNT] - [--subnetwork=SUBNETWORK] [--valid-after-duration=VALID_AFTER_DURATION] + [--subnetwork=SUBNETWORK] [--tags=[TAGS,...]] + [--valid-after-duration=VALID_AFTER_DURATION] [--valid-after-time=VALID_AFTER_TIME] [--valid-until-duration=VALID_UNTIL_DURATION] [--valid-until-time=VALID_UNTIL_TIME] [GCLOUD_WIDE_FLAG ...] @@ -36,8 +38,8 @@ EXAMPLES $ gcloud alpha compute tpus queued-resources create \ my-queued-resource --accelerator-type=v4-8 \ - --runtime-version=v2-alpha-tpuv4 --node-prefix=my-node \ - --node-count=2 --zone=us-central2-b --project=my-project + --runtime-version=v2-alpha-tpuv4 --node-count=2 \ + --zone=us-central2-b --project=my-project POSITIONAL ARGUMENTS Queued resource resource - The Queued Resource you want to create. The @@ -77,8 +79,8 @@ REQUIRED FLAGS --runtime-version=RUNTIME_VERSION Runtime version for the TPU, such as 2.3. - Specify TPU node(s) with either a single node id, or a node prefix and - node count combination + Specify TPU node(s) with either a single node id or a node count and an + optional node prefix Exactly one of these must be specified: @@ -88,9 +90,9 @@ REQUIRED FLAGS Unqualified node identifier used to identify the node in the project once provisioned. - To request a resource with multiple nodes, use --node-prefix to - specify the prefix for each node and --node-count to specify the - number of nodes in place of --node-id. + To request a resource with multiple nodes, in place of --node-id, + use --node-count to specify the number of nodes and optionally use + --node-prefix to specify the prefix for each node. Multinode creation @@ -99,20 +101,16 @@ REQUIRED FLAGS generate the qualified name for nodes in the provision. Value must be greater than 1. - Must also specify --node-prefix. - This flag argument must be specified if any of the other arguments in this group are specified. --node-prefix=NODE_PREFIX Node prefix used to generate the qualified name of each node the - multislice node provision. + multislice node provision. If not supplied, the queued resource id + will be used as the prefix. Must also specify --node-count. - This flag argument must be specified if any of the other arguments - in this group are specified. - OPTIONAL FLAGS --async Return immediately, without waiting for the operation in progress to @@ -170,6 +168,12 @@ OPTIONAL FLAGS --subnetwork=SUBNETWORK Subnetwork that this TPU will be a part of. + --tags=[TAGS,...] + Tags to apply to the TPU Node. Tags are used to identify valid sources + or targets for network firewalls. See + https://cloud.google.com/vpc/docs/add-remove-network-tags for more + details. + --valid-after-duration=VALID_AFTER_DURATION A duration before which the TPU must not be provisioned, relative to the current time. See $ gcloud topic datetimes for information on diff --git a/gcloud/alpha/compute/tpus/topologies/help b/gcloud/alpha/compute/tpus/topologies/help index 19bf146e3..1b9d1c188 100644 --- a/gcloud/alpha/compute/tpus/topologies/help +++ b/gcloud/alpha/compute/tpus/topologies/help @@ -22,5 +22,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud compute tpus topologies diff --git a/gcloud/alpha/compute/tpus/topologies/list b/gcloud/alpha/compute/tpus/topologies/list index 829984235..711659da1 100644 --- a/gcloud/alpha/compute/tpus/topologies/list +++ b/gcloud/alpha/compute/tpus/topologies/list @@ -75,5 +75,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 compute tpus topologies list diff --git a/gcloud/alpha/compute/tpus/tpu-vm/create b/gcloud/alpha/compute/tpus/tpu-vm/create index 709bac182..e2ffadfdb 100644 --- a/gcloud/alpha/compute/tpus/tpu-vm/create +++ b/gcloud/alpha/compute/tpus/tpu-vm/create @@ -9,7 +9,7 @@ SYNOPSIS [--metadata-from-file=[METADATA_FROM_FILE,...]] [--network=NETWORK; default="default"] [--preemptible] [--range=RANGE] [--reserved] [--scopes=[SCOPES,...]] - [--service-account=SERVICE_ACCOUNT] [--shielded-secure-boot] + [--service-account=SERVICE_ACCOUNT] [--shielded-secure-boot] [--spot] [--subnetwork=SUBNETWORK] [--tags=[TAGS,...]] [--accelerator-type=ACCELERATOR_TYPE; default="v2-8" | --topology=TOPOLOGY --type=TYPE] [GCLOUD_WIDE_FLAG ...] @@ -114,11 +114,11 @@ OPTIONAL FLAGS --metadata=[METADATA,...] List of comma-separated metadata key-value pairs for the Cloud TPU VM - node. + node. Example: --metadata='key1=value1,key2=value2' --metadata-from-file=[METADATA_FROM_FILE,...] Same as --metadata except the value for the entry will be read from a - local file. + local file. Example: --metadata-from-file='key1=value1.txt' --network=NETWORK; default="default" Network that this TPU will be a part of. @@ -161,6 +161,13 @@ OPTIONAL FLAGS Specifies that the TPU instances are created with secure boot enabled. This implicitly makes them Shielded VM instances. + --spot + If specified, create this VM as a spot VM. Spot VMs make unused + capacity available at highly discounted rates. Spot VMs may be + preempted at any time if the capacity is needed, but unless preempted + there is no limit on runtime duration. Spot VM TPUs cannot be + restarted, and must be recreated again. + --subnetwork=SUBNETWORK Subnetwork that this TPU will be a part of. diff --git a/gcloud/alpha/config/get b/gcloud/alpha/config/get index 154a93f74..12dc8a777 100644 --- a/gcloud/alpha/config/get +++ b/gcloud/alpha/config/get @@ -562,6 +562,9 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud firebase test command group. Defaults to https://testing.googleapis.com/ + transfer + Overrides API endpoint for gcloud transfer command group. + vision Overrides API endpoint for gcloud ml vision command group. Defaults to https://vision.googleapis.com/ diff --git a/gcloud/alpha/config/help b/gcloud/alpha/config/help index a45b8729a..83e9e82c2 100644 --- a/gcloud/alpha/config/help +++ b/gcloud/alpha/config/help @@ -594,6 +594,9 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud firebase test command group. Defaults to https://testing.googleapis.com/ + transfer + Overrides API endpoint for gcloud transfer command group. + vision Overrides API endpoint for gcloud ml vision command group. Defaults to https://vision.googleapis.com/ diff --git a/gcloud/alpha/config/list b/gcloud/alpha/config/list index e6dbc5332..1e5aec4b5 100644 --- a/gcloud/alpha/config/list +++ b/gcloud/alpha/config/list @@ -606,6 +606,9 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud firebase test command group. Defaults to https://testing.googleapis.com/ + transfer + Overrides API endpoint for gcloud transfer command group. + vision Overrides API endpoint for gcloud ml vision command group. Defaults to https://vision.googleapis.com/ diff --git a/gcloud/alpha/config/set b/gcloud/alpha/config/set index 5c515b35f..dd7a1f0d7 100644 --- a/gcloud/alpha/config/set +++ b/gcloud/alpha/config/set @@ -609,6 +609,9 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud firebase test command group. Defaults to https://testing.googleapis.com/ + transfer + Overrides API endpoint for gcloud transfer command group. + vision Overrides API endpoint for gcloud ml vision command group. Defaults to https://vision.googleapis.com/ diff --git a/gcloud/alpha/config/unset b/gcloud/alpha/config/unset index 5ae2f2e25..a1e9ecadb 100644 --- a/gcloud/alpha/config/unset +++ b/gcloud/alpha/config/unset @@ -570,6 +570,9 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud firebase test command group. Defaults to https://testing.googleapis.com/ + transfer + Overrides API endpoint for gcloud transfer command group. + vision Overrides API endpoint for gcloud ml vision command group. Defaults to https://vision.googleapis.com/ diff --git a/gcloud/alpha/container/aws/node-pools/create b/gcloud/alpha/container/aws/node-pools/create index ec50b2e2e..bb4f68b64 100644 --- a/gcloud/alpha/container/aws/node-pools/create +++ b/gcloud/alpha/container/aws/node-pools/create @@ -10,7 +10,7 @@ SYNOPSIS --subnet-id=SUBNET_ID [--annotations=ANNOTATION,[ANNOTATION,...]] [--async] [--image-type=IMAGE_TYPE] [--instance-placement=INSTANCE_PLACEMENT] - [--instance-type=INSTANCE_TYPE] [--max-pods-per-node=MAX_PODS_PER_NODE] + [--max-pods-per-node=MAX_PODS_PER_NODE] [--node-labels=NODE_LABEL,[NODE_LABEL,...]] [--node-taints=NODE_TAINT,[NODE_TAINT,...]] [--root-volume-iops=ROOT_VOLUME_IOPS] @@ -22,6 +22,8 @@ SYNOPSIS [--validate-only] [--autoscaling-metrics-granularity=AUTOSCALING_METRICS_GRANULARITY : --autoscaling-metrics=[AUTOSCALING_METRIC,...]] + [--instance-type=INSTANCE_TYPE + | --spot-instance-types=[INSTANCE_TYPE,...]] [--max-nodes=MAX_NODES --min-nodes=MIN_NODES] [--proxy-secret-arn=PROXY_SECRET_ARN --proxy-secret-version-id=PROXY_SECRET_VERSION_ID] @@ -106,9 +108,6 @@ OPTIONAL FLAGS Type of the tenancy. INSTANCE_PLACEMENT must be one of: dedicated, default, host. - --instance-type=INSTANCE_TYPE - AWS EC2 instance type for the node pool's nodes. - --max-pods-per-node=MAX_PODS_PER_NODE Maximum number of pods per node. @@ -166,6 +165,20 @@ OPTIONAL FLAGS If granularity is specified but not any metrics, all metrics are enabled. + Node pool instance configuration + + At most one of these can be specified: + + --instance-type=INSTANCE_TYPE + AWS EC2 instance type for the node pool's nodes. + + --spot-instance-types=[INSTANCE_TYPE,...] + List of AWS EC2 instance types for creating a spot node pool's nodes. + The specified instance types must have the same number of CPUs and + memory. You can use the Amazon EC2 Instance Selector tool + (https://github.com/aws/amazon-ec2-instance-selector) to choose + instance types with matching CPU and memory configurations. + Node pool autoscaling --max-nodes=MAX_NODES diff --git a/gcloud/alpha/container/clusters/create b/gcloud/alpha/container/clusters/create index d33526dcc..feacc20f0 100644 --- a/gcloud/alpha/container/clusters/create +++ b/gcloud/alpha/container/clusters/create @@ -172,7 +172,7 @@ FLAGS ADDON must be one of: HttpLoadBalancing, HorizontalPodAutoscaling, KubernetesDashboard, NetworkPolicy, NodeLocalDNS, ConfigConnector, GcePersistentDiskCsiDriver, GcpFilestoreCsiDriver, BackupRestore, - Istio, CloudBuild, CloudRun. + Istio, GcsFuseCsiDriver, CloudBuild, CloudRun. --allow-route-overlap Allows the provided cluster CIDRs to overlap with existing routes that diff --git a/gcloud/alpha/container/clusters/update b/gcloud/alpha/container/clusters/update index 67789d2aa..76246a9cb 100644 --- a/gcloud/alpha/container/clusters/update +++ b/gcloud/alpha/container/clusters/update @@ -32,6 +32,8 @@ SYNOPSIS | --stack-type=STACK_TYPE | --start-credential-rotation | --start-ip-rotation | --update-addons=[ADDON=ENABLED|DISABLED,...] | --update-labels=[KEY=VALUE,...] | --workload-pool=WORKLOAD_POOL + | --additional-pod-ipv4-ranges=NAME,[NAME,...] + --remove-additional-pod-ipv4-ranges=NAME,[NAME,...] | --additional-zones=[ZONE,...] | --node-locations=ZONE,[ZONE,...] | --binauthz-policy=BINAUTHZ_POLICY --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE @@ -49,8 +51,7 @@ SYNOPSIS --enable-resource-consumption-metering --resource-usage-bigquery-dataset=RESOURCE_USAGE_BIGQUERY_DATASET | --cluster-dns=CLUSTER_DNS --cluster-dns-domain=CLUSTER_DNS_DOMAIN - --cluster-dns-scope=CLUSTER_DNS_SCOPE | --disable-managed-prometheus - | --enable-managed-prometheus | [--enable-autoprovisioning + --cluster-dns-scope=CLUSTER_DNS_SCOPE | [--enable-autoprovisioning : --autoprovisioning-config-file=AUTOPROVISIONING_CONFIG_FILE | --autoprovisioning-image-type=AUTOPROVISIONING_IMAGE_TYPE --autoprovisioning-locations=ZONE,[ZONE,...] @@ -68,8 +69,9 @@ SYNOPSIS [--max-accelerator=[type=TYPE,count=COUNT,...] : --min-accelerator=[type=TYPE,count=COUNT,...]]] | --enable-tpu --enable-tpu-service-networking | --tpu-ipv4-cidr=CIDR - | --logging=[COMPONENT,...] --monitoring=[COMPONENT,...] - | --logging-service=LOGGING_SERVICE + | --logging=[COMPONENT,...] + --monitoring=[COMPONENT,...] --disable-managed-prometheus + | --enable-managed-prometheus | --logging-service=LOGGING_SERVICE --monitoring-service=MONITORING_SERVICE | --password=PASSWORD --enable-basic-auth | --username=USERNAME, -u USERNAME) [--async] @@ -543,6 +545,7 @@ REQUIRED FLAGS ConfigConnector=ENABLED|DISABLED NodeLocalDNS=ENABLED|DISABLED GcePersistentDiskCsiDriver=ENABLED|DISABLED GcpFilestoreCsiDriver=ENABLED|DISABLED + GcsFuseCsiDriver=ENABLED|DISABLED --update-labels=[KEY=VALUE,...] Labels to apply to the Google Cloud resources in use by the @@ -566,6 +569,24 @@ REQUIRED FLAGS https://cloud.google.com/kubernetes-engine/docs/how-to/workload-identity + --additional-pod-ipv4-ranges=NAME,[NAME,...] + Additional IP address ranges(by name) for pods that need to be added + to the cluster. + + Examples: + + $ gcloud alpha container clusters update example-cluster \ + --additional-pod-ipv4-ranges=range1,range2 + + --remove-additional-pod-ipv4-ranges=NAME,[NAME,...] + Previously added additional pod ranges(by name) for pods that are to + be removed from the cluster. + + Examples: + + $ gcloud alpha container clusters update example-cluster \ + --remove-additional-pod-ipv4-ranges=range1,range2 + At most one of these can be specified: --additional-zones=[ZONE,...] @@ -798,14 +819,6 @@ REQUIRED FLAGS vpc Configures the Cloud DNS zone to be private to the VPC Network. - At most one of these can be specified: - - --disable-managed-prometheus - Disable managed collection for Managed Service for Prometheus. - - --enable-managed-prometheus - Enable managed collection for Managed Service for Prometheus. - Node autoprovisioning --enable-autoprovisioning @@ -1096,6 +1109,14 @@ REQUIRED FLAGS --monitoring=SYSTEM,API_SERVER $ gcloud alpha container clusters update --monitoring=NONE + At most one of these can be specified: + + --disable-managed-prometheus + Disable managed collection for Managed Service for Prometheus. + + --enable-managed-prometheus + Enable managed collection for Managed Service for Prometheus. + --logging-service=LOGGING_SERVICE (DEPRECATED) Logging service to use for the cluster. Options are: "logging.googleapis.com/kubernetes" (the Google Cloud Logging service diff --git a/gcloud/alpha/container/fleet/mesh/update b/gcloud/alpha/container/fleet/mesh/update index a42f62b06..952d2df1e 100644 --- a/gcloud/alpha/container/fleet/mesh/update +++ b/gcloud/alpha/container/fleet/mesh/update @@ -24,8 +24,12 @@ REQUIRED FLAGS At least one of these must be specified: --control-plane=CONTROL_PLANE - The control plane management to update to. CONTROL_PLANE must be one - of: automatic, manual. + (DEPRECATED) The control plane management to update to. + + The --control-plane flag is now deprecated. Please use --management + instead. See + https://cloud.google.com/service-mesh/docs/managed/provision-managed-anthos-service-mesh. + CONTROL_PLANE must be one of: automatic, manual. --management=MANAGEMENT The management mode to update to. MANAGEMENT must be one of: diff --git a/gcloud/alpha/container/hub/mesh/update b/gcloud/alpha/container/hub/mesh/update index b64e0e75b..3b986e505 100644 --- a/gcloud/alpha/container/hub/mesh/update +++ b/gcloud/alpha/container/hub/mesh/update @@ -24,8 +24,12 @@ REQUIRED FLAGS At least one of these must be specified: --control-plane=CONTROL_PLANE - The control plane management to update to. CONTROL_PLANE must be one - of: automatic, manual. + (DEPRECATED) The control plane management to update to. + + The --control-plane flag is now deprecated. Please use --management + instead. See + https://cloud.google.com/service-mesh/docs/managed/provision-managed-anthos-service-mesh. + CONTROL_PLANE must be one of: automatic, manual. --management=MANAGEMENT The management mode to update to. MANAGEMENT must be one of: diff --git a/gcloud/alpha/dataplex/assets/create b/gcloud/alpha/dataplex/assets/create index bfdfdec22..25077fa1c 100644 --- a/gcloud/alpha/dataplex/assets/create +++ b/gcloud/alpha/dataplex/assets/create @@ -4,8 +4,9 @@ NAME SYNOPSIS gcloud alpha dataplex assets create (ASSET : --lake=LAKE --location=LOCATION --zone=ZONE) - (--resource-type=RESOURCE_TYPE : --resource-name=RESOURCE_NAME) - [--async] [--description=DESCRIPTION] [--display-name=DISPLAY_NAME] + (--resource-type=RESOURCE_TYPE : --resource-name=RESOURCE_NAME + --resource-read-access-mode=RESOURCE_READ_ACCESS_MODE) [--async] + [--description=DESCRIPTION] [--display-name=DISPLAY_NAME] [--labels=[KEY=VALUE,...]] [--validate-only] [--[no-]discovery-enabled --discovery-exclude-patterns=[EXCLUDE_PATTERNS,...] @@ -113,6 +114,14 @@ REQUIRED FLAGS projects/{project_number}/buckets/{bucket_id} or projects/{project_number}/datasets/{dataset_id} + --resource-read-access-mode=RESOURCE_READ_ACCESS_MODE + Read access mode. RESOURCE_READ_ACCESS_MODE must be one of: + + DIRECT + Data is accessed directly using storage APIs + MANAGED + Data is accessed through a managed interface using BigQuery APIs. + OPTIONAL FLAGS --async Return immediately, without waiting for the operation in progress to diff --git a/gcloud/alpha/dataplex/assets/update b/gcloud/alpha/dataplex/assets/update index e70cf401f..eaffae50f 100644 --- a/gcloud/alpha/dataplex/assets/update +++ b/gcloud/alpha/dataplex/assets/update @@ -5,7 +5,9 @@ SYNOPSIS gcloud alpha dataplex assets update (ASSET : --lake=LAKE --location=LOCATION --zone=ZONE) [--async] [--description=DESCRIPTION] [--display-name=DISPLAY_NAME] - [--labels=[KEY=VALUE,...]] [--validate-only] + [--labels=[KEY=VALUE,...]] + [--resource-read-access-mode=RESOURCE_READ_ACCESS_MODE] + [--validate-only] [--[no-]discovery-enabled --discovery-exclude-patterns=[EXCLUDE_PATTERNS,...] --discovery-include-patterns=[INCLUDE_PATTERNS,...] @@ -89,6 +91,16 @@ FLAGS contain only hyphens (-), underscores (_), lowercase characters, and numbers. + Specification of the resource that is referenced by this asset. + + --resource-read-access-mode=RESOURCE_READ_ACCESS_MODE + Read access mode. RESOURCE_READ_ACCESS_MODE must be one of: + + DIRECT + Data is accessed directly using storage APIs + MANAGED + Data is accessed through a managed interface using BigQuery APIs. + --validate-only Validate the update action, but don't actually perform it. diff --git a/gcloud/alpha/dataplex/lakes/authorize b/gcloud/alpha/dataplex/lakes/authorize index 5458919e6..eb9ccf85a 100644 --- a/gcloud/alpha/dataplex/lakes/authorize +++ b/gcloud/alpha/dataplex/lakes/authorize @@ -1,6 +1,6 @@ NAME - gcloud alpha dataplex lakes authorize - authorize a project service account - to manage given resource + gcloud alpha dataplex lakes authorize - authorize a service agent to manage + resources SYNOPSIS gcloud alpha dataplex lakes authorize @@ -10,23 +10,23 @@ SYNOPSIS --secondary-project=SECONDARY_PROJECT) [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) IAM Bindings for the service account of the primary project will be - added to a secondary project, a storage bucket, or BigQuery dataset. + (ALPHA) The service agent for the primary project will be granted an IAM + role on a secondary project, a Cloud Storage bucket, or a BigQuery dataset. EXAMPLES - To authorize the service account in project test-project to manage another - project test-project2, run: + To authorize the service agent in project test-project to manage resources + in the project test-project2, run: $ gcloud alpha dataplex lakes authorize --project=test-project \ --project-resource=test-project2 - To authorize the service account in project test-project to manage the - storage bucket dataplex-storage-bucket, run: + To authorize the service agent in project test-project to manage the Cloud + Storage bucket dataplex-storage-bucket, run: $ gcloud alpha dataplex lakes authorize --project=test-project \ --storage-bucket-resource=dataplex-storage-bucket - To authorize the service account in project test-project to manage the + To authorize the service agent in project test-project to manage the BigQuery dataset test-dataset in project test-project2, run: $ gcloud alpha dataplex lakes authorize --project=test-project \ @@ -34,27 +34,30 @@ EXAMPLES --secondary-project=test-project2 REQUIRED FLAGS - Container or Object to bind P4SA. + The resource on which to grant a role to the service agent. Exactly one of these must be specified: --project-resource=PROJECT_RESOURCE - The identifier of the project to authorize. + The identifier of the project whose resources the service agent will + manage. --storage-bucket-resource=STORAGE_BUCKET_RESOURCE - The identifier of the Cloud Storage bucket to authorize the project - on. + The identifier of the Cloud Storage bucket that the service agent + will manage. - Fields to help identify the BigQuery Dataset. + Fields to identify the BigQuery dataset. --bigquery-dataset-resource=BIGQUERY_DATASET_RESOURCE - The identifier of the BigQuery dataset to authorize. + The identifier of the BigQuery dataset that the service agent will + manage. This flag argument must be specified if any of the other arguments in this group are specified. --secondary-project=SECONDARY_PROJECT - The identifier of the Project where BigQuery dataset resides. + The identifier of the project where the BigQuery dataset is + located. This flag argument must be specified if any of the other arguments in this group are specified. diff --git a/gcloud/alpha/dataplex/lakes/deauthorize b/gcloud/alpha/dataplex/lakes/deauthorize index 30e8c749d..790ffae0d 100644 --- a/gcloud/alpha/dataplex/lakes/deauthorize +++ b/gcloud/alpha/dataplex/lakes/deauthorize @@ -1,6 +1,6 @@ NAME - gcloud alpha dataplex lakes deauthorize - deauthorize a project service - account from managing given resource + gcloud alpha dataplex lakes deauthorize - deauthorize a service agent from + managing resources SYNOPSIS gcloud alpha dataplex lakes deauthorize @@ -10,52 +10,55 @@ SYNOPSIS --secondary-project=SECONDARY_PROJECT) [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Remove IAM Bindings for the service account of the primary project - from a secondary project, a storage bucket, or BigQuery dataset. + (ALPHA) The service agent for the primary project will have its IAM role + revoked from a secondary project, a Cloud Storage bucket, or a BigQuery + dataset. EXAMPLES - To deauthorize the service account in project test-project from managing - another project test-project2, run: + To deauthorize the service agent in project test-project from managing + resources in the project test-project2, run: $ gcloud alpha dataplex lakes deauthorize --project=test-project \ --project-resource=test-project2 - To deauthorize the service account in project test-project from managing - the storage bucket dataplex-storage-bucket, run: + To deauthorize the service agent in project test-project from managing the + Cloud Storage bucket dataplex-storage-bucket, run: $ gcloud alpha dataplex lakes deauthorize --project=test-project \ --storage-bucket-resource=dataplex-storage-bucket - To deauthorize the service account in project test-project from managing - the BigQuery dataset test-dataset in project test-project2, run: + To deauthorize the service agent in project test-project from managing the + BigQuery dataset test-dataset in project test-project2, run: $ gcloud alpha dataplex lakes deauthorize --project=test-project \ --bigquery-dataset-resource=test-dataset \ --secondary-project=test-project2 REQUIRED FLAGS - Container or Object to unbind p4sa + The resource for which the service agent's role will be revoked. Exactly one of these must be specified: --project-resource=PROJECT_RESOURCE - The identifier of the project to deauthorize. + The identifier of the project whose resources the service agent will + no longer manage. --storage-bucket-resource=STORAGE_BUCKET_RESOURCE - The identifier of the Cloud Storage bucket to deauthorize the project - from. + The identifier of the Cloud Storage bucket that the service agent + will no longer manage. - Fields to help identify the BigQuery Dataset. + Fields to identify the BigQuery dataset. --bigquery-dataset-resource=BIGQUERY_DATASET_RESOURCE - The identifier of the BigQuery dataset to deauthorize the project - from. + The identifier of the BigQuery dataset that the service agent will + no longer manage. This flag argument must be specified if any of the other arguments in this group are specified. --secondary-project=SECONDARY_PROJECT - The identifier of the Project where BigQuery dataset resides + The identifier of the project where the BigQuery dataset is + located. This flag argument must be specified if any of the other arguments in this group are specified. diff --git a/gcloud/alpha/dataplex/lakes/help b/gcloud/alpha/dataplex/lakes/help index 64bf7d0a9..f63a69454 100644 --- a/gcloud/alpha/dataplex/lakes/help +++ b/gcloud/alpha/dataplex/lakes/help @@ -25,14 +25,13 @@ COMMANDS (ALPHA) Add IAM policy binding to a Dataplex lake resource. authorize - (ALPHA) Authorize a project service account to manage given resource. + (ALPHA) Authorize a service agent to manage resources. create (ALPHA) Create a Dataplex lake resource. deauthorize - (ALPHA) Deauthorize a project service account from managing given - resource. + (ALPHA) Deauthorize a service agent from managing resources. delete (ALPHA) Delete a Dataplex lake resource. diff --git a/gcloud/alpha/datastore/databases/create b/gcloud/alpha/datastore/databases/create deleted file mode 100644 index 9d11ef21d..000000000 --- a/gcloud/alpha/datastore/databases/create +++ /dev/null @@ -1,50 +0,0 @@ -NAME - gcloud alpha datastore databases create - create a Google Cloud Firestore - in Datastore Mode database - -SYNOPSIS - gcloud alpha datastore databases create [--region=REGION] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) (DEPRECATED) This command is deprecated. Please use gcloud alpha - firestore database update --type=datastore-mode instead. - - (ALPHA) (DEPRECATED) Create a Google Cloud Firestore in Datastore Mode - database. - - This command is deprecated. Please use gcloud alpha firestore database - update --type=datastore-mode instead. - -EXAMPLES - To create Google Cloud Firestore in Datastore Mode database - - $ gcloud alpha datastore databases create - - To create an app in the us-central region, run: - - $ gcloud alpha datastore databases create --region=us-central - -FLAGS - --region=REGION - The region to create the Google Cloud Firestore in Datastore Mode - database within. Use gcloud app regions list to list available regions. - -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. These variants are also available: - - $ gcloud datastore databases create - - $ gcloud beta datastore databases create - diff --git a/gcloud/alpha/datastore/databases/help b/gcloud/alpha/datastore/databases/help index da0fc6dd0..5093fca95 100644 --- a/gcloud/alpha/datastore/databases/help +++ b/gcloud/alpha/datastore/databases/help @@ -13,13 +13,6 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. -COMMANDS - COMMAND is one of the following: - - create - (ALPHA) (DEPRECATED) Create a Google Cloud Firestore in Datastore Mode - database. - NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct diff --git a/gcloud/alpha/firestore/databases/describe b/gcloud/alpha/firestore/databases/describe index 647d1f510..af15ed88a 100644 --- a/gcloud/alpha/firestore/databases/describe +++ b/gcloud/alpha/firestore/databases/describe @@ -48,5 +48,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. These variants are also available: + + $ gcloud firestore databases describe + + $ gcloud beta firestore databases describe diff --git a/gcloud/alpha/firestore/databases/list b/gcloud/alpha/firestore/databases/list index 4878737ce..e79b198da 100644 --- a/gcloud/alpha/firestore/databases/list +++ b/gcloud/alpha/firestore/databases/list @@ -7,8 +7,10 @@ SYNOPSIS [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] -DESCRIPTION - (ALPHA) Lists all Firestore databases under the project. +EXAMPLES + To list all Firestore databases. + + $ gcloud alpha firestore databases list LIST COMMAND FLAGS --filter=EXPRESSION @@ -54,5 +56,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. These variants are also available: + + $ gcloud firestore databases list + + $ gcloud beta firestore databases list diff --git a/gcloud/alpha/firestore/databases/update b/gcloud/alpha/firestore/databases/update index 0180c3b7d..0c9e267ed 100644 --- a/gcloud/alpha/firestore/databases/update +++ b/gcloud/alpha/firestore/databases/update @@ -56,5 +56,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. These variants are also available: + + $ gcloud firestore databases update + + $ gcloud beta firestore databases update diff --git a/gcloud/alpha/logging/sinks/create b/gcloud/alpha/logging/sinks/create index 61d4d919b..43e184272 100644 --- a/gcloud/alpha/logging/sinks/create +++ b/gcloud/alpha/logging/sinks/create @@ -22,7 +22,8 @@ DESCRIPTION https://cloud.google.com/logging/docs/view/logging-query-language The sink's destination can be a Cloud Logging log bucket, a Cloud Storage - bucket, a BigQuery dataset, or a Cloud Pub/Sub topic. + bucket, a BigQuery dataset, a Cloud Pub/Sub topic, or a Google Cloud + project. The destination must already exist. diff --git a/gcloud/alpha/metastore/services/alter-table-properties b/gcloud/alpha/metastore/services/alter-table-properties new file mode 100644 index 000000000..bd9e171a0 --- /dev/null +++ b/gcloud/alpha/metastore/services/alter-table-properties @@ -0,0 +1,135 @@ +NAME + gcloud alpha metastore services alter-table-properties - alter metadata + table properties + +SYNOPSIS + gcloud alpha metastore services alter-table-properties + (SERVICE : --location=LOCATION) --properties=PROPERTIES + --table-name=TABLE_NAME --update-mask=UPDATE_MASK [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Alter metadata table properties from a Dataproc Metastore service's + underlying metadata store. + + If run asynchronously with --async, exits after printing one operation name + that can be used to poll the status of the creation via: + + gcloud metastore operations describe + +EXAMPLES + To alter metadata table properties a and b on table-name + databases/{database_id}/tables/{table_id} , use the update-mask + properties.a,properties.b , and run: + + $ gcloud alpha metastore services alter-table-properties \ + my-metastore-service --location=us-central1 \ + --table-name=databases/my-database/tables/my-table \ + --update-mask=properties.a,properties.b --properties=a=1,b=2 + +POSITIONAL ARGUMENTS + Service resource - Arguments and flags that specify the table you want to + alter. 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 service on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + SERVICE + ID of the service or fully qualified identifier for the service. To + set the service attribute: + ▸ provide the argument service on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the Dataproc Metastore service. + + If not specified, will use default metastore/location. + + To set the location attribute: + ▸ provide the argument service on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property metastore/location. + +REQUIRED FLAGS + --properties=PROPERTIES + A string where field names are separated by a comma. Describes the + desired values to mutate. If update-mask is empty, the properties will + not update. Otherwise, the properties only alter the values whose + associated paths exist in the update mask. + + For example, the desired key-value pairs. + + a=2,b=3,c=4 + + --table-name=TABLE_NAME + The name of the table containing the properties you're altering in the + following format. + + databases/{database_id}/tables/{table_id} + + --update-mask=UPDATE_MASK + A string where field names are separated by a comma. Specifies the + metadata table properties fields that are overwritten by the update. + Fields specified in the update-mask are relative to the resource (not + to the full request). A field is overwritten if it is in the mask. + + For example, given the target properties: + + properties { + a: 1 + b: 2 + } + + And an update properties: + + properties { + a: 2 + b: 3 + c: 4 + } + + then if the field mask is: + + properties.b,properties.c + + then the updated result will be: + + properties { + a: 1 + b: 3 + c: 4 + } + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the metastore/v1alpha API. The full documentation for + this API can be found at: https://cloud.google.com/dataproc-metastore/docs + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta metastore services alter-table-properties + diff --git a/gcloud/alpha/metastore/services/help b/gcloud/alpha/metastore/services/help index 708369fc9..fa05c299b 100644 --- a/gcloud/alpha/metastore/services/help +++ b/gcloud/alpha/metastore/services/help @@ -40,6 +40,9 @@ COMMANDS alter-metadata-resource-location (ALPHA) Alter metadata resource location. + alter-table-properties + (ALPHA) Alter metadata table properties. + create (ALPHA) Create a Dataproc Metastore service. diff --git a/gcloud/alpha/mps/help b/gcloud/alpha/mps/help index 1b2d90eed..6182e4953 100644 --- a/gcloud/alpha/mps/help +++ b/gcloud/alpha/mps/help @@ -12,12 +12,6 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. -GROUPS - GROUP is one of the following: - - instances - (ALPHA) Manage instances in MarketplaceSolutions. - NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct diff --git a/gcloud/alpha/mps/instances/help b/gcloud/alpha/mps/instances/help deleted file mode 100644 index 1a642b8e4..000000000 --- a/gcloud/alpha/mps/instances/help +++ /dev/null @@ -1,20 +0,0 @@ -NAME - gcloud alpha mps instances - manage instances in MarketplaceSolutions - -SYNOPSIS - gcloud alpha mps instances COMMAND [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Manage instances in MarketplaceSolutions. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - 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/resource-manager/tags/bindings/create b/gcloud/alpha/resource-manager/tags/bindings/create index 490301685..761f1f79c 100644 --- a/gcloud/alpha/resource-manager/tags/bindings/create +++ b/gcloud/alpha/resource-manager/tags/bindings/create @@ -11,8 +11,8 @@ DESCRIPTION (ALPHA) Creates a TagBinding given the TagValue and the parent cloud resource the TagValue will be attached to. The TagValue can be represented with its numeric id or its namespaced name of - organizations/{org_id}/{tag_key_short_name}. The parent resource should be - represented with its full resource name. See: + {parent_namespace}/{tag_key_short_name}/{tag_value_short_name}. The parent + resource should be represented with its full resource name. See: https://cloud.google.com/apis/design/resource_names#full_resource_name. EXAMPLES diff --git a/gcloud/alpha/resource-manager/tags/bindings/delete b/gcloud/alpha/resource-manager/tags/bindings/delete index 5aafc427b..5c85d44f7 100644 --- a/gcloud/alpha/resource-manager/tags/bindings/delete +++ b/gcloud/alpha/resource-manager/tags/bindings/delete @@ -12,7 +12,7 @@ DESCRIPTION resource name. See: https://cloud.google.com/apis/design/resource_names#full_resource_name. The TagValue can be represented with its numeric id or its namespaced name of - {org_id}/{tag_key_short_name}. + {parent_namespace}/{tag_key_short_name}/{tag_value_short_name}. EXAMPLES To delete a TagBinding between tagValue/111 and Project with name diff --git a/gcloud/alpha/resource-manager/tags/bindings/help b/gcloud/alpha/resource-manager/tags/bindings/help index ff0349abd..9aaed1a49 100644 --- a/gcloud/alpha/resource-manager/tags/bindings/help +++ b/gcloud/alpha/resource-manager/tags/bindings/help @@ -7,10 +7,10 @@ SYNOPSIS DESCRIPTION (ALPHA) The Resource Manager Service gives you centralized and programmatic - control over your organization's Tags. As the tag administrator, you will - be able to create and configure restrictions across the tags in the org. As - the tag user, you will be able to attach TagValues to different resources - as a TagBinding. + control over your organization or project's Tags. As the tag administrator, + you will be able to create and configure restrictions across the tags in + your organization or projects. As the tag user, you will be able to attach + TagValues to different resources as a TagBinding. GCLOUD WIDE FLAGS These flags are available to all commands: --help. diff --git a/gcloud/alpha/resource-manager/tags/help b/gcloud/alpha/resource-manager/tags/help index 8ae7fac47..9445d3b17 100644 --- a/gcloud/alpha/resource-manager/tags/help +++ b/gcloud/alpha/resource-manager/tags/help @@ -8,8 +8,9 @@ SYNOPSIS DESCRIPTION (ALPHA) The Tags Service gives you centralized and programmatic control over your organization's tags. As the tag administrator, you will be able - to create and configure restrictions across the tags in the org. As the tag - user, you will be able to attach tags values to different resources. + to create and configure restrictions across the tags in your organization + or projects. As the tag user, you will be able to attach tags values to + different resources. GCLOUD WIDE FLAGS These flags are available to all commands: --help. diff --git a/gcloud/alpha/resource-manager/tags/holds/create b/gcloud/alpha/resource-manager/tags/holds/create index bf419728c..0e6017ade 100644 --- a/gcloud/alpha/resource-manager/tags/holds/create +++ b/gcloud/alpha/resource-manager/tags/holds/create @@ -10,7 +10,7 @@ DESCRIPTION (ALPHA) Create a TagHold under a TagValue, indicating that the TagValue is being used by a holder (cloud resource) from an (optional) origin. The TagValue can be represented with its numeric id or its namespaced name of - {org_id}/{tag_key_short_name}/{tag_value_short_name}. + {parent_namespace}/{tag_key_short_name}/{tag_value_short_name}. EXAMPLES To create a TagHold on tagValues/123, with holder cloud-resource-holder, diff --git a/gcloud/alpha/resource-manager/tags/holds/help b/gcloud/alpha/resource-manager/tags/holds/help index b89160b86..30f255836 100644 --- a/gcloud/alpha/resource-manager/tags/holds/help +++ b/gcloud/alpha/resource-manager/tags/holds/help @@ -7,8 +7,9 @@ SYNOPSIS DESCRIPTION (ALPHA) The Resource Manager Service gives you centralized and programmatic control over your organization's Tags. As the tag administrator, you will - be able to create and configure restrictions across the tags in the org, - and you will be able to indicate the use of a TagValue as a TagHold. + be able to create and configure restrictions across the tags in your + organization or projects, and you will be able to indicate the use of a + TagValue as a TagHold. GCLOUD WIDE FLAGS These flags are available to all commands: --help. diff --git a/gcloud/alpha/resource-manager/tags/holds/list b/gcloud/alpha/resource-manager/tags/holds/list index a3dc55f66..a43647c37 100644 --- a/gcloud/alpha/resource-manager/tags/holds/list +++ b/gcloud/alpha/resource-manager/tags/holds/list @@ -11,11 +11,11 @@ SYNOPSIS DESCRIPTION (ALPHA) List TagHolds under a TagValue. The TagValue can be represented with its numeric id or its namespaced name of - {org_id}/{tag_key_short_name}/{tag_value_short_name}. Limited to TagHolds - stored in a single --location: if none is provided, the API will assume the - "global" location. Optional filters are --holder and --origin: if provided, - returned TagHolds' holder and origin fields must match the exact flag - value. + {parent_namespace}/{tag_key_short_name}/{tag_value_short_name}. Limited to + TagHolds stored in a single --location: if none is provided, the API will + assume the "global" location. Optional filters are --holder and --origin: + if provided, returned TagHolds' holder and origin fields must match the + exact flag value. EXAMPLES To list TagHolds for tagValues/456 in us-central1-a, run: @@ -33,7 +33,7 @@ POSITIONAL ARGUMENTS PARENT TagValue resource name or namespaced name to list TagHolds for. This field should be in the form tagValues/ or - //. + //. FLAGS --holder=HOLDER diff --git a/gcloud/alpha/resource-manager/tags/keys/help b/gcloud/alpha/resource-manager/tags/keys/help index ed1bf3c54..54369c5fb 100644 --- a/gcloud/alpha/resource-manager/tags/keys/help +++ b/gcloud/alpha/resource-manager/tags/keys/help @@ -7,8 +7,9 @@ SYNOPSIS DESCRIPTION (ALPHA) The Resource Manager Service gives you centralized and programmatic control over your organization's Tags. As the tag administrator, you will - be able to create and configure restrictions across the tags in the org. As - the tag user, you will be able to attach TagValues to different resources. + be able to create and configure restrictions across the tags in your + organization or projects. As the tag user, you will be able to attach + TagValues to different resources. GCLOUD WIDE FLAGS These flags are available to all commands: --help. diff --git a/gcloud/alpha/resource-manager/tags/values/add-iam-policy-binding b/gcloud/alpha/resource-manager/tags/values/add-iam-policy-binding index 37192b892..b4161165c 100644 --- a/gcloud/alpha/resource-manager/tags/values/add-iam-policy-binding +++ b/gcloud/alpha/resource-manager/tags/values/add-iam-policy-binding @@ -11,8 +11,9 @@ SYNOPSIS DESCRIPTION (ALPHA) Adds the IAM policy binding for a TagValue resource given the binding and an identifier for the TagValue. The identifier can be the - TagValue's // or - the TagValue's ID in the form: tagValues/{numeric_id}. + TagValue's namespaced name in the form + // or the + TagValue's ID in the form: tagValues/{numeric_id}. EXAMPLES To add an IAM policy binding for the role of 'roles/editor' for the user diff --git a/gcloud/alpha/resource-manager/tags/values/help b/gcloud/alpha/resource-manager/tags/values/help index 541a66206..8f5d90b09 100644 --- a/gcloud/alpha/resource-manager/tags/values/help +++ b/gcloud/alpha/resource-manager/tags/values/help @@ -7,8 +7,9 @@ SYNOPSIS DESCRIPTION (ALPHA) The Resource Manager Service gives you centralized and programmatic control over your organization's Tags. As the tag administrator, you will - be able to create and configure restrictions across the tags in the org. As - the tag user, you will be able to attach TagValues to different resources. + be able to create and configure restrictions across the tags in your + organization or projects. As the tag user, you will be able to attach + TagValues to different resources. GCLOUD WIDE FLAGS These flags are available to all commands: --help. diff --git a/gcloud/alpha/resource-manager/tags/values/remove-iam-policy-binding b/gcloud/alpha/resource-manager/tags/values/remove-iam-policy-binding index ba316ab29..39b16c81a 100644 --- a/gcloud/alpha/resource-manager/tags/values/remove-iam-policy-binding +++ b/gcloud/alpha/resource-manager/tags/values/remove-iam-policy-binding @@ -11,8 +11,9 @@ SYNOPSIS DESCRIPTION (ALPHA) Removes an IAM policy binding for a TagValue resource given the binding and an identifier for the TagValue. The identifier can be the - TagValue's // or - the TagValue's ID in the form: tagValues/{numeric_id}. + TagValue's namespaced name in the form + // or the + TagValue's ID in the form: tagValues/{numeric_id}. EXAMPLES To remove an IAM policy binding for the role of 'roles/editor' for the user diff --git a/gcloud/alpha/resource-manager/tags/values/update b/gcloud/alpha/resource-manager/tags/values/update index e426fbcb6..032f380c2 100644 --- a/gcloud/alpha/resource-manager/tags/values/update +++ b/gcloud/alpha/resource-manager/tags/values/update @@ -7,8 +7,8 @@ SYNOPSIS [--description=DESCRIPTION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Updates the TagValue's description given the TagValue's - // or the TagValue's + (ALPHA) Updates the TagValue's description given the TagValue's namespaced + name // or the TagValue's numeric id tagValues/ EXAMPLES diff --git a/gcloud/alpha/run/jobs/execute b/gcloud/alpha/run/jobs/execute index d03dcab8b..eb786583c 100644 --- a/gcloud/alpha/run/jobs/execute +++ b/gcloud/alpha/run/jobs/execute @@ -2,7 +2,9 @@ NAME gcloud alpha run jobs execute - execute a job SYNOPSIS - gcloud alpha run jobs execute [JOB] [--region=REGION] [--async | --wait] + gcloud alpha run jobs execute [JOB] [--args=[ARG,...]] [--region=REGION] + [--task-timeout=TASK_TIMEOUT] [--tasks=TASKS] + [--update-env-vars=[KEY=VALUE,...]] [--async | --wait] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -31,10 +33,38 @@ POSITIONAL ARGUMENTS ▸ specify the job name from an interactive prompt. FLAGS + --args=[ARG,...] + Comma-separated arguments passed to the command run by the container + image. If provided, an execution will be created with the input values. + Otherwise, the existing arguments of the job are used. + --region=REGION Region in which the resource can be found. Alternatively, set the property [run/region]. + --task-timeout=TASK_TIMEOUT + The existing maximum time (deadline) a job task attempt can run for. If + provided, an execution will be created with this value. Otherwise + existing maximum time of the job is used. In the case of retries, this + deadline applies to each attempt of a task. If the task attempt does + not complete within this time, it will be killed. It is specified as a + duration; for example, "10m5s" is ten minutes, and five seconds. If you + don't specify a unit, seconds is assumed. For example, "10" is 10 + seconds. + + --tasks=TASKS + Number of tasks that must run to completion for the job to be + considered done. If provided, an execution will be created with this + value. Otherwise the existing task count of the job is used. Use this + flag to trigger multiple runs of the job. + + --update-env-vars=[KEY=VALUE,...] + List of key-value pairs to set as environment variables overrides for + an execution of a job. If provided, an execution will be created with + the merge result of the input values and the existing environment + variables. New value overrides existing value if they have the same + key. If not provided, existing environment variables are used. + At most one of these can be specified: --async diff --git a/gcloud/alpha/storage/help b/gcloud/alpha/storage/help index 0501fe8e3..ae3c1aa08 100644 --- a/gcloud/alpha/storage/help +++ b/gcloud/alpha/storage/help @@ -23,6 +23,9 @@ GROUPS buckets (ALPHA) Manage Cloud Storage buckets. + insights + (ALPHA) Manage Cloud Storage inventory reports. + objects (ALPHA) Manage Cloud Storage objects. diff --git a/gcloud/alpha/storage/insights/help b/gcloud/alpha/storage/insights/help new file mode 100644 index 000000000..597a7b4c7 --- /dev/null +++ b/gcloud/alpha/storage/insights/help @@ -0,0 +1,28 @@ +NAME + gcloud alpha storage insights - manage Cloud Storage inventory reports + +SYNOPSIS + gcloud alpha storage insights GROUP [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Cloud Storage inventory reports. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + inventory-reports + (ALPHA) Manage Cloud Storage inventory report configurations. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud storage insights + diff --git a/gcloud/alpha/storage/insights/inventory-reports/create b/gcloud/alpha/storage/insights/inventory-reports/create new file mode 100644 index 000000000..33cfd72b1 --- /dev/null +++ b/gcloud/alpha/storage/insights/inventory-reports/create @@ -0,0 +1,105 @@ +NAME + gcloud alpha storage insights inventory-reports create - create a new + inventory report config + +SYNOPSIS + gcloud alpha storage insights inventory-reports create SOURCE_BUCKET_URL + [--destination=DESTINATION_URL] [--display-name=DISPLAY_NAME] + [--metadata-fields=[METADATA_FIELDS,...]; + default="project,bucket,name,location,size,timeCreated,timeDeleted, + updated,storageClass,etag,retentionExpirationTime,crc32c,md5Hash, + generation, + metageneration,contentType,contentEncoding,timeStorageClassUpdated"] + [--schedule-repeats=FREQUENCY; default="daily"] + [--schedule-repeats-until=END_DATE] [--schedule-starts=START_DATE] + [--parquet | --csv-delimiter=DELIMITER + --[no-]csv-header --csv-separator=SEPARATOR] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create an inventory report config that defines how often inventory + reports are generated, the metadata fields you want the reports to include, + and a bucket/prefix in which to store the reports, also known as the + destination. + +EXAMPLES + To create an inventory report about "my-bucket" that will store report + details in "report-bucket" with the prefix "save-path/". + + $ gcloud alpha storage insights inventory-reports create \ + gs://my-bucket --destination=gs://report-bucket/save-path/ + +POSITIONAL ARGUMENTS + SOURCE_BUCKET_URL + URL of the source bucket that will contain the inventory report + configuration. + +FLAGS + --destination=DESTINATION_URL + Sets the URL of the destination bucket and path where generated reports + are stored. Defaults to /inventory_reports/. + + --display-name=DISPLAY_NAME + Sets the editable name of the report configuration. + + --metadata-fields=[METADATA_FIELDS,...]; default="project,bucket,name,location,size,timeCreated,timeDeleted,updated,storageClass,etag,retentionExpirationTime,crc32c,md5Hash,generation,metageneration,contentType,contentEncoding,timeStorageClassUpdated" + The metadata fields to be included in the inventory report. The fields: + "project, bucket, name" are REQUIRED. Defaults to all fields being + included. METADATA_FIELDS must be one of: project, bucket, name, + location, size, timeCreated, timeDeleted, updated, storageClass, etag, + retentionExpirationTime, crc32c, md5Hash, generation, metageneration, + contentType, contentEncoding, timeStorageClassUpdated. + + --schedule-repeats=FREQUENCY; default="daily" + Sets how often the inventory report configuration will run. Defaults to + DAILY. FREQUENCY must be one of: daily, weekly. + + --schedule-repeats-until=END_DATE + Sets date after which you want to stop generating inventory reports. + For example, 2022-03-30. Defaults to one year from --schedule-starts + value. + + --schedule-starts=START_DATE + Sets the date you want to start generating inventory reports. For + example, 2022-01-30. Should be tomorrow or later based on UTC timezone. + Defaults to tomorrow. + + Report format configuration. Any combination of CSV flags is valid as long + as the Parquet flag is not present. + + At most one of these can be specified: + + --parquet + Generate reports in parquet format. + + Flags for setting CSV format options. + + --csv-delimiter=DELIMITER + Sets the delimiter that separates the fields in the inventory + report CSV file. For example, ``,`` + + --[no-]csv-header + Indicates whether or not headers are included in the inventory + report CSV file. Default is None. Use --csv-header to enable and + --no-csv-header to disable. + + --csv-separator=SEPARATOR + Sets the character used to separate the records in the inventory + report CSV file. For example, ``\n``. SEPARATOR must be one of: \n, + \r\n. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud storage insights inventory-reports create + diff --git a/gcloud/alpha/storage/insights/inventory-reports/delete b/gcloud/alpha/storage/insights/inventory-reports/delete new file mode 100644 index 000000000..8c2922f67 --- /dev/null +++ b/gcloud/alpha/storage/insights/inventory-reports/delete @@ -0,0 +1,75 @@ +NAME + gcloud alpha storage insights inventory-reports delete - delete an + inventory report config + +SYNOPSIS + gcloud alpha storage insights inventory-reports delete + (REPORT_CONFIG : --location=LOCATION) [--force] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete an inventory report config. + +EXAMPLES + To delete an inventory report config with ID=1234, location=us-central1 and + project=foo: + + $ gcloud alpha storage insights inventory-reports delete 1234 \ + --location=us-central1 --project=foo + + To delete the same inventory report config with fully specified name: + + $ gcloud alpha storage insights inventory-reports delete \ + /projects/foo/locations/us-central1/reportConfigs/1234 + + To delete the report config with all generated report details: + + $ gcloud alpha storage insights inventory-reports delete \ + /projects/foo/locations/us-central1/reportConfigs/1234 --force + +POSITIONAL ARGUMENTS + Report config resource - The Report config to delete. The arguments in + this group can be used to specify the attributes of this resource. (NOTE) + Some attributes are not given arguments in this group but can be set in + other ways. To set the project attribute: + ◆ provide the argument report_config 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. + + REPORT_CONFIG + ID of the report-config or fully qualified identifier for the + report-config. To set the report-config attribute: + ▸ provide the argument report_config on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Google Cloud location for the report-config. To set the location + attribute: + ▸ provide the argument report_config on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --force + If set, all report details for this report config will be deleted. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud storage insights inventory-reports delete + diff --git a/gcloud/alpha/storage/insights/inventory-reports/describe b/gcloud/alpha/storage/insights/inventory-reports/describe new file mode 100644 index 000000000..8de149b04 --- /dev/null +++ b/gcloud/alpha/storage/insights/inventory-reports/describe @@ -0,0 +1,73 @@ +NAME + gcloud alpha storage insights inventory-reports describe - describe an + inventory report config + +SYNOPSIS + gcloud alpha storage insights inventory-reports describe + (REPORT_CONFIG : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe an inventory report config. + +EXAMPLES + To describe an inventory report config with ID=1234, location=us-central1, + and project=foo: + + $ gcloud alpha storage insights inventory-reports describe 1234 \ + --location=us-central1 --project=foo + + To describe the same inventory report config with fully specified name: + + $ gcloud alpha storage insights inventory-reports describe \ + /projects/foo/locations/us-central1/reportConfigs/1234 + + Describe the same inventory report config with JSON formatting, only + returning the "displayName" field: + + $ gcloud alpha storage insights inventory-reports describe \ + /projects/foo/locations/us-central1/reportConfigs/1234 \ + --format="json(displayName)" + +POSITIONAL ARGUMENTS + Report config resource - The Report config to describe. The arguments in + this group can be used to specify the attributes of this resource. (NOTE) + Some attributes are not given arguments in this group but can be set in + other ways. To set the project attribute: + ◆ provide the argument report_config 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. + + REPORT_CONFIG + ID of the report-config or fully qualified identifier for the + report-config. To set the report-config attribute: + ▸ provide the argument report_config on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Google Cloud location for the report-config. To set the location + attribute: + ▸ provide the argument report_config on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud storage insights inventory-reports describe + diff --git a/gcloud/alpha/storage/insights/inventory-reports/details/describe b/gcloud/alpha/storage/insights/inventory-reports/details/describe new file mode 100644 index 000000000..93b37bba2 --- /dev/null +++ b/gcloud/alpha/storage/insights/inventory-reports/details/describe @@ -0,0 +1,82 @@ +NAME + gcloud alpha storage insights inventory-reports details describe - describe + inventory reports detail + +SYNOPSIS + gcloud alpha storage insights inventory-reports details describe + (REPORT_DETAIL : --location=LOCATION --report-config=REPORT_CONFIG) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe the inventory report detail. + +EXAMPLES + To describe an inventory report detail with ID=4568, location=us-central1, + project=foo, and report config ID=1234: + + $ gcloud alpha storage insights inventory-reports details describe \ + 1234 --location=us-central1 --project=foo --report-config=1234 + + To describe the same inventory report detail with fully specified name: + + $ gcloud alpha storage insights inventory-reports details describe \ + /projects/foo/locations/us-central1/reportConfigs/1234/\ + reportDetails/5678 + + To describe the same inventory report detail with JSON formatting, only + returning the "status" field: + + $ gcloud alpha storage insights inventory-reports details describe \ + /projects/foo/locations/us-central1/reportConfigs/1234/\ + reportDetails/5678 --format="json(status)" + +POSITIONAL ARGUMENTS + Report detail resource - The report detail to describe. The arguments in + this group can be used to specify the attributes of this resource. (NOTE) + Some attributes are not given arguments in this group but can be set in + other ways. To set the project attribute: + ◆ provide the argument report_detail 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. + + REPORT_DETAIL + ID of the report-detail or fully qualified identifier for the + report-detail. To set the report-detail attribute: + ▸ provide the argument report_detail on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Google Cloud location for the report-detail. To set the location + attribute: + ▸ provide the argument report_detail on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + + --report-config=REPORT_CONFIG + Report Config ID for the report-detail. To set the report-config + attribute: + ▸ provide the argument report_detail on the command line with a + fully specified name; + ▸ provide the argument --report-config on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud storage insights inventory-reports details describe + diff --git a/gcloud/alpha/storage/insights/inventory-reports/details/help b/gcloud/alpha/storage/insights/inventory-reports/details/help new file mode 100644 index 000000000..6717f1990 --- /dev/null +++ b/gcloud/alpha/storage/insights/inventory-reports/details/help @@ -0,0 +1,33 @@ +NAME + gcloud alpha storage insights inventory-reports details - retrieve details + of inventory reports + +SYNOPSIS + gcloud alpha storage insights inventory-reports details COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Retrieve details of inventory reports. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + (ALPHA) Describe inventory reports detail. + + list + (ALPHA) List inventory report details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud storage insights inventory-reports details + diff --git a/gcloud/alpha/storage/insights/inventory-reports/details/list b/gcloud/alpha/storage/insights/inventory-reports/details/list new file mode 100644 index 000000000..b43980691 --- /dev/null +++ b/gcloud/alpha/storage/insights/inventory-reports/details/list @@ -0,0 +1,109 @@ +NAME + gcloud alpha storage insights inventory-reports details list - list + inventory report details + +SYNOPSIS + gcloud alpha storage insights inventory-reports details list + (REPORT_CONFIG : --location=LOCATION) [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List all inventory report details generated by a given inventory + report config. + +EXAMPLES + To list all inventory report details for report config ID=1234, + location=us-central1, and project=foo: + + $ gcloud alpha storage insights inventory-reports details list \ + 1234 --location=us-central1 --project=foo + + To list all the same inventory report details with fully specified name of + the report config: + + $ gcloud alpha storage insights inventory-reports details list \ + /projects/foo/locations/us-central1/reportConfigs/1234 + + To list all inventory reports, only returning the "status" key: + + $ gcloud alpha storage insights inventory-reports details list \ + projects/a/locations/b/reportConfigs/some-id \ + --format="json(status)" + +POSITIONAL ARGUMENTS + Report config resource - The Report config for which the report details + should be listed. 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 report_config 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. + + REPORT_CONFIG + ID of the report-config or fully qualified identifier for the + report-config. To set the report-config attribute: + ▸ provide the argument report_config on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Google Cloud location for the report-config. To set the location + attribute: + ▸ provide the argument report_config on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud storage insights inventory-reports details list + diff --git a/gcloud/alpha/storage/insights/inventory-reports/help b/gcloud/alpha/storage/insights/inventory-reports/help new file mode 100644 index 000000000..c8c7c9b2f --- /dev/null +++ b/gcloud/alpha/storage/insights/inventory-reports/help @@ -0,0 +1,48 @@ +NAME + gcloud alpha storage insights inventory-reports - manage Cloud Storage + inventory report configurations + +SYNOPSIS + gcloud alpha storage insights inventory-reports GROUP | COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Cloud Storage inventory report configurations. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + details + (ALPHA) Retrieve details of inventory reports. + +COMMANDS + COMMAND is one of the following: + + create + (ALPHA) Create a new inventory report config. + + delete + (ALPHA) Delete an inventory report config. + + describe + (ALPHA) Describe an inventory report config. + + list + (ALPHA) Lists all inventory report configs. + + update + (ALPHA) Update an inventory report config. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud storage insights inventory-reports + diff --git a/gcloud/alpha/storage/insights/inventory-reports/list b/gcloud/alpha/storage/insights/inventory-reports/list new file mode 100644 index 000000000..4ea431092 --- /dev/null +++ b/gcloud/alpha/storage/insights/inventory-reports/list @@ -0,0 +1,80 @@ +NAME + gcloud alpha storage insights inventory-reports list - lists all inventory + report configs + +SYNOPSIS + gcloud alpha storage insights inventory-reports list [--location=LOCATION] + [--source=SOURCE_BUCKET_URL] [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List Cloud Storage inventory report configs. + +EXAMPLES + List all inventory report configs in the source bucket "my-bucket": + + $ gcloud alpha storage insights inventory-reports list \ + --source=gs://my-bucket + + List buckets with JSON formatting, only returning the "displayName" field: + + $ gcloud alpha storage insights inventory-reports list \ + --source=gs://my-bucket --format="json(displayName)" + +FLAGS + --location=LOCATION + The location of the report configs. + + --source=SOURCE_BUCKET_URL + Specifies URL of the source bucket that contains the inventory report + configuration. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud storage insights inventory-reports list + diff --git a/gcloud/alpha/storage/insights/inventory-reports/update b/gcloud/alpha/storage/insights/inventory-reports/update new file mode 100644 index 000000000..00e3f9b96 --- /dev/null +++ b/gcloud/alpha/storage/insights/inventory-reports/update @@ -0,0 +1,144 @@ +NAME + gcloud alpha storage insights inventory-reports update - update an + inventory report config + +SYNOPSIS + gcloud alpha storage insights inventory-reports update + (REPORT_CONFIG : --location=LOCATION) [--destination=DESTINATION_URL] + [--display-name=DISPLAY_NAME] [--schedule-repeats=FREQUENCY] + [--schedule-repeats-until=END_DATE] [--schedule-starts=START_DATE] + [--metadata-fields=[METADATA_FIELDS,...] + | --add-metadata-fields=[METADATA_FIELDS,...] + --remove-metadata-fields=[METADATA_FIELDS,...]] + [--parquet | --csv-delimiter=DELIMITER + --[no-]csv-header --csv-separator=SEPARATOR] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Update an inventory report config. + +EXAMPLES + To update the display-name of an inventory report config with ID=1234, + location=us-central1, and project=foo: + + $ gcloud alpha storage insights inventory-reports update 1234 \ + --location=us-central1 --project=foo --display-name=bar + + To update the same inventory report config with fully specified name: + + $ gcloud alpha storage insights inventory-reports update \ + /projects/foo/locations/us-central1/reportConfigs/1234 \ + --display-name=bar + +POSITIONAL ARGUMENTS + Report config resource - The Report config to update. The arguments in + this group can be used to specify the attributes of this resource. (NOTE) + Some attributes are not given arguments in this group but can be set in + other ways. To set the project attribute: + ◆ provide the argument report_config 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. + + REPORT_CONFIG + ID of the report-config or fully qualified identifier for the + report-config. To set the report-config attribute: + ▸ provide the argument report_config on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Google Cloud location for the report-config. To set the location + attribute: + ▸ provide the argument report_config on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --destination=DESTINATION_URL + Sets the URL of the destination bucket and path where generated reports + are stored. + + --display-name=DISPLAY_NAME + Sets the editable name of the report configuration. + + --schedule-repeats=FREQUENCY + Sets how often the inventory report configuration will run. FREQUENCY + must be one of: daily, weekly. + + --schedule-repeats-until=END_DATE + Sets date after which you want to stop generating inventory reports. + For example, 2022-03-30. + + --schedule-starts=START_DATE + Sets the date you want to start generating inventory reports. For + example, 2022-01-30. Should be tomorrow or later based on UTC timezone. + + At most one of these can be specified: + + --metadata-fields=[METADATA_FIELDS,...] + The metadata fields to be included in the inventory report. The + fields: "project, bucket, name" are REQUIRED. METADATA_FIELDS must be + one of: project, bucket, name, location, size, timeCreated, + timeDeleted, updated, storageClass, etag, retentionExpirationTime, + crc32c, md5Hash, generation, metageneration, contentType, + contentEncoding, timeStorageClassUpdated. + + Add and Remove flags for metadata fields + + --add-metadata-fields=[METADATA_FIELDS,...] + Adds fields to the metadata_fields list. METADATA_FIELDS must be + one of: location, size, timeCreated, timeDeleted, updated, + storageClass, etag, retentionExpirationTime, crc32c, md5Hash, + generation, metageneration, contentType, contentEncoding, + timeStorageClassUpdated. + + --remove-metadata-fields=[METADATA_FIELDS,...] + Removes fields from the metadata_fields list. METADATA_FIELDS must + be one of: location, size, timeCreated, timeDeleted, updated, + storageClass, etag, retentionExpirationTime, crc32c, md5Hash, + generation, metageneration, contentType, contentEncoding, + timeStorageClassUpdated. + + Report format configuration. Any combination of CSV flags is valid as long + as the Parquet flag is not present. + + At most one of these can be specified: + + --parquet + Generate reports in parquet format. + + Flags for setting CSV format options. + + --csv-delimiter=DELIMITER + Sets the delimiter that separates the fields in the inventory + report CSV file. For example, ``,`` + + --[no-]csv-header + Indicates whether or not headers are included in the inventory + report CSV file. Default is None. Use --csv-header to enable and + --no-csv-header to disable. + + --csv-separator=SEPARATOR + Sets the character used to separate the records in the inventory + report CSV file. For example, ``\n``. SEPARATOR must be one of: \n, + \r\n. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud storage insights inventory-reports update + diff --git a/gcloud/alpha/workstations/configs/create b/gcloud/alpha/workstations/configs/create index f87b2c2ea..088567cf8 100644 --- a/gcloud/alpha/workstations/configs/create +++ b/gcloud/alpha/workstations/configs/create @@ -12,7 +12,7 @@ SYNOPSIS [--container-run-as-user=CONTAINER_RUN_AS_USER] [--container-working-dir=CONTAINER_WORKING_DIR] [--disable-public-ip-addresses] [--enable-confidential-compute] - [--idle-timeout=IDLE_TIMEOUT; default=7200] + [--idle-timeout=IDLE_TIMEOUT; default=7200] [--labels=[LABELS,...]] [--machine-type=MACHINE_TYPE; default="e2-standard-4"] [--network-tags=[NETWORK_TAGS,...]] [--pd-disk-size=PD_DISK_SIZE; default=200] @@ -134,6 +134,15 @@ FLAGS that hasn't received any user traffic. A value of 0 indicates that this instance should never time out due to idleness. + --labels=[LABELS,...] + Labels that are applied to the resource and propagated to the + underlying Compute Engine resources. + + Example: + + $ gcloud alpha workstations configs create \ + --labels=label1=value1,label2=value2 + --machine-type=MACHINE_TYPE; default="e2-standard-4" Machine type determines the specifications of the Compute Engine machines that the workstations created under this configuration will diff --git a/gcloud/alpha/workstations/configs/update b/gcloud/alpha/workstations/configs/update index 379221685..161fe3468 100644 --- a/gcloud/alpha/workstations/configs/update +++ b/gcloud/alpha/workstations/configs/update @@ -12,11 +12,11 @@ SYNOPSIS [--container-run-as-user=CONTAINER_RUN_AS_USER] [--container-working-dir=CONTAINER_WORKING_DIR] [--disable-public-ip-addresses] [--enable-confidential-compute] - [--idle-timeout=IDLE_TIMEOUT] [--machine-type=MACHINE_TYPE] - [--network-tags=[NETWORK_TAGS,...]] [--pool-size=POOL_SIZE] - [--running-timeout=RUNNING_TIMEOUT] [--service-account=SERVICE_ACCOUNT] - [--shielded-integrity-monitoring] [--shielded-secure-boot] - [--shielded-vtpm] + [--idle-timeout=IDLE_TIMEOUT] [--labels=[LABELS,...]] + [--machine-type=MACHINE_TYPE] [--network-tags=[NETWORK_TAGS,...]] + [--pool-size=POOL_SIZE] [--running-timeout=RUNNING_TIMEOUT] + [--service-account=SERVICE_ACCOUNT] [--shielded-integrity-monitoring] + [--shielded-secure-boot] [--shielded-vtpm] [--container-custom-image=CONTAINER_CUSTOM_IMAGE | --container-predefined-image=CONTAINER_PREDEFINED_IMAGE] [GCLOUD_WIDE_FLAG ...] @@ -122,6 +122,15 @@ FLAGS that hasn't received any user traffic. A value of 0 indicates that this instance should never time out due to idleness. + --labels=[LABELS,...] + Labels that are applied to the resource and propagated to the + underlying Compute Engine resources. + + Example: + + $ gcloud alpha workstations configs update \ + --labels=label1=value1,label2=value2 + --machine-type=MACHINE_TYPE Machine type determines the specifications of the Compute Engine machines that the workstations created under this configuration will diff --git a/gcloud/auth/print-access-token b/gcloud/auth/print-access-token index eac0c0202..158d68848 100644 --- a/gcloud/auth/print-access-token +++ b/gcloud/auth/print-access-token @@ -3,7 +3,8 @@ NAME account SYNOPSIS - gcloud auth print-access-token [ACCOUNT] [GCLOUD_WIDE_FLAG ...] + gcloud auth print-access-token [ACCOUNT] [--lifetime=LIFETIME] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION Print an access token for the specified account. See RFC6749 @@ -34,6 +35,16 @@ POSITIONAL ARGUMENTS Account to get the access token for. If not specified, the current active account will be used. +FLAGS + --lifetime=LIFETIME + Access token lifetime. The default access token lifetime is 3600 + seconds, but you can use this flag to reduce the lifetime or extend it + up to 43200 seconds (12 hours). The org policy constraint + constraints/iam.allowServiceAccountCredentialLifetimeExtension must be + set if you want to extend the lifetime beyond 3600 seconds. Note that + this flag is for service account impersonation only, so it must be used + together with the --impersonate-service-account flag. + 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/auth/print-access-token b/gcloud/beta/auth/print-access-token index 90aa953c1..cdc34e9a9 100644 --- a/gcloud/beta/auth/print-access-token +++ b/gcloud/beta/auth/print-access-token @@ -3,7 +3,8 @@ NAME specified account SYNOPSIS - gcloud beta auth print-access-token [ACCOUNT] [GCLOUD_WIDE_FLAG ...] + gcloud beta auth print-access-token [ACCOUNT] [--lifetime=LIFETIME] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Print an access token for the specified account. See RFC6749 @@ -34,6 +35,16 @@ POSITIONAL ARGUMENTS Account to get the access token for. If not specified, the current active account will be used. +FLAGS + --lifetime=LIFETIME + Access token lifetime. The default access token lifetime is 3600 + seconds, but you can use this flag to reduce the lifetime or extend it + up to 43200 seconds (12 hours). The org policy constraint + constraints/iam.allowServiceAccountCredentialLifetimeExtension must be + set if you want to extend the lifetime beyond 3600 seconds. Note that + this flag is for service account impersonation only, so it must be used + together with the --impersonate-service-account flag. + 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/compute/disks/start-async-replication b/gcloud/beta/compute/disks/start-async-replication index ecca4fceb..9fbddc70c 100644 --- a/gcloud/beta/compute/disks/start-async-replication +++ b/gcloud/beta/compute/disks/start-async-replication @@ -4,10 +4,11 @@ NAME SYNOPSIS gcloud beta compute disks start-async-replication DISK_NAME - --secondary-disk=SECONDARY_DISK [--region=REGION | --zone=ZONE] + --secondary-disk=SECONDARY_DISK (--region=REGION | --zone=ZONE) + (--secondary-disk-region=SECONDARY_DISK_REGION + | --secondary-disk-zone=SECONDARY_DISK_ZONE) [--secondary-disk-project=SECONDARY_DISK_PROJECT] - [--secondary-disk-region=SECONDARY_DISK_REGION - | --secondary-disk-zone=SECONDARY_DISK_ZONE] [GCLOUD_WIDE_FLAG ...] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) gcloud beta compute disks start-async-replication starts async @@ -31,8 +32,7 @@ REQUIRED FLAGS Secondary disk for asynchronous replication. This flag is required when starting replication. -FLAGS - At most one of these can be specified: + Exactly one of these must be specified: --region=REGION Region of the disk to operate on. If not specified, you might be @@ -75,11 +75,7 @@ FLAGS Alternatively, the zone can be stored in the environment variable CLOUDSDK_COMPUTE_ZONE. -SECONDARY DISK FLAGS - --secondary-disk-project=SECONDARY_DISK_PROJECT - Project of the secondary disk for asynchronous replication. - - At most one of these can be specified: + Exactly one of these must be specified: --secondary-disk-region=SECONDARY_DISK_REGION Region of the secondary disk for asynchronous replication. Overrides @@ -90,6 +86,10 @@ SECONDARY DISK FLAGS Zone of the secondary disk for asynchronous replication. Overrides the default compute/zone property value for this command invocation. +SECONDARY DISK FLAGS + --secondary-disk-project=SECONDARY_DISK_PROJECT + Project of the secondary disk for asynchronous replication. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/beta/config/get b/gcloud/beta/config/get index 4e75b7b64..7d3372a15 100644 --- a/gcloud/beta/config/get +++ b/gcloud/beta/config/get @@ -562,6 +562,9 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud firebase test command group. Defaults to https://testing.googleapis.com/ + transfer + Overrides API endpoint for gcloud transfer command group. + vision Overrides API endpoint for gcloud ml vision command group. Defaults to https://vision.googleapis.com/ diff --git a/gcloud/beta/config/help b/gcloud/beta/config/help index 51dfb01dd..df4b801d5 100644 --- a/gcloud/beta/config/help +++ b/gcloud/beta/config/help @@ -594,6 +594,9 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud firebase test command group. Defaults to https://testing.googleapis.com/ + transfer + Overrides API endpoint for gcloud transfer command group. + vision Overrides API endpoint for gcloud ml vision command group. Defaults to https://vision.googleapis.com/ diff --git a/gcloud/beta/config/list b/gcloud/beta/config/list index 6f9c73e6f..60d6f3a30 100644 --- a/gcloud/beta/config/list +++ b/gcloud/beta/config/list @@ -606,6 +606,9 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud firebase test command group. Defaults to https://testing.googleapis.com/ + transfer + Overrides API endpoint for gcloud transfer command group. + vision Overrides API endpoint for gcloud ml vision command group. Defaults to https://vision.googleapis.com/ diff --git a/gcloud/beta/config/set b/gcloud/beta/config/set index 7f723e4e0..81ab91836 100644 --- a/gcloud/beta/config/set +++ b/gcloud/beta/config/set @@ -609,6 +609,9 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud firebase test command group. Defaults to https://testing.googleapis.com/ + transfer + Overrides API endpoint for gcloud transfer command group. + vision Overrides API endpoint for gcloud ml vision command group. Defaults to https://vision.googleapis.com/ diff --git a/gcloud/beta/config/unset b/gcloud/beta/config/unset index 264bbb5c6..694c2df5a 100644 --- a/gcloud/beta/config/unset +++ b/gcloud/beta/config/unset @@ -570,6 +570,9 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud firebase test command group. Defaults to https://testing.googleapis.com/ + transfer + Overrides API endpoint for gcloud transfer command group. + vision Overrides API endpoint for gcloud ml vision command group. Defaults to https://vision.googleapis.com/ diff --git a/gcloud/beta/container/clusters/create b/gcloud/beta/container/clusters/create index 257fc741e..28230e6f6 100644 --- a/gcloud/beta/container/clusters/create +++ b/gcloud/beta/container/clusters/create @@ -167,7 +167,7 @@ FLAGS ADDON must be one of: HttpLoadBalancing, HorizontalPodAutoscaling, KubernetesDashboard, NetworkPolicy, NodeLocalDNS, ConfigConnector, GcePersistentDiskCsiDriver, GcpFilestoreCsiDriver, BackupRestore, - Istio, CloudRun. + Istio, GcsFuseCsiDriver, CloudRun. --allow-route-overlap Allows the provided cluster CIDRs to overlap with existing routes that diff --git a/gcloud/beta/container/clusters/update b/gcloud/beta/container/clusters/update index 59342363e..d4fa0f974 100644 --- a/gcloud/beta/container/clusters/update +++ b/gcloud/beta/container/clusters/update @@ -31,6 +31,8 @@ SYNOPSIS | --stack-type=STACK_TYPE | --start-credential-rotation | --start-ip-rotation | --update-addons=[ADDON=ENABLED|DISABLED,...] | --update-labels=[KEY=VALUE,...] | --workload-pool=WORKLOAD_POOL + | --additional-pod-ipv4-ranges=NAME,[NAME,...] + --remove-additional-pod-ipv4-ranges=NAME,[NAME,...] | --additional-zones=[ZONE,...] | --node-locations=ZONE,[ZONE,...] | --binauthz-policy=BINAUTHZ_POLICY --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE @@ -48,8 +50,7 @@ SYNOPSIS --enable-resource-consumption-metering --resource-usage-bigquery-dataset=RESOURCE_USAGE_BIGQUERY_DATASET | --cluster-dns=CLUSTER_DNS --cluster-dns-domain=CLUSTER_DNS_DOMAIN - --cluster-dns-scope=CLUSTER_DNS_SCOPE | --disable-managed-prometheus - | --enable-managed-prometheus | [--enable-autoprovisioning + --cluster-dns-scope=CLUSTER_DNS_SCOPE | [--enable-autoprovisioning : --autoprovisioning-config-file=AUTOPROVISIONING_CONFIG_FILE | --autoprovisioning-image-type=AUTOPROVISIONING_IMAGE_TYPE --autoprovisioning-locations=ZONE,[ZONE,...] @@ -67,8 +68,9 @@ SYNOPSIS [--max-accelerator=[type=TYPE,count=COUNT,...] : --min-accelerator=[type=TYPE,count=COUNT,...]]] | --enable-tpu --enable-tpu-service-networking | --tpu-ipv4-cidr=CIDR - | --logging=[COMPONENT,...] --monitoring=[COMPONENT,...] - | --logging-service=LOGGING_SERVICE + | --logging=[COMPONENT,...] + --monitoring=[COMPONENT,...] --disable-managed-prometheus + | --enable-managed-prometheus | --logging-service=LOGGING_SERVICE --monitoring-service=MONITORING_SERVICE | --password=PASSWORD --enable-basic-auth | --username=USERNAME, -u USERNAME) [--async] @@ -532,6 +534,7 @@ REQUIRED FLAGS NodeLocalDNS=ENABLED|DISABLED GcePersistentDiskCsiDriver=ENABLED|DISABLED GcpFilestoreCsiDriver=ENABLED|DISABLED + GcsFuseCsiDriver=ENABLED|DISABLED --update-labels=[KEY=VALUE,...] Labels to apply to the Google Cloud resources in use by the @@ -555,6 +558,24 @@ REQUIRED FLAGS https://cloud.google.com/kubernetes-engine/docs/how-to/workload-identity + --additional-pod-ipv4-ranges=NAME,[NAME,...] + Additional IP address ranges(by name) for pods that need to be added + to the cluster. + + Examples: + + $ gcloud beta container clusters update example-cluster \ + --additional-pod-ipv4-ranges=range1,range2 + + --remove-additional-pod-ipv4-ranges=NAME,[NAME,...] + Previously added additional pod ranges(by name) for pods that are to + be removed from the cluster. + + Examples: + + $ gcloud beta container clusters update example-cluster \ + --remove-additional-pod-ipv4-ranges=range1,range2 + At most one of these can be specified: --additional-zones=[ZONE,...] @@ -787,14 +808,6 @@ REQUIRED FLAGS vpc Configures the Cloud DNS zone to be private to the VPC Network. - At most one of these can be specified: - - --disable-managed-prometheus - Disable managed collection for Managed Service for Prometheus. - - --enable-managed-prometheus - Enable managed collection for Managed Service for Prometheus. - Node autoprovisioning --enable-autoprovisioning @@ -1085,6 +1098,14 @@ REQUIRED FLAGS --monitoring=SYSTEM,API_SERVER $ gcloud beta container clusters update --monitoring=NONE + At most one of these can be specified: + + --disable-managed-prometheus + Disable managed collection for Managed Service for Prometheus. + + --enable-managed-prometheus + Enable managed collection for Managed Service for Prometheus. + --logging-service=LOGGING_SERVICE (DEPRECATED) Logging service to use for the cluster. Options are: "logging.googleapis.com/kubernetes" (the Google Cloud Logging service diff --git a/gcloud/beta/container/fleet/memberships/register b/gcloud/beta/container/fleet/memberships/register index ce10f1105..b153fdf99 100644 --- a/gcloud/beta/container/fleet/memberships/register +++ b/gcloud/beta/container/fleet/memberships/register @@ -3,7 +3,8 @@ NAME a fleet SYNOPSIS - gcloud beta container fleet memberships register MEMBERSHIP_NAME + gcloud beta container fleet memberships register + (MEMBERSHIP_NAME : --location=LOCATION) (--gke-cluster=LOCATION/CLUSTER_NAME | --gke-uri=GKE_URI | [--context=CONTEXT : --kubeconfig=KUBECONFIG]) [--install-connect-agent] [--internal-ip] @@ -114,9 +115,35 @@ EXAMPLES --service-account-key-file=/tmp/keyfile.json POSITIONAL ARGUMENTS - MEMBERSHIP_NAME - The membership name that you choose to uniquely represents the cluster - being registered on the fleet. + Membership resource - The group of arguments defining a membership. 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 MEMBERSHIP_NAME on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + MEMBERSHIP_NAME + ID of the membership or fully qualified identifier for the + membership. To set the membership attribute: + ▸ provide the argument MEMBERSHIP_NAME on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location for the membership resource, e.g. us-central1. If not + specified, defaults to global. Not supported for GKE clusters, whose + membership location will be the location of the cluster. + + To set the location attribute: + ▸ provide the argument MEMBERSHIP_NAME on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property gkehub/location. REQUIRED FLAGS Cluster identifier. diff --git a/gcloud/beta/container/hub/memberships/register b/gcloud/beta/container/hub/memberships/register index def1cf60c..192455dd5 100644 --- a/gcloud/beta/container/hub/memberships/register +++ b/gcloud/beta/container/hub/memberships/register @@ -3,7 +3,8 @@ NAME fleet SYNOPSIS - gcloud beta container hub memberships register MEMBERSHIP_NAME + gcloud beta container hub memberships register + (MEMBERSHIP_NAME : --location=LOCATION) (--gke-cluster=LOCATION/CLUSTER_NAME | --gke-uri=GKE_URI | [--context=CONTEXT : --kubeconfig=KUBECONFIG]) [--install-connect-agent] [--internal-ip] @@ -114,9 +115,35 @@ EXAMPLES --service-account-key-file=/tmp/keyfile.json POSITIONAL ARGUMENTS - MEMBERSHIP_NAME - The membership name that you choose to uniquely represents the cluster - being registered on the fleet. + Membership resource - The group of arguments defining a membership. 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 MEMBERSHIP_NAME on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + MEMBERSHIP_NAME + ID of the membership or fully qualified identifier for the + membership. To set the membership attribute: + ▸ provide the argument MEMBERSHIP_NAME on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location for the membership resource, e.g. us-central1. If not + specified, defaults to global. Not supported for GKE clusters, whose + membership location will be the location of the cluster. + + To set the location attribute: + ▸ provide the argument MEMBERSHIP_NAME on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property gkehub/location. REQUIRED FLAGS Cluster identifier. diff --git a/gcloud/beta/datastore/databases/create b/gcloud/beta/datastore/databases/create deleted file mode 100644 index 36300cdcc..000000000 --- a/gcloud/beta/datastore/databases/create +++ /dev/null @@ -1,48 +0,0 @@ -NAME - gcloud beta datastore databases create - create a Google Cloud Firestore in - Datastore Mode database - -SYNOPSIS - gcloud beta datastore databases create [--region=REGION] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (BETA) (DEPRECATED) This command is deprecated. Please use gcloud alpha - firestore database update --type=datastore-mode instead. - - (BETA) (DEPRECATED) Create a Google Cloud Firestore in Datastore Mode - database. - - This command is deprecated. Please use gcloud alpha firestore database - update --type=datastore-mode instead. - -EXAMPLES - To create Google Cloud Firestore in Datastore Mode database - - $ gcloud beta datastore databases create - - To create an app in the us-central region, run: - - $ gcloud beta datastore databases create --region=us-central - -FLAGS - --region=REGION - The region to create the Google Cloud Firestore in Datastore Mode - database within. Use gcloud app regions list to list available regions. - -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 datastore databases create - - $ gcloud alpha datastore databases create - diff --git a/gcloud/beta/datastore/databases/help b/gcloud/beta/datastore/databases/help index e026a1e05..b90a62675 100644 --- a/gcloud/beta/datastore/databases/help +++ b/gcloud/beta/datastore/databases/help @@ -13,13 +13,6 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. -COMMANDS - COMMAND is one of the following: - - create - (BETA) (DEPRECATED) Create a Google Cloud Firestore in Datastore Mode - database. - NOTES This command is currently in beta and might change without notice. These variants are also available: diff --git a/gcloud/beta/events/brokers/create b/gcloud/beta/events/brokers/create index a64cfdb49..11f9f791d 100644 --- a/gcloud/beta/events/brokers/create +++ b/gcloud/beta/events/brokers/create @@ -9,9 +9,15 @@ SYNOPSIS | --context=CONTEXT --kubeconfig=KUBECONFIG] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Create a broker to initialize a namespace for eventing. Creates a - new broker for the given namespace. Currently, you can only create a broker - named "default". This command is only available with Cloud Run for Anthos. + (BETA) (DEPRECATED) The gcloud events command surface is deprecated and + will be removed in an upcoming release. Please use gcloud eventarc instead. + + (BETA) (DEPRECATED) Create a broker to initialize a namespace for eventing. + + The gcloud events command surface is deprecated and will be removed in an + upcoming release. Please use gcloud eventarc instead. Creates a new broker + for the given namespace. Currently, you can only create a broker named + "default". This command is only available with Cloud Run for Anthos. EXAMPLES To create a broker, run: diff --git a/gcloud/beta/events/brokers/delete b/gcloud/beta/events/brokers/delete index 6236e2ed3..27938e0c8 100644 --- a/gcloud/beta/events/brokers/delete +++ b/gcloud/beta/events/brokers/delete @@ -8,7 +8,13 @@ SYNOPSIS | --context=CONTEXT --kubeconfig=KUBECONFIG] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Delete a broker. + (BETA) (DEPRECATED) The gcloud events command surface is deprecated and + will be removed in an upcoming release. Please use gcloud eventarc instead. + + (BETA) (DEPRECATED) Delete a broker. + + The gcloud events command surface is deprecated and will be removed in an + upcoming release. Please use gcloud eventarc instead. EXAMPLES To delete a broker: diff --git a/gcloud/beta/events/brokers/describe b/gcloud/beta/events/brokers/describe index 4e7c3322c..e3cc87c88 100644 --- a/gcloud/beta/events/brokers/describe +++ b/gcloud/beta/events/brokers/describe @@ -8,7 +8,13 @@ SYNOPSIS | --context=CONTEXT --kubeconfig=KUBECONFIG] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Get details about a given broker. + (BETA) (DEPRECATED) The gcloud events command surface is deprecated and + will be removed in an upcoming release. Please use gcloud eventarc instead. + + (BETA) (DEPRECATED) Get details about a given broker. + + The gcloud events command surface is deprecated and will be removed in an + upcoming release. Please use gcloud eventarc instead. EXAMPLES To get details about a given broker: diff --git a/gcloud/beta/events/brokers/help b/gcloud/beta/events/brokers/help index 94cd7e4ef..a02449430 100644 --- a/gcloud/beta/events/brokers/help +++ b/gcloud/beta/events/brokers/help @@ -7,8 +7,13 @@ SYNOPSIS | --context=CONTEXT --kubeconfig=KUBECONFIG] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) This set of commands can be used to view and manage Brokers. This - command group is only available with Cloud Run for Anthos. + (BETA) (DEPRECATED) View and manage Brokers. + + The gcloud events command surface is deprecated and will be removed in an + upcoming release. Please use gcloud eventarc instead. + + This set of commands can be used to view and manage Brokers. This command + group is only available with Cloud Run for Anthos. EXAMPLES To create a broker, run: @@ -92,16 +97,17 @@ COMMANDS COMMAND is one of the following: create - (BETA) Create a broker to initialize a namespace for eventing. + (BETA) (DEPRECATED) Create a broker to initialize a namespace for + eventing. delete - (BETA) Delete a broker. + (BETA) (DEPRECATED) Delete a broker. describe - (BETA) Get details about a given broker. + (BETA) (DEPRECATED) Get details about a given broker. list - (BETA) List brokers. + (BETA) (DEPRECATED) List brokers. NOTES This command is currently in beta and might change without notice. diff --git a/gcloud/beta/events/brokers/list b/gcloud/beta/events/brokers/list index a19a301b2..627839b77 100644 --- a/gcloud/beta/events/brokers/list +++ b/gcloud/beta/events/brokers/list @@ -10,7 +10,10 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) List brokers. + (BETA) (DEPRECATED) List brokers. + + The gcloud events command surface is deprecated and will be removed in an + upcoming release. Please use gcloud eventarc instead. FLAGS Namespace resource - Namespace to create the Broker in. This represents a diff --git a/gcloud/beta/events/help b/gcloud/beta/events/help index 81c61a5ae..923e7bbdc 100644 --- a/gcloud/beta/events/help +++ b/gcloud/beta/events/help @@ -7,8 +7,11 @@ SYNOPSIS | --context=CONTEXT --kubeconfig=KUBECONFIG] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) The gcloud beta events command group lets you manage ' 'your Cloud - Run for Anthos Events resources. + (BETA) (DEPRECATED) The gcloud events command surface is deprecated and + will be removed in an upcoming release. Please use gcloud eventarc instead. + + The gcloud beta events command group lets you manage ' 'your Cloud Run for + Anthos Events resources. EXAMPLES To view your existing triggers, use the gcloud events triggers list @@ -96,22 +99,22 @@ GROUPS GROUP is one of the following: brokers - (BETA) View and manage Brokers. + (BETA) (DEPRECATED) View and manage Brokers. namespaces - (BETA) Initialize namespaces with secrets. + (BETA) (DEPRECATED) Initialize namespaces with secrets. triggers - (BETA) View and manage your Events triggers. + (BETA) (DEPRECATED) View and manage your Events triggers. types - (BETA) View and manage Event Types. + (BETA) (DEPRECATED) View and manage Event Types. COMMANDS COMMAND is one of the following: init - (BETA) Initialize a cluster for eventing. + (BETA) (DEPRECATED) Initialize a cluster for eventing. NOTES This command is currently in beta and might change without notice. diff --git a/gcloud/beta/events/init b/gcloud/beta/events/init index 0bccce58a..58f9a7c2e 100644 --- a/gcloud/beta/events/init +++ b/gcloud/beta/events/init @@ -12,10 +12,16 @@ SYNOPSIS | --context=CONTEXT --kubeconfig=KUBECONFIG] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Initialize a cluster for eventing. Enables necessary services for - the project, adds necessary IAM policy bindings to the provided service - account, and creates a new key for the provided service account. This - command is only available with Cloud Run for Anthos. + (BETA) (DEPRECATED) The gcloud events command surface is deprecated and + will be removed in an upcoming release. Please use gcloud eventarc instead. + + (BETA) (DEPRECATED) Initialize a cluster for eventing. + + The gcloud events command surface is deprecated and will be removed in an + upcoming release. Please use gcloud eventarc instead. Enables necessary + services for the project, adds necessary IAM policy bindings to the + provided service account, and creates a new key for the provided service + account. This command is only available with Cloud Run for Anthos. EXAMPLES To initialize a cluster: diff --git a/gcloud/beta/events/namespaces/help b/gcloud/beta/events/namespaces/help index 9886ba6a7..4739e660b 100644 --- a/gcloud/beta/events/namespaces/help +++ b/gcloud/beta/events/namespaces/help @@ -8,8 +8,13 @@ SYNOPSIS | --context=CONTEXT --kubeconfig=KUBECONFIG] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) This set of commands can be used to manage namespaces. This command - group is only available with Cloud Run for Anthos. + (BETA) (DEPRECATED) Initialize namespaces with secrets. + + The gcloud events command surface is deprecated and will be removed in an + upcoming release. Please use gcloud eventarc instead. + + This set of commands can be used to manage namespaces. This command group + is only available with Cloud Run for Anthos. EXAMPLES To initialize a namespace, run: @@ -93,7 +98,7 @@ COMMANDS COMMAND is one of the following: init - (BETA) Initialize a namespace for eventing. + (BETA) (DEPRECATED) Initialize a namespace for eventing. NOTES This command is currently in beta and might change without notice. diff --git a/gcloud/beta/events/namespaces/init b/gcloud/beta/events/namespaces/init index 95d9d6756..180075808 100644 --- a/gcloud/beta/events/namespaces/init +++ b/gcloud/beta/events/namespaces/init @@ -9,7 +9,13 @@ SYNOPSIS | --context=CONTEXT --kubeconfig=KUBECONFIG] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Initialize a namespace for eventing. Copies the necessary + (BETA) (DEPRECATED) The gcloud events command surface is deprecated and + will be removed in an upcoming release. Please use gcloud eventarc instead. + + (BETA) (DEPRECATED) Initialize a namespace for eventing. + + The gcloud events command surface is deprecated and will be removed in an + upcoming release. Please use gcloud eventarc instead. Copies the necessary google-cloud-sources-key secret to the specified namespace, which is necessary when using secrets for authentication. diff --git a/gcloud/beta/events/triggers/create b/gcloud/beta/events/triggers/create index 423357fb1..c8e794f0a 100644 --- a/gcloud/beta/events/triggers/create +++ b/gcloud/beta/events/triggers/create @@ -14,7 +14,13 @@ SYNOPSIS | --parameters-from-file=PARAMETERS_FROM_FILE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Create a trigger. + (BETA) (DEPRECATED) The gcloud events command surface is deprecated and + will be removed in an upcoming release. Please use gcloud eventarc instead. + + (BETA) (DEPRECATED) Create a trigger. + + The gcloud events command surface is deprecated and will be removed in an + upcoming release. Please use gcloud eventarc instead. EXAMPLES To create a trigger for a Cloud Pub/Sub event type: diff --git a/gcloud/beta/events/triggers/delete b/gcloud/beta/events/triggers/delete index ec761586e..b8b6c76c1 100644 --- a/gcloud/beta/events/triggers/delete +++ b/gcloud/beta/events/triggers/delete @@ -8,7 +8,13 @@ SYNOPSIS | --context=CONTEXT --kubeconfig=KUBECONFIG] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Delete a trigger. + (BETA) (DEPRECATED) The gcloud events command surface is deprecated and + will be removed in an upcoming release. Please use gcloud eventarc instead. + + (BETA) (DEPRECATED) Delete a trigger. + + The gcloud events command surface is deprecated and will be removed in an + upcoming release. Please use gcloud eventarc instead. EXAMPLES To delete a trigger: diff --git a/gcloud/beta/events/triggers/describe b/gcloud/beta/events/triggers/describe index 9aefb2d32..508ab1d31 100644 --- a/gcloud/beta/events/triggers/describe +++ b/gcloud/beta/events/triggers/describe @@ -8,7 +8,13 @@ SYNOPSIS | --context=CONTEXT --kubeconfig=KUBECONFIG] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Get details about a given trigger. + (BETA) (DEPRECATED) The gcloud events command surface is deprecated and + will be removed in an upcoming release. Please use gcloud eventarc instead. + + (BETA) (DEPRECATED) Get details about a given trigger. + + The gcloud events command surface is deprecated and will be removed in an + upcoming release. Please use gcloud eventarc instead. EXAMPLES To get details about a given trigger: diff --git a/gcloud/beta/events/triggers/help b/gcloud/beta/events/triggers/help index 5d7b09ace..273057a8e 100644 --- a/gcloud/beta/events/triggers/help +++ b/gcloud/beta/events/triggers/help @@ -8,8 +8,12 @@ SYNOPSIS | --context=CONTEXT --kubeconfig=KUBECONFIG] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) This set of commands can be used to view and manage your Events - resources. + (BETA) (DEPRECATED) View and manage your Events triggers. + + The gcloud events command surface is deprecated and will be removed in an + upcoming release. Please use gcloud eventarc instead. + + This set of commands can be used to view and manage your Events resources. EXAMPLES To list your existing triggers, run: @@ -93,16 +97,16 @@ COMMANDS COMMAND is one of the following: create - (BETA) Create a trigger. + (BETA) (DEPRECATED) Create a trigger. delete - (BETA) Delete a trigger. + (BETA) (DEPRECATED) Delete a trigger. describe - (BETA) Get details about a given trigger. + (BETA) (DEPRECATED) Get details about a given trigger. list - (BETA) List existing triggers. + (BETA) (DEPRECATED) List existing triggers. NOTES This command is currently in beta and might change without notice. diff --git a/gcloud/beta/events/triggers/list b/gcloud/beta/events/triggers/list index 5c3124668..2de32e272 100644 --- a/gcloud/beta/events/triggers/list +++ b/gcloud/beta/events/triggers/list @@ -11,7 +11,13 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) List existing triggers. + (BETA) (DEPRECATED) The gcloud events command surface is deprecated and + will be removed in an upcoming release. Please use gcloud eventarc instead. + + (BETA) (DEPRECATED) List existing triggers. + + The gcloud events command surface is deprecated and will be removed in an + upcoming release. Please use gcloud eventarc instead. EXAMPLES To list existing triggers: diff --git a/gcloud/beta/events/types/describe b/gcloud/beta/events/types/describe index 2cd76c865..cd8cf0d07 100644 --- a/gcloud/beta/events/types/describe +++ b/gcloud/beta/events/types/describe @@ -9,7 +9,13 @@ SYNOPSIS | --context=CONTEXT --kubeconfig=KUBECONFIG] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Get the details about a given event type. + (BETA) (DEPRECATED) The gcloud events command surface is deprecated and + will be removed in an upcoming release. Please use gcloud eventarc instead. + + (BETA) (DEPRECATED) Get the details about a given event type. + + The gcloud events command surface is deprecated and will be removed in an + upcoming release. Please use gcloud eventarc instead. EXAMPLES To get the details about a given event type: diff --git a/gcloud/beta/events/types/help b/gcloud/beta/events/types/help index 60ba79a83..e486bc45c 100644 --- a/gcloud/beta/events/types/help +++ b/gcloud/beta/events/types/help @@ -8,8 +8,12 @@ SYNOPSIS | --context=CONTEXT --kubeconfig=KUBECONFIG] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) This set of commands can be used to view and manage available Event - Types. + (BETA) (DEPRECATED) View and manage Event Types. + + The gcloud events command surface is deprecated and will be removed in an + upcoming release. Please use gcloud eventarc instead. + + This set of commands can be used to view and manage available Event Types. EXAMPLES To list available event types, run: @@ -93,16 +97,16 @@ GROUPS GROUP is one of the following: sources - (BETA) View available Event Type sources. + (BETA) (DEPRECATED) View available Event Type sources. COMMANDS COMMAND is one of the following: describe - (BETA) Get the details about a given event type. + (BETA) (DEPRECATED) Get the details about a given event type. list - (BETA) List available event types. + (BETA) (DEPRECATED) List available event types. NOTES This command is currently in beta and might change without notice. diff --git a/gcloud/beta/events/types/list b/gcloud/beta/events/types/list index f6767e0b5..2d14e393e 100644 --- a/gcloud/beta/events/types/list +++ b/gcloud/beta/events/types/list @@ -10,7 +10,13 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) List available event types. + (BETA) (DEPRECATED) The gcloud events command surface is deprecated and + will be removed in an upcoming release. Please use gcloud eventarc instead. + + (BETA) (DEPRECATED) List available event types. + + The gcloud events command surface is deprecated and will be removed in an + upcoming release. Please use gcloud eventarc instead. EXAMPLES To list available event types: diff --git a/gcloud/beta/events/types/sources/help b/gcloud/beta/events/types/sources/help index 5fe55938c..5ad7f25a2 100644 --- a/gcloud/beta/events/types/sources/help +++ b/gcloud/beta/events/types/sources/help @@ -8,7 +8,12 @@ SYNOPSIS | --context=CONTEXT --kubeconfig=KUBECONFIG] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) This set of commands can be used to view Event Type sources. + (BETA) (DEPRECATED) View available Event Type sources. + + The gcloud events command surface is deprecated and will be removed in an + upcoming release. Please use gcloud eventarc instead. + + This set of commands can be used to view Event Type sources. EXAMPLES To list available event type sources, run: @@ -92,7 +97,7 @@ COMMANDS COMMAND is one of the following: list - (BETA) List available event source kinds. + (BETA) (DEPRECATED) List available event source kinds. NOTES This command is currently in beta and might change without notice. diff --git a/gcloud/beta/events/types/sources/list b/gcloud/beta/events/types/sources/list index 2f841153b..865bdf1c1 100644 --- a/gcloud/beta/events/types/sources/list +++ b/gcloud/beta/events/types/sources/list @@ -10,7 +10,13 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) List available event source kinds. + (BETA) (DEPRECATED) The gcloud events command surface is deprecated and + will be removed in an upcoming release. Please use gcloud eventarc instead. + + (BETA) (DEPRECATED) List available event source kinds. + + The gcloud events command surface is deprecated and will be removed in an + upcoming release. Please use gcloud eventarc instead. EXAMPLES To list available event source kinds: diff --git a/gcloud/beta/firestore/databases/describe b/gcloud/beta/firestore/databases/describe new file mode 100644 index 000000000..f32b4da3f --- /dev/null +++ b/gcloud/beta/firestore/databases/describe @@ -0,0 +1,54 @@ +NAME + gcloud beta firestore databases describe - describe a Google Cloud + Firestore database + +SYNOPSIS + gcloud beta firestore databases describe [--database=DATABASE] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Describe a Google Cloud Firestore database. + +EXAMPLES + The following command describes a Google Cloud Firestore database. + + $ gcloud beta firestore databases describe + +FLAGS + Database resource - The Google Cloud Firestore database to describe. This + represents a Cloud resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. To set the project + attribute: + ◆ provide the argument --database on the command line with a fully + specified name; + ◆ the default value of argument [--database] is (default) with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + --database=DATABASE + ID of the database or fully qualified identifier for the database. To + set the database attribute: + ▸ provide the argument --database on the command line; + ▸ the default value of argument [--database] is (default). + +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 firestore/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/firestore + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud firestore databases describe + + $ gcloud alpha firestore databases describe + diff --git a/gcloud/beta/firestore/databases/help b/gcloud/beta/firestore/databases/help index 01dc9490f..1ceea48d2 100644 --- a/gcloud/beta/firestore/databases/help +++ b/gcloud/beta/firestore/databases/help @@ -19,6 +19,15 @@ COMMANDS create (BETA) Create a Google Cloud Firestore database via Firestore API. + describe + (BETA) Describe a Google Cloud Firestore database. + + list + (BETA) Lists all Firestore databases under the project. + + update + (BETA) Update the database configuration of a Cloud Firestore database. + NOTES This command is currently in beta and might change without notice. These variants are also available: diff --git a/gcloud/beta/firestore/databases/list b/gcloud/beta/firestore/databases/list new file mode 100644 index 000000000..ebd4e053d --- /dev/null +++ b/gcloud/beta/firestore/databases/list @@ -0,0 +1,62 @@ +NAME + gcloud beta firestore databases list - lists all Firestore databases under + the project + +SYNOPSIS + gcloud beta firestore databases list [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +EXAMPLES + To list all Firestore databases. + + $ gcloud beta firestore databases list + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud firestore databases list + + $ gcloud alpha firestore databases list + diff --git a/gcloud/beta/firestore/databases/update b/gcloud/beta/firestore/databases/update new file mode 100644 index 000000000..a21d9a8e8 --- /dev/null +++ b/gcloud/beta/firestore/databases/update @@ -0,0 +1,62 @@ +NAME + gcloud beta firestore databases update - update the database configuration + of a Cloud Firestore database + +SYNOPSIS + gcloud beta firestore databases update [--async] [--database=DATABASE] + [--type=TYPE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Update the database configuration of a Cloud Firestore database. + +EXAMPLES + The following command updates the database type of a Cloud Firestore + database. + + $ gcloud beta firestore databases update --type=firestore-native + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + Database resource - Cloud Firestore database to update. This represents a + Cloud resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. To set the project attribute: + ◆ provide the argument --database on the command line with a fully + specified name; + ◆ the default value of argument [--database] is (default) with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + --database=DATABASE + ID of the database or fully qualified identifier for the database. To + set the database attribute: + ▸ provide the argument --database on the command line; + ▸ the default value of argument [--database] is (default). + + --type=TYPE + The database type. TYPE must be one of: datastore-mode, + firestore-native. + +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 firestore/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/firestore + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud firestore databases update + + $ gcloud alpha firestore databases update + diff --git a/gcloud/beta/logging/sinks/create b/gcloud/beta/logging/sinks/create index 16888f8be..d5ffad477 100644 --- a/gcloud/beta/logging/sinks/create +++ b/gcloud/beta/logging/sinks/create @@ -21,7 +21,8 @@ DESCRIPTION https://cloud.google.com/logging/docs/view/logging-query-language The sink's destination can be a Cloud Logging log bucket, a Cloud Storage - bucket, a BigQuery dataset, or a Cloud Pub/Sub topic. + bucket, a BigQuery dataset, a Cloud Pub/Sub topic, or a Google Cloud + project. The destination must already exist. diff --git a/gcloud/beta/metastore/services/alter-table-properties b/gcloud/beta/metastore/services/alter-table-properties new file mode 100644 index 000000000..df747cf86 --- /dev/null +++ b/gcloud/beta/metastore/services/alter-table-properties @@ -0,0 +1,133 @@ +NAME + gcloud beta metastore services alter-table-properties - alter metadata + table properties + +SYNOPSIS + gcloud beta metastore services alter-table-properties + (SERVICE : --location=LOCATION) --properties=PROPERTIES + --table-name=TABLE_NAME --update-mask=UPDATE_MASK [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Alter metadata table properties from a Dataproc Metastore service's + underlying metadata store. + + If run asynchronously with --async, exits after printing one operation name + that can be used to poll the status of the creation via: + + gcloud metastore operations describe + +EXAMPLES + To alter metadata table properties a and b on table-name + databases/{database_id}/tables/{table_id} , use the update-mask + properties.a,properties.b , and run: + + $ gcloud beta metastore services alter-table-properties \ + my-metastore-service --location=us-central1 \ + --table-name=databases/my-database/tables/my-table \ + --update-mask=properties.a,properties.b --properties=a=1,b=2 + +POSITIONAL ARGUMENTS + Service resource - Arguments and flags that specify the table you want to + alter. 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 service on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + SERVICE + ID of the service or fully qualified identifier for the service. To + set the service attribute: + ▸ provide the argument service on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the Dataproc Metastore service. + + If not specified, will use default metastore/location. + + To set the location attribute: + ▸ provide the argument service on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property metastore/location. + +REQUIRED FLAGS + --properties=PROPERTIES + A string where field names are separated by a comma. Describes the + desired values to mutate. If update-mask is empty, the properties will + not update. Otherwise, the properties only alter the values whose + associated paths exist in the update mask. + + For example, the desired key-value pairs. + + a=2,b=3,c=4 + + --table-name=TABLE_NAME + The name of the table containing the properties you're altering in the + following format. + + databases/{database_id}/tables/{table_id} + + --update-mask=UPDATE_MASK + A string where field names are separated by a comma. Specifies the + metadata table properties fields that are overwritten by the update. + Fields specified in the update-mask are relative to the resource (not + to the full request). A field is overwritten if it is in the mask. + + For example, given the target properties: + + properties { + a: 1 + b: 2 + } + + And an update properties: + + properties { + a: 2 + b: 3 + c: 4 + } + + then if the field mask is: + + properties.b,properties.c + + then the updated result will be: + + properties { + a: 1 + b: 3 + c: 4 + } + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the metastore/v1beta API. The full documentation for this + API can be found at: https://cloud.google.com/dataproc-metastore/docs + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha metastore services alter-table-properties + diff --git a/gcloud/beta/metastore/services/help b/gcloud/beta/metastore/services/help index b3d72082e..5061641e3 100644 --- a/gcloud/beta/metastore/services/help +++ b/gcloud/beta/metastore/services/help @@ -40,6 +40,9 @@ COMMANDS alter-metadata-resource-location (BETA) Alter metadata resource location. + alter-table-properties + (BETA) Alter metadata table properties. + create (BETA) Create a Dataproc Metastore service. diff --git a/gcloud/beta/resource-manager/tags/bindings/create b/gcloud/beta/resource-manager/tags/bindings/create index cddbd8c08..5a6bdb48e 100644 --- a/gcloud/beta/resource-manager/tags/bindings/create +++ b/gcloud/beta/resource-manager/tags/bindings/create @@ -11,8 +11,8 @@ DESCRIPTION (BETA) Creates a TagBinding given the TagValue and the parent cloud resource the TagValue will be attached to. The TagValue can be represented with its numeric id or its namespaced name of - organizations/{org_id}/{tag_key_short_name}. The parent resource should be - represented with its full resource name. See: + {parent_namespace}/{tag_key_short_name}/{tag_value_short_name}. The parent + resource should be represented with its full resource name. See: https://cloud.google.com/apis/design/resource_names#full_resource_name. EXAMPLES diff --git a/gcloud/beta/resource-manager/tags/bindings/delete b/gcloud/beta/resource-manager/tags/bindings/delete index 5a91b3ea6..cad1104d3 100644 --- a/gcloud/beta/resource-manager/tags/bindings/delete +++ b/gcloud/beta/resource-manager/tags/bindings/delete @@ -12,7 +12,7 @@ DESCRIPTION name. See: https://cloud.google.com/apis/design/resource_names#full_resource_name. The TagValue can be represented with its numeric id or its namespaced name of - {org_id}/{tag_key_short_name}. + {parent_namespace}/{tag_key_short_name}/{tag_value_short_name}. EXAMPLES To delete a TagBinding between tagValue/111 and Project with name diff --git a/gcloud/beta/resource-manager/tags/bindings/help b/gcloud/beta/resource-manager/tags/bindings/help index 40a0df3b0..943cc2fbd 100644 --- a/gcloud/beta/resource-manager/tags/bindings/help +++ b/gcloud/beta/resource-manager/tags/bindings/help @@ -7,10 +7,10 @@ SYNOPSIS DESCRIPTION (BETA) The Resource Manager Service gives you centralized and programmatic - control over your organization's Tags. As the tag administrator, you will - be able to create and configure restrictions across the tags in the org. As - the tag user, you will be able to attach TagValues to different resources - as a TagBinding. + control over your organization or project's Tags. As the tag administrator, + you will be able to create and configure restrictions across the tags in + your organization or projects. As the tag user, you will be able to attach + TagValues to different resources as a TagBinding. GCLOUD WIDE FLAGS These flags are available to all commands: --help. diff --git a/gcloud/beta/resource-manager/tags/help b/gcloud/beta/resource-manager/tags/help index ee463400a..3f6b598a0 100644 --- a/gcloud/beta/resource-manager/tags/help +++ b/gcloud/beta/resource-manager/tags/help @@ -8,8 +8,9 @@ SYNOPSIS DESCRIPTION (BETA) The Tags Service gives you centralized and programmatic control over your organization's tags. As the tag administrator, you will be able to - create and configure restrictions across the tags in the org. As the tag - user, you will be able to attach tags values to different resources. + create and configure restrictions across the tags in your organization or + projects. As the tag user, you will be able to attach tags values to + different resources. GCLOUD WIDE FLAGS These flags are available to all commands: --help. diff --git a/gcloud/beta/resource-manager/tags/holds/create b/gcloud/beta/resource-manager/tags/holds/create index 1c8573247..38b2fe0b2 100644 --- a/gcloud/beta/resource-manager/tags/holds/create +++ b/gcloud/beta/resource-manager/tags/holds/create @@ -10,7 +10,7 @@ DESCRIPTION (BETA) Create a TagHold under a TagValue, indicating that the TagValue is being used by a holder (cloud resource) from an (optional) origin. The TagValue can be represented with its numeric id or its namespaced name of - {org_id}/{tag_key_short_name}/{tag_value_short_name}. + {parent_namespace}/{tag_key_short_name}/{tag_value_short_name}. EXAMPLES To create a TagHold on tagValues/123, with holder cloud-resource-holder, diff --git a/gcloud/beta/resource-manager/tags/holds/help b/gcloud/beta/resource-manager/tags/holds/help index e8f4824fc..41c4bff5b 100644 --- a/gcloud/beta/resource-manager/tags/holds/help +++ b/gcloud/beta/resource-manager/tags/holds/help @@ -7,8 +7,9 @@ SYNOPSIS DESCRIPTION (BETA) The Resource Manager Service gives you centralized and programmatic control over your organization's Tags. As the tag administrator, you will - be able to create and configure restrictions across the tags in the org, - and you will be able to indicate the use of a TagValue as a TagHold. + be able to create and configure restrictions across the tags in your + organization or projects, and you will be able to indicate the use of a + TagValue as a TagHold. GCLOUD WIDE FLAGS These flags are available to all commands: --help. diff --git a/gcloud/beta/resource-manager/tags/holds/list b/gcloud/beta/resource-manager/tags/holds/list index 42794585d..bbfd447e5 100644 --- a/gcloud/beta/resource-manager/tags/holds/list +++ b/gcloud/beta/resource-manager/tags/holds/list @@ -11,11 +11,11 @@ SYNOPSIS DESCRIPTION (BETA) List TagHolds under a TagValue. The TagValue can be represented with its numeric id or its namespaced name of - {org_id}/{tag_key_short_name}/{tag_value_short_name}. Limited to TagHolds - stored in a single --location: if none is provided, the API will assume the - "global" location. Optional filters are --holder and --origin: if provided, - returned TagHolds' holder and origin fields must match the exact flag - value. + {parent_namespace}/{tag_key_short_name}/{tag_value_short_name}. Limited to + TagHolds stored in a single --location: if none is provided, the API will + assume the "global" location. Optional filters are --holder and --origin: + if provided, returned TagHolds' holder and origin fields must match the + exact flag value. EXAMPLES To list TagHolds for tagValues/456 in us-central1-a, run: @@ -33,7 +33,7 @@ POSITIONAL ARGUMENTS PARENT TagValue resource name or namespaced name to list TagHolds for. This field should be in the form tagValues/ or - //. + //. FLAGS --holder=HOLDER diff --git a/gcloud/beta/resource-manager/tags/keys/help b/gcloud/beta/resource-manager/tags/keys/help index 068bfe082..e15b4852b 100644 --- a/gcloud/beta/resource-manager/tags/keys/help +++ b/gcloud/beta/resource-manager/tags/keys/help @@ -7,8 +7,9 @@ SYNOPSIS DESCRIPTION (BETA) The Resource Manager Service gives you centralized and programmatic control over your organization's Tags. As the tag administrator, you will - be able to create and configure restrictions across the tags in the org. As - the tag user, you will be able to attach TagValues to different resources. + be able to create and configure restrictions across the tags in your + organization or projects. As the tag user, you will be able to attach + TagValues to different resources. GCLOUD WIDE FLAGS These flags are available to all commands: --help. diff --git a/gcloud/beta/resource-manager/tags/values/add-iam-policy-binding b/gcloud/beta/resource-manager/tags/values/add-iam-policy-binding index 238a79b99..2935caebf 100644 --- a/gcloud/beta/resource-manager/tags/values/add-iam-policy-binding +++ b/gcloud/beta/resource-manager/tags/values/add-iam-policy-binding @@ -11,8 +11,9 @@ SYNOPSIS DESCRIPTION (BETA) Adds the IAM policy binding for a TagValue resource given the binding and an identifier for the TagValue. The identifier can be the - TagValue's // or - the TagValue's ID in the form: tagValues/{numeric_id}. + TagValue's namespaced name in the form + // or the + TagValue's ID in the form: tagValues/{numeric_id}. EXAMPLES To add an IAM policy binding for the role of 'roles/editor' for the user diff --git a/gcloud/beta/resource-manager/tags/values/help b/gcloud/beta/resource-manager/tags/values/help index fc6a4a318..d235f8258 100644 --- a/gcloud/beta/resource-manager/tags/values/help +++ b/gcloud/beta/resource-manager/tags/values/help @@ -7,8 +7,9 @@ SYNOPSIS DESCRIPTION (BETA) The Resource Manager Service gives you centralized and programmatic control over your organization's Tags. As the tag administrator, you will - be able to create and configure restrictions across the tags in the org. As - the tag user, you will be able to attach TagValues to different resources. + be able to create and configure restrictions across the tags in your + organization or projects. As the tag user, you will be able to attach + TagValues to different resources. GCLOUD WIDE FLAGS These flags are available to all commands: --help. diff --git a/gcloud/beta/resource-manager/tags/values/remove-iam-policy-binding b/gcloud/beta/resource-manager/tags/values/remove-iam-policy-binding index 3aa3e53f7..98a7c53f3 100644 --- a/gcloud/beta/resource-manager/tags/values/remove-iam-policy-binding +++ b/gcloud/beta/resource-manager/tags/values/remove-iam-policy-binding @@ -11,8 +11,9 @@ SYNOPSIS DESCRIPTION (BETA) Removes an IAM policy binding for a TagValue resource given the binding and an identifier for the TagValue. The identifier can be the - TagValue's // or - the TagValue's ID in the form: tagValues/{numeric_id}. + TagValue's namespaced name in the form + // or the + TagValue's ID in the form: tagValues/{numeric_id}. EXAMPLES To remove an IAM policy binding for the role of 'roles/editor' for the user diff --git a/gcloud/beta/resource-manager/tags/values/update b/gcloud/beta/resource-manager/tags/values/update index 70c280948..036ae826c 100644 --- a/gcloud/beta/resource-manager/tags/values/update +++ b/gcloud/beta/resource-manager/tags/values/update @@ -7,8 +7,8 @@ SYNOPSIS [--description=DESCRIPTION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Updates the TagValue's description given the TagValue's - // or the TagValue's + (BETA) Updates the TagValue's description given the TagValue's namespaced + name // or the TagValue's numeric id tagValues/ EXAMPLES diff --git a/gcloud/beta/run/deploy b/gcloud/beta/run/deploy index 9fdec6759..fa2032e58 100644 --- a/gcloud/beta/run/deploy +++ b/gcloud/beta/run/deploy @@ -31,6 +31,10 @@ SYNOPSIS | --clear-cloudsql-instances | --remove-cloudsql-instances=[CLOUDSQL-INSTANCES,...] | --set-cloudsql-instances=[CLOUDSQL-INSTANCES,...] + --add-custom-audiences=[CUSTOM-AUDIENCES,...] + | --clear-custom-audiences + | --remove-custom-audiences=[CUSTOM-AUDIENCES,...] + | --set-custom-audiences=[CUSTOM-AUDIENCES,...] --binary-authorization=POLICY | --clear-binary-authorization --clear-encryption-key-shutdown-hours | --encryption-key-shutdown-hours=ENCRYPTION_KEY_SHUTDOWN_HOURS @@ -450,6 +454,24 @@ FLAGS Completely replace the current Cloud SQL instances with the given values. + These flags modify the custom audiences that can be used in the audience + field of ID token for authenticated requests. + + At most one of these can be specified: + + --add-custom-audiences=[CUSTOM-AUDIENCES,...] + Append the given values to the current custom audiences. + + --clear-custom-audiences + Empty the current custom audiences. + + --remove-custom-audiences=[CUSTOM-AUDIENCES,...] + Remove the given values from the current custom audiences. + + --set-custom-audiences=[CUSTOM-AUDIENCES,...] + Completely replace the current custom audiences with the given + values. + At most one of these can be specified: --binary-authorization=POLICY diff --git a/gcloud/beta/run/services/update b/gcloud/beta/run/services/update index 4250a41cb..c00a01fcb 100644 --- a/gcloud/beta/run/services/update +++ b/gcloud/beta/run/services/update @@ -19,6 +19,10 @@ SYNOPSIS | --clear-cloudsql-instances | --remove-cloudsql-instances=[CLOUDSQL-INSTANCES,...] | --set-cloudsql-instances=[CLOUDSQL-INSTANCES,...] + --add-custom-audiences=[CUSTOM-AUDIENCES,...] + | --clear-custom-audiences + | --remove-custom-audiences=[CUSTOM-AUDIENCES,...] + | --set-custom-audiences=[CUSTOM-AUDIENCES,...] --binary-authorization=POLICY | --clear-binary-authorization --clear-encryption-key-shutdown-hours | --encryption-key-shutdown-hours=ENCRYPTION_KEY_SHUTDOWN_HOURS @@ -279,6 +283,24 @@ FLAGS Completely replace the current Cloud SQL instances with the given values. + These flags modify the custom audiences that can be used in the audience + field of ID token for authenticated requests. + + At most one of these can be specified: + + --add-custom-audiences=[CUSTOM-AUDIENCES,...] + Append the given values to the current custom audiences. + + --clear-custom-audiences + Empty the current custom audiences. + + --remove-custom-audiences=[CUSTOM-AUDIENCES,...] + Remove the given values from the current custom audiences. + + --set-custom-audiences=[CUSTOM-AUDIENCES,...] + Completely replace the current custom audiences with the given + values. + At most one of these can be specified: --binary-authorization=POLICY diff --git a/gcloud/beta/workstations/configs/create b/gcloud/beta/workstations/configs/create index a982026ea..737cf09f1 100644 --- a/gcloud/beta/workstations/configs/create +++ b/gcloud/beta/workstations/configs/create @@ -12,7 +12,7 @@ SYNOPSIS [--container-run-as-user=CONTAINER_RUN_AS_USER] [--container-working-dir=CONTAINER_WORKING_DIR] [--disable-public-ip-addresses] [--enable-confidential-compute] - [--idle-timeout=IDLE_TIMEOUT; default=7200] + [--idle-timeout=IDLE_TIMEOUT; default=7200] [--labels=[LABELS,...]] [--machine-type=MACHINE_TYPE; default="e2-standard-4"] [--network-tags=[NETWORK_TAGS,...]] [--pd-disk-size=PD_DISK_SIZE; default=200] @@ -134,6 +134,15 @@ FLAGS that hasn't received any user traffic. A value of 0 indicates that this instance should never time out due to idleness. + --labels=[LABELS,...] + Labels that are applied to the resource and propagated to the + underlying Compute Engine resources. + + Example: + + $ gcloud beta workstations configs create \ + --labels=label1=value1,label2=value2 + --machine-type=MACHINE_TYPE; default="e2-standard-4" Machine type determines the specifications of the Compute Engine machines that the workstations created under this configuration will diff --git a/gcloud/beta/workstations/configs/update b/gcloud/beta/workstations/configs/update index f8f19ff59..d1daf757d 100644 --- a/gcloud/beta/workstations/configs/update +++ b/gcloud/beta/workstations/configs/update @@ -12,11 +12,11 @@ SYNOPSIS [--container-run-as-user=CONTAINER_RUN_AS_USER] [--container-working-dir=CONTAINER_WORKING_DIR] [--disable-public-ip-addresses] [--enable-confidential-compute] - [--idle-timeout=IDLE_TIMEOUT] [--machine-type=MACHINE_TYPE] - [--network-tags=[NETWORK_TAGS,...]] [--pool-size=POOL_SIZE] - [--running-timeout=RUNNING_TIMEOUT] [--service-account=SERVICE_ACCOUNT] - [--shielded-integrity-monitoring] [--shielded-secure-boot] - [--shielded-vtpm] + [--idle-timeout=IDLE_TIMEOUT] [--labels=[LABELS,...]] + [--machine-type=MACHINE_TYPE] [--network-tags=[NETWORK_TAGS,...]] + [--pool-size=POOL_SIZE] [--running-timeout=RUNNING_TIMEOUT] + [--service-account=SERVICE_ACCOUNT] [--shielded-integrity-monitoring] + [--shielded-secure-boot] [--shielded-vtpm] [--container-custom-image=CONTAINER_CUSTOM_IMAGE | --container-predefined-image=CONTAINER_PREDEFINED_IMAGE] [GCLOUD_WIDE_FLAG ...] @@ -122,6 +122,15 @@ FLAGS that hasn't received any user traffic. A value of 0 indicates that this instance should never time out due to idleness. + --labels=[LABELS,...] + Labels that are applied to the resource and propagated to the + underlying Compute Engine resources. + + Example: + + $ gcloud beta workstations configs update \ + --labels=label1=value1,label2=value2 + --machine-type=MACHINE_TYPE Machine type determines the specifications of the Compute Engine machines that the workstations created under this configuration will diff --git a/gcloud/compute/tpus/help b/gcloud/compute/tpus/help index 6adffb891..32c8c100f 100644 --- a/gcloud/compute/tpus/help +++ b/gcloud/compute/tpus/help @@ -30,6 +30,9 @@ GROUPS locations List or Describe Available Cloud TPU Locations. + topologies + List available Cloud TPU topologies. + tpu-vm List, create, and manage Cloud TPU VM nodes. diff --git a/gcloud/compute/tpus/topologies/help b/gcloud/compute/tpus/topologies/help new file mode 100644 index 000000000..f1ac4367b --- /dev/null +++ b/gcloud/compute/tpus/topologies/help @@ -0,0 +1,25 @@ +NAME + gcloud compute tpus topologies - list available Cloud TPU topologies + +SYNOPSIS + gcloud compute tpus topologies COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List available Cloud TPU topologies. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + list + List available topologies for Cloud TPUs. + +NOTES + This variant is also available: + + $ gcloud alpha compute tpus topologies + diff --git a/gcloud/compute/tpus/topologies/list b/gcloud/compute/tpus/topologies/list new file mode 100644 index 000000000..8505bb9de --- /dev/null +++ b/gcloud/compute/tpus/topologies/list @@ -0,0 +1,78 @@ +NAME + gcloud compute tpus topologies list - list available topologies for Cloud + TPUs + +SYNOPSIS + gcloud compute tpus topologies list [--zone=ZONE] [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List available topologies for for Cloud TPUs. + +EXAMPLES + The following command lists all of the topologies available in zone + us-central1-b: + + $ gcloud compute tpus topologies list --zone=us-central1-b + +FLAGS + Location resource - The zone to list topologies versions for. This + represents a Cloud resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. To set the project + attribute: + ◆ provide the argument --zone on the command line with a fully + specified name; + ◆ set the property compute/zone with a fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --zone=ZONE + ID of the location or fully qualified identifier for the location. To + set the zone attribute: + ▸ provide the argument --zone on the command line; + ▸ set the property compute/zone. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the tpu/v2 API. The full documentation for this API can + be found at: https://cloud.google.com/tpu/ + +NOTES + This variant is also available: + + $ gcloud alpha compute tpus topologies list + diff --git a/gcloud/compute/tpus/tpu-vm/create b/gcloud/compute/tpus/tpu-vm/create index 914a89756..2e59052e0 100644 --- a/gcloud/compute/tpus/tpu-vm/create +++ b/gcloud/compute/tpus/tpu-vm/create @@ -113,11 +113,11 @@ OPTIONAL FLAGS --metadata=[METADATA,...] List of comma-separated metadata key-value pairs for the Cloud TPU VM - node. + node. Example: --metadata='key1=value1,key2=value2' --metadata-from-file=[METADATA_FROM_FILE,...] Same as --metadata except the value for the entry will be read from a - local file. + local file. Example: --metadata-from-file='key1=value1.txt' --network=NETWORK; default="default" Network that this TPU will be a part of. diff --git a/gcloud/config/get b/gcloud/config/get index c4d6ad4c7..f363ba38b 100644 --- a/gcloud/config/get +++ b/gcloud/config/get @@ -562,6 +562,9 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud firebase test command group. Defaults to https://testing.googleapis.com/ + transfer + Overrides API endpoint for gcloud transfer command group. + vision Overrides API endpoint for gcloud ml vision command group. Defaults to https://vision.googleapis.com/ diff --git a/gcloud/config/help b/gcloud/config/help index 01c623069..a732a54ac 100644 --- a/gcloud/config/help +++ b/gcloud/config/help @@ -594,6 +594,9 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud firebase test command group. Defaults to https://testing.googleapis.com/ + transfer + Overrides API endpoint for gcloud transfer command group. + vision Overrides API endpoint for gcloud ml vision command group. Defaults to https://vision.googleapis.com/ diff --git a/gcloud/config/list b/gcloud/config/list index d4fe7d203..b9f6f44f6 100644 --- a/gcloud/config/list +++ b/gcloud/config/list @@ -606,6 +606,9 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud firebase test command group. Defaults to https://testing.googleapis.com/ + transfer + Overrides API endpoint for gcloud transfer command group. + vision Overrides API endpoint for gcloud ml vision command group. Defaults to https://vision.googleapis.com/ diff --git a/gcloud/config/set b/gcloud/config/set index c3b303288..3af85cb7d 100644 --- a/gcloud/config/set +++ b/gcloud/config/set @@ -609,6 +609,9 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud firebase test command group. Defaults to https://testing.googleapis.com/ + transfer + Overrides API endpoint for gcloud transfer command group. + vision Overrides API endpoint for gcloud ml vision command group. Defaults to https://vision.googleapis.com/ diff --git a/gcloud/config/unset b/gcloud/config/unset index 4f7479523..4cb7ac7b3 100644 --- a/gcloud/config/unset +++ b/gcloud/config/unset @@ -570,6 +570,9 @@ AVAILABLE PROPERTIES Overrides API endpoint for gcloud firebase test command group. Defaults to https://testing.googleapis.com/ + transfer + Overrides API endpoint for gcloud transfer command group. + vision Overrides API endpoint for gcloud ml vision command group. Defaults to https://vision.googleapis.com/ diff --git a/gcloud/container/aws/node-pools/create b/gcloud/container/aws/node-pools/create index 2638f47e7..75dfa0c10 100644 --- a/gcloud/container/aws/node-pools/create +++ b/gcloud/container/aws/node-pools/create @@ -93,8 +93,10 @@ OPTIONAL FLAGS Return immediately, without waiting for the operation in progress to complete. - --instance-type=INSTANCE_TYPE - AWS EC2 instance type for the node pool's nodes. + Node pool instance configuration + + --instance-type=INSTANCE_TYPE + AWS EC2 instance type for the node pool's nodes. --max-pods-per-node=MAX_PODS_PER_NODE Maximum number of pods per node. diff --git a/gcloud/container/clusters/update b/gcloud/container/clusters/update index 5f46644e5..c9e52c970 100644 --- a/gcloud/container/clusters/update +++ b/gcloud/container/clusters/update @@ -28,6 +28,8 @@ SYNOPSIS | --stack-type=STACK_TYPE | --start-credential-rotation | --start-ip-rotation | --update-addons=[ADDON=ENABLED|DISABLED,...] | --update-labels=[KEY=VALUE,...] | --workload-pool=WORKLOAD_POOL + | --additional-pod-ipv4-ranges=NAME,[NAME,...] + --remove-additional-pod-ipv4-ranges=NAME,[NAME,...] | --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE | --enable-binauthz | --clear-maintenance-window | --remove-maintenance-exclusion=NAME @@ -43,8 +45,7 @@ SYNOPSIS --enable-resource-consumption-metering --resource-usage-bigquery-dataset=RESOURCE_USAGE_BIGQUERY_DATASET | --cluster-dns=CLUSTER_DNS --cluster-dns-domain=CLUSTER_DNS_DOMAIN - --cluster-dns-scope=CLUSTER_DNS_SCOPE | --disable-managed-prometheus - | --enable-managed-prometheus | [--enable-autoprovisioning + --cluster-dns-scope=CLUSTER_DNS_SCOPE | [--enable-autoprovisioning : --autoprovisioning-config-file=AUTOPROVISIONING_CONFIG_FILE | --autoprovisioning-image-type=AUTOPROVISIONING_IMAGE_TYPE --autoprovisioning-locations=ZONE,[ZONE,...] @@ -61,8 +62,9 @@ SYNOPSIS --enable-autoprovisioning-autoupgrade [--max-accelerator=[type=TYPE,count=COUNT,...] : --min-accelerator=[type=TYPE,count=COUNT,...]]] - | --logging=[COMPONENT,...] --monitoring=[COMPONENT,...] - | --logging-service=LOGGING_SERVICE + | --logging=[COMPONENT,...] + --monitoring=[COMPONENT,...] --disable-managed-prometheus + | --enable-managed-prometheus | --logging-service=LOGGING_SERVICE --monitoring-service=MONITORING_SERVICE | --password=PASSWORD --enable-basic-auth | --username=USERNAME, -u USERNAME) [--async] @@ -514,6 +516,24 @@ REQUIRED FLAGS https://cloud.google.com/kubernetes-engine/docs/how-to/workload-identity + --additional-pod-ipv4-ranges=NAME,[NAME,...] + Additional IP address ranges(by name) for pods that need to be added + to the cluster. + + Examples: + + $ gcloud container clusters update example-cluster \ + --additional-pod-ipv4-ranges=range1,range2 + + --remove-additional-pod-ipv4-ranges=NAME,[NAME,...] + Previously added additional pod ranges(by name) for pods that are to + be removed from the cluster. + + Examples: + + $ gcloud container clusters update example-cluster \ + --remove-additional-pod-ipv4-ranges=range1,range2 + Flags for Binary Authorization: At most one of these can be specified: @@ -692,14 +712,6 @@ REQUIRED FLAGS vpc Configures the Cloud DNS zone to be private to the VPC Network. - At most one of these can be specified: - - --disable-managed-prometheus - Disable managed collection for Managed Service for Prometheus. - - --enable-managed-prometheus - Enable managed collection for Managed Service for Prometheus. - Node autoprovisioning --enable-autoprovisioning @@ -959,6 +971,14 @@ REQUIRED FLAGS $ gcloud container clusters update --monitoring=SYSTEM,API_SERVER $ gcloud container clusters update --monitoring=NONE + At most one of these can be specified: + + --disable-managed-prometheus + Disable managed collection for Managed Service for Prometheus. + + --enable-managed-prometheus + Enable managed collection for Managed Service for Prometheus. + --logging-service=LOGGING_SERVICE (DEPRECATED) Logging service to use for the cluster. Options are: "logging.googleapis.com/kubernetes" (the Google Cloud Logging service diff --git a/gcloud/container/fleet/memberships/register b/gcloud/container/fleet/memberships/register index 8ebefeae4..265dce93b 100644 --- a/gcloud/container/fleet/memberships/register +++ b/gcloud/container/fleet/memberships/register @@ -3,7 +3,8 @@ NAME fleet SYNOPSIS - gcloud container fleet memberships register MEMBERSHIP_NAME + gcloud container fleet memberships register + (MEMBERSHIP_NAME : --location=LOCATION) (--gke-cluster=LOCATION/CLUSTER_NAME | --gke-uri=GKE_URI | [--context=CONTEXT : --kubeconfig=KUBECONFIG]) [--install-connect-agent] [--internal-ip] @@ -114,9 +115,35 @@ EXAMPLES --service-account-key-file=/tmp/keyfile.json POSITIONAL ARGUMENTS - MEMBERSHIP_NAME - The membership name that you choose to uniquely represents the cluster - being registered on the fleet. + Membership resource - The group of arguments defining a membership. 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 MEMBERSHIP_NAME on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + MEMBERSHIP_NAME + ID of the membership or fully qualified identifier for the + membership. To set the membership attribute: + ▸ provide the argument MEMBERSHIP_NAME on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location for the membership resource, e.g. us-central1. If not + specified, defaults to global. Not supported for GKE clusters, whose + membership location will be the location of the cluster. + + To set the location attribute: + ▸ provide the argument MEMBERSHIP_NAME on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property gkehub/location. REQUIRED FLAGS Cluster identifier. diff --git a/gcloud/container/fleet/mesh/update b/gcloud/container/fleet/mesh/update index 98a0c94d3..361b17f3f 100644 --- a/gcloud/container/fleet/mesh/update +++ b/gcloud/container/fleet/mesh/update @@ -23,8 +23,12 @@ REQUIRED FLAGS At least one of these must be specified: --control-plane=CONTROL_PLANE - Control plane management to update to. CONTROL_PLANE must be one of: - automatic, manual. + (DEPRECATED) Control plane management to update to. + + The --control-plane flag is now deprecated. Please use --management + instead. See + https://cloud.google.com/service-mesh/docs/managed/provision-managed-anthos-service-mesh. + CONTROL_PLANE must be one of: automatic, manual. --management=MANAGEMENT The management mode to update to. MANAGEMENT must be one of: diff --git a/gcloud/container/hub/memberships/register b/gcloud/container/hub/memberships/register index eac1b711e..571da528d 100644 --- a/gcloud/container/hub/memberships/register +++ b/gcloud/container/hub/memberships/register @@ -2,7 +2,8 @@ NAME gcloud container hub memberships register - register a cluster with a fleet SYNOPSIS - gcloud container hub memberships register MEMBERSHIP_NAME + gcloud container hub memberships register + (MEMBERSHIP_NAME : --location=LOCATION) (--gke-cluster=LOCATION/CLUSTER_NAME | --gke-uri=GKE_URI | [--context=CONTEXT : --kubeconfig=KUBECONFIG]) [--install-connect-agent] [--internal-ip] @@ -113,9 +114,35 @@ EXAMPLES --service-account-key-file=/tmp/keyfile.json POSITIONAL ARGUMENTS - MEMBERSHIP_NAME - The membership name that you choose to uniquely represents the cluster - being registered on the fleet. + Membership resource - The group of arguments defining a membership. 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 MEMBERSHIP_NAME on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + MEMBERSHIP_NAME + ID of the membership or fully qualified identifier for the + membership. To set the membership attribute: + ▸ provide the argument MEMBERSHIP_NAME on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location for the membership resource, e.g. us-central1. If not + specified, defaults to global. Not supported for GKE clusters, whose + membership location will be the location of the cluster. + + To set the location attribute: + ▸ provide the argument MEMBERSHIP_NAME on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property gkehub/location. REQUIRED FLAGS Cluster identifier. diff --git a/gcloud/container/hub/mesh/update b/gcloud/container/hub/mesh/update index dd93d427f..c1ba981d5 100644 --- a/gcloud/container/hub/mesh/update +++ b/gcloud/container/hub/mesh/update @@ -23,8 +23,12 @@ REQUIRED FLAGS At least one of these must be specified: --control-plane=CONTROL_PLANE - Control plane management to update to. CONTROL_PLANE must be one of: - automatic, manual. + (DEPRECATED) Control plane management to update to. + + The --control-plane flag is now deprecated. Please use --management + instead. See + https://cloud.google.com/service-mesh/docs/managed/provision-managed-anthos-service-mesh. + CONTROL_PLANE must be one of: automatic, manual. --management=MANAGEMENT The management mode to update to. MANAGEMENT must be one of: diff --git a/gcloud/dataplex/lakes/authorize b/gcloud/dataplex/lakes/authorize index d07885d67..9a45dfc7c 100644 --- a/gcloud/dataplex/lakes/authorize +++ b/gcloud/dataplex/lakes/authorize @@ -1,6 +1,6 @@ NAME - gcloud dataplex lakes authorize - authorize a project service account to - manage given resource + gcloud dataplex lakes authorize - authorize a service agent to manage + resources SYNOPSIS gcloud dataplex lakes authorize @@ -10,23 +10,23 @@ SYNOPSIS --secondary-project=SECONDARY_PROJECT) [GCLOUD_WIDE_FLAG ...] DESCRIPTION - IAM Bindings for the service account of the primary project will be added - to a secondary project, a storage bucket, or BigQuery dataset. + The service agent for the primary project will be granted an IAM role on a + secondary project, a Cloud Storage bucket, or a BigQuery dataset. EXAMPLES - To authorize the service account in project test-project to manage another - project test-project2, run: + To authorize the service agent in project test-project to manage resources + in the project test-project2, run: $ gcloud dataplex lakes authorize --project=test-project \ --project-resource=test-project2 - To authorize the service account in project test-project to manage the - storage bucket dataplex-storage-bucket, run: + To authorize the service agent in project test-project to manage the Cloud + Storage bucket dataplex-storage-bucket, run: $ gcloud dataplex lakes authorize --project=test-project \ --storage-bucket-resource=dataplex-storage-bucket - To authorize the service account in project test-project to manage the + To authorize the service agent in project test-project to manage the BigQuery dataset test-dataset in project test-project2, run: $ gcloud dataplex lakes authorize --project=test-project \ @@ -34,27 +34,30 @@ EXAMPLES --secondary-project=test-project2 REQUIRED FLAGS - Container or Object to bind P4SA. + The resource on which to grant a role to the service agent. Exactly one of these must be specified: --project-resource=PROJECT_RESOURCE - The identifier of the project to authorize. + The identifier of the project whose resources the service agent will + manage. --storage-bucket-resource=STORAGE_BUCKET_RESOURCE - The identifier of the Cloud Storage bucket to authorize the project - on. + The identifier of the Cloud Storage bucket that the service agent + will manage. - Fields to help identify the BigQuery Dataset. + Fields to identify the BigQuery dataset. --bigquery-dataset-resource=BIGQUERY_DATASET_RESOURCE - The identifier of the BigQuery dataset to authorize. + The identifier of the BigQuery dataset that the service agent will + manage. This flag argument must be specified if any of the other arguments in this group are specified. --secondary-project=SECONDARY_PROJECT - The identifier of the Project where BigQuery dataset resides. + The identifier of the project where the BigQuery dataset is + located. This flag argument must be specified if any of the other arguments in this group are specified. diff --git a/gcloud/dataplex/lakes/deauthorize b/gcloud/dataplex/lakes/deauthorize index b5668e2ec..a2f46d78c 100644 --- a/gcloud/dataplex/lakes/deauthorize +++ b/gcloud/dataplex/lakes/deauthorize @@ -1,6 +1,6 @@ NAME - gcloud dataplex lakes deauthorize - deauthorize a project service account - from managing given resource + gcloud dataplex lakes deauthorize - deauthorize a service agent from + managing resources SYNOPSIS gcloud dataplex lakes deauthorize @@ -10,52 +10,54 @@ SYNOPSIS --secondary-project=SECONDARY_PROJECT) [GCLOUD_WIDE_FLAG ...] DESCRIPTION - Remove IAM Bindings for the service account of the primary project from a - secondary project, a storage bucket, or BigQuery dataset. + The service agent for the primary project will have its IAM role revoked + from a secondary project, a Cloud Storage bucket, or a BigQuery dataset. EXAMPLES - To deauthorize the service account in project test-project from managing - another project test-project2, run: + To deauthorize the service agent in project test-project from managing + resources in the project test-project2, run: $ gcloud dataplex lakes deauthorize --project=test-project \ --project-resource=test-project2 - To deauthorize the service account in project test-project from managing - the storage bucket dataplex-storage-bucket, run: + To deauthorize the service agent in project test-project from managing the + Cloud Storage bucket dataplex-storage-bucket, run: $ gcloud dataplex lakes deauthorize --project=test-project \ --storage-bucket-resource=dataplex-storage-bucket - To deauthorize the service account in project test-project from managing - the BigQuery dataset test-dataset in project test-project2, run: + To deauthorize the service agent in project test-project from managing the + BigQuery dataset test-dataset in project test-project2, run: $ gcloud dataplex lakes deauthorize --project=test-project \ --bigquery-dataset-resource=test-dataset \ --secondary-project=test-project2 REQUIRED FLAGS - Container or Object to unbind p4sa + The resource for which the service agent's role will be revoked. Exactly one of these must be specified: --project-resource=PROJECT_RESOURCE - The identifier of the project to deauthorize. + The identifier of the project whose resources the service agent will + no longer manage. --storage-bucket-resource=STORAGE_BUCKET_RESOURCE - The identifier of the Cloud Storage bucket to deauthorize the project - from. + The identifier of the Cloud Storage bucket that the service agent + will no longer manage. - Fields to help identify the BigQuery Dataset. + Fields to identify the BigQuery dataset. --bigquery-dataset-resource=BIGQUERY_DATASET_RESOURCE - The identifier of the BigQuery dataset to deauthorize the project - from. + The identifier of the BigQuery dataset that the service agent will + no longer manage. This flag argument must be specified if any of the other arguments in this group are specified. --secondary-project=SECONDARY_PROJECT - The identifier of the Project where BigQuery dataset resides + The identifier of the project where the BigQuery dataset is + located. This flag argument must be specified if any of the other arguments in this group are specified. diff --git a/gcloud/dataplex/lakes/help b/gcloud/dataplex/lakes/help index d17876e05..9962469f5 100644 --- a/gcloud/dataplex/lakes/help +++ b/gcloud/dataplex/lakes/help @@ -25,13 +25,13 @@ COMMANDS Add IAM policy binding to a Dataplex lake resource. authorize - Authorize a project service account to manage given resource. + Authorize a service agent to manage resources. create Create a Dataplex lake resource. deauthorize - Deauthorize a project service account from managing given resource. + Deauthorize a service agent from managing resources. delete Delete a Dataplex lake resource. diff --git a/gcloud/datastore/databases/create b/gcloud/datastore/databases/create deleted file mode 100644 index ec7f4b1bd..000000000 --- a/gcloud/datastore/databases/create +++ /dev/null @@ -1,45 +0,0 @@ -NAME - gcloud datastore databases create - create a Google Cloud Firestore in - Datastore Mode database - -SYNOPSIS - gcloud datastore databases create [--region=REGION] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (DEPRECATED) This command is deprecated. Please use gcloud alpha firestore - database update --type=datastore-mode instead. - - (DEPRECATED) Create a Google Cloud Firestore in Datastore Mode database. - - This command is deprecated. Please use gcloud alpha firestore database - update --type=datastore-mode instead. - -EXAMPLES - To create Google Cloud Firestore in Datastore Mode database - - $ gcloud datastore databases create - - To create an app in the us-central region, run: - - $ gcloud datastore databases create --region=us-central - -FLAGS - --region=REGION - The region to create the Google Cloud Firestore in Datastore Mode - database within. Use gcloud app regions list to list available regions. - -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 datastore databases create - - $ gcloud beta datastore databases create - diff --git a/gcloud/datastore/databases/help b/gcloud/datastore/databases/help index c881e263d..05794c8ba 100644 --- a/gcloud/datastore/databases/help +++ b/gcloud/datastore/databases/help @@ -13,13 +13,6 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. -COMMANDS - COMMAND is one of the following: - - create - (DEPRECATED) Create a Google Cloud Firestore in Datastore Mode - database. - NOTES These variants are also available: diff --git a/gcloud/firestore/databases/create b/gcloud/firestore/databases/create index b40cf984f..aa363dbee 100644 --- a/gcloud/firestore/databases/create +++ b/gcloud/firestore/databases/create @@ -1,38 +1,48 @@ NAME - gcloud firestore databases create - create a Google Cloud Firestore Native - database + gcloud firestore databases create - create a Google Cloud Firestore + database via Firestore API SYNOPSIS - gcloud firestore databases create [--location=LOCATION] [--region=REGION] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Create a Google Cloud Firestore Native database. + gcloud firestore databases create --location=LOCATION + [--database=DATABASE; default="(default)"] + [--type=TYPE; default="firestore-native"] [GCLOUD_WIDE_FLAG ...] EXAMPLES - To create Google Cloud Firestore Native database - - $ gcloud firestore databases create - - To create an app in the nam5 region (multi-region), run: + To create Firestore Native database in nam5. $ gcloud firestore databases create --location=nam5 - To create an app in the us-east1 region, run: + To create Datastore Mode database in us-east1. - $ gcloud firestore databases create --location=us-east1 + $ gcloud firestore databases create --location=us-east1 \ + --type=datastore-mode -FLAGS + To create Datastore Mode database in us-east1 with a databaseId foo. + + $ gcloud firestore databases create --database=mytest \ + --location=us-east1 --type=datastore-mode + +REQUIRED FLAGS --location=LOCATION The location to create the Google Cloud Firestore Native database within. Available locations are listed at https://cloud.google.com/firestore/docs/locations. - --region=REGION - (DEPRECATED) The region to create the Google Cloud Firestore Native - database within. Use gcloud app regions list to list available regions. +OPTIONAL FLAGS + --database=DATABASE; default="(default)" + The ID to use for the database, which will become the final component + of the database's resource name. If database ID is not provided, + (default) will be used as database ID. - The --region option is deprecated; use --location instead. + This value should be 4-63 characters. Valid characters are /[a-z][0-9]-/ + with first character a letter and the last a letter or a number. Must + not be UUID-like /[0-9a-f]{8}(-[0-9a-f]{4}){3}-[0-9a-f]{12}/. + + Using "(default)" database ID is also allowed. + + --type=TYPE; default="firestore-native" + The type of the database. TYPE must be one of: firestore-native, + datastore-mode. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/firestore/databases/describe b/gcloud/firestore/databases/describe new file mode 100644 index 000000000..dc49dc071 --- /dev/null +++ b/gcloud/firestore/databases/describe @@ -0,0 +1,53 @@ +NAME + gcloud firestore databases describe - describe a Google Cloud Firestore + database + +SYNOPSIS + gcloud firestore databases describe [--database=DATABASE] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe a Google Cloud Firestore database. + +EXAMPLES + The following command describes a Google Cloud Firestore database. + + $ gcloud firestore databases describe + +FLAGS + Database resource - The Google Cloud Firestore database to describe. This + represents a Cloud resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. To set the project + attribute: + ◆ provide the argument --database on the command line with a fully + specified name; + ◆ the default value of argument [--database] is (default) with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + --database=DATABASE + ID of the database or fully qualified identifier for the database. To + set the database attribute: + ▸ provide the argument --database on the command line; + ▸ the default value of argument [--database] is (default). + +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 firestore/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/firestore + +NOTES + These variants are also available: + + $ gcloud alpha firestore databases describe + + $ gcloud beta firestore databases describe + diff --git a/gcloud/firestore/databases/help b/gcloud/firestore/databases/help index 7f7fceccd..a06b465a1 100644 --- a/gcloud/firestore/databases/help +++ b/gcloud/firestore/databases/help @@ -17,7 +17,16 @@ COMMANDS COMMAND is one of the following: create - Create a Google Cloud Firestore Native database. + Create a Google Cloud Firestore database via Firestore API. + + describe + Describe a Google Cloud Firestore database. + + list + Lists all Firestore databases under the project. + + update + Update the database configuration of a Cloud Firestore database. NOTES These variants are also available: diff --git a/gcloud/firestore/databases/list b/gcloud/firestore/databases/list new file mode 100644 index 000000000..f7f44ff74 --- /dev/null +++ b/gcloud/firestore/databases/list @@ -0,0 +1,61 @@ +NAME + gcloud firestore databases list - lists all Firestore databases under the + project + +SYNOPSIS + gcloud firestore databases list [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +EXAMPLES + To list all Firestore databases. + + $ gcloud firestore databases list + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha firestore databases list + + $ gcloud beta firestore databases list + diff --git a/gcloud/firestore/databases/update b/gcloud/firestore/databases/update new file mode 100644 index 000000000..1fa8e6b5d --- /dev/null +++ b/gcloud/firestore/databases/update @@ -0,0 +1,61 @@ +NAME + gcloud firestore databases update - update the database configuration of a + Cloud Firestore database + +SYNOPSIS + gcloud firestore databases update [--async] [--database=DATABASE] + [--type=TYPE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Update the database configuration of a Cloud Firestore database. + +EXAMPLES + The following command updates the database type of a Cloud Firestore + database. + + $ gcloud firestore databases update --type=firestore-native + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + Database resource - Cloud Firestore database to update. This represents a + Cloud resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. To set the project attribute: + ◆ provide the argument --database on the command line with a fully + specified name; + ◆ the default value of argument [--database] is (default) with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + --database=DATABASE + ID of the database or fully qualified identifier for the database. To + set the database attribute: + ▸ provide the argument --database on the command line; + ▸ the default value of argument [--database] is (default). + + --type=TYPE + The database type. TYPE must be one of: datastore-mode, + firestore-native. + +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 firestore/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/firestore + +NOTES + These variants are also available: + + $ gcloud alpha firestore databases update + + $ gcloud beta firestore databases update + diff --git a/gcloud/logging/sinks/create b/gcloud/logging/sinks/create index 0cdce7b87..676f68129 100644 --- a/gcloud/logging/sinks/create +++ b/gcloud/logging/sinks/create @@ -21,7 +21,8 @@ DESCRIPTION https://cloud.google.com/logging/docs/view/logging-query-language The sink's destination can be a Cloud Logging log bucket, a Cloud Storage - bucket, a BigQuery dataset, or a Cloud Pub/Sub topic. + bucket, a BigQuery dataset, a Cloud Pub/Sub topic, or a Google Cloud + project. The destination must already exist. diff --git a/gcloud/network-connectivity/service-connection-policies/create b/gcloud/network-connectivity/service-connection-policies/create index 7b53657b3..70997c6df 100644 --- a/gcloud/network-connectivity/service-connection-policies/create +++ b/gcloud/network-connectivity/service-connection-policies/create @@ -6,9 +6,9 @@ SYNOPSIS gcloud network-connectivity service-connection-policies create (SERVICE_CONNECTION_POLICY : --region=REGION) --network=NETWORK --service-class=SERVICE_CLASS - (--psc-subnetworks=[PSC_SUBNETWORKS,...] - : --psc-connection-limit=PSC_CONNECTION_LIMIT) [--async] - [--description=DESCRIPTION] [--labels=KEY=VALUE] [GCLOUD_WIDE_FLAG ...] + (--subnets=[SUBNETS,...] : --psc-connection-limit=PSC_CONNECTION_LIMIT) + [--async] [--description=DESCRIPTION] [--labels=KEY=VALUE] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION Create a new Service Connection Policy with the given name. @@ -65,7 +65,7 @@ REQUIRED FLAGS This must be specified. - --psc-subnetworks=[PSC_SUBNETWORKS,...] + --subnets=[SUBNETS,...] Subnetwork to use for IP address management. This flag argument must be specified if any of the other arguments in diff --git a/gcloud/resource-manager/tags/bindings/create b/gcloud/resource-manager/tags/bindings/create index fd95014e2..094f9e910 100644 --- a/gcloud/resource-manager/tags/bindings/create +++ b/gcloud/resource-manager/tags/bindings/create @@ -11,8 +11,8 @@ DESCRIPTION Creates a TagBinding given the TagValue and the parent cloud resource the TagValue will be attached to. The TagValue can be represented with its numeric id or its namespaced name of - organizations/{org_id}/{tag_key_short_name}. The parent resource should be - represented with its full resource name. See: + {parent_namespace}/{tag_key_short_name}/{tag_value_short_name}. The parent + resource should be represented with its full resource name. See: https://cloud.google.com/apis/design/resource_names#full_resource_name. EXAMPLES diff --git a/gcloud/resource-manager/tags/bindings/delete b/gcloud/resource-manager/tags/bindings/delete index d9f357354..d3c1aed86 100644 --- a/gcloud/resource-manager/tags/bindings/delete +++ b/gcloud/resource-manager/tags/bindings/delete @@ -12,7 +12,7 @@ DESCRIPTION name. See: https://cloud.google.com/apis/design/resource_names#full_resource_name. The TagValue can be represented with its numeric id or its namespaced name of - {org_id}/{tag_key_short_name}. + {parent_namespace}/{tag_key_short_name}/{tag_value_short_name}. EXAMPLES To delete a TagBinding between tagValue/111 and Project with name diff --git a/gcloud/resource-manager/tags/bindings/help b/gcloud/resource-manager/tags/bindings/help index 7f04aeb87..abbf69a78 100644 --- a/gcloud/resource-manager/tags/bindings/help +++ b/gcloud/resource-manager/tags/bindings/help @@ -6,10 +6,10 @@ SYNOPSIS DESCRIPTION The Resource Manager Service gives you centralized and programmatic control - over your organization's Tags. As the tag administrator, you will be able - to create and configure restrictions across the tags in the org. As the tag - user, you will be able to attach TagValues to different resources as a - TagBinding. + over your organization or project's Tags. As the tag administrator, you + will be able to create and configure restrictions across the tags in your + organization or projects. As the tag user, you will be able to attach + TagValues to different resources as a TagBinding. GCLOUD WIDE FLAGS These flags are available to all commands: --help. diff --git a/gcloud/resource-manager/tags/help b/gcloud/resource-manager/tags/help index 49dfcd42e..2a85b03e1 100644 --- a/gcloud/resource-manager/tags/help +++ b/gcloud/resource-manager/tags/help @@ -8,8 +8,9 @@ SYNOPSIS DESCRIPTION The Tags Service gives you centralized and programmatic control over your organization's tags. As the tag administrator, you will be able to create - and configure restrictions across the tags in the org. As the tag user, you - will be able to attach tags values to different resources. + and configure restrictions across the tags in your organization or + projects. As the tag user, you will be able to attach tags values to + different resources. GCLOUD WIDE FLAGS These flags are available to all commands: --help. diff --git a/gcloud/resource-manager/tags/holds/create b/gcloud/resource-manager/tags/holds/create index bb4e2be42..a3ec53e59 100644 --- a/gcloud/resource-manager/tags/holds/create +++ b/gcloud/resource-manager/tags/holds/create @@ -10,7 +10,7 @@ DESCRIPTION Create a TagHold under a TagValue, indicating that the TagValue is being used by a holder (cloud resource) from an (optional) origin. The TagValue can be represented with its numeric id or its namespaced name of - {org_id}/{tag_key_short_name}/{tag_value_short_name}. + {parent_namespace}/{tag_key_short_name}/{tag_value_short_name}. EXAMPLES To create a TagHold on tagValues/123, with holder cloud-resource-holder, diff --git a/gcloud/resource-manager/tags/holds/help b/gcloud/resource-manager/tags/holds/help index f4e9a8608..8dfb6b968 100644 --- a/gcloud/resource-manager/tags/holds/help +++ b/gcloud/resource-manager/tags/holds/help @@ -7,8 +7,9 @@ SYNOPSIS DESCRIPTION The Resource Manager Service gives you centralized and programmatic control over your organization's Tags. As the tag administrator, you will be able - to create and configure restrictions across the tags in the org, and you - will be able to indicate the use of a TagValue as a TagHold. + to create and configure restrictions across the tags in your organization + or projects, and you will be able to indicate the use of a TagValue as a + TagHold. GCLOUD WIDE FLAGS These flags are available to all commands: --help. diff --git a/gcloud/resource-manager/tags/holds/list b/gcloud/resource-manager/tags/holds/list index a0496ba82..7a0bc0e3a 100644 --- a/gcloud/resource-manager/tags/holds/list +++ b/gcloud/resource-manager/tags/holds/list @@ -11,11 +11,11 @@ SYNOPSIS DESCRIPTION List TagHolds under a TagValue. The TagValue can be represented with its numeric id or its namespaced name of - {org_id}/{tag_key_short_name}/{tag_value_short_name}. Limited to TagHolds - stored in a single --location: if none is provided, the API will assume the - "global" location. Optional filters are --holder and --origin: if provided, - returned TagHolds' holder and origin fields must match the exact flag - value. + {parent_namespace}/{tag_key_short_name}/{tag_value_short_name}. Limited to + TagHolds stored in a single --location: if none is provided, the API will + assume the "global" location. Optional filters are --holder and --origin: + if provided, returned TagHolds' holder and origin fields must match the + exact flag value. EXAMPLES To list TagHolds for tagValues/456 in us-central1-a, run: @@ -33,7 +33,7 @@ POSITIONAL ARGUMENTS PARENT TagValue resource name or namespaced name to list TagHolds for. This field should be in the form tagValues/ or - //. + //. FLAGS --holder=HOLDER diff --git a/gcloud/resource-manager/tags/keys/help b/gcloud/resource-manager/tags/keys/help index 0f51b8c69..7a16e06a9 100644 --- a/gcloud/resource-manager/tags/keys/help +++ b/gcloud/resource-manager/tags/keys/help @@ -7,8 +7,9 @@ SYNOPSIS DESCRIPTION The Resource Manager Service gives you centralized and programmatic control over your organization's Tags. As the tag administrator, you will be able - to create and configure restrictions across the tags in the org. As the tag - user, you will be able to attach TagValues to different resources. + to create and configure restrictions across the tags in your organization + or projects. As the tag user, you will be able to attach TagValues to + different resources. GCLOUD WIDE FLAGS These flags are available to all commands: --help. diff --git a/gcloud/resource-manager/tags/values/add-iam-policy-binding b/gcloud/resource-manager/tags/values/add-iam-policy-binding index 803e2e857..5e094df5b 100644 --- a/gcloud/resource-manager/tags/values/add-iam-policy-binding +++ b/gcloud/resource-manager/tags/values/add-iam-policy-binding @@ -11,7 +11,8 @@ SYNOPSIS DESCRIPTION Adds the IAM policy binding for a TagValue resource given the binding and an identifier for the TagValue. The identifier can be the TagValue's - // or the + namespaced name in the form + // or the TagValue's ID in the form: tagValues/{numeric_id}. EXAMPLES diff --git a/gcloud/resource-manager/tags/values/help b/gcloud/resource-manager/tags/values/help index 16852db5c..ced4276fb 100644 --- a/gcloud/resource-manager/tags/values/help +++ b/gcloud/resource-manager/tags/values/help @@ -7,8 +7,9 @@ SYNOPSIS DESCRIPTION The Resource Manager Service gives you centralized and programmatic control over your organization's Tags. As the tag administrator, you will be able - to create and configure restrictions across the tags in the org. As the tag - user, you will be able to attach TagValues to different resources. + to create and configure restrictions across the tags in your organization + or projects. As the tag user, you will be able to attach TagValues to + different resources. GCLOUD WIDE FLAGS These flags are available to all commands: --help. diff --git a/gcloud/resource-manager/tags/values/remove-iam-policy-binding b/gcloud/resource-manager/tags/values/remove-iam-policy-binding index 2904a4087..4f4be37e9 100644 --- a/gcloud/resource-manager/tags/values/remove-iam-policy-binding +++ b/gcloud/resource-manager/tags/values/remove-iam-policy-binding @@ -11,7 +11,8 @@ SYNOPSIS DESCRIPTION Removes an IAM policy binding for a TagValue resource given the binding and an identifier for the TagValue. The identifier can be the TagValue's - // or the + namespaced name in the form + // or the TagValue's ID in the form: tagValues/{numeric_id}. EXAMPLES diff --git a/gcloud/resource-manager/tags/values/update b/gcloud/resource-manager/tags/values/update index fdab2c8dc..80dcdd83e 100644 --- a/gcloud/resource-manager/tags/values/update +++ b/gcloud/resource-manager/tags/values/update @@ -7,8 +7,8 @@ SYNOPSIS [--description=DESCRIPTION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - Updates the TagValue's description given the TagValue's - // or the TagValue's + Updates the TagValue's description given the TagValue's namespaced name + // or the TagValue's numeric id tagValues/ EXAMPLES diff --git a/gcloud/run/deploy b/gcloud/run/deploy index ed429673b..8fc00f8ff 100644 --- a/gcloud/run/deploy +++ b/gcloud/run/deploy @@ -25,8 +25,8 @@ SYNOPSIS --clear-vpc-connector --[no-]cpu-boost --[no-]cpu-throttling --description=DESCRIPTION --execution-environment=EXECUTION_ENVIRONMENT - --revision-suffix=REVISION_SUFFIX --vpc-connector=VPC_CONNECTOR - --vpc-egress=VPC_EGRESS + --revision-suffix=REVISION_SUFFIX --[no-]session-affinity + --vpc-connector=VPC_CONNECTOR --vpc-egress=VPC_EGRESS --add-cloudsql-instances=[CLOUDSQL-INSTANCES,...] | --clear-cloudsql-instances | --remove-cloudsql-instances=[CLOUDSQL-INSTANCES,...] @@ -406,6 +406,11 @@ FLAGS [--revision-suffix=v1] for a service named 'helloworld', would lead to a revision named 'helloworld-v1'. + --[no-]session-affinity + Whether to enable session affinity for connections to the service. + Use --session-affinity to enable and --no-session-affinity to + disable. + --vpc-connector=VPC_CONNECTOR Set a VPC connector for this resource. diff --git a/gcloud/run/services/update b/gcloud/run/services/update index 3715c0e62..91514a0d9 100644 --- a/gcloud/run/services/update +++ b/gcloud/run/services/update @@ -13,8 +13,8 @@ SYNOPSIS [--no-traffic] [--[no-]use-http2] [--breakglass=JUSTIFICATION --clear-vpc-connector --[no-]cpu-boost --[no-]cpu-throttling --execution-environment=EXECUTION_ENVIRONMENT - --revision-suffix=REVISION_SUFFIX --vpc-connector=VPC_CONNECTOR - --vpc-egress=VPC_EGRESS + --revision-suffix=REVISION_SUFFIX --[no-]session-affinity + --vpc-connector=VPC_CONNECTOR --vpc-egress=VPC_EGRESS --add-cloudsql-instances=[CLOUDSQL-INSTANCES,...] | --clear-cloudsql-instances | --remove-cloudsql-instances=[CLOUDSQL-INSTANCES,...] @@ -235,6 +235,11 @@ FLAGS [--revision-suffix=v1] for a service named 'helloworld', would lead to a revision named 'helloworld-v1'. + --[no-]session-affinity + Whether to enable session affinity for connections to the service. + Use --session-affinity to enable and --no-session-affinity to + disable. + --vpc-connector=VPC_CONNECTOR Set a VPC connector for this resource. diff --git a/gcloud/sql/flags/list b/gcloud/sql/flags/list index e0ef71b03..c8c3e90f0 100644 --- a/gcloud/sql/flags/list +++ b/gcloud/sql/flags/list @@ -19,10 +19,10 @@ FLAGS Apart from listed major versions, DATABASE_VERSION also accepts supported minor versions. DATABASE_VERSION must be one of: MYSQL_5_6, MYSQL_5_7, MYSQL_8_0, POSTGRES_9_6, POSTGRES_10, POSTGRES_11, - POSTGRES_12, POSTGRES_13, POSTGRES_14, SQLSERVER_2017_EXPRESS, - SQLSERVER_2017_WEB, SQLSERVER_2017_STANDARD, SQLSERVER_2017_ENTERPRISE, - SQLSERVER_2019_EXPRESS, SQLSERVER_2019_WEB, SQLSERVER_2019_STANDARD, - SQLSERVER_2019_ENTERPRISE. + POSTGRES_12, POSTGRES_13, POSTGRES_14, POSTGRES_15, + SQLSERVER_2017_EXPRESS, SQLSERVER_2017_WEB, SQLSERVER_2017_STANDARD, + SQLSERVER_2017_ENTERPRISE, SQLSERVER_2019_EXPRESS, SQLSERVER_2019_WEB, + SQLSERVER_2019_STANDARD, SQLSERVER_2019_ENTERPRISE. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/sql/instances/create b/gcloud/sql/instances/create index c79940b3a..3cef1eb75 100644 --- a/gcloud/sql/instances/create +++ b/gcloud/sql/instances/create @@ -185,10 +185,10 @@ FLAGS Apart from listed major versions, DATABASE_VERSION also accepts supported minor versions. DATABASE_VERSION must be one of: MYSQL_5_6, MYSQL_5_7, MYSQL_8_0, POSTGRES_9_6, POSTGRES_10, POSTGRES_11, - POSTGRES_12, POSTGRES_13, POSTGRES_14, SQLSERVER_2017_EXPRESS, - SQLSERVER_2017_WEB, SQLSERVER_2017_STANDARD, SQLSERVER_2017_ENTERPRISE, - SQLSERVER_2019_EXPRESS, SQLSERVER_2019_WEB, SQLSERVER_2019_STANDARD, - SQLSERVER_2019_ENTERPRISE. + POSTGRES_12, POSTGRES_13, POSTGRES_14, POSTGRES_15, + SQLSERVER_2017_EXPRESS, SQLSERVER_2017_WEB, SQLSERVER_2017_STANDARD, + SQLSERVER_2017_ENTERPRISE, SQLSERVER_2019_EXPRESS, SQLSERVER_2019_WEB, + SQLSERVER_2019_STANDARD, SQLSERVER_2019_ENTERPRISE. --[no-]deletion-protection Enable deletion protection on a Cloud SQL instance. Use diff --git a/gcloud/sql/instances/patch b/gcloud/sql/instances/patch index 33f85c018..256352362 100644 --- a/gcloud/sql/instances/patch +++ b/gcloud/sql/instances/patch @@ -130,10 +130,10 @@ FLAGS Apart from listed major versions, DATABASE_VERSION also accepts supported minor versions. DATABASE_VERSION must be one of: MYSQL_5_6, MYSQL_5_7, MYSQL_8_0, POSTGRES_9_6, POSTGRES_10, POSTGRES_11, - POSTGRES_12, POSTGRES_13, POSTGRES_14, SQLSERVER_2017_EXPRESS, - SQLSERVER_2017_WEB, SQLSERVER_2017_STANDARD, SQLSERVER_2017_ENTERPRISE, - SQLSERVER_2019_EXPRESS, SQLSERVER_2019_WEB, SQLSERVER_2019_STANDARD, - SQLSERVER_2019_ENTERPRISE. + POSTGRES_12, POSTGRES_13, POSTGRES_14, POSTGRES_15, + SQLSERVER_2017_EXPRESS, SQLSERVER_2017_WEB, SQLSERVER_2017_STANDARD, + SQLSERVER_2017_ENTERPRISE, SQLSERVER_2019_EXPRESS, SQLSERVER_2019_WEB, + SQLSERVER_2019_STANDARD, SQLSERVER_2019_ENTERPRISE. --[no-]deletion-protection Enable deletion protection on a Cloud SQL instance. Use diff --git a/gcloud/storage/help b/gcloud/storage/help index 8e311207d..a3de1a269 100644 --- a/gcloud/storage/help +++ b/gcloud/storage/help @@ -23,6 +23,9 @@ GROUPS buckets Manage Cloud Storage buckets. + insights + Manage Cloud Storage inventory reports. + objects Manage Cloud Storage objects. diff --git a/gcloud/storage/insights/help b/gcloud/storage/insights/help new file mode 100644 index 000000000..0cedde1ab --- /dev/null +++ b/gcloud/storage/insights/help @@ -0,0 +1,25 @@ +NAME + gcloud storage insights - manage Cloud Storage inventory reports + +SYNOPSIS + gcloud storage insights GROUP [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Cloud Storage inventory reports. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + inventory-reports + Manage Cloud Storage inventory report configurations. + +NOTES + This variant is also available: + + $ gcloud alpha storage insights + diff --git a/gcloud/storage/insights/inventory-reports/create b/gcloud/storage/insights/inventory-reports/create new file mode 100644 index 000000000..047e110f3 --- /dev/null +++ b/gcloud/storage/insights/inventory-reports/create @@ -0,0 +1,101 @@ +NAME + gcloud storage insights inventory-reports create - create a new inventory + report config + +SYNOPSIS + gcloud storage insights inventory-reports create SOURCE_BUCKET_URL + [--destination=DESTINATION_URL] [--display-name=DISPLAY_NAME] + [--metadata-fields=[METADATA_FIELDS,...]; + default="project,bucket,name,location,size,timeCreated,timeDeleted, + updated,storageClass,etag,retentionExpirationTime,crc32c,md5Hash, + generation, + metageneration,contentType,contentEncoding,timeStorageClassUpdated"] + [--schedule-repeats=FREQUENCY; default="daily"] + [--schedule-repeats-until=END_DATE] [--schedule-starts=START_DATE] + [--parquet | --csv-delimiter=DELIMITER + --[no-]csv-header --csv-separator=SEPARATOR] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create an inventory report config that defines how often inventory reports + are generated, the metadata fields you want the reports to include, and a + bucket/prefix in which to store the reports, also known as the destination. + +EXAMPLES + To create an inventory report about "my-bucket" that will store report + details in "report-bucket" with the prefix "save-path/". + + $ gcloud storage insights inventory-reports create gs://my-bucket \ + --destination=gs://report-bucket/save-path/ + +POSITIONAL ARGUMENTS + SOURCE_BUCKET_URL + URL of the source bucket that will contain the inventory report + configuration. + +FLAGS + --destination=DESTINATION_URL + Sets the URL of the destination bucket and path where generated reports + are stored. Defaults to /inventory_reports/. + + --display-name=DISPLAY_NAME + Sets the editable name of the report configuration. + + --metadata-fields=[METADATA_FIELDS,...]; default="project,bucket,name,location,size,timeCreated,timeDeleted,updated,storageClass,etag,retentionExpirationTime,crc32c,md5Hash,generation,metageneration,contentType,contentEncoding,timeStorageClassUpdated" + The metadata fields to be included in the inventory report. The fields: + "project, bucket, name" are REQUIRED. Defaults to all fields being + included. METADATA_FIELDS must be one of: project, bucket, name, + location, size, timeCreated, timeDeleted, updated, storageClass, etag, + retentionExpirationTime, crc32c, md5Hash, generation, metageneration, + contentType, contentEncoding, timeStorageClassUpdated. + + --schedule-repeats=FREQUENCY; default="daily" + Sets how often the inventory report configuration will run. Defaults to + DAILY. FREQUENCY must be one of: daily, weekly. + + --schedule-repeats-until=END_DATE + Sets date after which you want to stop generating inventory reports. + For example, 2022-03-30. Defaults to one year from --schedule-starts + value. + + --schedule-starts=START_DATE + Sets the date you want to start generating inventory reports. For + example, 2022-01-30. Should be tomorrow or later based on UTC timezone. + Defaults to tomorrow. + + Report format configuration. Any combination of CSV flags is valid as long + as the Parquet flag is not present. + + At most one of these can be specified: + + --parquet + Generate reports in parquet format. + + Flags for setting CSV format options. + + --csv-delimiter=DELIMITER + Sets the delimiter that separates the fields in the inventory + report CSV file. For example, ``,`` + + --[no-]csv-header + Indicates whether or not headers are included in the inventory + report CSV file. Default is None. Use --csv-header to enable and + --no-csv-header to disable. + + --csv-separator=SEPARATOR + Sets the character used to separate the records in the inventory + report CSV file. For example, ``\n``. SEPARATOR must be one of: \n, + \r\n. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud alpha storage insights inventory-reports create + diff --git a/gcloud/storage/insights/inventory-reports/delete b/gcloud/storage/insights/inventory-reports/delete new file mode 100644 index 000000000..23981733c --- /dev/null +++ b/gcloud/storage/insights/inventory-reports/delete @@ -0,0 +1,72 @@ +NAME + gcloud storage insights inventory-reports delete - delete an inventory + report config + +SYNOPSIS + gcloud storage insights inventory-reports delete + (REPORT_CONFIG : --location=LOCATION) [--force] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete an inventory report config. + +EXAMPLES + To delete an inventory report config with ID=1234, location=us-central1 and + project=foo: + + $ gcloud storage insights inventory-reports delete 1234 \ + --location=us-central1 --project=foo + + To delete the same inventory report config with fully specified name: + + $ gcloud storage insights inventory-reports delete \ + /projects/foo/locations/us-central1/reportConfigs/1234 + + To delete the report config with all generated report details: + + $ gcloud storage insights inventory-reports delete \ + /projects/foo/locations/us-central1/reportConfigs/1234 --force + +POSITIONAL ARGUMENTS + Report config resource - The Report config to delete. The arguments in + this group can be used to specify the attributes of this resource. (NOTE) + Some attributes are not given arguments in this group but can be set in + other ways. To set the project attribute: + ◆ provide the argument report_config 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. + + REPORT_CONFIG + ID of the report-config or fully qualified identifier for the + report-config. To set the report-config attribute: + ▸ provide the argument report_config on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Google Cloud location for the report-config. To set the location + attribute: + ▸ provide the argument report_config on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --force + If set, all report details for this report config will be deleted. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud alpha storage insights inventory-reports delete + diff --git a/gcloud/storage/insights/inventory-reports/describe b/gcloud/storage/insights/inventory-reports/describe new file mode 100644 index 000000000..b6ff27e74 --- /dev/null +++ b/gcloud/storage/insights/inventory-reports/describe @@ -0,0 +1,70 @@ +NAME + gcloud storage insights inventory-reports describe - describe an inventory + report config + +SYNOPSIS + gcloud storage insights inventory-reports describe + (REPORT_CONFIG : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe an inventory report config. + +EXAMPLES + To describe an inventory report config with ID=1234, location=us-central1, + and project=foo: + + $ gcloud storage insights inventory-reports describe 1234 \ + --location=us-central1 --project=foo + + To describe the same inventory report config with fully specified name: + + $ gcloud storage insights inventory-reports describe \ + /projects/foo/locations/us-central1/reportConfigs/1234 + + Describe the same inventory report config with JSON formatting, only + returning the "displayName" field: + + $ gcloud storage insights inventory-reports describe \ + /projects/foo/locations/us-central1/reportConfigs/1234 \ + --format="json(displayName)" + +POSITIONAL ARGUMENTS + Report config resource - The Report config to describe. The arguments in + this group can be used to specify the attributes of this resource. (NOTE) + Some attributes are not given arguments in this group but can be set in + other ways. To set the project attribute: + ◆ provide the argument report_config 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. + + REPORT_CONFIG + ID of the report-config or fully qualified identifier for the + report-config. To set the report-config attribute: + ▸ provide the argument report_config on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Google Cloud location for the report-config. To set the location + attribute: + ▸ provide the argument report_config on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud alpha storage insights inventory-reports describe + diff --git a/gcloud/storage/insights/inventory-reports/details/describe b/gcloud/storage/insights/inventory-reports/details/describe new file mode 100644 index 000000000..890fde8f6 --- /dev/null +++ b/gcloud/storage/insights/inventory-reports/details/describe @@ -0,0 +1,79 @@ +NAME + gcloud storage insights inventory-reports details describe - describe + inventory reports detail + +SYNOPSIS + gcloud storage insights inventory-reports details describe + (REPORT_DETAIL : --location=LOCATION --report-config=REPORT_CONFIG) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe the inventory report detail. + +EXAMPLES + To describe an inventory report detail with ID=4568, location=us-central1, + project=foo, and report config ID=1234: + + $ gcloud storage insights inventory-reports details describe 1234 \ + --location=us-central1 --project=foo --report-config=1234 + + To describe the same inventory report detail with fully specified name: + + $ gcloud storage insights inventory-reports details describe \ + /projects/foo/locations/us-central1/reportConfigs/1234/\ + reportDetails/5678 + + To describe the same inventory report detail with JSON formatting, only + returning the "status" field: + + $ gcloud storage insights inventory-reports details describe \ + /projects/foo/locations/us-central1/reportConfigs/1234/\ + reportDetails/5678 --format="json(status)" + +POSITIONAL ARGUMENTS + Report detail resource - The report detail to describe. The arguments in + this group can be used to specify the attributes of this resource. (NOTE) + Some attributes are not given arguments in this group but can be set in + other ways. To set the project attribute: + ◆ provide the argument report_detail 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. + + REPORT_DETAIL + ID of the report-detail or fully qualified identifier for the + report-detail. To set the report-detail attribute: + ▸ provide the argument report_detail on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Google Cloud location for the report-detail. To set the location + attribute: + ▸ provide the argument report_detail on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + + --report-config=REPORT_CONFIG + Report Config ID for the report-detail. To set the report-config + attribute: + ▸ provide the argument report_detail on the command line with a + fully specified name; + ▸ provide the argument --report-config on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud alpha storage insights inventory-reports details describe + diff --git a/gcloud/storage/insights/inventory-reports/details/help b/gcloud/storage/insights/inventory-reports/details/help new file mode 100644 index 000000000..44e4dbda3 --- /dev/null +++ b/gcloud/storage/insights/inventory-reports/details/help @@ -0,0 +1,30 @@ +NAME + gcloud storage insights inventory-reports details - retrieve details of + inventory reports + +SYNOPSIS + gcloud storage insights inventory-reports details COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Retrieve details of inventory reports. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + Describe inventory reports detail. + + list + List inventory report details. + +NOTES + This variant is also available: + + $ gcloud alpha storage insights inventory-reports details + diff --git a/gcloud/storage/insights/inventory-reports/details/list b/gcloud/storage/insights/inventory-reports/details/list new file mode 100644 index 000000000..86807fc02 --- /dev/null +++ b/gcloud/storage/insights/inventory-reports/details/list @@ -0,0 +1,106 @@ +NAME + gcloud storage insights inventory-reports details list - list inventory + report details + +SYNOPSIS + gcloud storage insights inventory-reports details list + (REPORT_CONFIG : --location=LOCATION) [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List all inventory report details generated by a given inventory report + config. + +EXAMPLES + To list all inventory report details for report config ID=1234, + location=us-central1, and project=foo: + + $ gcloud storage insights inventory-reports details list 1234 \ + --location=us-central1 --project=foo + + To list all the same inventory report details with fully specified name of + the report config: + + $ gcloud storage insights inventory-reports details list \ + /projects/foo/locations/us-central1/reportConfigs/1234 + + To list all inventory reports, only returning the "status" key: + + $ gcloud storage insights inventory-reports details list \ + projects/a/locations/b/reportConfigs/some-id \ + --format="json(status)" + +POSITIONAL ARGUMENTS + Report config resource - The Report config for which the report details + should be listed. 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 report_config 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. + + REPORT_CONFIG + ID of the report-config or fully qualified identifier for the + report-config. To set the report-config attribute: + ▸ provide the argument report_config on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Google Cloud location for the report-config. To set the location + attribute: + ▸ provide the argument report_config on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud alpha storage insights inventory-reports details list + diff --git a/gcloud/storage/insights/inventory-reports/help b/gcloud/storage/insights/inventory-reports/help new file mode 100644 index 000000000..4348af70d --- /dev/null +++ b/gcloud/storage/insights/inventory-reports/help @@ -0,0 +1,45 @@ +NAME + gcloud storage insights inventory-reports - manage Cloud Storage inventory + report configurations + +SYNOPSIS + gcloud storage insights inventory-reports GROUP | COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Cloud Storage inventory report configurations. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + details + Retrieve details of inventory reports. + +COMMANDS + COMMAND is one of the following: + + create + Create a new inventory report config. + + delete + Delete an inventory report config. + + describe + Describe an inventory report config. + + list + Lists all inventory report configs. + + update + Update an inventory report config. + +NOTES + This variant is also available: + + $ gcloud alpha storage insights inventory-reports + diff --git a/gcloud/storage/insights/inventory-reports/list b/gcloud/storage/insights/inventory-reports/list new file mode 100644 index 000000000..b896a1735 --- /dev/null +++ b/gcloud/storage/insights/inventory-reports/list @@ -0,0 +1,77 @@ +NAME + gcloud storage insights inventory-reports list - lists all inventory report + configs + +SYNOPSIS + gcloud storage insights inventory-reports list [--location=LOCATION] + [--source=SOURCE_BUCKET_URL] [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List Cloud Storage inventory report configs. + +EXAMPLES + List all inventory report configs in the source bucket "my-bucket": + + $ gcloud storage insights inventory-reports list \ + --source=gs://my-bucket + + List buckets with JSON formatting, only returning the "displayName" field: + + $ gcloud storage insights inventory-reports list \ + --source=gs://my-bucket --format="json(displayName)" + +FLAGS + --location=LOCATION + The location of the report configs. + + --source=SOURCE_BUCKET_URL + Specifies URL of the source bucket that contains the inventory report + configuration. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud alpha storage insights inventory-reports list + diff --git a/gcloud/storage/insights/inventory-reports/update b/gcloud/storage/insights/inventory-reports/update new file mode 100644 index 000000000..57978b38b --- /dev/null +++ b/gcloud/storage/insights/inventory-reports/update @@ -0,0 +1,141 @@ +NAME + gcloud storage insights inventory-reports update - update an inventory + report config + +SYNOPSIS + gcloud storage insights inventory-reports update + (REPORT_CONFIG : --location=LOCATION) [--destination=DESTINATION_URL] + [--display-name=DISPLAY_NAME] [--schedule-repeats=FREQUENCY] + [--schedule-repeats-until=END_DATE] [--schedule-starts=START_DATE] + [--metadata-fields=[METADATA_FIELDS,...] + | --add-metadata-fields=[METADATA_FIELDS,...] + --remove-metadata-fields=[METADATA_FIELDS,...]] + [--parquet | --csv-delimiter=DELIMITER + --[no-]csv-header --csv-separator=SEPARATOR] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Update an inventory report config. + +EXAMPLES + To update the display-name of an inventory report config with ID=1234, + location=us-central1, and project=foo: + + $ gcloud storage insights inventory-reports update 1234 \ + --location=us-central1 --project=foo --display-name=bar + + To update the same inventory report config with fully specified name: + + $ gcloud storage insights inventory-reports update \ + /projects/foo/locations/us-central1/reportConfigs/1234 \ + --display-name=bar + +POSITIONAL ARGUMENTS + Report config resource - The Report config to update. The arguments in + this group can be used to specify the attributes of this resource. (NOTE) + Some attributes are not given arguments in this group but can be set in + other ways. To set the project attribute: + ◆ provide the argument report_config 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. + + REPORT_CONFIG + ID of the report-config or fully qualified identifier for the + report-config. To set the report-config attribute: + ▸ provide the argument report_config on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Google Cloud location for the report-config. To set the location + attribute: + ▸ provide the argument report_config on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --destination=DESTINATION_URL + Sets the URL of the destination bucket and path where generated reports + are stored. + + --display-name=DISPLAY_NAME + Sets the editable name of the report configuration. + + --schedule-repeats=FREQUENCY + Sets how often the inventory report configuration will run. FREQUENCY + must be one of: daily, weekly. + + --schedule-repeats-until=END_DATE + Sets date after which you want to stop generating inventory reports. + For example, 2022-03-30. + + --schedule-starts=START_DATE + Sets the date you want to start generating inventory reports. For + example, 2022-01-30. Should be tomorrow or later based on UTC timezone. + + At most one of these can be specified: + + --metadata-fields=[METADATA_FIELDS,...] + The metadata fields to be included in the inventory report. The + fields: "project, bucket, name" are REQUIRED. METADATA_FIELDS must be + one of: project, bucket, name, location, size, timeCreated, + timeDeleted, updated, storageClass, etag, retentionExpirationTime, + crc32c, md5Hash, generation, metageneration, contentType, + contentEncoding, timeStorageClassUpdated. + + Add and Remove flags for metadata fields + + --add-metadata-fields=[METADATA_FIELDS,...] + Adds fields to the metadata_fields list. METADATA_FIELDS must be + one of: location, size, timeCreated, timeDeleted, updated, + storageClass, etag, retentionExpirationTime, crc32c, md5Hash, + generation, metageneration, contentType, contentEncoding, + timeStorageClassUpdated. + + --remove-metadata-fields=[METADATA_FIELDS,...] + Removes fields from the metadata_fields list. METADATA_FIELDS must + be one of: location, size, timeCreated, timeDeleted, updated, + storageClass, etag, retentionExpirationTime, crc32c, md5Hash, + generation, metageneration, contentType, contentEncoding, + timeStorageClassUpdated. + + Report format configuration. Any combination of CSV flags is valid as long + as the Parquet flag is not present. + + At most one of these can be specified: + + --parquet + Generate reports in parquet format. + + Flags for setting CSV format options. + + --csv-delimiter=DELIMITER + Sets the delimiter that separates the fields in the inventory + report CSV file. For example, ``,`` + + --[no-]csv-header + Indicates whether or not headers are included in the inventory + report CSV file. Default is None. Use --csv-header to enable and + --no-csv-header to disable. + + --csv-separator=SEPARATOR + Sets the character used to separate the records in the inventory + report CSV file. For example, ``\n``. SEPARATOR must be one of: \n, + \r\n. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud alpha storage insights inventory-reports update +