From fb3e2aa33b6b1c25849bec2f48616b0609c23d32 Mon Sep 17 00:00:00 2001 From: Automated Date: Wed, 19 Jun 2024 09:33:28 +0000 Subject: [PATCH] gcloud: Wed Jun 19 09:33:28 UTC 2024 --- gcloud/_version | 12 +- gcloud/alloydb/instances/create | 23 +- gcloud/alloydb/instances/create-secondary | 28 +- gcloud/alloydb/instances/update | 2 +- .../cloud-bindings/create | 2 +- gcloud/alpha/alloydb/clusters/create | 2 +- gcloud/alpha/alloydb/clusters/help | 4 + gcloud/alpha/alloydb/clusters/switchover | 46 ++++ gcloud/alpha/alloydb/instances/create | 23 +- .../alpha/alloydb/instances/create-secondary | 28 +- gcloud/alpha/alloydb/instances/update | 2 +- gcloud/alpha/builds/worker-pools/create | 12 + gcloud/alpha/builds/worker-pools/update | 23 +- .../compute/firewall-policies/rules/create | 7 +- .../compute/firewall-policies/rules/update | 7 +- gcloud/alpha/compute/images/list | 6 +- .../compute/instance-groups/managed/update | 5 +- .../network-firewall-policies/rules/create | 7 +- .../network-firewall-policies/rules/update | 7 +- .../compute/tpus/queued-resources/create | 64 +++-- gcloud/alpha/container/clusters/create | 27 +- gcloud/alpha/container/clusters/create-auto | 22 +- gcloud/alpha/container/clusters/update | 31 ++- .../fleet/scopes/remove-app-operator-binding | 12 +- .../hub/scopes/remove-app-operator-binding | 12 +- .../google-domains-dns/export-dns-record-sets | 86 ++++++ .../google-domains-dns/get-forwarding-config | 63 +++++ .../registrations/google-domains-dns/help | 38 +++ gcloud/alpha/domains/registrations/help | 3 + gcloud/alpha/functions/deploy | 3 +- gcloud/alpha/iap/settings/get | 11 +- gcloud/alpha/iap/settings/set | 11 +- gcloud/alpha/iap/web/add-iam-policy-binding | 11 +- gcloud/alpha/iap/web/get-iam-policy | 10 +- .../alpha/iap/web/remove-iam-policy-binding | 11 +- gcloud/alpha/iap/web/set-iam-policy | 10 +- gcloud/alpha/managed-kafka/clusters/update | 3 +- gcloud/alpha/managed-kafka/topics/create | 5 +- gcloud/alpha/managed-kafka/topics/update | 5 +- gcloud/alpha/migration/vms/help | 4 + .../vms/machine-image-imports/create | 174 +++++++++++++ .../vms/machine-image-imports/delete | 72 +++++ .../vms/machine-image-imports/describe | 70 +++++ .../migration/vms/machine-image-imports/help | 65 +++++ .../vms/machine-image-imports}/list | 35 +-- .../internal-ranges/update | 9 + .../multicast-consumer-associations/delete | 7 +- .../multicast-domain-activations/delete | 7 +- .../network-services/multicast-domains/delete | 8 +- .../delete | 7 +- .../multicast-group-definitions/delete | 7 +- .../network-services/multicast-groups/delete | 8 +- .../alpha/number-registry/operations/cancel | 64 ----- .../alpha/number-registry/operations/delete | 64 ----- .../alpha/number-registry/operations/describe | 64 ----- gcloud/alpha/number-registry/operations/wait | 64 ----- .../number-registry/registry-books/create | 96 ------- .../number-registry/registry-books/delete | 88 ------- .../number-registry/registry-books/describe | 68 ----- .../alpha/number-registry/registry-books/help | 52 ---- .../registry-books/historical-events/help | 28 -- .../registry-books/historical-events/show | 95 ------- .../registry-books/node-events/help | 28 -- .../registry-books/node-events/show | 101 -------- .../registry-books/registry-nodes/create | 155 ----------- .../registry-books/registry-nodes/delete | 97 ------- .../registry-books/registry-nodes/describe | 77 ------ .../registry-books/registry-nodes/help | 43 --- .../registry-books/registry-nodes/search | 118 --------- .../registry-books/registry-nodes/update | 245 ------------------ .../number-registry/registry-books/update | 135 ---------- gcloud/alpha/pubsub/subscriptions/create | 9 +- gcloud/alpha/pubsub/subscriptions/update | 9 +- gcloud/alpha/{number-registry => quotas}/help | 14 +- gcloud/alpha/quotas/info/describe | 55 ++++ gcloud/alpha/quotas/info/help | 46 ++++ .../registry-books => quotas/info}/list | 57 ++-- gcloud/alpha/quotas/preferences/create | 97 +++++++ gcloud/alpha/quotas/preferences/describe | 54 ++++ gcloud/alpha/quotas/preferences/help | 43 +++ gcloud/alpha/quotas/preferences/list | 97 +++++++ gcloud/alpha/quotas/preferences/update | 109 ++++++++ gcloud/alpha/resource-settings/describe | 8 +- gcloud/alpha/resource-settings/help | 21 +- gcloud/alpha/resource-settings/list | 8 +- gcloud/alpha/resource-settings/list-values | 8 +- gcloud/alpha/resource-settings/set-value | 8 +- gcloud/alpha/resource-settings/unset-value | 12 +- gcloud/alpha/spanner/help | 3 + .../alpha/spanner/instance-partitions/create | 93 +++++++ .../alpha/spanner/instance-partitions/delete | 66 +++++ .../spanner/instance-partitions/describe | 66 +++++ gcloud/alpha/spanner/instance-partitions/help | 42 +++ gcloud/alpha/spanner/instance-partitions/list | 79 ++++++ .../alpha/spanner/instance-partitions/update | 91 +++++++ gcloud/alpha/spanner/operations/cancel | 7 +- gcloud/alpha/spanner/operations/describe | 7 +- gcloud/alpha/spanner/operations/list | 7 +- gcloud/alpha/storage/folders/create | 53 ++++ gcloud/alpha/storage/folders/delete | 41 +++ gcloud/alpha/storage/folders/describe | 46 ++++ .../operations => storage/folders}/help | 19 +- gcloud/alpha/storage/folders/list | 95 +++++++ gcloud/alpha/storage/help | 3 + gcloud/beta/alloydb/instances/create | 23 +- .../beta/alloydb/instances/create-secondary | 28 +- gcloud/beta/alloydb/instances/update | 2 +- gcloud/beta/builds/worker-pools/update | 23 +- gcloud/beta/compute/images/list | 6 +- .../compute/instance-groups/managed/update | 5 +- gcloud/beta/container/clusters/create | 27 +- gcloud/beta/container/clusters/create-auto | 22 +- gcloud/beta/container/clusters/update | 31 ++- gcloud/beta/dataflow/help | 3 +- gcloud/beta/dataflow/sql/help | 10 +- gcloud/beta/dataflow/sql/query | 12 +- .../google-domains-dns/export-dns-record-sets | 84 ++++++ .../google-domains-dns/get-forwarding-config | 61 +++++ .../registrations/google-domains-dns/help | 36 +++ gcloud/beta/domains/registrations/help | 3 + gcloud/beta/filestore/instances/create | 7 +- gcloud/beta/filestore/instances/help | 3 + .../beta/filestore/instances/promote-replica | 79 ++++++ gcloud/beta/functions/deploy | 3 +- .../principal-access-boundary-policies/help | 3 + .../principal-access-boundary-policies}/list | 60 ++--- gcloud/beta/iap/settings/get | 12 + gcloud/beta/iap/settings/set | 12 + gcloud/beta/iap/web/add-iam-policy-binding | 16 +- gcloud/beta/iap/web/get-iam-policy | 15 +- gcloud/beta/iap/web/remove-iam-policy-binding | 16 +- gcloud/beta/iap/web/set-iam-policy | 15 +- gcloud/beta/managed-kafka/clusters/update | 3 +- gcloud/beta/managed-kafka/topics/create | 5 +- gcloud/beta/managed-kafka/topics/update | 5 +- gcloud/beta/pubsub/subscriptions/create | 9 +- gcloud/beta/pubsub/subscriptions/update | 9 +- gcloud/beta/spanner/help | 3 + .../beta/spanner/instance-partitions/create | 91 +++++++ .../beta/spanner/instance-partitions/delete | 64 +++++ .../beta/spanner/instance-partitions/describe | 64 +++++ gcloud/beta/spanner/instance-partitions/help | 40 +++ gcloud/beta/spanner/instance-partitions/list | 77 ++++++ .../beta/spanner/instance-partitions/update | 89 +++++++ gcloud/beta/spanner/operations/cancel | 7 +- gcloud/beta/spanner/operations/describe | 7 +- gcloud/beta/spanner/operations/list | 7 +- gcloud/builds/worker-pools/update | 32 +-- gcloud/compute/images/list | 6 +- gcloud/compute/instance-groups/managed/update | 5 +- gcloud/compute/instance-templates/create | 33 ++- gcloud/compute/instances/bulk/create | 34 ++- gcloud/compute/instances/create | 36 ++- .../compute/instances/create-with-container | 34 ++- gcloud/container/clusters/create | 27 +- gcloud/container/clusters/create-auto | 22 +- gcloud/container/clusters/update | 31 ++- gcloud/dataflow/help | 2 +- gcloud/dataflow/sql/help | 10 +- gcloud/dataflow/sql/query | 6 + .../google-domains-dns/export-dns-record-sets | 83 ++++++ .../google-domains-dns/get-forwarding-config | 59 +++++ .../registrations/google-domains-dns/help | 34 +++ gcloud/domains/registrations/help | 3 + gcloud/filestore/instances/create | 7 +- gcloud/functions/deploy | 17 +- gcloud/iap/settings/get | 12 + gcloud/iap/settings/set | 11 + gcloud/iap/web/add-iam-policy-binding | 16 +- gcloud/iap/web/get-iam-policy | 14 +- gcloud/iap/web/remove-iam-policy-binding | 16 +- gcloud/iap/web/set-iam-policy | 15 +- .../internal-ranges/update | 9 + .../spokes/linked-vpc-network/create | 11 +- gcloud/pubsub/subscriptions/create | 9 +- gcloud/pubsub/subscriptions/update | 9 +- gcloud/resource-settings/describe | 6 + gcloud/resource-settings/help | 16 +- gcloud/resource-settings/list | 6 + gcloud/resource-settings/list-values | 6 + gcloud/resource-settings/set-value | 6 + gcloud/resource-settings/unset-value | 6 + 182 files changed, 3829 insertions(+), 2129 deletions(-) create mode 100644 gcloud/alpha/alloydb/clusters/switchover create mode 100644 gcloud/alpha/domains/registrations/google-domains-dns/export-dns-record-sets create mode 100644 gcloud/alpha/domains/registrations/google-domains-dns/get-forwarding-config create mode 100644 gcloud/alpha/domains/registrations/google-domains-dns/help create mode 100644 gcloud/alpha/migration/vms/machine-image-imports/create create mode 100644 gcloud/alpha/migration/vms/machine-image-imports/delete create mode 100644 gcloud/alpha/migration/vms/machine-image-imports/describe create mode 100644 gcloud/alpha/migration/vms/machine-image-imports/help rename gcloud/alpha/{number-registry/operations => migration/vms/machine-image-imports}/list (70%) delete mode 100644 gcloud/alpha/number-registry/operations/cancel delete mode 100644 gcloud/alpha/number-registry/operations/delete delete mode 100644 gcloud/alpha/number-registry/operations/describe delete mode 100644 gcloud/alpha/number-registry/operations/wait delete mode 100644 gcloud/alpha/number-registry/registry-books/create delete mode 100644 gcloud/alpha/number-registry/registry-books/delete delete mode 100644 gcloud/alpha/number-registry/registry-books/describe delete mode 100644 gcloud/alpha/number-registry/registry-books/help delete mode 100644 gcloud/alpha/number-registry/registry-books/historical-events/help delete mode 100644 gcloud/alpha/number-registry/registry-books/historical-events/show delete mode 100644 gcloud/alpha/number-registry/registry-books/node-events/help delete mode 100644 gcloud/alpha/number-registry/registry-books/node-events/show delete mode 100644 gcloud/alpha/number-registry/registry-books/registry-nodes/create delete mode 100644 gcloud/alpha/number-registry/registry-books/registry-nodes/delete delete mode 100644 gcloud/alpha/number-registry/registry-books/registry-nodes/describe delete mode 100644 gcloud/alpha/number-registry/registry-books/registry-nodes/help delete mode 100644 gcloud/alpha/number-registry/registry-books/registry-nodes/search delete mode 100644 gcloud/alpha/number-registry/registry-books/registry-nodes/update delete mode 100644 gcloud/alpha/number-registry/registry-books/update rename gcloud/alpha/{number-registry => quotas}/help (57%) create mode 100644 gcloud/alpha/quotas/info/describe create mode 100644 gcloud/alpha/quotas/info/help rename gcloud/alpha/{number-registry/registry-books => quotas/info}/list (63%) create mode 100644 gcloud/alpha/quotas/preferences/create create mode 100644 gcloud/alpha/quotas/preferences/describe create mode 100644 gcloud/alpha/quotas/preferences/help create mode 100644 gcloud/alpha/quotas/preferences/list create mode 100644 gcloud/alpha/quotas/preferences/update create mode 100644 gcloud/alpha/spanner/instance-partitions/create create mode 100644 gcloud/alpha/spanner/instance-partitions/delete create mode 100644 gcloud/alpha/spanner/instance-partitions/describe create mode 100644 gcloud/alpha/spanner/instance-partitions/help create mode 100644 gcloud/alpha/spanner/instance-partitions/list create mode 100644 gcloud/alpha/spanner/instance-partitions/update create mode 100644 gcloud/alpha/storage/folders/create create mode 100644 gcloud/alpha/storage/folders/delete create mode 100644 gcloud/alpha/storage/folders/describe rename gcloud/alpha/{number-registry/operations => storage/folders}/help (56%) create mode 100644 gcloud/alpha/storage/folders/list create mode 100644 gcloud/beta/domains/registrations/google-domains-dns/export-dns-record-sets create mode 100644 gcloud/beta/domains/registrations/google-domains-dns/get-forwarding-config create mode 100644 gcloud/beta/domains/registrations/google-domains-dns/help create mode 100644 gcloud/beta/filestore/instances/promote-replica rename gcloud/{alpha/number-registry/registry-books/registry-nodes => beta/iam/principal-access-boundary-policies}/list (57%) create mode 100644 gcloud/beta/spanner/instance-partitions/create create mode 100644 gcloud/beta/spanner/instance-partitions/delete create mode 100644 gcloud/beta/spanner/instance-partitions/describe create mode 100644 gcloud/beta/spanner/instance-partitions/help create mode 100644 gcloud/beta/spanner/instance-partitions/list create mode 100644 gcloud/beta/spanner/instance-partitions/update create mode 100644 gcloud/domains/registrations/google-domains-dns/export-dns-record-sets create mode 100644 gcloud/domains/registrations/google-domains-dns/get-forwarding-config create mode 100644 gcloud/domains/registrations/google-domains-dns/help diff --git a/gcloud/_version b/gcloud/_version index 9fae7dbc2..d3cc10046 100644 --- a/gcloud/_version +++ b/gcloud/_version @@ -1,8 +1,8 @@ -Google Cloud SDK 480.0.0 -alpha 2024.06.07 -beta 2024.06.07 -bq 2.1.5 +Google Cloud SDK 481.0.0 +alpha 2024.06.14 +beta 2024.06.14 +bq 2.1.6 bundled-python3-unix 3.11.8 -core 2024.06.07 +core 2024.06.14 gcloud-crc32c 1.0.0 -gsutil 5.29 +gsutil 5.30 diff --git a/gcloud/alloydb/instances/create b/gcloud/alloydb/instances/create index 74ae46fb3..6089fe36c 100644 --- a/gcloud/alloydb/instances/create +++ b/gcloud/alloydb/instances/create @@ -7,6 +7,7 @@ SYNOPSIS --cpu-count=CPU_COUNT --instance-type=INSTANCE_TYPE --region=REGION [--allowed-psc-projects=[ALLOWED_PSC_PROJECTS,...]] [--assign-inbound-public-ip=ASSIGN_INBOUND_PUBLIC_IP] [--async] + [--authorized-external-networks=[AUTHORIZED_NETWORK,...]] [--availability-type=AVAILABILITY_TYPE] [--database-flags=FLAG=VALUE,[FLAG=VALUE,...]] [--insights-config-query-plans-per-minute=INSIGHTS_CONFIG_QUERY_PLANS_PER_MINUTE] @@ -70,19 +71,25 @@ OPTIONAL FLAGS --allowed-psc-projects=project1,12345678,project2) --assign-inbound-public-ip=ASSIGN_INBOUND_PUBLIC_IP - Specify to enable or disable public IP on an instance. On instance - creation only disabling public IP is allowed. If you want to enable - public IP, an instance must be created with public IP disabled first, - then update the instance to enable public IP. ASSIGN_INBOUND_PUBLIC_IP - must be (only one value is supported): - - NO_PUBLIC_IP - This disables public IP on the instance. + Specify to enable or disable public IP on an instance. + ASSIGN_INBOUND_PUBLIC_IP must be one of: + ◆ NO_PUBLIC_IP + ▸ This disables public IP on the instance. Updating an instance to + disable public IP will clear the list of authorized networks. + ◆ ASSIGN_IPV4 + ▸ Assign an inbound public IPv4 address for the instance. Public IP + is enabled. --async Return immediately, without waiting for the operation in progress to complete. + --authorized-external-networks=[AUTHORIZED_NETWORK,...] + Comma-separated list of authorized external networks to set on the + instance. Authorized networks should use CIDR notation (e.g. + 1.2.3.4/30). This flag is only allowed to be set for instances with + public IP enabled. + --availability-type=AVAILABILITY_TYPE Specifies level of availability. AVAILABILITY_TYPE must be one of: diff --git a/gcloud/alloydb/instances/create-secondary b/gcloud/alloydb/instances/create-secondary index 8eabcf39f..0d4664607 100644 --- a/gcloud/alloydb/instances/create-secondary +++ b/gcloud/alloydb/instances/create-secondary @@ -5,9 +5,9 @@ NAME SYNOPSIS gcloud alloydb instances create-secondary INSTANCE --cluster=CLUSTER --region=REGION [--assign-inbound-public-ip=ASSIGN_INBOUND_PUBLIC_IP] - [--async] [--availability-type=AVAILABILITY_TYPE] - [--[no-]require-connectors] [--ssl-mode=SSL_MODE] - [GCLOUD_WIDE_FLAG ...] + [--async] [--authorized-external-networks=[AUTHORIZED_NETWORK,...]] + [--availability-type=AVAILABILITY_TYPE] [--[no-]require-connectors] + [--ssl-mode=SSL_MODE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION Creates a new AlloyDB SECONDARY instance within a given cluster. @@ -32,19 +32,25 @@ REQUIRED FLAGS OPTIONAL FLAGS --assign-inbound-public-ip=ASSIGN_INBOUND_PUBLIC_IP - Specify to enable or disable public IP on an instance. On instance - creation only disabling public IP is allowed. If you want to enable - public IP, an instance must be created with public IP disabled first, - then update the instance to enable public IP. ASSIGN_INBOUND_PUBLIC_IP - must be (only one value is supported): - - NO_PUBLIC_IP - This disables public IP on the instance. + Specify to enable or disable public IP on an instance. + ASSIGN_INBOUND_PUBLIC_IP must be one of: + ◆ NO_PUBLIC_IP + ▸ This disables public IP on the instance. Updating an instance to + disable public IP will clear the list of authorized networks. + ◆ ASSIGN_IPV4 + ▸ Assign an inbound public IPv4 address for the instance. Public IP + is enabled. --async Return immediately, without waiting for the operation in progress to complete. + --authorized-external-networks=[AUTHORIZED_NETWORK,...] + Comma-separated list of authorized external networks to set on the + instance. Authorized networks should use CIDR notation (e.g. + 1.2.3.4/30). This flag is only allowed to be set for instances with + public IP enabled. + --availability-type=AVAILABILITY_TYPE Specifies level of availability. AVAILABILITY_TYPE must be one of: diff --git a/gcloud/alloydb/instances/update b/gcloud/alloydb/instances/update index 79139029a..f98e1d603 100644 --- a/gcloud/alloydb/instances/update +++ b/gcloud/alloydb/instances/update @@ -53,7 +53,7 @@ OPTIONAL FLAGS ▸ This disables public IP on the instance. Updating an instance to disable public IP will clear the list of authorized networks. ◆ ASSIGN_IPV4 - ▸ Assign an inbound public IPv4 address for the instance. public IP + ▸ Assign an inbound public IPv4 address for the instance. Public IP is enabled. --async diff --git a/gcloud/alpha/access-context-manager/cloud-bindings/create b/gcloud/alpha/access-context-manager/cloud-bindings/create index 97d487b2a..602bc2d63 100644 --- a/gcloud/alpha/access-context-manager/cloud-bindings/create +++ b/gcloud/alpha/access-context-manager/cloud-bindings/create @@ -15,7 +15,7 @@ DESCRIPTION (ALPHA) Create a new access binding. The access level will be bound with the group and the restricted client application. The access level is enforced at the organization level for all context-aware access group - members, as specified in the bind. If a restricted client application is + members, as specified in the binding. If a restricted client application is specified, then the enforcement applies only to the specified application, and not to the entire organization. diff --git a/gcloud/alpha/alloydb/clusters/create b/gcloud/alpha/alloydb/clusters/create index 08505a9b5..22cab09c1 100644 --- a/gcloud/alpha/alloydb/clusters/create +++ b/gcloud/alpha/alloydb/clusters/create @@ -59,7 +59,7 @@ OPTIONAL FLAGS --database-version=DATABASE_VERSION Database version of the cluster. DATABASE_VERSION must be one of: - POSTGRES_14, POSTGRES_15. + POSTGRES_14, POSTGRES_15, POSTGRES_16. --enable-private-service-connect Enable Private Service Connect (PSC) connectivity for the cluster. diff --git a/gcloud/alpha/alloydb/clusters/help b/gcloud/alpha/alloydb/clusters/help index 04dc5c792..983e48188 100644 --- a/gcloud/alpha/alloydb/clusters/help +++ b/gcloud/alpha/alloydb/clusters/help @@ -40,6 +40,10 @@ COMMANDS (ALPHA) Restore an AlloyDB cluster from a given backup or a source cluster and a timestamp. + switchover + (ALPHA) Switchover an AlloyDB SECONDARY cluster in a given project and + region. + update (ALPHA) Update an AlloyDB cluster within a given project and region. diff --git a/gcloud/alpha/alloydb/clusters/switchover b/gcloud/alpha/alloydb/clusters/switchover new file mode 100644 index 000000000..17e687534 --- /dev/null +++ b/gcloud/alpha/alloydb/clusters/switchover @@ -0,0 +1,46 @@ +NAME + gcloud alpha alloydb clusters switchover - switchover an AlloyDB SECONDARY + cluster in a given project and region + +SYNOPSIS + gcloud alpha alloydb clusters switchover CLUSTER --region=REGION [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Switchover an AlloyDB SECONDARY cluster in a given project and + region. + +EXAMPLES + To switchover a cluster, run: + + $ gcloud alpha alloydb clusters switchover my-cluster \ + --region=us-central1 + +POSITIONAL ARGUMENTS + CLUSTER + AlloyDB cluster ID + +REQUIRED FLAGS + --region=REGION + Regional location (e.g. asia-east1, us-east1). See the full list of + regions at https://cloud.google.com/sql/docs/instance-locations. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in 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/alloydb/instances/create b/gcloud/alpha/alloydb/instances/create index 9f6385778..688371055 100644 --- a/gcloud/alpha/alloydb/instances/create +++ b/gcloud/alpha/alloydb/instances/create @@ -7,6 +7,7 @@ SYNOPSIS --cpu-count=CPU_COUNT --instance-type=INSTANCE_TYPE --region=REGION [--allowed-psc-projects=[ALLOWED_PSC_PROJECTS,...]] [--assign-inbound-public-ip=ASSIGN_INBOUND_PUBLIC_IP] [--async] + [--authorized-external-networks=[AUTHORIZED_NETWORK,...]] [--availability-type=AVAILABILITY_TYPE] [--database-flags=FLAG=VALUE,[FLAG=VALUE,...]] [--insights-config-query-plans-per-minute=INSIGHTS_CONFIG_QUERY_PLANS_PER_MINUTE] @@ -71,19 +72,25 @@ OPTIONAL FLAGS --allowed-psc-projects=project1,12345678,project2) --assign-inbound-public-ip=ASSIGN_INBOUND_PUBLIC_IP - Specify to enable or disable public IP on an instance. On instance - creation only disabling public IP is allowed. If you want to enable - public IP, an instance must be created with public IP disabled first, - then update the instance to enable public IP. ASSIGN_INBOUND_PUBLIC_IP - must be (only one value is supported): - - NO_PUBLIC_IP - This disables public IP on the instance. + Specify to enable or disable public IP on an instance. + ASSIGN_INBOUND_PUBLIC_IP must be one of: + ◆ NO_PUBLIC_IP + ▸ This disables public IP on the instance. Updating an instance to + disable public IP will clear the list of authorized networks. + ◆ ASSIGN_IPV4 + ▸ Assign an inbound public IPv4 address for the instance. Public IP + is enabled. --async Return immediately, without waiting for the operation in progress to complete. + --authorized-external-networks=[AUTHORIZED_NETWORK,...] + Comma-separated list of authorized external networks to set on the + instance. Authorized networks should use CIDR notation (e.g. + 1.2.3.4/30). This flag is only allowed to be set for instances with + public IP enabled. + --availability-type=AVAILABILITY_TYPE Specifies level of availability. AVAILABILITY_TYPE must be one of: diff --git a/gcloud/alpha/alloydb/instances/create-secondary b/gcloud/alpha/alloydb/instances/create-secondary index fd3018c7b..b44d0d185 100644 --- a/gcloud/alpha/alloydb/instances/create-secondary +++ b/gcloud/alpha/alloydb/instances/create-secondary @@ -5,9 +5,9 @@ NAME SYNOPSIS gcloud alpha alloydb instances create-secondary INSTANCE --cluster=CLUSTER --region=REGION [--assign-inbound-public-ip=ASSIGN_INBOUND_PUBLIC_IP] - [--async] [--availability-type=AVAILABILITY_TYPE] - [--[no-]require-connectors] [--ssl-mode=SSL_MODE] - [GCLOUD_WIDE_FLAG ...] + [--async] [--authorized-external-networks=[AUTHORIZED_NETWORK,...]] + [--availability-type=AVAILABILITY_TYPE] [--[no-]require-connectors] + [--ssl-mode=SSL_MODE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Creates a new AlloyDB SECONDARY instance within a given cluster. @@ -32,19 +32,25 @@ REQUIRED FLAGS OPTIONAL FLAGS --assign-inbound-public-ip=ASSIGN_INBOUND_PUBLIC_IP - Specify to enable or disable public IP on an instance. On instance - creation only disabling public IP is allowed. If you want to enable - public IP, an instance must be created with public IP disabled first, - then update the instance to enable public IP. ASSIGN_INBOUND_PUBLIC_IP - must be (only one value is supported): - - NO_PUBLIC_IP - This disables public IP on the instance. + Specify to enable or disable public IP on an instance. + ASSIGN_INBOUND_PUBLIC_IP must be one of: + ◆ NO_PUBLIC_IP + ▸ This disables public IP on the instance. Updating an instance to + disable public IP will clear the list of authorized networks. + ◆ ASSIGN_IPV4 + ▸ Assign an inbound public IPv4 address for the instance. Public IP + is enabled. --async Return immediately, without waiting for the operation in progress to complete. + --authorized-external-networks=[AUTHORIZED_NETWORK,...] + Comma-separated list of authorized external networks to set on the + instance. Authorized networks should use CIDR notation (e.g. + 1.2.3.4/30). This flag is only allowed to be set for instances with + public IP enabled. + --availability-type=AVAILABILITY_TYPE Specifies level of availability. AVAILABILITY_TYPE must be one of: diff --git a/gcloud/alpha/alloydb/instances/update b/gcloud/alpha/alloydb/instances/update index ebfa7a915..9ec1591ab 100644 --- a/gcloud/alpha/alloydb/instances/update +++ b/gcloud/alpha/alloydb/instances/update @@ -53,7 +53,7 @@ OPTIONAL FLAGS ▸ This disables public IP on the instance. Updating an instance to disable public IP will clear the list of authorized networks. ◆ ASSIGN_IPV4 - ▸ Assign an inbound public IPv4 address for the instance. public IP + ▸ Assign an inbound public IPv4 address for the instance. Public IP is enabled. --async diff --git a/gcloud/alpha/builds/worker-pools/create b/gcloud/alpha/builds/worker-pools/create index 8127eaa80..bc36128db 100644 --- a/gcloud/alpha/builds/worker-pools/create +++ b/gcloud/alpha/builds/worker-pools/create @@ -33,6 +33,18 @@ EXAMPLES --peered-network-ip-range=192.168.0.0/28 \ --worker-machine-type=e2-standard-2 --worker-disk-size=64GB + To create a private pool in project p1 in region us-central1 where workers + are of machine type e2-standard-2 and are peered to the network attachment + projects/p1/regions/us-central1/networkAttachments/na. The workers don't + have public IP address and all the traffic is routed to the network + attachment. + + $ gcloud alpha builds worker-pools create pwp1 --project=p1 \ + --region=us-central1 \ + --network-attachment=projects/p1/regions/us-central1/\ + networkAttachments/na --route-all-traffic \ + --disable-public-ip-address --worker-machine-type=e2-standard-2 + POSITIONAL ARGUMENTS WORKER_POOL Unique identifier for the worker pool to create. This value should be diff --git a/gcloud/alpha/builds/worker-pools/update b/gcloud/alpha/builds/worker-pools/update index 2f5d3e83e..f263bd431 100644 --- a/gcloud/alpha/builds/worker-pools/update +++ b/gcloud/alpha/builds/worker-pools/update @@ -4,8 +4,8 @@ NAME SYNOPSIS gcloud alpha builds worker-pools update WORKER_POOL --region=REGION - (--config-from-file=CONFIG_FROM_FILE | --public-egress - | --no-public-egress --worker-disk-size=WORKER_DISK_SIZE + (--config-from-file=CONFIG_FROM_FILE | --[no-]public-egress + --worker-disk-size=WORKER_DISK_SIZE --worker-machine-type=WORKER_MACHINE_TYPE) [--generation=GENERATION; default=1] [GCLOUD_WIDE_FLAG ...] @@ -41,20 +41,15 @@ REQUIRED FLAGS Command-line flags to configure the private pool: - Network configuration for Service Networking: + --[no-]public-egress + If set to true, workers in the worker pool are created with an + external IP address. - At most one of these can be specified: + If set to false, workers in the worker pool are created without an + external IP address. If the worker pool is within a VPC Service + Control perimeter, use this flag. - --public-egress - If set, workers in the worker pool are created with an external - IP address. - - --no-public-egress - If set, workers in the worker pool are created without an - external IP address. - - If the worker pool is within a VPC Service Control perimeter, - use this flag. + Use --public-egress to enable and --no-public-egress to disable. Configuration to be used for creating workers in the worker pool: diff --git a/gcloud/alpha/compute/firewall-policies/rules/create b/gcloud/alpha/compute/firewall-policies/rules/create index 21889e26b..0afeb9c6f 100644 --- a/gcloud/alpha/compute/firewall-policies/rules/create +++ b/gcloud/alpha/compute/firewall-policies/rules/create @@ -67,8 +67,8 @@ OPTIONAL FLAGS --dest-network-scope=DEST_NETWORK_SCOPE Use this flag to indicate that the rule should match internet or non-internet traffic. It applies to destination traffic for egress - rules. Valid values are INTERNET and NON_INTERNET. Use empty string to - clear the field. + rules. Valid values are INTERNET, NON_INTERNET and INTRA_VPC. Use empty + string to clear the field. --dest-region-codes=[DEST_REGION_CODES,...] Destination Region Code to match for this rule. Can only be specified @@ -128,7 +128,8 @@ OPTIONAL FLAGS Use this flag to indicate that the rule should match internet, non-internet traffic or traffic coming from the network specified by --src-network. It applies to ingress rules. Valid values are INTERNET, - NON_INTERNET and VPC_NETWORKS. Use empty string to clear the field. + NON_INTERNET, VPC_NETWORKS and INTRA_VPC. Use empty string to clear the + field. --src-networks=[SRC_NETWORKS,...] The source VPC networks to match for this rule. It can only be diff --git a/gcloud/alpha/compute/firewall-policies/rules/update b/gcloud/alpha/compute/firewall-policies/rules/update index 93c9528a6..c28a9c4f1 100644 --- a/gcloud/alpha/compute/firewall-policies/rules/update +++ b/gcloud/alpha/compute/firewall-policies/rules/update @@ -69,8 +69,8 @@ OPTIONAL FLAGS --dest-network-scope=DEST_NETWORK_SCOPE Use this flag to indicate that the rule should match internet or non-internet traffic. It applies to destination traffic for egress - rules. Valid values are INTERNET and NON_INTERNET. Use empty string to - clear the field. + rules. Valid values are INTERNET, NON_INTERNET and INTRA_VPC. Use empty + string to clear the field. --dest-region-codes=[DEST_REGION_CODES,...] Destination Region Code to match for this rule. Can only be specified @@ -133,7 +133,8 @@ OPTIONAL FLAGS Use this flag to indicate that the rule should match internet, non-internet traffic or traffic coming from the network specified by --src-network. It applies to ingress rules. Valid values are INTERNET, - NON_INTERNET and VPC_NETWORKS. Use empty string to clear the field. + NON_INTERNET, VPC_NETWORKS and INTRA_VPC. Use empty string to clear the + field. --src-networks=[SRC_NETWORKS,...] The source VPC networks to match for this rule. It can only be diff --git a/gcloud/alpha/compute/images/list b/gcloud/alpha/compute/images/list index 00120f788..802af3d57 100644 --- a/gcloud/alpha/compute/images/list +++ b/gcloud/alpha/compute/images/list @@ -57,9 +57,9 @@ FLAGS --standard-images List images from public image projects. The public image projects that - are available include the following: centos-cloud, cos-cloud, - debian-cloud, fedora-coreos-cloud, opensuse-cloud, rhel-cloud, - rhel-sap-cloud, rocky-linux-cloud, suse-cloud, suse-sap-cloud, + are available include the following: cos-cloud, debian-cloud, + rocky-linux-cloud, centos-cloud, fedora-coreos-cloud, opensuse-cloud, + rhel-cloud, rhel-sap-cloud, suse-cloud, suse-sap-cloud, ubuntu-os-cloud, ubuntu-os-pro-cloud, windows-cloud, windows-sql-cloud. Enabled by default, use --no-standard-images to disable. diff --git a/gcloud/alpha/compute/instance-groups/managed/update b/gcloud/alpha/compute/instance-groups/managed/update index 9e4d2673a..0ed220b10 100644 --- a/gcloud/alpha/compute/instance-groups/managed/update +++ b/gcloud/alpha/compute/instance-groups/managed/update @@ -13,7 +13,7 @@ SYNOPSIS [--list-managed-instances-results=MODE] [--remove-stateful-disks=DEVICE_NAME,[DEVICE_NAME,...]] [--remove-stateful-external-ips=INTERFACE_NAME,[...]] - [--remove-stateful-internal-ips=INTERFACE_NAME,[...]] + [--remove-stateful-internal-ips=INTERFACE_NAME,[...]] [--size=SIZE] [--standby-policy-initial-delay=STANDBY_POLICY_INITIAL_DELAY] [--standby-policy-mode=STANDBY_POLICY_MODE] [--stateful-disk=[auto-delete=AUTO-DELETE],[device-name=DEVICE-NAME]] @@ -145,6 +145,9 @@ FLAGS Remove stateful configuration for the specified interfaces for internal IPs. + --size=SIZE + Target number of running instances in managed instance group. + --standby-policy-initial-delay=STANDBY_POLICY_INITIAL_DELAY Specifies the number of seconds that the MIG should wait before suspending or stopping a VM. The initial delay gives the initialization diff --git a/gcloud/alpha/compute/network-firewall-policies/rules/create b/gcloud/alpha/compute/network-firewall-policies/rules/create index bc7be2e56..5d761b835 100644 --- a/gcloud/alpha/compute/network-firewall-policies/rules/create +++ b/gcloud/alpha/compute/network-firewall-policies/rules/create @@ -77,8 +77,8 @@ OPTIONAL FLAGS --dest-network-scope=DEST_NETWORK_SCOPE Use this flag to indicate that the rule should match internet or non-internet traffic. It applies to destination traffic for egress - rules. Valid values are INTERNET and NON_INTERNET. Use empty string to - clear the field. + rules. Valid values are INTERNET, NON_INTERNET and INTRA_VPC. Use empty + string to clear the field. --dest-region-codes=[DEST_REGION_CODES,...] Destination Region Code to match for this rule. Can only be specified @@ -135,7 +135,8 @@ OPTIONAL FLAGS Use this flag to indicate that the rule should match internet, non-internet traffic or traffic coming from the network specified by --src-network. It applies to ingress rules. Valid values are INTERNET, - NON_INTERNET and VPC_NETWORKS. Use empty string to clear the field. + NON_INTERNET, VPC_NETWORKS and INTRA_VPC. Use empty string to clear the + field. --src-networks=[SRC_NETWORKS,...] The source VPC networks to match for this rule. It can only be diff --git a/gcloud/alpha/compute/network-firewall-policies/rules/update b/gcloud/alpha/compute/network-firewall-policies/rules/update index 27947ce62..4d59ed215 100644 --- a/gcloud/alpha/compute/network-firewall-policies/rules/update +++ b/gcloud/alpha/compute/network-firewall-policies/rules/update @@ -70,8 +70,8 @@ OPTIONAL FLAGS --dest-network-scope=DEST_NETWORK_SCOPE Use this flag to indicate that the rule should match internet or non-internet traffic. It applies to destination traffic for egress - rules. Valid values are INTERNET and NON_INTERNET. Use empty string to - clear the field. + rules. Valid values are INTERNET, NON_INTERNET and INTRA_VPC. Use empty + string to clear the field. --dest-region-codes=[DEST_REGION_CODES,...] Destination Region Code to match for this rule. Can only be specified @@ -131,7 +131,8 @@ OPTIONAL FLAGS Use this flag to indicate that the rule should match internet, non-internet traffic or traffic coming from the network specified by --src-network. It applies to ingress rules. Valid values are INTERNET, - NON_INTERNET and VPC_NETWORKS. Use empty string to clear the field. + NON_INTERNET, VPC_NETWORKS and INTRA_VPC. Use empty string to clear the + field. --src-networks=[SRC_NETWORKS,...] The source VPC networks to match for this rule. It can only be diff --git a/gcloud/alpha/compute/tpus/queued-resources/create b/gcloud/alpha/compute/tpus/queued-resources/create index ffb34784b..f382d0602 100644 --- a/gcloud/alpha/compute/tpus/queued-resources/create +++ b/gcloud/alpha/compute/tpus/queued-resources/create @@ -10,19 +10,21 @@ SYNOPSIS | [--node-count=NODE_COUNT : --node-prefix=NODE_PREFIX]) [--async] [--autocheckpoint-enabled] [--best-effort] [--boot-disk=[KEY=VALUE,...]] [--data-disk=[mode=MODE],[source=SOURCE]] - [--description=DESCRIPTION] [--guaranteed] [--internal-ips] - [--labels=[KEY=VALUE,...]] [--metadata=[KEY=VALUE,...]] - [--metadata-from-file=[KEY=VALUE,...]] - [--network=NETWORK; default="default"] [--range=RANGE] - [--reservation-host-folder=RESERVATION_HOST_FOLDER] + [--description=DESCRIPTION] [--guaranteed] [--labels=[KEY=VALUE,...]] + [--metadata=[KEY=VALUE,...]] [--metadata-from-file=[KEY=VALUE,...]] + [--range=RANGE] [--reservation-host-folder=RESERVATION_HOST_FOLDER] [--reservation-host-organization=RESERVATION_HOST_ORGANIZATION] [--reservation-host-project=RESERVATION_HOST_PROJECT] [--reserved] [--scopes=[SCOPES,...]] [--service-account=SERVICE_ACCOUNT] - [--shielded-secure-boot] [--spot] [--subnetwork=SUBNETWORK] - [--tags=[TAGS,...]] [--valid-after-duration=VALID_AFTER_DURATION] + [--shielded-secure-boot] [--spot] [--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 ...] + [--valid-until-time=VALID_UNTIL_TIME] + [--network-config=[external-ips=EXTERNAL-IPS], + [network=NETWORK],[subnetwork=SUBNETWORK] | --internal-ips + --network=NETWORK; default="default" --subnetwork=SUBNETWORK] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Create a new Queued Resource with the specified attributes. @@ -196,11 +198,6 @@ OPTIONAL FLAGS If provided, the Node requested here will only be scheduled at the 'guaranteed' tier. - --internal-ips - Indicates that the IP addresses for the node should be internal. The - default is that external IP addresses will be associated with the TPU - workers. - --labels=[KEY=VALUE,...] Resource labels to represent user-provided metadata. See https://cloud.google.com/compute/docs/labeling-resources for details. @@ -213,9 +210,6 @@ OPTIONAL FLAGS Same as --metadata except the value for the entry will be read from a local file. Example: --metadata-from-file='key1=value1.txt' - --network=NETWORK; default="default" - Network that this TPU will be a part of. - --range=RANGE CIDR range for the TPU. @@ -260,9 +254,6 @@ OPTIONAL FLAGS --spot If provided, the Node requested here will be created as Spot VMs. - --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 @@ -287,6 +278,41 @@ OPTIONAL FLAGS An absolute time after which resources must not be created. See $ gcloud topic datetimes for information on duration formats. + At most one of these can be specified: + + --network-config=[external-ips=EXTERNAL-IPS],[network=NETWORK],[subnetwork=SUBNETWORK] + Specify a full network_config for the TPU. network or subnetwork must + be specified. + + This flag may be repeated to provide multiple networks. For example: + + $ gcloud alpha compute tpus queued-resources create \ + --network-config network=example_network,internal-ips=true + + The following keys are allowed: + + network + Specify the network to be used by this TPU. + + subnetwork + Specify the network to be used by this TPU. If not specified, + this defaults to the subnetwork by the same name as the network. + + external-ips + Indicate that the IP addresses for the node should be exteranl. + The default will be only internal IP addresses. + + --internal-ips + Indicates that the IP addresses for the node should be internal. The + default is that external IP addresses will be associated with the TPU + workers. + + --network=NETWORK; default="default" + Network that this TPU will be a part of. + + --subnetwork=SUBNETWORK + Subnetwork that this TPU will be a part of. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/container/clusters/create b/gcloud/alpha/container/clusters/create index ae4596435..26d97ff14 100644 --- a/gcloud/alpha/container/clusters/create +++ b/gcloud/alpha/container/clusters/create @@ -67,7 +67,7 @@ SYNOPSIS [--placement-policy=PLACEMENT_POLICY] [--placement-type=PLACEMENT_TYPE] [--preemptible] [--private-endpoint-subnetwork=NAME] [--private-ipv6-google-access-type=PRIVATE_IPV6_GOOGLE_ACCESS_TYPE] - [--release-channel=CHANNEL] [--resource-manager-tags=[KEY=VALUE,...]] + [--release-channel=[CHANNEL]] [--resource-manager-tags=[KEY=VALUE,...]] [--security-group=SECURITY_GROUP] [--security-posture=SECURITY_POSTURE] [--services-ipv4-cidr=CIDR] [--services-secondary-range-name=NAME] [--shielded-integrity-monitoring] [--shielded-secure-boot] [--spot] @@ -1096,7 +1096,7 @@ FLAGS PRIVATE_IPV6_GOOGLE_ACCESS_TYPE must be one of: bidirectional, disabled, outbound-only. - --release-channel=CHANNEL + --release-channel=[CHANNEL] Release channel a cluster is subscribed to. If left unspecified and a version is specified, the cluster is enrolled @@ -1112,10 +1112,8 @@ FLAGS CHANNEL must be one of: - None - Use 'None' to opt-out of any release channel. + rapid - rapid 'rapid' channel is offered on an early access basis for customers who want to test new releases. @@ -1123,14 +1121,23 @@ FLAGS to unresolved issues with no known workaround and are not subject to any SLAs. - regular + regular + Clusters subscribed to 'regular' receive versions that are considered GA quality. 'regular' is intended for production users who want to take advantage of new features. - stable + + stable + Clusters subscribed to 'stable' receive versions that are known to be stable and reliable in production. + None + + Use 'None' to opt-out of any release channel. + + CHANNEL must be one of: rapid, regular, stable, None. + --resource-manager-tags=[KEY=VALUE,...] Applies the specified comma-separated resource manager tags that has the GCE_FIREWALL purpose to all nodes in the new default node pool(s) @@ -1177,6 +1184,9 @@ FLAGS To disable in an existing cluster, explicitly set the flag to --security-posture=disabled. + For more information on enablement, see + https://cloud.google.com/kubernetes-engine/docs/concepts/about-security-posture-dashboard#feature-enablement. + SECURITY_POSTURE must be one of: disabled, standard, enterprise. --services-ipv4-cidr=CIDR @@ -1375,6 +1385,9 @@ FLAGS To disable in an existing cluster, explicitly set the flag to --workload-vulnerability-scanning=disabled. + For more information on enablement, see + https://cloud.google.com/kubernetes-engine/docs/concepts/about-security-posture-dashboard#feature-enablement. + WORKLOAD_VULNERABILITY_SCANNING must be one of: disabled, standard, enterprise. diff --git a/gcloud/alpha/container/clusters/create-auto b/gcloud/alpha/container/clusters/create-auto index fca8d081d..7c2a3ec88 100644 --- a/gcloud/alpha/container/clusters/create-auto +++ b/gcloud/alpha/container/clusters/create-auto @@ -21,7 +21,7 @@ SYNOPSIS [--fleet-project=PROJECT_ID_OR_NUMBER] [--labels=[KEY=VALUE,...]] [--logging=[COMPONENT,...]] [--monitoring=[COMPONENT,...]] [--network=NETWORK] [--private-endpoint-subnetwork=NAME] - [--release-channel=CHANNEL] [--security-group=SECURITY_GROUP] + [--release-channel=[CHANNEL]] [--security-group=SECURITY_GROUP] [--security-posture=SECURITY_POSTURE] [--services-ipv4-cidr=CIDR] [--services-secondary-range-name=NAME] [--subnetwork=SUBNETWORK] [--workload-policies=WORKLOAD_POLICIES] @@ -311,7 +311,7 @@ FLAGS Sets the subnetwork GKE uses to provision the control plane's private endpoint. - --release-channel=CHANNEL + --release-channel=[CHANNEL] Release channel a cluster is subscribed to. If left unspecified and a version is specified, the cluster is enrolled @@ -327,7 +327,8 @@ FLAGS CHANNEL must be one of: - rapid + rapid + 'rapid' channel is offered on an early access basis for customers who want to test new releases. @@ -335,14 +336,19 @@ FLAGS to unresolved issues with no known workaround and are not subject to any SLAs. - regular + regular + Clusters subscribed to 'regular' receive versions that are considered GA quality. 'regular' is intended for production users who want to take advantage of new features. - stable + + stable + Clusters subscribed to 'stable' receive versions that are known to be stable and reliable in production. + CHANNEL must be one of: rapid, regular, stable. + --security-group=SECURITY_GROUP The name of the RBAC security group for use with Google security groups in Kubernetes RBAC @@ -367,6 +373,9 @@ FLAGS To disable in an existing cluster, explicitly set the flag to --security-posture=disabled. + For more information on enablement, see + https://cloud.google.com/kubernetes-engine/docs/concepts/about-security-posture-dashboard#feature-enablement. + SECURITY_POSTURE must be one of: disabled, standard, enterprise. --services-ipv4-cidr=CIDR @@ -417,6 +426,9 @@ FLAGS To disable in an existing cluster, explicitly set the flag to --workload-vulnerability-scanning=disabled. + For more information on enablement, see + https://cloud.google.com/kubernetes-engine/docs/concepts/about-security-posture-dashboard#feature-enablement. + WORKLOAD_VULNERABILITY_SCANNING must be one of: disabled, standard, enterprise. diff --git a/gcloud/alpha/container/clusters/update b/gcloud/alpha/container/clusters/update index f41587233..56a0a3d01 100644 --- a/gcloud/alpha/container/clusters/update +++ b/gcloud/alpha/container/clusters/update @@ -36,7 +36,7 @@ SYNOPSIS | --notification-config=[pubsub=ENABLED|DISABLED, pubsub-topic=TOPIC,...] | --private-ipv6-google-access-type=PRIVATE_IPV6_GOOGLE_ACCESS_TYPE - | --release-channel=CHANNEL | --remove-labels=[KEY,...] + | --release-channel=[CHANNEL] | --remove-labels=[KEY,...] | --remove-workload-policies=REMOVE_WORKLOAD_POLICIES | --security-group=SECURITY_GROUP | --security-posture=SECURITY_POSTURE @@ -575,7 +575,7 @@ REQUIRED FLAGS PRIVATE_IPV6_GOOGLE_ACCESS_TYPE must be one of: bidirectional, disabled, outbound-only. - --release-channel=CHANNEL + --release-channel=[CHANNEL] Subscribe or unsubscribe this cluster to a release channel. When a cluster is subscribed to a release channel, Google maintains @@ -586,10 +586,8 @@ REQUIRED FLAGS CHANNEL must be one of: - None - Use 'None' to opt-out of any release channel. + rapid - rapid 'rapid' channel is offered on an early access basis for customers who want to test new releases. @@ -597,13 +595,22 @@ REQUIRED FLAGS to unresolved issues with no known workaround and are not subject to any SLAs. - regular + regular + Clusters subscribed to 'regular' receive versions that are considered GA quality. 'regular' is intended for production users who want to take advantage of new features. - stable - Clusters subscribed to 'stable' receive versions that are known - to be stable and reliable in production. + + stable + + Clusters subscribed to 'stable' receive versions that are known to + be stable and reliable in production. + + None + + Use 'None' to opt-out of any release channel. + + CHANNEL must be one of: rapid, regular, stable, None. --remove-labels=[KEY,...] Labels to remove from the Google Cloud resources in use by the @@ -648,6 +655,9 @@ REQUIRED FLAGS To disable in an existing cluster, explicitly set the flag to --security-posture=disabled. + For more information on enablement, see + https://cloud.google.com/kubernetes-engine/docs/concepts/about-security-posture-dashboard#feature-enablement. + SECURITY_POSTURE must be one of: disabled, standard, enterprise. --security-profile=SECURITY_PROFILE @@ -746,6 +756,9 @@ REQUIRED FLAGS To disable in an existing cluster, explicitly set the flag to --workload-vulnerability-scanning=disabled. + For more information on enablement, see + https://cloud.google.com/kubernetes-engine/docs/concepts/about-security-posture-dashboard#feature-enablement. + WORKLOAD_VULNERABILITY_SCANNING must be one of: disabled, standard, enterprise. diff --git a/gcloud/alpha/container/fleet/scopes/remove-app-operator-binding b/gcloud/alpha/container/fleet/scopes/remove-app-operator-binding index 450f41fb8..3cc01642a 100644 --- a/gcloud/alpha/container/fleet/scopes/remove-app-operator-binding +++ b/gcloud/alpha/container/fleet/scopes/remove-app-operator-binding @@ -5,8 +5,7 @@ NAME SYNOPSIS gcloud alpha container fleet scopes remove-app-operator-binding SCOPE - (--group=GROUP | --user=USER) [--labels=[KEY=VALUE,...]] - [GCLOUD_WIDE_FLAG ...] + (--group=GROUP | --user=USER) [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) One binding consists of an app operator principal (user/group) and @@ -107,15 +106,6 @@ REQUIRED FLAGS --user=USER User for the role binding. -OPTIONAL FLAGS - --labels=[KEY=VALUE,...] - List of label KEY=VALUE pairs to add. - - Keys must start with a lowercase character and contain only hyphens - (-), underscores (_), lowercase characters, and numbers. Values must - contain only hyphens (-), underscores (_), lowercase characters, and - numbers. - GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/container/hub/scopes/remove-app-operator-binding b/gcloud/alpha/container/hub/scopes/remove-app-operator-binding index 33c378a81..a2d6df6fe 100644 --- a/gcloud/alpha/container/hub/scopes/remove-app-operator-binding +++ b/gcloud/alpha/container/hub/scopes/remove-app-operator-binding @@ -5,8 +5,7 @@ NAME SYNOPSIS gcloud alpha container hub scopes remove-app-operator-binding SCOPE - (--group=GROUP | --user=USER) [--labels=[KEY=VALUE,...]] - [GCLOUD_WIDE_FLAG ...] + (--group=GROUP | --user=USER) [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) One binding consists of an app operator principal (user/group) and @@ -107,15 +106,6 @@ REQUIRED FLAGS --user=USER User for the role binding. -OPTIONAL FLAGS - --labels=[KEY=VALUE,...] - List of label KEY=VALUE pairs to add. - - Keys must start with a lowercase character and contain only hyphens - (-), underscores (_), lowercase characters, and numbers. Values must - contain only hyphens (-), underscores (_), lowercase characters, and - numbers. - GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/domains/registrations/google-domains-dns/export-dns-record-sets b/gcloud/alpha/domains/registrations/google-domains-dns/export-dns-record-sets new file mode 100644 index 000000000..f22a76022 --- /dev/null +++ b/gcloud/alpha/domains/registrations/google-domains-dns/export-dns-record-sets @@ -0,0 +1,86 @@ +NAME + gcloud alpha domains registrations google-domains-dns + export-dns-record-sets - export your registration's Google Domains DNS + zone's record-sets into a file + +SYNOPSIS + gcloud alpha domains registrations google-domains-dns + export-dns-record-sets REGISTRATION --records-file=RECORDS_FILE + [--zone-file-format] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Export your registration's Google Domains DNS (deprecated) zone's + record-sets into a file. The formats you can export to are YAML records + format (default) and BIND zone file format. + +EXAMPLES + To export DNS record-sets of example.com into a YAML file, run: + + $ gcloud domains registrations google-domains-dns \ + export-dns-record-sets example.com --records-file=records.yaml + + To export DNS record-sets of example.com into a BIND zone formatted file, + run: + + $ gcloud domains registrations google-domains-dns \ + export-dns-record-sets example.com \ + --records-file=records.zonefile --zone-file-format + +POSITIONAL ARGUMENTS + Registration resource - The domain registration to get the DNS records + 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 registration on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument registration on the command line with a fully + specified name; + ◆ location is always global. + + This must be specified. + + REGISTRATION + ID of the registration or fully qualified identifier for the + registration. + + To set the registration attribute: + ▸ provide the argument registration on the command line. + +REQUIRED FLAGS + --records-file=RECORDS_FILE + File to which record-sets should be exported. + +OPTIONAL FLAGS + --zone-file-format + Indicates that records-file should be in the zone file format. When + using this flag, expect the record-set to be exported to a BIND zone + formatted file. If you omit this flag, the record-set is exported into + a YAML formatted records file. Note, this format flag determines the + format of the output recorded in the records-file; it is different from + the global --format flag which affects console output alone. + +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 domains registrations google-domains-dns \ + export-dns-record-sets + + $ gcloud beta domains registrations google-domains-dns \ + export-dns-record-sets + diff --git a/gcloud/alpha/domains/registrations/google-domains-dns/get-forwarding-config b/gcloud/alpha/domains/registrations/google-domains-dns/get-forwarding-config new file mode 100644 index 000000000..acb7cd117 --- /dev/null +++ b/gcloud/alpha/domains/registrations/google-domains-dns/get-forwarding-config @@ -0,0 +1,63 @@ +NAME + gcloud alpha domains registrations google-domains-dns get-forwarding-config + - get forwarding configuration of a specific Cloud Domains registration + +SYNOPSIS + gcloud alpha domains registrations google-domains-dns get-forwarding-config + REGISTRATION [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Get forwarding configuration (deprecated) of a specific + registration. + +EXAMPLES + To get forwarding configuration of example.com, run: + + $ gcloud domains registrations google-domains-dns \ + get-forwarding-config example.com + +POSITIONAL ARGUMENTS + Registration resource - The domain registration to get the forwarding + config 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 registration on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument registration on the command line with a fully + specified name; + ◆ location is always global. + + This must be specified. + + REGISTRATION + ID of the registration or fully qualified identifier for the + registration. + + To set the registration attribute: + ▸ provide the argument registration 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. These variants are also available: + + $ gcloud domains registrations google-domains-dns \ + get-forwarding-config + + $ gcloud beta domains registrations google-domains-dns \ + get-forwarding-config + diff --git a/gcloud/alpha/domains/registrations/google-domains-dns/help b/gcloud/alpha/domains/registrations/google-domains-dns/help new file mode 100644 index 000000000..60db44e6a --- /dev/null +++ b/gcloud/alpha/domains/registrations/google-domains-dns/help @@ -0,0 +1,38 @@ +NAME + gcloud alpha domains registrations google-domains-dns - manage deprecated + Google Domains DNS configuration + +SYNOPSIS + gcloud alpha domains registrations google-domains-dns COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Commands for managing DNS records and forwarding configuration of + Cloud Domains registrations that use deprecated Google Domains DNS. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + export-dns-record-sets + (ALPHA) Export your registration's Google Domains DNS zone's + record-sets into a file. + + get-forwarding-config + (ALPHA) Get forwarding configuration of a specific Cloud Domains + registration. + +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 domains registrations google-domains-dns + + $ gcloud beta domains registrations google-domains-dns + diff --git a/gcloud/alpha/domains/registrations/help b/gcloud/alpha/domains/registrations/help index 77876678e..835fa462b 100644 --- a/gcloud/alpha/domains/registrations/help +++ b/gcloud/alpha/domains/registrations/help @@ -22,6 +22,9 @@ GROUPS (ALPHA) Configure Cloud Domains registrations' management, DNS or contact settings. + google-domains-dns + (ALPHA) Manage deprecated Google Domains DNS configuration. + operations (ALPHA) Manage Cloud Domains operations. diff --git a/gcloud/alpha/functions/deploy b/gcloud/alpha/functions/deploy index 7a5e285e1..c295aa51b 100644 --- a/gcloud/alpha/functions/deploy +++ b/gcloud/alpha/functions/deploy @@ -107,7 +107,8 @@ FLAGS --build-service-account=BUILD_SERVICE_ACCOUNT IAM service account whose credentials will be used for the build step. Must be of the format - projects/${PROJECT_ID}/serviceAccounts/${ACCOUNT_EMAIL_ADDRESS}. + projects/${PROJECT_ID}/serviceAccounts/${ACCOUNT_EMAIL_ADDRESS} or + {ACCOUNT_EMAIL_ADDRESS}. If not provided, the function will use the project's default service account for Cloud Build. diff --git a/gcloud/alpha/iap/settings/get b/gcloud/alpha/iap/settings/get index eee6ab2bb..c20754b94 100644 --- a/gcloud/alpha/iap/settings/get +++ b/gcloud/alpha/iap/settings/get @@ -56,6 +56,12 @@ EXAMPLES $ gcloud alpha iap settings get --project=PROJECT_ID \ --resource-type=compute --service=SERVICE_ID + To get the IAP setting for a regional backend service within a project, + run: + + $ gcloud alpha iap settings get --project=PROJECT_ID \ + --resource-type=compute --service=SERVICE_ID --region=REGION_ID + FLAGS --folder=FOLDER Folder ID. @@ -67,8 +73,9 @@ FLAGS Project ID. --region=REGION - Region name. Not applicable for app-engine. Optional when resource-type - is compute. + Region name. Not applicable for app-engine. Required when resource-type + is compute and regional scoped. Not applicable for compute when global + scoped. --resource-type=RESOURCE_TYPE Resource type of the IAP resource. RESOURCE_TYPE must be one of: diff --git a/gcloud/alpha/iap/settings/set b/gcloud/alpha/iap/settings/set index 2c4fac048..58ed3c12a 100644 --- a/gcloud/alpha/iap/settings/set +++ b/gcloud/alpha/iap/settings/set @@ -60,6 +60,12 @@ EXAMPLES --project=PROJECT_ID --resource-type=compute \ --service=SERVICE_ID + To set the IAP setting for a region backend service within a project, run: + + $ gcloud alpha iap settings set iap_settings.yaml \ + --project=PROJECT_ID --resource-type=compute \ + --service=SERVICE_ID --region=REGION_ID + POSITIONAL ARGUMENTS SETTING_FILE JSON or YAML file containing the IAP resource settings. @@ -119,8 +125,9 @@ FLAGS Project ID. --region=REGION - Region name. Not applicable for app-engine. Optional when resource-type - is compute. + Region name. Not applicable for app-engine. Required when resource-type + is compute and regional scoped. Not applicable for compute when global + scoped. --resource-type=RESOURCE_TYPE Resource type of the IAP resource. RESOURCE_TYPE must be one of: diff --git a/gcloud/alpha/iap/web/add-iam-policy-binding b/gcloud/alpha/iap/web/add-iam-policy-binding index 615ebedee..a6d1f0804 100644 --- a/gcloud/alpha/iap/web/add-iam-policy-binding +++ b/gcloud/alpha/iap/web/add-iam-policy-binding @@ -27,6 +27,14 @@ EXAMPLES --resource-type=IAP_IAM_RESOURCE \ --member='user:test-user@gmail.com' --role='roles/editor' + To add an IAM policy binding for the role of 'roles/editor' for the user + 'test-user@gmail.com' on regional IAP IAM resource IAP_IAM_RESOURCE, run: + + $ gcloud alpha iap web add-iam-policy-binding \ + --resource-type=IAP_IAM_RESOURCE \ + --member='user:test-user@gmail.com' --role='roles/editor' \ + --region=REGION + To add an IAM policy binding for the role of 'roles/editor' for all authenticated users on IAP IAM resource IAP_IAM_RESOURCE, run: @@ -113,7 +121,8 @@ OPTIONAL FLAGS --region=REGION Region name. Should only be specified with - --resource-type=backend-services. + --resource-type=backend-services if it is a regional scoped. Not + applicable for global scoped backend services. --service=SERVICE Service name. diff --git a/gcloud/alpha/iap/web/get-iam-policy b/gcloud/alpha/iap/web/get-iam-policy index f6397d594..c238e99cf 100644 --- a/gcloud/alpha/iap/web/get-iam-policy +++ b/gcloud/alpha/iap/web/get-iam-policy @@ -57,6 +57,13 @@ EXAMPLES $ gcloud alpha iap web get-iam-policy \ --resource-type=backend-services --service=SERVICE_ID + To get the IAM policy for the web accesses to the IAP protected resources + within a regional backend service, run: + + $ gcloud alpha iap web get-iam-policy \ + --resource-type=backend-services --service=SERVICE_ID \ + --region=REGION + FLAGS --resource-type=RESOURCE_TYPE Resource type of the IAP resource. RESOURCE_TYPE must be one of: @@ -64,7 +71,8 @@ FLAGS --region=REGION Region name. Should only be specified with - --resource-type=backend-services. + --resource-type=backend-services if it is a regional scoped. Not + applicable for global scoped backend services. --service=SERVICE Service name. diff --git a/gcloud/alpha/iap/web/remove-iam-policy-binding b/gcloud/alpha/iap/web/remove-iam-policy-binding index 0457a0b33..45063e174 100644 --- a/gcloud/alpha/iap/web/remove-iam-policy-binding +++ b/gcloud/alpha/iap/web/remove-iam-policy-binding @@ -28,6 +28,14 @@ EXAMPLES --resource-type=IAP_IAM_RESOURCE \ --member='user:test-user@gmail.com' --role='roles/editor' + To remove an IAM policy binding for the role of 'roles/editor' for the user + 'test-user@gmail.com' on regional IAP IAM resource IAP_IAM_RESOURCE, run: + + $ gcloud alpha iap web remove-iam-policy-binding \ + --resource-type=IAP_IAM_RESOURCE \ + --member='user:test-user@gmail.com' --role='roles/editor' \ + --region=REGION + To remove an IAM policy binding for the role of 'roles/editor' from all authenticated users on IAP IAM resource IAP_IAM_RESOURCE,run: @@ -129,7 +137,8 @@ OPTIONAL FLAGS --region=REGION Region name. Should only be specified with - --resource-type=backend-services. + --resource-type=backend-services if it is a regional scoped. Not + applicable for global scoped backend services. --service=SERVICE Service name. diff --git a/gcloud/alpha/iap/web/set-iam-policy b/gcloud/alpha/iap/web/set-iam-policy index 79289d63e..d832fb6bd 100644 --- a/gcloud/alpha/iap/web/set-iam-policy +++ b/gcloud/alpha/iap/web/set-iam-policy @@ -61,6 +61,13 @@ EXAMPLES $ gcloud alpha iap web set-iam-policy POLICY_FILE \ --resource-type=backend-services --service=SERVICE_ID + To set the IAM policy for the web accesses to the IAP protected resources + within a regional backend service, run: + + $ gcloud alpha iap web set-iam-policy POLICY_FILE \ + --resource-type=backend-services --service=SERVICE_ID \ + --region=REGION + POSITIONAL ARGUMENTS POLICY_FILE JSON or YAML file containing the IAM policy. @@ -72,7 +79,8 @@ FLAGS --region=REGION Region name. Should only be specified with - --resource-type=backend-services. + --resource-type=backend-services if it is a regional scoped. Not + applicable for global scoped backend services. --service=SERVICE Service name. diff --git a/gcloud/alpha/managed-kafka/clusters/update b/gcloud/alpha/managed-kafka/clusters/update index 68071b9c2..639000d89 100644 --- a/gcloud/alpha/managed-kafka/clusters/update +++ b/gcloud/alpha/managed-kafka/clusters/update @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud alpha managed-kafka clusters update (CLUSTER : --location=LOCATION) - (--no-auto-rebalance --cpu=CPU + (--auto-rebalance --cpu=CPU --labels=[KEY=VALUE,...] --memory=MEMORY --subnets=[SUBNETS,...]) [--async] [GCLOUD_WIDE_FLAG ...] @@ -59,7 +59,6 @@ REQUIRED FLAGS rebalancing is enabled, topic partitions are rebalanced among brokers when the number of CPUs in the cluster changes. Automatic rebalancing is enabled by default. Use --no-auto-rebalance to disable this flag. - Enabled by default, use --no-auto-rebalance to disable. --cpu=CPU The number of vCPUs to provision for the cluster. The minimum is 3. diff --git a/gcloud/alpha/managed-kafka/topics/create b/gcloud/alpha/managed-kafka/topics/create index 5faa4a623..661896f60 100644 --- a/gcloud/alpha/managed-kafka/topics/create +++ b/gcloud/alpha/managed-kafka/topics/create @@ -74,7 +74,10 @@ OPTIONAL FLAGS --configs=[KEY=VALUE,...] Configuration for the topic that are overridden from the cluster defaults. The key of the map is a Kafka topic property name, for - example: cleanup.policy=compact, compression.type=producer. + example: cleanup.policy=compact,compression.type=producer. If you + provide a map with a key that already exists, only that configuration + is updated. If the map contains a key that does not exist, the entry is + appended to the topic configuration. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/managed-kafka/topics/update b/gcloud/alpha/managed-kafka/topics/update index 46e14b976..284fe4d11 100644 --- a/gcloud/alpha/managed-kafka/topics/update +++ b/gcloud/alpha/managed-kafka/topics/update @@ -65,7 +65,10 @@ REQUIRED FLAGS --configs=[KEY=VALUE,...] Configuration for the topic that are overridden from the cluster defaults. The key of the map is a Kafka topic property name, for - example: cleanup.policy=compact, compression.type=producer. + example: cleanup.policy=compact,compression.type=producer. If you + provide a map with a key that already exists, only that configuration + is updated. If the map contains a key that does not exist, the entry + is appended to the topic configuration. --partitions=PARTITIONS The number of partitions in a topic. You can increase the partition diff --git a/gcloud/alpha/migration/vms/help b/gcloud/alpha/migration/vms/help index fe88554c8..827130986 100644 --- a/gcloud/alpha/migration/vms/help +++ b/gcloud/alpha/migration/vms/help @@ -24,6 +24,10 @@ GROUPS (ALPHA) Imports images to Google Compute Engine from Google Cloud Storage. + machine-image-imports + (ALPHA) Imports machine images to Google Compute Engine from Google + Cloud Storage. + target-projects (ALPHA) Manage Target Projects. diff --git a/gcloud/alpha/migration/vms/machine-image-imports/create b/gcloud/alpha/migration/vms/machine-image-imports/create new file mode 100644 index 000000000..7527761e3 --- /dev/null +++ b/gcloud/alpha/migration/vms/machine-image-imports/create @@ -0,0 +1,174 @@ +NAME + gcloud alpha migration vms machine-image-imports create - import machine + images to Google Compute Engine + +SYNOPSIS + gcloud alpha migration vms machine-image-imports create + (IMAGE_IMPORT_NAME : --location=LOCATION) --source-file=SOURCE_FILE + [--additional-licenses=[ADDITIONAL_LICENSES,...]] + [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] + [--machine-image-name=MACHINE_IMAGE_NAME] [--machine-type=MACHINE_TYPE] + [--single-region-storage] [--tags=[TAGS,...]] + [--target-project=TARGET_PROJECT] + [--enable-integrity-monitoring --enable-vtpm --secure-boot=SECURE_BOOT] + [--scopes=[SCOPES,...] --service-account=SERVICE_ACCOUNT] + [--skip-os-adaptation | --generalize --license-type=LICENSE_TYPE] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) gcloud alpha migration vms machine-image-imports create Imports + machine images such as OVA and OVF files, from a Google Cloud Storage file + (gs://...) to Google Compute Engine, using the Migrate to Virtual Machines + service API. This command creates an Image Import resource with a nested + Image Import Job resource. The Image Import Job resource tracks the image + import progress. To use this command, you must enable VM Migration API in + your project. + +EXAMPLES + To import ub-14.04.5.ova from my-images-bucket to my-target-project in + us-central1, create my-image-import resource in my-project in us-central1. + Run: $ gcloud alpha migration vms machine-image-imports create \ + my-machine-image-import \ + --source-file=gs://my-images-bucket/ub-14.04.5.ova \ + --image-name=my-ubuntu-machine-image --location=us-central1 \ + --target-project=projects/my-project/locations/global/\ + targetProjects/my-target-project --project=my-project + +POSITIONAL ARGUMENTS + Image import resource - The Image Import resource you want to create. This + would be the machine image name if --machine-image-name is not given. 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 image_import_name 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. + + IMAGE_IMPORT_NAME + ID of the image_import or fully qualified identifier for the + image_import. + + To set the image_import_name attribute: + ▸ provide the argument image_import_name on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Resource location. + + To set the location attribute: + ▸ provide the argument image_import_name on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property compute/region. + +REQUIRED FLAGS + --source-file=SOURCE_FILE + The path to the Google Cloud Storage file from which the image should + be imported. + +OPTIONAL FLAGS + --additional-licenses=[ADDITIONAL_LICENSES,...] + Comma-separated list of the additional licenses to assign to the + machine image. + + --description=DESCRIPTION + A description of the machine image. + + --labels=[KEY=VALUE,...] + A map of labels to associate with the machine image. + + --machine-image-name=MACHINE_IMAGE_NAME + The name of the machine image that will be imported to Google Compute + Engine. Default is the Image Import name. + + --machine-type=MACHINE_TYPE + The machine type to create the machine image with. If not provided, the + service will choose a relevant machine type series based on the + information from the source image. + + --single-region-storage + If true, the location of the imported machine image will be the region + of the import job. Otherwise the closest multi-region is selected. + Default is false. + + --tags=[TAGS,...] + The tags to apply to the instance created by the machine image. + + --target-project=TARGET_PROJECT + The target project resource path to which the machine image will be + imported. Default is the host project. To get a list of the target + projects run the gcloud alpha migration vms target-projects list + command. + + Shielded instance configuration. + + --enable-integrity-monitoring + Defines whether the instance created by the machine image has + integrity monitoring enabled. This can be set to true only if the + image boot option is EFI, and vTPM is enabled. + + --enable-vtpm + Defines whether the instance created by the machine image has vTPM + enabled. This can be set to true only if the image boot option is + EFI. + + --secure-boot=SECURE_BOOT + Defines whether the instance created by the machine image has Secure + Boot enabled. This can be set to true only if the image boot option + is EFI. If not specified we will use the configuration of the source. + SECURE_BOOT must be one of: false, secure-boot-unspecified, true. + + The service account to assign to the instance created by the machine + image. + + --scopes=[SCOPES,...] + The list of scopes to be made available for the service account. + + --service-account=SERVICE_ACCOUNT + The email address of the service account. + + OS adaptation parameters. + + At most one of these can be specified: + + --skip-os-adaptation + If true, skip OS adaptation. Default false. + + --generalize + If true, generalize the imported machine image. Default false. The + generalization process enables co-existence of multiple VMs created + from the same machine image. For Windows, generalizing the machine + image removes computer-specific information such as installed drivers + and the computer security identifier (SID). + + --license-type=LICENSE_TYPE + The license to use post migration. LICENSE_TYPE must be one of: + compute-engine-license-type-byol, + compute-engine-license-type-default, + compute-engine-license-type-payg. + +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 vmmigration/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/migrate/virtual-machines + +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/migration/vms/machine-image-imports/delete b/gcloud/alpha/migration/vms/machine-image-imports/delete new file mode 100644 index 000000000..7fbce4235 --- /dev/null +++ b/gcloud/alpha/migration/vms/machine-image-imports/delete @@ -0,0 +1,72 @@ +NAME + gcloud alpha migration vms machine-image-imports delete - delete an Image + Import resource + +SYNOPSIS + gcloud alpha migration vms machine-image-imports delete + (IMAGE_IMPORT_NAME : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) gcloud alpha migration vms machine-image-imports delete deletes an + Image Import resource. To use this command, you must enable VM Migration + API in your project. + + This command does not delete any machine images imported to Google Compute + Engine. + +EXAMPLES + To delete my-image-import resource in us-central1 in the default project, + run: $ gcloud alpha migration vms machine-image-imports delete \ + my-image-import --location=us-central1 + +POSITIONAL ARGUMENTS + Image import resource - The Image Import resource you want to delete. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument image_import_name 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. + + IMAGE_IMPORT_NAME + ID of the image_import or fully qualified identifier for the + image_import. + + To set the image_import_name attribute: + ▸ provide the argument image_import_name on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Resource location. + + To set the location attribute: + ▸ provide the argument image_import_name on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property compute/region. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the vmmigration/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/migrate/virtual-machines + +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/migration/vms/machine-image-imports/describe b/gcloud/alpha/migration/vms/machine-image-imports/describe new file mode 100644 index 000000000..94122eaee --- /dev/null +++ b/gcloud/alpha/migration/vms/machine-image-imports/describe @@ -0,0 +1,70 @@ +NAME + gcloud alpha migration vms machine-image-imports describe - describe an + Image Import + +SYNOPSIS + gcloud alpha migration vms machine-image-imports describe + (IMAGE_IMPORT_NAME : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) gcloud alpha migration vms machine-image-imports describe describes + an Image Import resource with a nested Image Import Job. The Image Import + Job resource tracks the image import progress. To use this command, you + must enable VM Migration API in your project. + +EXAMPLES + To describe my-image-import resource in us-central1 in the default project, + run: $ gcloud alpha migration vms machine-image-imports describe \ + my-image-import --location=us-central1 + +POSITIONAL ARGUMENTS + Image import resource - The Image Import you want 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 image_import_name 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. + + IMAGE_IMPORT_NAME + ID of the image_import or fully qualified identifier for the + image_import. + + To set the image_import_name attribute: + ▸ provide the argument image_import_name on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Resource location. + + To set the location attribute: + ▸ provide the argument image_import_name on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property compute/region. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the vmmigration/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/migrate/virtual-machines + +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/migration/vms/machine-image-imports/help b/gcloud/alpha/migration/vms/machine-image-imports/help new file mode 100644 index 000000000..25b6835d5 --- /dev/null +++ b/gcloud/alpha/migration/vms/machine-image-imports/help @@ -0,0 +1,65 @@ +NAME + gcloud alpha migration vms machine-image-imports - imports machine images + to Google Compute Engine from Google Cloud Storage + +SYNOPSIS + gcloud alpha migration vms machine-image-imports COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) gcloud alpha migration vms machine-image-imports provides a more + robust and better supported method for importing machine images to Google + Compute Engine. Other image-related operations (for example, list) can be + done using gcloud compute images, as usual. + + The commands use VM Migration API which supports importing of a machine + image from a Google Cloud Storage file (gs://...) to a target project. VM + Migration API must be enabled in your project. + + gcloud alpha migration vms machine-image-imports create creates a machine + Image Import resource with a nested Image Import Job resource. The Image + Import Job resource tracks the machine image import progress. After the + Image Import Job completes, successfully or otherwise, there's no further + use for the Image Import resource. + + The machine image is imported to a Google Cloud Project, desginated by the + Target Project resource. To get a list of Target Projects, run the gcloud + alpha migration vms target-projects list command. Use the Google Cloud + console to add target project resources. For information on adding target + projects, see + https://cloud.google.com/migrate/virtual-machines/docs/5.0/how-to/target-project. + + A project can support up to a certain number of Image Import resources per + project. Hence it's recommended to delete an Image Import resource after + the Image Import Job is complete to avoid reaching the Image Import + resources limit. Deletion of Image Import resource does not affect the + imported machine image. For more information about the image import + resource, see + https://cloud.google.com/migrate/virtual-machines/docs/5.0/migrate/image_import. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (ALPHA) import machine images to Google Compute Engine. + + delete + (ALPHA) delete an Image Import resource. + + describe + (ALPHA) describe an Image Import. + + list + (ALPHA) list Image Imports. + +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/number-registry/operations/list b/gcloud/alpha/migration/vms/machine-image-imports/list similarity index 70% rename from gcloud/alpha/number-registry/operations/list rename to gcloud/alpha/migration/vms/machine-image-imports/list index 63573ac0b..6064c0535 100644 --- a/gcloud/alpha/number-registry/operations/list +++ b/gcloud/alpha/migration/vms/machine-image-imports/list @@ -1,37 +1,42 @@ NAME - gcloud alpha number-registry operations list - list operations + gcloud alpha migration vms machine-image-imports list - list Image Imports SYNOPSIS - gcloud alpha number-registry operations list --location=LOCATION + gcloud alpha migration vms machine-image-imports list [--location=LOCATION] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) List operations + (ALPHA) gcloud alpha migration vms machine-image-imports list prints a + detailed list of Image Import resources. To use this command, you must + enable VM Migration API in your project. EXAMPLES - To list all operations, run: + To list the Image Import resources in us-central1 in the default project, + run: $ gcloud alpha migration vms machine-image-imports list \ + --location=us-central1 - $ gcloud alpha number-registry operations list - -REQUIRED FLAGS - Location resource - The name of the operation's parent resource. This - represents a Cloud resource. (NOTE) Some attributes are not given - arguments in this group but can be set in other ways. +FLAGS + Location resource - The compute/region of the Image Import. To get a list + of the available regions, run gcloud compute regions list command. If not + specified, the value of the [compute/zone] property in the current gcloud + configuration is used. This represents a Cloud resource. (NOTE) Some + attributes are not given arguments in this group but can be set in other + ways. To set the project attribute: ◆ provide the argument --location on the command line with a fully specified name; + ◆ set the property compute/region with a fully specified name; ◆ set the property core/project; ◆ provide the argument --project on the command line. - This must be specified. - --location=LOCATION ID of the location or fully qualified identifier for the location. To set the location attribute: - ▸ provide the argument --location on the command line. + ▸ provide the argument --location on the command line; + ▸ set the property compute/region. LIST COMMAND FLAGS --filter=EXPRESSION @@ -74,8 +79,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the cloudnumberregistry/v1alpha API. The full - documentation for this API can be found at: http://go/cloud-number-registry + This command uses the vmmigration/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/migrate/virtual-machines NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/network-connectivity/internal-ranges/update b/gcloud/alpha/network-connectivity/internal-ranges/update index f1b31e7aa..0bc2bf139 100644 --- a/gcloud/alpha/network-connectivity/internal-ranges/update +++ b/gcloud/alpha/network-connectivity/internal-ranges/update @@ -5,6 +5,7 @@ NAME SYNOPSIS gcloud alpha network-connectivity internal-ranges update (INTERNAL_RANGE : --region=REGION) [--async] + [--clear-labels | --labels=[KEY=VALUE,...]] [--clear-overlaps | --overlaps=[OVERLAPS,...]] [--ip-cidr-range=IP_CIDR_RANGE | --prefix-length=PREFIX_LENGTH] [GCLOUD_WIDE_FLAG ...] @@ -61,6 +62,14 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + At most one of these can be specified: + + --clear-labels + Clear existing labels for the range. + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs for the range being updated. + At most one of these can be specified: --clear-overlaps diff --git a/gcloud/alpha/network-services/multicast-consumer-associations/delete b/gcloud/alpha/network-services/multicast-consumer-associations/delete index 488a03477..1dba1cc82 100644 --- a/gcloud/alpha/network-services/multicast-consumer-associations/delete +++ b/gcloud/alpha/network-services/multicast-consumer-associations/delete @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud alpha network-services multicast-consumer-associations delete - (MULTICAST_CONSUMER_ASSOCIATION : --location=LOCATION) + (MULTICAST_CONSUMER_ASSOCIATION : --location=LOCATION) [--async] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -50,6 +50,11 @@ POSITIONAL ARGUMENTS command line with a fully specified name; ▸ provide the argument --location on the command line. +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/network-services/multicast-domain-activations/delete b/gcloud/alpha/network-services/multicast-domain-activations/delete index d4742a053..e1961d4fa 100644 --- a/gcloud/alpha/network-services/multicast-domain-activations/delete +++ b/gcloud/alpha/network-services/multicast-domain-activations/delete @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud alpha network-services multicast-domain-activations delete - (MULTICAST_DOMAIN_ACTIVATION : --location=LOCATION) + (MULTICAST_DOMAIN_ACTIVATION : --location=LOCATION) [--async] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -50,6 +50,11 @@ POSITIONAL ARGUMENTS line with a fully specified name; ▸ provide the argument --location on the command line. +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/network-services/multicast-domains/delete b/gcloud/alpha/network-services/multicast-domains/delete index c1b0bea0b..d09db8bf1 100644 --- a/gcloud/alpha/network-services/multicast-domains/delete +++ b/gcloud/alpha/network-services/multicast-domains/delete @@ -4,7 +4,8 @@ NAME SYNOPSIS gcloud alpha network-services multicast-domains delete - (MULTICAST_DOMAIN : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + (MULTICAST_DOMAIN : --location=LOCATION) [--async] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Delete a multicast domain in the specified location of the current @@ -48,6 +49,11 @@ POSITIONAL ARGUMENTS fully specified name; ▸ provide the argument --location on the command line. +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/network-services/multicast-group-consumer-activations/delete b/gcloud/alpha/network-services/multicast-group-consumer-activations/delete index 6daf638ee..acc1d64f9 100644 --- a/gcloud/alpha/network-services/multicast-group-consumer-activations/delete +++ b/gcloud/alpha/network-services/multicast-group-consumer-activations/delete @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud alpha network-services multicast-group-consumer-activations delete - (MULTICAST_GROUP_CONSUMER_ACTIVATION : --location=LOCATION) + (MULTICAST_GROUP_CONSUMER_ACTIVATION : --location=LOCATION) [--async] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -52,6 +52,11 @@ POSITIONAL ARGUMENTS command line with a fully specified name; ▸ provide the argument --location on the command line. +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/network-services/multicast-group-definitions/delete b/gcloud/alpha/network-services/multicast-group-definitions/delete index 7445e274a..f70f7ce6a 100644 --- a/gcloud/alpha/network-services/multicast-group-definitions/delete +++ b/gcloud/alpha/network-services/multicast-group-definitions/delete @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud alpha network-services multicast-group-definitions delete - (MULTICAST_GROUP_DEFINITION : --location=LOCATION) + (MULTICAST_GROUP_DEFINITION : --location=LOCATION) [--async] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -50,6 +50,11 @@ POSITIONAL ARGUMENTS line with a fully specified name; ▸ provide the argument --location on the command line. +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/network-services/multicast-groups/delete b/gcloud/alpha/network-services/multicast-groups/delete index c022cbcf0..7491f352a 100644 --- a/gcloud/alpha/network-services/multicast-groups/delete +++ b/gcloud/alpha/network-services/multicast-groups/delete @@ -4,7 +4,8 @@ NAME SYNOPSIS gcloud alpha network-services multicast-groups delete - (MULTICAST_GROUP : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + (MULTICAST_GROUP : --location=LOCATION) [--async] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Delete a multicast group in the specified location of the current @@ -48,6 +49,11 @@ POSITIONAL ARGUMENTS fully specified name; ▸ provide the argument --location on the command line. +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/number-registry/operations/cancel b/gcloud/alpha/number-registry/operations/cancel deleted file mode 100644 index a200d92e7..000000000 --- a/gcloud/alpha/number-registry/operations/cancel +++ /dev/null @@ -1,64 +0,0 @@ -NAME - gcloud alpha number-registry operations cancel - cancel operations - -SYNOPSIS - gcloud alpha number-registry operations cancel - (OPERATION : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Cancel an operation - -EXAMPLES - To cancel the operation, run: - - $ gcloud alpha number-registry operations cancel - -POSITIONAL ARGUMENTS - Operation resource - The name of the operation resource to be cancelled. - The arguments in this group can be used to specify the attributes of this - resource. (NOTE) Some attributes are not given arguments in this group but - can be set in other ways. - - To set the project attribute: - ◆ provide the argument operation on the command line with a fully - specified name; - ◆ set the property core/project; - ◆ provide the argument --project on the command line. - - This must be specified. - - OPERATION - ID of the operation or fully qualified identifier for the operation. - - To set the operation attribute: - ▸ provide the argument operation on the command line. - - This positional argument must be specified if any of the other - arguments in this group are specified. - - --location=LOCATION - locations TBD - - To set the location attribute: - ▸ provide the argument operation on the command line with a fully - specified name; - ▸ provide the argument --location on the command line. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the cloudnumberregistry/v1alpha API. The full - documentation for this API can be found at: http://go/cloud-number-registry - -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/number-registry/operations/delete b/gcloud/alpha/number-registry/operations/delete deleted file mode 100644 index 7fdbf2a7e..000000000 --- a/gcloud/alpha/number-registry/operations/delete +++ /dev/null @@ -1,64 +0,0 @@ -NAME - gcloud alpha number-registry operations delete - delete operations - -SYNOPSIS - gcloud alpha number-registry operations delete - (OPERATION : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Delete an operation - -EXAMPLES - To delete the operation, run: - - $ gcloud alpha number-registry operations delete - -POSITIONAL ARGUMENTS - Operation resource - The name of the operation resource to be deleted. The - arguments in this group can be used to specify the attributes of this - resource. (NOTE) Some attributes are not given arguments in this group but - can be set in other ways. - - To set the project attribute: - ◆ provide the argument operation on the command line with a fully - specified name; - ◆ set the property core/project; - ◆ provide the argument --project on the command line. - - This must be specified. - - OPERATION - ID of the operation or fully qualified identifier for the operation. - - To set the operation attribute: - ▸ provide the argument operation on the command line. - - This positional argument must be specified if any of the other - arguments in this group are specified. - - --location=LOCATION - locations TBD - - To set the location attribute: - ▸ provide the argument operation on the command line with a fully - specified name; - ▸ provide the argument --location on the command line. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the cloudnumberregistry/v1alpha API. The full - documentation for this API can be found at: http://go/cloud-number-registry - -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/number-registry/operations/describe b/gcloud/alpha/number-registry/operations/describe deleted file mode 100644 index f7f995b36..000000000 --- a/gcloud/alpha/number-registry/operations/describe +++ /dev/null @@ -1,64 +0,0 @@ -NAME - gcloud alpha number-registry operations describe - describe operations - -SYNOPSIS - gcloud alpha number-registry operations describe - (OPERATION : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Describe an operation - -EXAMPLES - To describe the operation, run: - - $ gcloud alpha number-registry operations describe - -POSITIONAL ARGUMENTS - Operation resource - The name of the operation resource. The arguments in - this group can be used to specify the attributes of this resource. (NOTE) - Some attributes are not given arguments in this group but can be set in - other ways. - - To set the project attribute: - ◆ provide the argument operation on the command line with a fully - specified name; - ◆ set the property core/project; - ◆ provide the argument --project on the command line. - - This must be specified. - - OPERATION - ID of the operation or fully qualified identifier for the operation. - - To set the operation attribute: - ▸ provide the argument operation on the command line. - - This positional argument must be specified if any of the other - arguments in this group are specified. - - --location=LOCATION - locations TBD - - To set the location attribute: - ▸ provide the argument operation on the command line with a fully - specified name; - ▸ provide the argument --location on the command line. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the cloudnumberregistry/v1alpha API. The full - documentation for this API can be found at: http://go/cloud-number-registry - -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/number-registry/operations/wait b/gcloud/alpha/number-registry/operations/wait deleted file mode 100644 index 85e22925d..000000000 --- a/gcloud/alpha/number-registry/operations/wait +++ /dev/null @@ -1,64 +0,0 @@ -NAME - gcloud alpha number-registry operations wait - wait operations - -SYNOPSIS - gcloud alpha number-registry operations wait - (OPERATION : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Wait an operation - -EXAMPLES - To wait the operation, run: - - $ gcloud alpha number-registry operations wait - -POSITIONAL ARGUMENTS - Operation resource - The name of the operation resource to wait on. The - arguments in this group can be used to specify the attributes of this - resource. (NOTE) Some attributes are not given arguments in this group but - can be set in other ways. - - To set the project attribute: - ◆ provide the argument operation on the command line with a fully - specified name; - ◆ set the property core/project; - ◆ provide the argument --project on the command line. - - This must be specified. - - OPERATION - ID of the operation or fully qualified identifier for the operation. - - To set the operation attribute: - ▸ provide the argument operation on the command line. - - This positional argument must be specified if any of the other - arguments in this group are specified. - - --location=LOCATION - locations TBD - - To set the location attribute: - ▸ provide the argument operation on the command line with a fully - specified name; - ▸ provide the argument --location on the command line. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the cloudnumberregistry/v1alpha API. The full - documentation for this API can be found at: http://go/cloud-number-registry - -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/number-registry/registry-books/create b/gcloud/alpha/number-registry/registry-books/create deleted file mode 100644 index de127245f..000000000 --- a/gcloud/alpha/number-registry/registry-books/create +++ /dev/null @@ -1,96 +0,0 @@ -NAME - gcloud alpha number-registry registry-books create - create a registry book - resource - -SYNOPSIS - gcloud alpha number-registry registry-books create - (REGISTRY_BOOK : --location=LOCATION) [--async] [--labels=[LABELS,...]] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Create a registry book resource. - -EXAMPLES - To create an registry book my-registry-book in location global run: - - $ gcloud alpha number-registry registry-books create \ - my-registry-book --location=global - -POSITIONAL ARGUMENTS - RegistryBook resource - Identifier. name of resource The arguments in this - group can be used to specify the attributes of this resource. (NOTE) Some - attributes are not given arguments in this group but can be set in other - ways. - - To set the project attribute: - ◆ provide the argument registry_book 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. - - REGISTRY_BOOK - ID of the registryBook or fully qualified identifier for the - registryBook. - - To set the registry_book attribute: - ▸ provide the argument registry_book on the command line. - - This positional argument must be specified if any of the other - arguments in this group are specified. - - --location=LOCATION - locations TBD - - To set the location attribute: - ▸ provide the argument registry_book on the command line with a - fully specified name; - ▸ provide the argument --location on the command line. - -FLAGS - --async - Return immediately, without waiting for the operation in progress to - complete. - - --labels=[LABELS,...] - Labels as key value pairs. - - KEY - Keys must start with a lowercase character and contain only hyphens - (-), underscores (_), lowercase characters, and numbers. - - VALUE - Values must contain only hyphens (-), underscores (_), lowercase - characters, and numbers. - - Shorthand Example: - - --labels=string=string - - JSON Example: - - --labels='{"string": "string"}' - - File Example: - - --labels=path_to_file.(yaml|json) - -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 cloudnumberregistry/v1alpha API. The full - documentation for this API can be found at: http://go/cloud-number-registry - -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/number-registry/registry-books/delete b/gcloud/alpha/number-registry/registry-books/delete deleted file mode 100644 index 531d80252..000000000 --- a/gcloud/alpha/number-registry/registry-books/delete +++ /dev/null @@ -1,88 +0,0 @@ -NAME - gcloud alpha number-registry registry-books delete - delete a single - registry book resource - -SYNOPSIS - gcloud alpha number-registry registry-books delete - (REGISTRY_BOOK : --location=LOCATION) [--async] - [--request-id=REQUEST_ID] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Deletes a single registry book. - -EXAMPLES - To delete a registry book my-registry-book in location global run: - - $ gcloud alpha number-registry registry-books delete \ - my-registry-book --location=global - -POSITIONAL ARGUMENTS - RegistryBook resource - Name of the resource The arguments in this group - can be used to specify the attributes of this resource. (NOTE) Some - attributes are not given arguments in this group but can be set in other - ways. - - To set the project attribute: - ◆ provide the argument registry_book 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. - - REGISTRY_BOOK - ID of the registryBook or fully qualified identifier for the - registryBook. - - To set the registry_book attribute: - ▸ provide the argument registry_book on the command line. - - This positional argument must be specified if any of the other - arguments in this group are specified. - - --location=LOCATION - locations TBD - - To set the location attribute: - ▸ provide the argument registry_book on the command line with a - fully specified name; - ▸ provide the argument --location on the command line. - -FLAGS - --async - Return immediately, without waiting for the operation in progress to - complete. - - --request-id=REQUEST_ID - An optional request ID to identify requests. Specify a unique request - ID so that if you must retry your request, the server will know to - ignore the request if it has already been completed. The server will - guarantee that for at least 60 minutes after the first request. - - For example, consider a situation where you make an initial request and - the request times out. If you make the request again with the same - request ID, the server can check if original operation with the same - request ID was received, and if so, will ignore the second request. - This prevents clients from accidentally creating duplicate commitments. - - The request ID must be a valid UUID with the exception that zero UUID - is not supported (00000000-0000-0000-0000-000000000000). - -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 cloudnumberregistry/v1alpha API. The full - documentation for this API can be found at: http://go/cloud-number-registry - -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/number-registry/registry-books/describe b/gcloud/alpha/number-registry/registry-books/describe deleted file mode 100644 index 425ebf636..000000000 --- a/gcloud/alpha/number-registry/registry-books/describe +++ /dev/null @@ -1,68 +0,0 @@ -NAME - gcloud alpha number-registry registry-books describe - gets details of a - single registry book resource - -SYNOPSIS - gcloud alpha number-registry registry-books describe - (REGISTRY_BOOK : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Gets details of a single registry book resource. - -EXAMPLES - To get the details of a single registry book my-registry-book in location - global run: - - $ gcloud alpha number-registry registry-books describe \ - my-registry-book --location=global - -POSITIONAL ARGUMENTS - RegistryBook resource - Name of the resource The arguments in this group - can be used to specify the attributes of this resource. (NOTE) Some - attributes are not given arguments in this group but can be set in other - ways. - - To set the project attribute: - ◆ provide the argument registry_book 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. - - REGISTRY_BOOK - ID of the registryBook or fully qualified identifier for the - registryBook. - - To set the registry_book attribute: - ▸ provide the argument registry_book on the command line. - - This positional argument must be specified if any of the other - arguments in this group are specified. - - --location=LOCATION - locations TBD - - To set the location attribute: - ▸ provide the argument registry_book on the command line with a - fully specified name; - ▸ provide the argument --location on the command line. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the cloudnumberregistry/v1alpha API. The full - documentation for this API can be found at: http://go/cloud-number-registry - -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/number-registry/registry-books/help b/gcloud/alpha/number-registry/registry-books/help deleted file mode 100644 index 82bfd844c..000000000 --- a/gcloud/alpha/number-registry/registry-books/help +++ /dev/null @@ -1,52 +0,0 @@ -NAME - gcloud alpha number-registry registry-books - manage registry book - resources - -SYNOPSIS - gcloud alpha number-registry registry-books GROUP | COMMAND - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Manage registry book resources. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -GROUPS - GROUP is one of the following: - - historical-events - (ALPHA) Manage historical event resources. - - node-events - (ALPHA) Manage node event resources. - - registry-nodes - (ALPHA) Manage registry node resources. - -COMMANDS - COMMAND is one of the following: - - create - (ALPHA) Create a registry book resource. - - delete - (ALPHA) Delete a single registry book resource. - - describe - (ALPHA) Gets details of a single registry book resource. - - list - (ALPHA) List registry book resources. - - update - (ALPHA) Update the parameters of a single registry book resource. - -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/number-registry/registry-books/historical-events/help b/gcloud/alpha/number-registry/registry-books/historical-events/help deleted file mode 100644 index 5dfce1bd9..000000000 --- a/gcloud/alpha/number-registry/registry-books/historical-events/help +++ /dev/null @@ -1,28 +0,0 @@ -NAME - gcloud alpha number-registry registry-books historical-events - manage - historical event resources - -SYNOPSIS - gcloud alpha number-registry registry-books historical-events COMMAND - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Manage historical event resources. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -COMMANDS - COMMAND is one of the following: - - show - (ALPHA) List all historical events in a registry book. - -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/number-registry/registry-books/historical-events/show b/gcloud/alpha/number-registry/registry-books/historical-events/show deleted file mode 100644 index bfa1ca5f7..000000000 --- a/gcloud/alpha/number-registry/registry-books/historical-events/show +++ /dev/null @@ -1,95 +0,0 @@ -NAME - gcloud alpha number-registry registry-books historical-events show - list - all historical events in a registry book - -SYNOPSIS - gcloud alpha number-registry registry-books historical-events show - (--registry-book=REGISTRY_BOOK : --location=LOCATION) - [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] - [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) List all historical events in a registry book. - -EXAMPLES - To list all historical events in registry book my-registry-book in location - global run: - - $ gcloud alpha number-registry registry-books historical-events \ show --registry-book=my-registry-book --location=global - -REQUIRED FLAGS - RegistryBook resource - Parent value for ShowHistoricalEventsRequest 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 --registry-book 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. - - --registry-book=REGISTRY_BOOK - ID of the registryBook or fully qualified identifier for the - registryBook. - - To set the registry-book attribute: - ▸ provide the argument --registry-book on the command line. - - This flag argument must be specified if any of the other arguments in - this group are specified. - - --location=LOCATION - locations TBD - - To set the location attribute: - ▸ provide the argument --registry-book 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. - -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 cloudnumberregistry/v1alpha API. The full - documentation for this API can be found at: http://go/cloud-number-registry - -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/number-registry/registry-books/node-events/help b/gcloud/alpha/number-registry/registry-books/node-events/help deleted file mode 100644 index f95c07d46..000000000 --- a/gcloud/alpha/number-registry/registry-books/node-events/help +++ /dev/null @@ -1,28 +0,0 @@ -NAME - gcloud alpha number-registry registry-books node-events - manage node event - resources - -SYNOPSIS - gcloud alpha number-registry registry-books node-events COMMAND - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Manage node event resources. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -COMMANDS - COMMAND is one of the following: - - show - (ALPHA) List all node events of an IP range in a registry book. - -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/number-registry/registry-books/node-events/show b/gcloud/alpha/number-registry/registry-books/node-events/show deleted file mode 100644 index fdfff691b..000000000 --- a/gcloud/alpha/number-registry/registry-books/node-events/show +++ /dev/null @@ -1,101 +0,0 @@ -NAME - gcloud alpha number-registry registry-books node-events show - list all - node events of an IP range in a registry book - -SYNOPSIS - gcloud alpha number-registry registry-books node-events show - --ip-range=IP_RANGE - (--registry-book=REGISTRY_BOOK : --location=LOCATION) - [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] - [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) List all node events of an IP range in a registry book. - -EXAMPLES - To list all node events of IP range 10.10.20.0/24 in registry book - my-registry-book in location global run: - - $ gcloud alpha number-registry registry-books node-events show \ - --ip-range=10.10.20.0/24 --registry-book=my-registry-book \ - --location=global - -REQUIRED FLAGS - --ip-range=IP_RANGE - The IP range of node events to list. - - RegistryBook resource - Parent value for ShowNodeEventsRequest 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 --registry-book 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. - - --registry-book=REGISTRY_BOOK - ID of the registryBook or fully qualified identifier for the - registryBook. - - To set the registry-book attribute: - ▸ provide the argument --registry-book on the command line. - - This flag argument must be specified if any of the other arguments in - this group are specified. - - --location=LOCATION - locations TBD - - To set the location attribute: - ▸ provide the argument --registry-book 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. - -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 cloudnumberregistry/v1alpha API. The full - documentation for this API can be found at: http://go/cloud-number-registry - -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/number-registry/registry-books/registry-nodes/create b/gcloud/alpha/number-registry/registry-books/registry-nodes/create deleted file mode 100644 index 73a382d05..000000000 --- a/gcloud/alpha/number-registry/registry-books/registry-nodes/create +++ /dev/null @@ -1,155 +0,0 @@ -NAME - gcloud alpha number-registry registry-books registry-nodes create - create - a registry node resource in a registry book - -SYNOPSIS - gcloud alpha number-registry registry-books registry-nodes create - (REGISTRY_NODE : --location=LOCATION --registry-book=REGISTRY_BOOK) - --ip-range=IP_RANGE [--async] - [--attribute=[description=DESCRIPTION],[key=KEY],[value=VALUE]] - [--labels=[LABELS,...]] - [--import-info-source=IMPORT_INFO_SOURCE - --import-info-writer=IMPORT_INFO_WRITER] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Create a registry node resource in a registry book. - -EXAMPLES - To create a registry node my-registry-node under registry book - my-registry-book with IP range 10.10.10.0/24 in location global run: - - $ gcloud alpha number-registry registry-books registry-nodes \ create my-registry-node --registry-book=my-registry-book \ - --ip-range=10.10.10.0/24 --location=global - - To create a registry node my-registry-node under registry book - my-registry-book with IP range 10.10.20.0/24 with two attributes in - location global run: - - $ gcloud alpha number-registry registry-books registry-nodes \ create my-registry-node --registry-book=my-registry-book \ - --ip-range=10.10.20.0/24 \ - --attribute=key='gke',value='gke usage' \ - --attribute=key='gce subnet',value='gce subnet for auto gke' \ - --location=global - -POSITIONAL ARGUMENTS - RegistryNode resource - Identifier. name of resource The arguments in this - group can be used to specify the attributes of this resource. (NOTE) Some - attributes are not given arguments in this group but can be set in other - ways. - - To set the project attribute: - ◆ provide the argument registry_node 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. - - REGISTRY_NODE - ID of the registryNode or fully qualified identifier for the - registryNode. - - To set the registry_node attribute: - ▸ provide the argument registry_node on the command line. - - This positional argument must be specified if any of the other - arguments in this group are specified. - - --location=LOCATION - locations TBD - - To set the location attribute: - ▸ provide the argument registry_node on the command line with a - fully specified name; - ▸ provide the argument --location on the command line. - - --registry-book=REGISTRY_BOOK - registryBooks TBD - - To set the registry-book attribute: - ▸ provide the argument registry_node on the command line with a - fully specified name; - ▸ provide the argument --registry-book on the command line. - -REQUIRED FLAGS - --ip-range=IP_RANGE - IP range of registry node. - -OPTIONAL FLAGS - --async - Return immediately, without waiting for the operation in progress to - complete. - - --attribute=[description=DESCRIPTION],[key=KEY],[value=VALUE] - Attributes represent the custom metadata for registry node. - - description - The description of the registry node attribute. - - key - The key of the registry attribute. - - value - The value of the registry node attribute. - - Shorthand Example: - - --attribute=description=string,key=string,value=string --attribute=description=string,key=string,value=string - - JSON Example: - - --attribute='[{"description": "string", "key": "string", "value": "string"}]' - - File Example: - - --attribute=path_to_file.(yaml|json) - - --labels=[LABELS,...] - Labels as key value pairs. - - KEY - Keys must start with a lowercase character and contain only hyphens - (-), underscores (_), lowercase characters, and numbers. - - VALUE - Values must contain only hyphens (-), underscores (_), lowercase - characters, and numbers. - - Shorthand Example: - - --labels=string=string - - JSON Example: - - --labels='{"string": "string"}' - - File Example: - - --labels=path_to_file.(yaml|json) - - Message describing import metadata. - - --import-info-source=IMPORT_INFO_SOURCE - Resource name of imported source. - - --import-info-writer=IMPORT_INFO_WRITER - Writer of imported information. - -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 cloudnumberregistry/v1alpha API. The full - documentation for this API can be found at: http://go/cloud-number-registry - -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/number-registry/registry-books/registry-nodes/delete b/gcloud/alpha/number-registry/registry-books/registry-nodes/delete deleted file mode 100644 index c9e05cd0f..000000000 --- a/gcloud/alpha/number-registry/registry-books/registry-nodes/delete +++ /dev/null @@ -1,97 +0,0 @@ -NAME - gcloud alpha number-registry registry-books registry-nodes delete - delete - a single registry node from a registry book - -SYNOPSIS - gcloud alpha number-registry registry-books registry-nodes delete - (REGISTRY_NODE : --location=LOCATION --registry-book=REGISTRY_BOOK) - [--async] [--request-id=REQUEST_ID] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Deletes a single registry node from a registry book. - -EXAMPLES - To delete a registry node my-registry-node from registry book - my-registry-book run: - - $ gcloud alpha number-registry registry-books registry-nodes \ delete my-registry-node --registry-book=my-registry-book \ - --location=global - -POSITIONAL ARGUMENTS - RegistryNode resource - Name of the resource The arguments in this group - can be used to specify the attributes of this resource. (NOTE) Some - attributes are not given arguments in this group but can be set in other - ways. - - To set the project attribute: - ◆ provide the argument registry_node 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. - - REGISTRY_NODE - ID of the registryNode or fully qualified identifier for the - registryNode. - - To set the registry_node attribute: - ▸ provide the argument registry_node on the command line. - - This positional argument must be specified if any of the other - arguments in this group are specified. - - --location=LOCATION - locations TBD - - To set the location attribute: - ▸ provide the argument registry_node on the command line with a - fully specified name; - ▸ provide the argument --location on the command line. - - --registry-book=REGISTRY_BOOK - registryBooks TBD - - To set the registry-book attribute: - ▸ provide the argument registry_node on the command line with a - fully specified name; - ▸ provide the argument --registry-book on the command line. - -FLAGS - --async - Return immediately, without waiting for the operation in progress to - complete. - - --request-id=REQUEST_ID - An optional request ID to identify requests. Specify a unique request - ID so that if you must retry your request, the server will know to - ignore the request if it has already been completed. The server will - guarantee that for at least 60 minutes after the first request. - - For example, consider a situation where you make an initial request and - the request times out. If you make the request again with the same - request ID, the server can check if original operation with the same - request ID was received, and if so, will ignore the second request. - This prevents clients from accidentally creating duplicate commitments. - - The request ID must be a valid UUID with the exception that zero UUID - is not supported (00000000-0000-0000-0000-000000000000). - -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 cloudnumberregistry/v1alpha API. The full - documentation for this API can be found at: http://go/cloud-number-registry - -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/number-registry/registry-books/registry-nodes/describe b/gcloud/alpha/number-registry/registry-books/registry-nodes/describe deleted file mode 100644 index 41d5b0073..000000000 --- a/gcloud/alpha/number-registry/registry-books/registry-nodes/describe +++ /dev/null @@ -1,77 +0,0 @@ -NAME - gcloud alpha number-registry registry-books registry-nodes describe - gets - details of a single registry node resource - -SYNOPSIS - gcloud alpha number-registry registry-books registry-nodes describe - (REGISTRY_NODE : --location=LOCATION --registry-book=REGISTRY_BOOK) - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Gets details of a single registry node resource. - -EXAMPLES - To get the details of a single registry node my-registry-node in location - global run: - - $ gcloud alpha number-registry registry-books registry-nodes \ describe my-registry-node --registry-book=my-registry-book \ - --location=global - -POSITIONAL ARGUMENTS - RegistryNode resource - Name of the resource The arguments in this group - can be used to specify the attributes of this resource. (NOTE) Some - attributes are not given arguments in this group but can be set in other - ways. - - To set the project attribute: - ◆ provide the argument registry_node 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. - - REGISTRY_NODE - ID of the registryNode or fully qualified identifier for the - registryNode. - - To set the registry_node attribute: - ▸ provide the argument registry_node on the command line. - - This positional argument must be specified if any of the other - arguments in this group are specified. - - --location=LOCATION - locations TBD - - To set the location attribute: - ▸ provide the argument registry_node on the command line with a - fully specified name; - ▸ provide the argument --location on the command line. - - --registry-book=REGISTRY_BOOK - registryBooks TBD - - To set the registry-book attribute: - ▸ provide the argument registry_node on the command line with a - fully specified name; - ▸ provide the argument --registry-book on the command line. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the cloudnumberregistry/v1alpha API. The full - documentation for this API can be found at: http://go/cloud-number-registry - -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/number-registry/registry-books/registry-nodes/help b/gcloud/alpha/number-registry/registry-books/registry-nodes/help deleted file mode 100644 index ac1389a3f..000000000 --- a/gcloud/alpha/number-registry/registry-books/registry-nodes/help +++ /dev/null @@ -1,43 +0,0 @@ -NAME - gcloud alpha number-registry registry-books registry-nodes - manage - registry node resources - -SYNOPSIS - gcloud alpha number-registry registry-books registry-nodes COMMAND - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Manage registry node resources. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -COMMANDS - COMMAND is one of the following: - - create - (ALPHA) Create a registry node resource in a registry book. - - delete - (ALPHA) Delete a single registry node from a registry book. - - describe - (ALPHA) Gets details of a single registry node resource. - - list - (ALPHA) List registry node resources in a registry book. - - search - (ALPHA) Search registry node resources in a registry book. - - update - (ALPHA) Update the parameters of a single registry node resource. - -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/number-registry/registry-books/registry-nodes/search b/gcloud/alpha/number-registry/registry-books/registry-nodes/search deleted file mode 100644 index 3cf4b52ad..000000000 --- a/gcloud/alpha/number-registry/registry-books/registry-nodes/search +++ /dev/null @@ -1,118 +0,0 @@ -NAME - gcloud alpha number-registry registry-books registry-nodes search - search - registry node resources in a registry book - -SYNOPSIS - gcloud alpha number-registry registry-books registry-nodes search - (--registry-book=REGISTRY_BOOK : --location=LOCATION) - [--attribute-keys=[ATTRIBUTE_KEYS,...]] [--ip-range=IP_RANGE] - [--keywords=[KEYWORDS,...]] [--source=SOURCE] [--filter=EXPRESSION] - [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Search registry node resources in a registry book. - -EXAMPLES - To search all registry nodes containing keyword gke in registry book - my-registry-book in location global run: - - $ gcloud alpha number-registry registry-books registry-nodes \ search --keywords='gke' --registry-book=my-registry-book \ - --location=global - - To search all registry nodes with IP range 192.168.0.0/24 in registry book - my-registry-book in location global run: - - $ gcloud alpha number-registry registry-books registry-nodes \ search --ip-range='192.168.0.0/24' \ - --registry-book=my-registry-book --location=global - -REQUIRED FLAGS - RegistryBook resource - Name of the parent resource The arguments in this - group can be used to specify the attributes of this resource. (NOTE) Some - attributes are not given arguments in this group but can be set in other - ways. - - To set the project attribute: - ◆ provide the argument --registry-book 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. - - --registry-book=REGISTRY_BOOK - ID of the registryBook or fully qualified identifier for the - registryBook. - - To set the registry-book attribute: - ▸ provide the argument --registry-book on the command line. - - This flag argument must be specified if any of the other arguments in - this group are specified. - - --location=LOCATION - locations TBD - - To set the location attribute: - ▸ provide the argument --registry-book on the command line with a - fully specified name; - ▸ provide the argument --location on the command line. - -FLAGS - --attribute-keys=[ATTRIBUTE_KEYS,...] - A list of attribute keys owned by the registry nodes. - - --ip-range=IP_RANGE - IP range to filter for registry node. - - --keywords=[KEYWORDS,...] - A list of keywords that are contained by the attribute values within - registry nodes. - - --source=SOURCE - Source filter of the registry nodes. - -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 cloudnumberregistry/v1alpha API. The full - documentation for this API can be found at: http://go/cloud-number-registry - -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/number-registry/registry-books/registry-nodes/update b/gcloud/alpha/number-registry/registry-books/registry-nodes/update deleted file mode 100644 index 94463aa7a..000000000 --- a/gcloud/alpha/number-registry/registry-books/registry-nodes/update +++ /dev/null @@ -1,245 +0,0 @@ -NAME - gcloud alpha number-registry registry-books registry-nodes update - update - the parameters of a single registry node resource - -SYNOPSIS - gcloud alpha number-registry registry-books registry-nodes update - (REGISTRY_NODE : --location=LOCATION --registry-book=REGISTRY_BOOK) - [--async] [--ip-range=IP_RANGE] - [--attribute=[description=DESCRIPTION],[key=KEY],[value=VALUE] - | --add-attribute=[description=DESCRIPTION],[key=KEY],[value=VALUE] - --clear-attribute - | --remove-attribute=[description=DESCRIPTION], - [key=KEY],[value=VALUE]] - [--import-info-source=IMPORT_INFO_SOURCE - --import-info-writer=IMPORT_INFO_WRITER] - [--labels=[LABELS,...] - | --update-labels=[UPDATE_LABELS,...] --clear-labels - | --remove-labels=[__REMOVE_LABELS,...]] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Update the parameters of a single registry node resource. - -EXAMPLES - To update the IP range of a registry node my-registry-node with a new IP - range 10.20.10.0/24 in location global run: - - $ gcloud alpha number-registry registry-books registry-nodes \ update my-registry-node --ip-range=10.20.10.0/24 \ - --location=global --registry-book=my-registry-book - -POSITIONAL ARGUMENTS - RegistryNode resource - Identifier. name of resource The arguments in this - group can be used to specify the attributes of this resource. (NOTE) Some - attributes are not given arguments in this group but can be set in other - ways. - - To set the project attribute: - ◆ provide the argument registry_node 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. - - REGISTRY_NODE - ID of the registryNode or fully qualified identifier for the - registryNode. - - To set the registry_node attribute: - ▸ provide the argument registry_node on the command line. - - This positional argument must be specified if any of the other - arguments in this group are specified. - - --location=LOCATION - locations TBD - - To set the location attribute: - ▸ provide the argument registry_node on the command line with a - fully specified name; - ▸ provide the argument --location on the command line. - - --registry-book=REGISTRY_BOOK - registryBooks TBD - - To set the registry-book attribute: - ▸ provide the argument registry_node on the command line with a - fully specified name; - ▸ provide the argument --registry-book on the command line. - -FLAGS - --async - Return immediately, without waiting for the operation in progress to - complete. - - --ip-range=IP_RANGE - IP range of registry node. - - Update attribute. - - At most one of these can be specified: - - --attribute=[description=DESCRIPTION],[key=KEY],[value=VALUE] - Set attribute to new value. Attributes represent the custom metadata - for registry node. - - description - The description of the registry node attribute. - - key - The key of the registry attribute. - - value - The value of the registry node attribute. - - Shorthand Example: - - --attribute=description=string,key=string,value=string --attribute=description=string,key=string,value=string - - JSON Example: - - --attribute='[{"description": "string", "key": "string", "value": "string"}]' - - File Example: - - --attribute=path_to_file.(yaml|json) - - --add-attribute=[description=DESCRIPTION],[key=KEY],[value=VALUE] - Add new value to attribute list. Attributes represent the custom - metadata for registry node. - - description - The description of the registry node attribute. - - key - The key of the registry attribute. - - value - The value of the registry node attribute. - - Shorthand Example: - - --add-attribute=description=string,key=string,value=string --add-attribute=description=string,key=string,value=string - - JSON Example: - - --add-attribute='[{"description": "string", "key": "string", "value": "string"}]' - - File Example: - - --add-attribute=path_to_file.(yaml|json) - - At most one of these can be specified: - - --clear-attribute - Clear attribute value and set to empty list. - - --remove-attribute=[description=DESCRIPTION],[key=KEY],[value=VALUE] - Remove existing value from attribute list. Attributes represent the - custom metadata for registry node. - - description - The description of the registry node attribute. - - key - The key of the registry attribute. - - value - The value of the registry node attribute. - - Shorthand Example: - - --remove-attribute=description=string,key=string,value=string --remove-attribute=description=string,key=string,value=string - - JSON Example: - - --remove-attribute='[{"description": "string", "key": "string", "value": "string"}]' - - File Example: - - --remove-attribute=path_to_file.(yaml|json) - - Message describing import metadata. - - --import-info-source=IMPORT_INFO_SOURCE - Resource name of imported source. - - --import-info-writer=IMPORT_INFO_WRITER - Writer of imported information. - - Update labels. - - At most one of these can be specified: - - --labels=[LABELS,...] - Set labels to new value. Labels as key value pairs - - KEY - Keys must start with a lowercase character and contain only - hyphens (-), underscores (_), lowercase characters, and numbers. - - VALUE - Values must contain only hyphens (-), underscores (_), lowercase - characters, and numbers. - - Shorthand Example: - - --labels=string=string - - JSON Example: - - --labels='{"string": "string"}' - - File Example: - - --labels=path_to_file.(yaml|json) - - --update-labels=[UPDATE_LABELS,...] - Update labels value or add key value pair. Labels as key value pairs - - KEY - Keys must start with a lowercase character and contain only - hyphens (-), underscores (_), lowercase characters, and numbers. - - VALUE - Values must contain only hyphens (-), underscores (_), lowercase - characters, and numbers. - - Shorthand Example: - - --update-labels=string=string - - JSON Example: - - --update-labels='{"string": "string"}' - - File Example: - - --update-labels=path_to_file.(yaml|json) - - At most one of these can be specified: - - --clear-labels - Clear labels value and set to empty map. - - --remove-labels=[__REMOVE_LABELS,...] - Remove existing value from map labels. - -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 cloudnumberregistry/v1alpha API. The full - documentation for this API can be found at: http://go/cloud-number-registry - -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/number-registry/registry-books/update b/gcloud/alpha/number-registry/registry-books/update deleted file mode 100644 index 102e0ffc1..000000000 --- a/gcloud/alpha/number-registry/registry-books/update +++ /dev/null @@ -1,135 +0,0 @@ -NAME - gcloud alpha number-registry registry-books update - update the parameters - of a single registry book resource - -SYNOPSIS - gcloud alpha number-registry registry-books update - (REGISTRY_BOOK : --location=LOCATION) [--async] - [--labels=[LABELS,...] - | --update-labels=[UPDATE_LABELS,...] --clear-labels - | --remove-labels=[__REMOVE_LABELS,...]] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Update a registry book resource. - -EXAMPLES - To update the name of a registry book my-registry-book in location global - run: - - $ gcloud alpha number-registry registry-books update \ - my-registry-book --location=global \ - --name="updated-registry-book" - -POSITIONAL ARGUMENTS - RegistryBook resource - Identifier. name of resource The arguments in this - group can be used to specify the attributes of this resource. (NOTE) Some - attributes are not given arguments in this group but can be set in other - ways. - - To set the project attribute: - ◆ provide the argument registry_book 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. - - REGISTRY_BOOK - ID of the registryBook or fully qualified identifier for the - registryBook. - - To set the registry_book attribute: - ▸ provide the argument registry_book on the command line. - - This positional argument must be specified if any of the other - arguments in this group are specified. - - --location=LOCATION - locations TBD - - To set the location attribute: - ▸ provide the argument registry_book on the command line with a - fully specified name; - ▸ provide the argument --location on the command line. - -FLAGS - --async - Return immediately, without waiting for the operation in progress to - complete. - - Update labels. - - At most one of these can be specified: - - --labels=[LABELS,...] - Set labels to new value. Labels as key value pairs - - KEY - Keys must start with a lowercase character and contain only - hyphens (-), underscores (_), lowercase characters, and numbers. - - VALUE - Values must contain only hyphens (-), underscores (_), lowercase - characters, and numbers. - - Shorthand Example: - - --labels=string=string - - JSON Example: - - --labels='{"string": "string"}' - - File Example: - - --labels=path_to_file.(yaml|json) - - --update-labels=[UPDATE_LABELS,...] - Update labels value or add key value pair. Labels as key value pairs - - KEY - Keys must start with a lowercase character and contain only - hyphens (-), underscores (_), lowercase characters, and numbers. - - VALUE - Values must contain only hyphens (-), underscores (_), lowercase - characters, and numbers. - - Shorthand Example: - - --update-labels=string=string - - JSON Example: - - --update-labels='{"string": "string"}' - - File Example: - - --update-labels=path_to_file.(yaml|json) - - At most one of these can be specified: - - --clear-labels - Clear labels value and set to empty map. - - --remove-labels=[__REMOVE_LABELS,...] - Remove existing value from map labels. - -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 cloudnumberregistry/v1alpha API. The full - documentation for this API can be found at: http://go/cloud-number-registry - -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/pubsub/subscriptions/create b/gcloud/alpha/pubsub/subscriptions/create index 0617de53e..6d2804e9e 100644 --- a/gcloud/alpha/pubsub/subscriptions/create +++ b/gcloud/alpha/pubsub/subscriptions/create @@ -16,7 +16,7 @@ SYNOPSIS : --bigquery-service-account-email=BIGQUERY_SERVICE_ACCOUNT_EMAIL --drop-unknown-fields --write-metadata --use-table-schema | --use-topic-schema] | [--cloud-storage-bucket=CLOUD_STORAGE_BUCKET - : --cloud-storage-file-datetime-format=CLOUD_STORAGE_FILE_DATETIME_FORMAT --cloud-storage-file-prefix=CLOUD_STORAGE_FILE_PREFIX --cloud-storage-file-suffix=CLOUD_STORAGE_FILE_SUFFIX --cloud-storage-max-bytes=CLOUD_STORAGE_MAX_BYTES --cloud-storage-max-duration=CLOUD_STORAGE_MAX_DURATION --cloud-storage-output-format=OUTPUT_FORMAT; default="text" --cloud-storage-service-account-email=CLOUD_STORAGE_SERVICE_ACCOUNT_EMAIL --cloud-storage-write-metadata]] + : --cloud-storage-file-datetime-format=CLOUD_STORAGE_FILE_DATETIME_FORMAT --cloud-storage-file-prefix=CLOUD_STORAGE_FILE_PREFIX --cloud-storage-file-suffix=CLOUD_STORAGE_FILE_SUFFIX --cloud-storage-max-bytes=CLOUD_STORAGE_MAX_BYTES --cloud-storage-max-duration=CLOUD_STORAGE_MAX_DURATION --cloud-storage-output-format=OUTPUT_FORMAT; default="text" --cloud-storage-service-account-email=CLOUD_STORAGE_SERVICE_ACCOUNT_EMAIL --cloud-storage-use-topic-schema --cloud-storage-write-metadata]] [--max-delivery-attempts=MAX_DELIVERY_ATTEMPTS [--dead-letter-topic=DEAD_LETTER_TOPIC : --dead-letter-topic-project=DEAD_LETTER_TOPIC_PROJECT]] @@ -242,6 +242,13 @@ OPTIONAL FLAGS unspecified, uses the Pub/Sub service agent (https://cloud.google.com/iam/docs/service-account-types#service-agents). + --cloud-storage-use-topic-schema + Whether or not to use the schema for the subscription's topic (if + it exists) when writing messages to Cloud Storage. This has an + effect only for subscriptions with + --cloud-storage-output-format=avro. Use + --no-cloud-storage-use-topic-schema to disable this flag. + --cloud-storage-write-metadata Whether or not to write the subscription name, message_id, publish_time, attributes, and ordering_key as additional fields in diff --git a/gcloud/alpha/pubsub/subscriptions/update b/gcloud/alpha/pubsub/subscriptions/update index 773d30470..060380b40 100644 --- a/gcloud/alpha/pubsub/subscriptions/update +++ b/gcloud/alpha/pubsub/subscriptions/update @@ -16,7 +16,7 @@ SYNOPSIS --drop-unknown-fields --write-metadata --use-table-schema | --use-topic-schema] | --clear-cloud-storage-config | [--cloud-storage-bucket=CLOUD_STORAGE_BUCKET - : --cloud-storage-file-datetime-format=CLOUD_STORAGE_FILE_DATETIME_FORMAT --cloud-storage-file-prefix=CLOUD_STORAGE_FILE_PREFIX --cloud-storage-file-suffix=CLOUD_STORAGE_FILE_SUFFIX --cloud-storage-max-bytes=CLOUD_STORAGE_MAX_BYTES --cloud-storage-max-duration=CLOUD_STORAGE_MAX_DURATION --cloud-storage-output-format=OUTPUT_FORMAT; default="text" --cloud-storage-service-account-email=CLOUD_STORAGE_SERVICE_ACCOUNT_EMAIL --cloud-storage-write-metadata]] + : --cloud-storage-file-datetime-format=CLOUD_STORAGE_FILE_DATETIME_FORMAT --cloud-storage-file-prefix=CLOUD_STORAGE_FILE_PREFIX --cloud-storage-file-suffix=CLOUD_STORAGE_FILE_SUFFIX --cloud-storage-max-bytes=CLOUD_STORAGE_MAX_BYTES --cloud-storage-max-duration=CLOUD_STORAGE_MAX_DURATION --cloud-storage-output-format=OUTPUT_FORMAT; default="text" --cloud-storage-service-account-email=CLOUD_STORAGE_SERVICE_ACCOUNT_EMAIL --cloud-storage-use-topic-schema --cloud-storage-write-metadata]] [--clear-dead-letter-policy | --max-delivery-attempts=MAX_DELIVERY_ATTEMPTS [--dead-letter-topic=DEAD_LETTER_TOPIC @@ -222,6 +222,13 @@ FLAGS If unspecified, uses the Pub/Sub service agent (https://cloud.google.com/iam/docs/service-account-types#service-agents). + --cloud-storage-use-topic-schema + Whether or not to use the schema for the subscription's topic (if + it exists) when writing messages to Cloud Storage. This has an + effect only for subscriptions with + --cloud-storage-output-format=avro. Use + --no-cloud-storage-use-topic-schema to disable this flag. + --cloud-storage-write-metadata Whether or not to write the subscription name, message_id, publish_time, attributes, and ordering_key as additional fields diff --git a/gcloud/alpha/number-registry/help b/gcloud/alpha/quotas/help similarity index 57% rename from gcloud/alpha/number-registry/help rename to gcloud/alpha/quotas/help index 4cca5770a..fec0e22c0 100644 --- a/gcloud/alpha/number-registry/help +++ b/gcloud/alpha/quotas/help @@ -1,11 +1,11 @@ NAME - gcloud alpha number-registry - manage cloud number registry resources + gcloud alpha quotas - manage Cloud Quotas quota info and quota preferences SYNOPSIS - gcloud alpha number-registry GROUP [GCLOUD_WIDE_FLAG ...] + gcloud alpha quotas GROUP [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Manage cloud number registry resources. + (ALPHA) Manage Cloud Quotas quota info and quota preferences. GCLOUD WIDE FLAGS These flags are available to all commands: --help. @@ -15,11 +15,11 @@ GCLOUD WIDE FLAGS GROUPS GROUP is one of the following: - operations - (ALPHA) Manage Operation resources. + info + (ALPHA) Manage Cloud Quotas QuotaInfo. - registry-books - (ALPHA) Manage registry book resources. + preferences + (ALPHA) Manage Cloud Quotas QuotaPreferences. NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/quotas/info/describe b/gcloud/alpha/quotas/info/describe new file mode 100644 index 000000000..88faa2dce --- /dev/null +++ b/gcloud/alpha/quotas/info/describe @@ -0,0 +1,55 @@ +NAME + gcloud alpha quotas info describe - retrieve the QuotaInfo of a quota for a + project, folder or organization + +SYNOPSIS + gcloud alpha quotas info describe QUOTA_ID --service=SERVICE + (--folder=FOLDER_ID | --organization=ORGANIZATION_ID + | --project=PROJECT_ID_OR_NUMBER) [GCLOUD_WIDE_FLAG ...] + +EXAMPLES + To get the details about quota CpusPerProject for service + example.googleapis.com and projects/my-project, run: + + $ gcloud alpha quotas info describe CpusPerProject \ + --service=example.googleapis.com --project=my-project + + To get the details about quota CpusPerProject for service + example.googleapis.com and folders/12345, run: + + $ gcloud alpha quotas info describe CpusPerProject \ + --service=example.googleapis.com --folder=12345 + +POSITIONAL ARGUMENTS + QUOTA_ID + ID of the quota, which is unique within the service. + +REQUIRED FLAGS + --service=SERVICE + Name of the service in which the quota is defined. + + Exactly one of these must be specified: + + --folder=FOLDER_ID + Folder of the quota info to describe. + + --organization=ORGANIZATION_ID + Organization of the quota info to describe. + + --project=PROJECT_ID_OR_NUMBER + Project of the quota info to describe. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/quotas/info/help b/gcloud/alpha/quotas/info/help new file mode 100644 index 000000000..5c6d81c9a --- /dev/null +++ b/gcloud/alpha/quotas/info/help @@ -0,0 +1,46 @@ +NAME + gcloud alpha quotas info - manage Cloud Quotas QuotaInfo + +SYNOPSIS + gcloud alpha quotas info COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) QuotaInfo is a read-only resource that provides metadata and quota + value information about a particular quota for a given project, folder or + organization. The QuotaInfo resource contains: + + ▪ Metadata such as name and dimension. + ▪ Quota values for different quota dimensions. + + Cloud Quotas obtains information from the quotas defined by Google Cloud + services and any fulfilled quota adjustments that you initiate. + + Note: Because QuotaInfo is constructed by incorporating information from + different sources, a default quota configuration exists even if you have + not created a QuotaPreference resource. Until you express a preferred state + through quotaPreference.create or quotaPreference.update, QuotaInfo relies + on the default quota information available to determine what quota value to + enforce. + +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) Retrieve the QuotaInfo of a quota for a project, folder or + organization. + + list + (ALPHA) List QuotaInfos of all quotas for a given project, folder or + organization. + +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/number-registry/registry-books/list b/gcloud/alpha/quotas/info/list similarity index 63% rename from gcloud/alpha/number-registry/registry-books/list rename to gcloud/alpha/quotas/info/list index c59973696..eafcd0284 100644 --- a/gcloud/alpha/number-registry/registry-books/list +++ b/gcloud/alpha/quotas/info/list @@ -1,38 +1,49 @@ NAME - gcloud alpha number-registry registry-books list - list registry book - resources + gcloud alpha quotas info list - list QuotaInfos of all quotas for a given + project, folder or organization SYNOPSIS - gcloud alpha number-registry registry-books list --location=LOCATION + gcloud alpha quotas info list --service=SERVICE + (--folder=FOLDER_ID | --organization=ORGANIZATION_ID + | --project=PROJECT_ID_OR_NUMBER) [--page-token=PAGE_TOKEN] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] -DESCRIPTION - (ALPHA) List registry book resources. - EXAMPLES - To list all registry books in location global run: + To list all quota info for service example.googleapis.com and + projects/12321, run: - $ gcloud alpha number-registry registry-books list --location=global + $ gcloud alpha quotas info list --service=example.googleapis.com \ + --project=12321 + $ gcloud alpha quotas info list --service=example.googleapis.com \ + --project=my-project-id + + To list first 100 quota info ordered alphabetically for service + `example.googleapis.com` and `folders/12321`, + run: + + $ gcloud alpha quotas info list --service=example.googleapis.com \ + --folder=12321 --page-size=100 REQUIRED FLAGS - Location resource - Parent value for ListRegistryBooksRequest This - represents a Cloud resource. (NOTE) Some attributes are not given - arguments in this group but can be set in other ways. + --service=SERVICE + Name of the service in which the quota is defined. - To set the project attribute: - ◆ provide the argument --location on the command line with a fully - specified name; - ◆ set the property core/project; - ◆ provide the argument --project on the command line. + Exactly one of these must be specified: - This must be specified. + --folder=FOLDER_ID + Folder of the quota info to list. - --location=LOCATION - ID of the location or fully qualified identifier for the location. + --organization=ORGANIZATION_ID + Organization of the quota info to list. - To set the location attribute: - ▸ provide the argument --location on the command line. + --project=PROJECT_ID_OR_NUMBER + Project of the quota info to list. + +FLAGS + --page-token=PAGE_TOKEN + A token identifying a page of results the server should return. Default + is none. LIST COMMAND FLAGS --filter=EXPRESSION @@ -74,10 +85,6 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. -API REFERENCE - This command uses the cloudnumberregistry/v1alpha API. The full - documentation for this API can be found at: http://go/cloud-number-registry - 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/quotas/preferences/create b/gcloud/alpha/quotas/preferences/create new file mode 100644 index 000000000..218fb31fb --- /dev/null +++ b/gcloud/alpha/quotas/preferences/create @@ -0,0 +1,97 @@ +NAME + gcloud alpha quotas preferences create - create a new QuotaPreference that + declares the desired value for a quota + +SYNOPSIS + gcloud alpha quotas preferences create --preferred-value=PREFERRED_VALUE + --quota-id=QUOTA_ID --service=SERVICE + (--folder=FOLDER_ID | --organization=ORGANIZATION_ID + | --project=PROJECT_ID_OR_NUMBER) + [--allow-high-percentage-quota-decrease] + [--allow-quota-decrease-below-usage] [--dimensions=[KEY=VALUE,...]] + [--email=EMAIL] [--justification=JUSTIFICATION] + [--preference-id=PREFERENCE_ID] [GCLOUD_WIDE_FLAG ...] + +EXAMPLES + To create a quota preference in region us-central1 that applies to the + default_limit quota under service example.googleapis.com for + projects/12321, run: + + $ gcloud alpha quotas preferences create \ + --service=example.googleapis.com --project=12321 \ + --quota-id=default_limit --preferred-value=100 \ + --dimensions=region=us-central1 \ + --preference-id=example_default-limit_us-central1 + + To create a quota preference under service example.googleapis.com for + organizations/123 with random preference ID, run: + + $ gcloud alpha quotas preferences create \ + --service=example.googleapis.com --organization=123 \ + --quota-id=default_limit --preferred-value=200 + +REQUIRED FLAGS + --preferred-value=PREFERRED_VALUE + Preferred value. Must be greater than or equal to -1. If set to -1, it + means the value is "unlimited". + + --quota-id=QUOTA_ID + ID of the quota, which is unique within the service. + + --service=SERVICE + Name of the service in which the quota is defined. + + Exactly one of these must be specified: + + --folder=FOLDER_ID + Folder of the quota preference to create. + + --organization=ORGANIZATION_ID + Organization of the quota preference to create. + + --project=PROJECT_ID_OR_NUMBER + Project of the quota preference to create. + +OPTIONAL FLAGS + --allow-high-percentage-quota-decrease + If specified, allows you to reduce your effective limit by more than 10 + percent. Default is false. + + --allow-quota-decrease-below-usage + If specified, allows you to reduce your effective limit below your + quota usage. Default is false. + + --dimensions=[KEY=VALUE,...] + Dimensions of the quota. + + --email=EMAIL + An optional email address that can be used for quota related + communication between the Google Cloud and the user in case the Google + Cloud needs further information to make a decision on whether the user + preferred quota can be granted. The Google account for the email + address must have quota update permission for the project, folder or + organization this quota preference is for. If no contact email address + is provided, or the provided email address does not have the required + quota update permission, the quota preference request will be denied in + case further information is required to make a decision. + + --justification=JUSTIFICATION + A short statement to justify quota increase requests. + + --preference-id=PREFERENCE_ID + ID of the Quota Preference object, must be unique under its parent. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/quotas/preferences/describe b/gcloud/alpha/quotas/preferences/describe new file mode 100644 index 000000000..e803df9ea --- /dev/null +++ b/gcloud/alpha/quotas/preferences/describe @@ -0,0 +1,54 @@ +NAME + gcloud alpha quotas preferences describe - get details about a single + QuotaPreference + +SYNOPSIS + gcloud alpha quotas preferences describe PREFERENCE_ID + (--folder=FOLDER_ID | --organization=ORGANIZATION_ID + | --project=PROJECT_ID_OR_NUMBER) [GCLOUD_WIDE_FLAG ...] + +EXAMPLES + To get the details about quota preference my-preference for projects/12321, + run: + + $ gcloud alpha quotas preferences describe my-preference \ + --project=12321 + $ gcloud alpha quotas preferences describe my-preference \ + --project=my-project-id + + To get the details about quota preference my-preference for folders/12345, + run: + + $ gcloud alpha quotas preferences describe my-preference \ + --folder=12345 + +POSITIONAL ARGUMENTS + PREFERENCE_ID + ID of the Quota Preference object, must be unique under its parent. + +REQUIRED FLAGS + Exactly one of these must be specified: + + --folder=FOLDER_ID + Folder of the quota preference to describe. + + --organization=ORGANIZATION_ID + Organization of the quota preference to describe. + + --project=PROJECT_ID_OR_NUMBER + Project of the quota preference to describe. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/quotas/preferences/help b/gcloud/alpha/quotas/preferences/help new file mode 100644 index 000000000..ed01f4ab5 --- /dev/null +++ b/gcloud/alpha/quotas/preferences/help @@ -0,0 +1,43 @@ +NAME + gcloud alpha quotas preferences - manage Cloud Quotas QuotaPreferences + +SYNOPSIS + gcloud alpha quotas preferences COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) A QuotaPreference resource represents your preference for a + particular dimension combination. Use this resource to make quota increase + adjustments to quotas in your projects and to make quota decrease + adjustments to quotas in your projects, folders or organizations. Quota + increase adjustments are subject to approval and fulfillment. Quota + decreases are fulfilled immediately. Use the Cloud Quotas console UI or API + to set a quota preference. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (ALPHA) Create a new QuotaPreference that declares the desired value + for a quota. + + describe + (ALPHA) Get details about a single QuotaPreference. + + list + (ALPHA) List QuotaPreferences in a given project, folder or + organization. + + update + (ALPHA) Update the parameters of a single QuotaPreference. + +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/quotas/preferences/list b/gcloud/alpha/quotas/preferences/list new file mode 100644 index 000000000..0d7ca59d2 --- /dev/null +++ b/gcloud/alpha/quotas/preferences/list @@ -0,0 +1,97 @@ +NAME + gcloud alpha quotas preferences list - list QuotaPreferences in a given + project, folder or organization + +SYNOPSIS + gcloud alpha quotas preferences list + (--folder=FOLDER_ID | --organization=ORGANIZATION_ID + | --project=PROJECT_ID_OR_NUMBER) [--page-token=PAGE_TOKEN] + [--reconciling-only] [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +EXAMPLES + To list the quota preferences for projects/12321, run: + + $ gcloud alpha quotas preferences list --project=12321 + $ gcloud alpha quotas preferences list --project=my-project-id + + To list first 10 quota preferences ordered by create time for folder/12345, + run: + + $ gcloud alpha quotas preferences list --folder=12345 \ + --page-size=10 --sort-by=create_time + + To list all quota preferences in unresolved state in region us-central1 for + organization/987, run: + + $ gcloud alpha quotas preferences list --organization=987 \ + --filter=dimensions.region:us-central1 --reconciling-only + +REQUIRED FLAGS + Exactly one of these must be specified: + + --folder=FOLDER_ID + Folder of the quota preferences to list. + + --organization=ORGANIZATION_ID + Organization of the quota preferences to list. + + --project=PROJECT_ID_OR_NUMBER + Project of the quota preferences to list. + +FLAGS + --page-token=PAGE_TOKEN + A token identifying a page of results the server should return. Default + is none. + + --reconciling-only + If specified, only displays quota preferences in unresolved states. + Default is false. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/quotas/preferences/update b/gcloud/alpha/quotas/preferences/update new file mode 100644 index 000000000..53e29ccba --- /dev/null +++ b/gcloud/alpha/quotas/preferences/update @@ -0,0 +1,109 @@ +NAME + gcloud alpha quotas preferences update - update the parameters of a single + QuotaPreference + +SYNOPSIS + gcloud alpha quotas preferences update PREFERENCE_ID + --preferred-value=PREFERRED_VALUE --quota-id=QUOTA_ID --service=SERVICE + (--folder=FOLDER_ID | --organization=ORGANIZATION_ID + | --project=PROJECT_ID_OR_NUMBER) + [--allow-high-percentage-quota-decrease] [--allow-missing] + [--allow-quota-decrease-below-usage] [--dimensions=[KEY=VALUE,...]] + [--email=EMAIL] [--justification=JUSTIFICATION] [--validate-only] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) This command updates an existing or creates a new QuotaPreference. + It can updates the config in any states, not just the ones pending + approval. + +EXAMPLES + To update a quota preference with id my-preference in region us-central1 + that applies to the default_limit quota for projects/12321, run: + + $ gcloud alpha quotas preferences update my-preference \ + --service=example.googleapis.com --project=12321 \ + --quota-id=default_limit --preferred-value=100 \ + --dimensions=region=us-central1 + + To create a new quota preference for organizations/123, run: + + $ gcloud alpha quotas preferences update my-preference \ + --service=example.googleapis.com --organization=123 \ + --quota-id=default_limit --preferred-value=200 --allow-missing + +POSITIONAL ARGUMENTS + PREFERENCE_ID + ID of the Quota Preference object, must be unique under its parent. + +REQUIRED FLAGS + --preferred-value=PREFERRED_VALUE + Preferred value. Must be greater than or equal to -1. If set to -1, it + means the value is "unlimited". + + --quota-id=QUOTA_ID + ID of the quota, which is unique within the service. + + --service=SERVICE + Name of the service in which the quota is defined. + + Exactly one of these must be specified: + + --folder=FOLDER_ID + Folder of the quota preference to update. + + --organization=ORGANIZATION_ID + Organization of the quota preference to update. + + --project=PROJECT_ID_OR_NUMBER + Project of the quota preference to update. + +OPTIONAL FLAGS + --allow-high-percentage-quota-decrease + If specified, allows you to reduce your effective limit by more than 10 + percent. Default is false. + + --allow-missing + If specified and the quota preference is not found, a new one will be + created. Default is false. + + --allow-quota-decrease-below-usage + If specified, allows you to reduce your effective limit below your + quota usage. Default is false. + + --dimensions=[KEY=VALUE,...] + Dimensions of the quota. + + --email=EMAIL + An optional email address that can be used for quota related + communication between the Google Cloud and the user in case the Google + Cloud needs further information to make a decision on whether the user + preferred quota can be granted. The Google account for the email + address must have quota update permission for the project, folder or + organization this quota preference is for. If no contact email address + is provided, or the provided email address does not have the required + quota update permission, the quota preference request will be denied in + case further information is required to make a decision. + + --justification=JUSTIFICATION + A short statement to justify quota increase requests. + + --validate-only + If specified, only validates the request, but does not actually update. + Note that a request being valid does not mean that the request is + guaranteed to be fulfilled. Default is false. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/resource-settings/describe b/gcloud/alpha/resource-settings/describe index 5b16a2892..8994a6c87 100644 --- a/gcloud/alpha/resource-settings/describe +++ b/gcloud/alpha/resource-settings/describe @@ -8,7 +8,13 @@ SYNOPSIS | --project=PROJECT_ID) [--effective] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Show the value of a resource setting. + (ALPHA) (DEPRECATED) Show the value of a resource setting. + + Resource Settings is deprecated. As of November 7, 2023, no organizations + will be onboarded for any of the enabled settings, and the service will be + shut down on October 1, 2024. + + Show the value of a resource setting. EXAMPLES To describe the resource settings net-preferredDnsServers with the project diff --git a/gcloud/alpha/resource-settings/help b/gcloud/alpha/resource-settings/help index 1f5383390..7d0d913ca 100644 --- a/gcloud/alpha/resource-settings/help +++ b/gcloud/alpha/resource-settings/help @@ -5,8 +5,14 @@ SYNOPSIS gcloud alpha resource-settings COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) The gcloud Resource Settings command group lets you create and - manipulate resource settings. + (ALPHA) (DEPRECATED) Create and manage Resource Settings. + + Resource Settings is deprecated. As of November 7, 2023, no organizations + will be onboarded for any of the enabled settings, and the service will be + shut down on October 1, 2024. + + The gcloud Resource Settings command group lets you create and manipulate + resource settings. The Resource Settings Service is a hierarchy-aware service with a public-facing API for users to store settings that modify the behavior of @@ -25,19 +31,20 @@ COMMANDS COMMAND is one of the following: describe - (ALPHA) Show the value of a resource setting. + (ALPHA) (DEPRECATED) Show the value of a resource setting. list - (ALPHA) List all available resource settings. + (ALPHA) (DEPRECATED) List all available resource settings. list-values - (ALPHA) List the values for any configured resource settings. + (ALPHA) (DEPRECATED) List the values for any configured resource + settings. set-value - (ALPHA) Update the value of a resource setting. + (ALPHA) (DEPRECATED) Update the value of a resource setting. unset-value - (ALPHA) Remove the value of a resource setting. + (ALPHA) (DEPRECATED) Remove the value of a resource setting. NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/resource-settings/list b/gcloud/alpha/resource-settings/list index b2c86176a..77c52ac1e 100644 --- a/gcloud/alpha/resource-settings/list +++ b/gcloud/alpha/resource-settings/list @@ -9,7 +9,13 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) List all available resource settings. + (ALPHA) (DEPRECATED) List all available resource settings. + + Resource Settings is deprecated. As of November 7, 2023, no organizations + will be onboarded for any of the enabled settings, and the service will be + shut down on October 1, 2024. + + List all available resource settings. EXAMPLES To list all available resource settings with the project foo-project, run: diff --git a/gcloud/alpha/resource-settings/list-values b/gcloud/alpha/resource-settings/list-values index dbade7071..2c67ec8bc 100644 --- a/gcloud/alpha/resource-settings/list-values +++ b/gcloud/alpha/resource-settings/list-values @@ -10,7 +10,13 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) List the values for any configured resource settings. + (ALPHA) (DEPRECATED) List the values for any configured resource settings. + + Resource Settings is deprecated. As of November 7, 2023, no organizations + will be onboarded for any of the enabled settings, and the service will be + shut down on October 1, 2024. + + List the values for any configured resource settings. EXAMPLES To list all setting values on the project foo-project, run: diff --git a/gcloud/alpha/resource-settings/set-value b/gcloud/alpha/resource-settings/set-value index 31c9eb323..a39326afd 100644 --- a/gcloud/alpha/resource-settings/set-value +++ b/gcloud/alpha/resource-settings/set-value @@ -7,7 +7,13 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Update the value of a resource setting. + (ALPHA) (DEPRECATED) Update the value of a resource setting. + + Resource Settings is deprecated. As of November 7, 2023, no organizations + will be onboarded for any of the enabled settings, and the service will be + shut down on October 1, 2024. + + Update the value of a resource setting. EXAMPLES To set the resource setting from the file with the path ./sample_path, run: diff --git a/gcloud/alpha/resource-settings/unset-value b/gcloud/alpha/resource-settings/unset-value index f95729e3b..155c5e76b 100644 --- a/gcloud/alpha/resource-settings/unset-value +++ b/gcloud/alpha/resource-settings/unset-value @@ -8,9 +8,15 @@ SYNOPSIS | --project=PROJECT_ID) [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Remove the value of a resource setting. This reverts the resource - to inheriting the resource settings from above it in the resource - hierarchy, if any is set on a resource above it. + (ALPHA) (DEPRECATED) Remove the value of a resource setting. + + Resource Settings is deprecated. As of November 7, 2023, no organizations + will be onboarded for any of the enabled settings, and the service will be + shut down on October 1, 2024. + + Remove the value of a resource setting. This reverts the resource to + inheriting the resource settings from above it in the resource hierarchy, + if any is set on a resource above it. EXAMPLES To unset the resource settings net-preferredDnsServers with the project diff --git a/gcloud/alpha/spanner/help b/gcloud/alpha/spanner/help index 63c5246ac..8f1816336 100644 --- a/gcloud/alpha/spanner/help +++ b/gcloud/alpha/spanner/help @@ -24,6 +24,9 @@ GROUPS instance-configs (ALPHA) Manage Cloud Spanner instance configs. + instance-partitions + (ALPHA) Manage Cloud Spanner instance partitions. + instances (ALPHA) Manage Cloud Spanner instances. diff --git a/gcloud/alpha/spanner/instance-partitions/create b/gcloud/alpha/spanner/instance-partitions/create new file mode 100644 index 000000000..88ba7e84c --- /dev/null +++ b/gcloud/alpha/spanner/instance-partitions/create @@ -0,0 +1,93 @@ +NAME + gcloud alpha spanner instance-partitions create - create a Cloud Spanner + instance partition + +SYNOPSIS + gcloud alpha spanner instance-partitions create + (INSTANCE_PARTITION : --instance=INSTANCE) --config=CONFIG + --description=DESCRIPTION [--async] + [--nodes=NODES | --processing-units=PROCESSING_UNITS] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create a Cloud Spanner instance partition. + +EXAMPLES + To create a Cloud Spanner instance partition, run: + + $ gcloud alpha spanner instance-partitions create \ + my-instance-partition-id --instance=my-instance-id \ + --config=regional-us-east1 \ + --description=my-instance-display-name --nodes=3 + +POSITIONAL ARGUMENTS + Instance partition resource - The Cloud Spanner instance partition to + create. The arguments in this group can be used to specify the attributes + of this resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument instance_partition 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. + + INSTANCE_PARTITION + ID of the instance-partition or fully qualified identifier for the + instance-partition. + + To set the instance-partition attribute: + ▸ provide the argument instance_partition on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --instance=INSTANCE + The Cloud Spanner instance for the instance-partition. + + To set the instance attribute: + ▸ provide the argument instance_partition on the command line with + a fully specified name; + ▸ provide the argument --instance on the command line; + ▸ set the property spanner/instance. + +REQUIRED FLAGS + --config=CONFIG + Instance configuration defines the geographic placement and replication + used by the instance partition. Available configurations can be found + by running "gcloud spanner instance-configs list" + + --description=DESCRIPTION + Description of the instance partition. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + At most one of these can be specified: + + --nodes=NODES + Number of nodes for the instance partition. + + --processing-units=PROCESSING_UNITS + Number of processing units for the instance partition. + +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 beta spanner instance-partitions create + diff --git a/gcloud/alpha/spanner/instance-partitions/delete b/gcloud/alpha/spanner/instance-partitions/delete new file mode 100644 index 000000000..5d478990c --- /dev/null +++ b/gcloud/alpha/spanner/instance-partitions/delete @@ -0,0 +1,66 @@ +NAME + gcloud alpha spanner instance-partitions delete - delete a Cloud Spanner + instance partition + +SYNOPSIS + gcloud alpha spanner instance-partitions delete + (INSTANCE_PARTITION : --instance=INSTANCE) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete a Cloud Spanner instance partition. + +EXAMPLES + To delete a Cloud Spanner instance partition, run: + + $ gcloud alpha spanner instance-partitions delete \ + my-instance-partition-id --instance=my-instance-id + +POSITIONAL ARGUMENTS + Instance partition resource - The Cloud Spanner instance partition 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 instance_partition 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. + + INSTANCE_PARTITION + ID of the instance-partition or fully qualified identifier for the + instance-partition. + + To set the instance-partition attribute: + ▸ provide the argument instance_partition on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --instance=INSTANCE + The Cloud Spanner instance for the instance-partition. + + To set the instance attribute: + ▸ provide the argument instance_partition on the command line with + a fully specified name; + ▸ provide the argument --instance on the command line; + ▸ set the property spanner/instance. + +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 beta spanner instance-partitions delete + diff --git a/gcloud/alpha/spanner/instance-partitions/describe b/gcloud/alpha/spanner/instance-partitions/describe new file mode 100644 index 000000000..fb45c1c87 --- /dev/null +++ b/gcloud/alpha/spanner/instance-partitions/describe @@ -0,0 +1,66 @@ +NAME + gcloud alpha spanner instance-partitions describe - describe a Cloud + Spanner instance partition + +SYNOPSIS + gcloud alpha spanner instance-partitions describe + (INSTANCE_PARTITION : --instance=INSTANCE) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe a Cloud Spanner instance partition. + +EXAMPLES + To describe a Cloud Spanner instance partition, run: + + $ gcloud alpha spanner instance-partitions describe \ + my-instance-partition-id --instance=my-instance-id + +POSITIONAL ARGUMENTS + Instance partition resource - The Cloud Spanner instance partition 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 instance_partition 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. + + INSTANCE_PARTITION + ID of the instance-partition or fully qualified identifier for the + instance-partition. + + To set the instance-partition attribute: + ▸ provide the argument instance_partition on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --instance=INSTANCE + The Cloud Spanner instance for the instance-partition. + + To set the instance attribute: + ▸ provide the argument instance_partition on the command line with + a fully specified name; + ▸ provide the argument --instance on the command line; + ▸ set the property spanner/instance. + +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 beta spanner instance-partitions describe + diff --git a/gcloud/alpha/spanner/instance-partitions/help b/gcloud/alpha/spanner/instance-partitions/help new file mode 100644 index 000000000..be2f3914f --- /dev/null +++ b/gcloud/alpha/spanner/instance-partitions/help @@ -0,0 +1,42 @@ +NAME + gcloud alpha spanner instance-partitions - manage Cloud Spanner instance + partitions + +SYNOPSIS + gcloud alpha spanner instance-partitions COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Cloud Spanner instance partitions. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (ALPHA) Create a Cloud Spanner instance partition. + + delete + (ALPHA) Delete a Cloud Spanner instance partition. + + describe + (ALPHA) Describe a Cloud Spanner instance partition. + + list + (ALPHA) List the Cloud Spanner instance partitions contained within the + given instance. + + update + (ALPHA) Update a Cloud Spanner instance partition. + +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 spanner instance-partitions + diff --git a/gcloud/alpha/spanner/instance-partitions/list b/gcloud/alpha/spanner/instance-partitions/list new file mode 100644 index 000000000..93db0533a --- /dev/null +++ b/gcloud/alpha/spanner/instance-partitions/list @@ -0,0 +1,79 @@ +NAME + gcloud alpha spanner instance-partitions list - list the Cloud Spanner + instance partitions contained within the given instance + +SYNOPSIS + gcloud alpha spanner instance-partitions list [--instance=INSTANCE] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List the Cloud Spanner instance partitions contained within the + given instance. + +EXAMPLES + To list all Cloud Spanner instances partitions in an instance, run: + + $ gcloud alpha spanner instance-partitions list \ + --instance=my-instance-id + +FLAGS + Instance resource - The Cloud Spanner instance in which to list instance + partitions. 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 --instance on the command line with a fully + specified name; + ◆ set the property spanner/instance with a fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --instance=INSTANCE + ID of the instance or fully qualified identifier for the instance. + + To set the instance attribute: + ▸ provide the argument --instance on the command line; + ▸ set the property spanner/instance. + +LIST COMMAND FLAGS + --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 beta spanner instance-partitions list + diff --git a/gcloud/alpha/spanner/instance-partitions/update b/gcloud/alpha/spanner/instance-partitions/update new file mode 100644 index 000000000..2b434aee1 --- /dev/null +++ b/gcloud/alpha/spanner/instance-partitions/update @@ -0,0 +1,91 @@ +NAME + gcloud alpha spanner instance-partitions update - update a Cloud Spanner + instance partition + +SYNOPSIS + gcloud alpha spanner instance-partitions update + (INSTANCE_PARTITION : --instance=INSTANCE) [--async] + [--description=DESCRIPTION] + [--nodes=NODES | --processing-units=PROCESSING_UNITS] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Update a Cloud Spanner instance partition. + +EXAMPLES + To update the display name of a Cloud Spanner instance partition, run: + + $ gcloud alpha spanner instance-partitions update \ + my-instance-partition-id --instance=my-instance-id \ + --description=my-new-display-name + + To update the node count of a Cloud Spanner instance partition, run: + + $ gcloud alpha spanner instance-partitions update \ + my-instance-partition-id --instance=my-instance-id --nodes=1 + +POSITIONAL ARGUMENTS + Instance partition resource - The Cloud Spanner instance partition 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 instance_partition 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. + + INSTANCE_PARTITION + ID of the instance-partition or fully qualified identifier for the + instance-partition. + + To set the instance-partition attribute: + ▸ provide the argument instance_partition on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --instance=INSTANCE + The Cloud Spanner instance for the instance-partition. + + To set the instance attribute: + ▸ provide the argument instance_partition on the command line with + a fully specified name; + ▸ provide the argument --instance on the command line; + ▸ set the property spanner/instance. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + Description of the instance partition. + + At most one of these can be specified: + + --nodes=NODES + Number of nodes for the instance partition. + + --processing-units=PROCESSING_UNITS + Number of processing units for the instance partition. + +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 beta spanner instance-partitions update + diff --git a/gcloud/alpha/spanner/operations/cancel b/gcloud/alpha/spanner/operations/cancel index deeaa2a0d..710cff988 100644 --- a/gcloud/alpha/spanner/operations/cancel +++ b/gcloud/alpha/spanner/operations/cancel @@ -4,7 +4,8 @@ NAME SYNOPSIS gcloud alpha spanner operations cancel OPERATION-ID (--instance=INSTANCE | --instance-config=INSTANCE_CONFIG) - [--backup=BACKUP] [--database=DATABASE] [GCLOUD_WIDE_FLAG ...] + [--backup=BACKUP] [--database=DATABASE] + [--instance-partition=INSTANCE_PARTITION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Cancel a Cloud Spanner operation. @@ -53,6 +54,10 @@ OPTIONAL FLAGS For a database operation, the name of the database the operation is executing on. + --instance-partition=INSTANCE_PARTITION + For instance partition operations, the name of the instance partition + the operation is executing on. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/spanner/operations/describe b/gcloud/alpha/spanner/operations/describe index e2894209b..cd722f448 100644 --- a/gcloud/alpha/spanner/operations/describe +++ b/gcloud/alpha/spanner/operations/describe @@ -5,7 +5,8 @@ NAME SYNOPSIS gcloud alpha spanner operations describe OPERATION-ID (--instance=INSTANCE | --instance-config=INSTANCE_CONFIG) - [--backup=BACKUP] [--database=DATABASE] [GCLOUD_WIDE_FLAG ...] + [--backup=BACKUP] [--database=DATABASE] + [--instance-partition=INSTANCE_PARTITION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Describe a Cloud Spanner operation. @@ -53,6 +54,10 @@ OPTIONAL FLAGS For a database operation, the name of the database the operation is executing on. + --instance-partition=INSTANCE_PARTITION + For instance partition operations, the name of the instance partition + the operation is executing on. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/spanner/operations/list b/gcloud/alpha/spanner/operations/list index ca93de477..757fe40f1 100644 --- a/gcloud/alpha/spanner/operations/list +++ b/gcloud/alpha/spanner/operations/list @@ -4,7 +4,8 @@ NAME SYNOPSIS gcloud alpha spanner operations list (--instance=INSTANCE | --instance-config=INSTANCE_CONFIG) - [--backup=BACKUP] [--database=DATABASE] [--type=TYPE] + [--backup=BACKUP] [--database=DATABASE] + [--instance-partition=INSTANCE_PARTITION] [--type=TYPE] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] @@ -71,6 +72,10 @@ FLAGS For database operations, the name of the database the operations are executing on. + --instance-partition=INSTANCE_PARTITION + For instance partition operations, the name of the instance partition + the operation is executing on. + --type=TYPE (optional) List only the operations of the given type. TYPE must be one of: diff --git a/gcloud/alpha/storage/folders/create b/gcloud/alpha/storage/folders/create new file mode 100644 index 000000000..1be20a233 --- /dev/null +++ b/gcloud/alpha/storage/folders/create @@ -0,0 +1,53 @@ +NAME + gcloud alpha storage folders create - create folders for hierarchical + namespace bucket + +SYNOPSIS + gcloud alpha storage folders create URL [URL ...] + [--additional-headers=HEADER=VALUE] [--recursive] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create folders. + +EXAMPLES + The following command creates a folder called folder/ in a bucket named + my-bucket: + + $ gcloud alpha storage folders create gs://my-bucket/folder/ + + The following command creates all folders in the path A/B/C/D in a bucket + named my-bucket: + + $ gcloud alpha storage folders create \ + --recursive gs://my-bucket/folder/A/B/C/D + +POSITIONAL ARGUMENTS + URL [URL ...] + The URLs of the folders to create. + +FLAGS + --additional-headers=HEADER=VALUE + Includes arbitrary headers in storage API calls. Accepts a comma + separated list of key=value pairs, e.g. header1=value1,header2=value2. + Overrides the default storage/additional_headers property value for + this command invocation. + + --recursive + Recursively create all folders in a given path if they do not alraedy + exist. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/storage/folders/delete b/gcloud/alpha/storage/folders/delete new file mode 100644 index 000000000..430cda7a5 --- /dev/null +++ b/gcloud/alpha/storage/folders/delete @@ -0,0 +1,41 @@ +NAME + gcloud alpha storage folders delete - delete folders + +SYNOPSIS + gcloud alpha storage folders delete URLS [URLS ...] + [--additional-headers=HEADER=VALUE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete folders. + +EXAMPLES + The following command deletes a folder named folder in a hierarchical + namesapce bucket called my-bucket: + + $ gcloud alpha storage folders delete gs://my-bucket/folder/ + +POSITIONAL ARGUMENTS + URLS [URLS ...] + The URLs of the folders to delete. + +FLAGS + --additional-headers=HEADER=VALUE + Includes arbitrary headers in storage API calls. Accepts a comma + separated list of key=value pairs, e.g. header1=value1,header2=value2. + Overrides the default storage/additional_headers property value for + this command invocation. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/storage/folders/describe b/gcloud/alpha/storage/folders/describe new file mode 100644 index 000000000..a4fa1d9ac --- /dev/null +++ b/gcloud/alpha/storage/folders/describe @@ -0,0 +1,46 @@ +NAME + gcloud alpha storage folders describe - describe hierarchical namesapace + bucket folders + +SYNOPSIS + gcloud alpha storage folders describe URL + [--additional-headers=HEADER=VALUE] [--raw] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe hierarchical namespace bucket folders. + +EXAMPLES + The following command shows information about a folder named folder in an + hierarchical namespace bucket called my-bucket: + + $ gcloud alpha storage folders describe gs://my-bucket/folder/ + +POSITIONAL ARGUMENTS + URL + The URL of the folder to describe. + +FLAGS + --additional-headers=HEADER=VALUE + Includes arbitrary headers in storage API calls. Accepts a comma + separated list of key=value pairs, e.g. header1=value1,header2=value2. + Overrides the default storage/additional_headers property value for + this command invocation. + + --raw + Shows metadata in the format returned by the API instead of + standardizing it. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/number-registry/operations/help b/gcloud/alpha/storage/folders/help similarity index 56% rename from gcloud/alpha/number-registry/operations/help rename to gcloud/alpha/storage/folders/help index 8a5ebe8dd..aa81591ee 100644 --- a/gcloud/alpha/number-registry/operations/help +++ b/gcloud/alpha/storage/folders/help @@ -1,11 +1,11 @@ NAME - gcloud alpha number-registry operations - manage Operation resources + gcloud alpha storage folders - manage Cloud Storage folders SYNOPSIS - gcloud alpha number-registry operations COMMAND [GCLOUD_WIDE_FLAG ...] + gcloud alpha storage folders COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Manage Operation resources. + (ALPHA) Manage Cloud Storage folders. GCLOUD WIDE FLAGS These flags are available to all commands: --help. @@ -15,20 +15,17 @@ GCLOUD WIDE FLAGS COMMANDS COMMAND is one of the following: - cancel - (ALPHA) Cancel operations. + create + (ALPHA) Create folders for hierarchical namespace bucket. delete - (ALPHA) Delete operations. + (ALPHA) Delete folders. describe - (ALPHA) Describe operations. + (ALPHA) Describe hierarchical namesapace bucket folders. list - (ALPHA) List operations. - - wait - (ALPHA) Wait operations. + (ALPHA) List folders. NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/storage/folders/list b/gcloud/alpha/storage/folders/list new file mode 100644 index 000000000..72568fdf1 --- /dev/null +++ b/gcloud/alpha/storage/folders/list @@ -0,0 +1,95 @@ +NAME + gcloud alpha storage folders list - list folders + +SYNOPSIS + gcloud alpha storage folders list URL [URL ...] + [--additional-headers=HEADER=VALUE] [--raw] [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List folders. + +EXAMPLES + The following command lists all folders in a hierarchical namespace bucket: + + $ gcloud alpha storage folders list gs://my-bucket/ + + The following command lists all folders under a parent folder: + + $ gcloud alpha storage folders list gs://my-bucket/parent-folder/ + + You can use wildcards (https://cloud.google.com/storage/docs/wildcards) to + match multiple paths (including multiple buckets). Bucket wildcards are + expanded to match only buckets contained in your current project. The + following command matches folders that are stored in buckets in your + project that begin with my-b: + + $ gcloud alpha storage folders list gs://my-b*/ + + Following is another example where we are listing all folders that begin + with ``B'' under a given bucket: + + $ gcloud alpha storage folders list gs://my-bucket/B* + +POSITIONAL ARGUMENTS + URL [URL ...] + The URLs of the resources to list. + +FLAGS + --additional-headers=HEADER=VALUE + Includes arbitrary headers in storage API calls. Accepts a comma + separated list of key=value pairs, e.g. header1=value1,header2=value2. + Overrides the default storage/additional_headers property value for + this command invocation. + + --raw + Shows metadata in the format returned by the API instead of + standardizing it. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/storage/help b/gcloud/alpha/storage/help index 883e49221..a13d330be 100644 --- a/gcloud/alpha/storage/help +++ b/gcloud/alpha/storage/help @@ -23,6 +23,9 @@ GROUPS buckets (ALPHA) Manage Cloud Storage buckets. + folders + (ALPHA) Manage Cloud Storage folders. + hmac (ALPHA) Manage Cloud Storage service account HMAC keys. diff --git a/gcloud/beta/alloydb/instances/create b/gcloud/beta/alloydb/instances/create index 1da6ca5c8..6f8a90389 100644 --- a/gcloud/beta/alloydb/instances/create +++ b/gcloud/beta/alloydb/instances/create @@ -7,6 +7,7 @@ SYNOPSIS --cpu-count=CPU_COUNT --instance-type=INSTANCE_TYPE --region=REGION [--allowed-psc-projects=[ALLOWED_PSC_PROJECTS,...]] [--assign-inbound-public-ip=ASSIGN_INBOUND_PUBLIC_IP] [--async] + [--authorized-external-networks=[AUTHORIZED_NETWORK,...]] [--availability-type=AVAILABILITY_TYPE] [--database-flags=FLAG=VALUE,[FLAG=VALUE,...]] [--insights-config-query-plans-per-minute=INSIGHTS_CONFIG_QUERY_PLANS_PER_MINUTE] @@ -71,19 +72,25 @@ OPTIONAL FLAGS --allowed-psc-projects=project1,12345678,project2) --assign-inbound-public-ip=ASSIGN_INBOUND_PUBLIC_IP - Specify to enable or disable public IP on an instance. On instance - creation only disabling public IP is allowed. If you want to enable - public IP, an instance must be created with public IP disabled first, - then update the instance to enable public IP. ASSIGN_INBOUND_PUBLIC_IP - must be (only one value is supported): - - NO_PUBLIC_IP - This disables public IP on the instance. + Specify to enable or disable public IP on an instance. + ASSIGN_INBOUND_PUBLIC_IP must be one of: + ◆ NO_PUBLIC_IP + ▸ This disables public IP on the instance. Updating an instance to + disable public IP will clear the list of authorized networks. + ◆ ASSIGN_IPV4 + ▸ Assign an inbound public IPv4 address for the instance. Public IP + is enabled. --async Return immediately, without waiting for the operation in progress to complete. + --authorized-external-networks=[AUTHORIZED_NETWORK,...] + Comma-separated list of authorized external networks to set on the + instance. Authorized networks should use CIDR notation (e.g. + 1.2.3.4/30). This flag is only allowed to be set for instances with + public IP enabled. + --availability-type=AVAILABILITY_TYPE Specifies level of availability. AVAILABILITY_TYPE must be one of: diff --git a/gcloud/beta/alloydb/instances/create-secondary b/gcloud/beta/alloydb/instances/create-secondary index 2d65fb370..9bcaa98e0 100644 --- a/gcloud/beta/alloydb/instances/create-secondary +++ b/gcloud/beta/alloydb/instances/create-secondary @@ -5,9 +5,9 @@ NAME SYNOPSIS gcloud beta alloydb instances create-secondary INSTANCE --cluster=CLUSTER --region=REGION [--assign-inbound-public-ip=ASSIGN_INBOUND_PUBLIC_IP] - [--async] [--availability-type=AVAILABILITY_TYPE] - [--[no-]require-connectors] [--ssl-mode=SSL_MODE] - [GCLOUD_WIDE_FLAG ...] + [--async] [--authorized-external-networks=[AUTHORIZED_NETWORK,...]] + [--availability-type=AVAILABILITY_TYPE] [--[no-]require-connectors] + [--ssl-mode=SSL_MODE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Creates a new AlloyDB SECONDARY instance within a given cluster. @@ -32,19 +32,25 @@ REQUIRED FLAGS OPTIONAL FLAGS --assign-inbound-public-ip=ASSIGN_INBOUND_PUBLIC_IP - Specify to enable or disable public IP on an instance. On instance - creation only disabling public IP is allowed. If you want to enable - public IP, an instance must be created with public IP disabled first, - then update the instance to enable public IP. ASSIGN_INBOUND_PUBLIC_IP - must be (only one value is supported): - - NO_PUBLIC_IP - This disables public IP on the instance. + Specify to enable or disable public IP on an instance. + ASSIGN_INBOUND_PUBLIC_IP must be one of: + ◆ NO_PUBLIC_IP + ▸ This disables public IP on the instance. Updating an instance to + disable public IP will clear the list of authorized networks. + ◆ ASSIGN_IPV4 + ▸ Assign an inbound public IPv4 address for the instance. Public IP + is enabled. --async Return immediately, without waiting for the operation in progress to complete. + --authorized-external-networks=[AUTHORIZED_NETWORK,...] + Comma-separated list of authorized external networks to set on the + instance. Authorized networks should use CIDR notation (e.g. + 1.2.3.4/30). This flag is only allowed to be set for instances with + public IP enabled. + --availability-type=AVAILABILITY_TYPE Specifies level of availability. AVAILABILITY_TYPE must be one of: diff --git a/gcloud/beta/alloydb/instances/update b/gcloud/beta/alloydb/instances/update index deb4de29d..8813a4744 100644 --- a/gcloud/beta/alloydb/instances/update +++ b/gcloud/beta/alloydb/instances/update @@ -53,7 +53,7 @@ OPTIONAL FLAGS ▸ This disables public IP on the instance. Updating an instance to disable public IP will clear the list of authorized networks. ◆ ASSIGN_IPV4 - ▸ Assign an inbound public IPv4 address for the instance. public IP + ▸ Assign an inbound public IPv4 address for the instance. Public IP is enabled. --async diff --git a/gcloud/beta/builds/worker-pools/update b/gcloud/beta/builds/worker-pools/update index f4c113d86..faed9f8b8 100644 --- a/gcloud/beta/builds/worker-pools/update +++ b/gcloud/beta/builds/worker-pools/update @@ -4,8 +4,8 @@ NAME SYNOPSIS gcloud beta builds worker-pools update WORKER_POOL --region=REGION - (--config-from-file=CONFIG_FROM_FILE | --public-egress - | --no-public-egress --worker-disk-size=WORKER_DISK_SIZE + (--config-from-file=CONFIG_FROM_FILE | --[no-]public-egress + --worker-disk-size=WORKER_DISK_SIZE --worker-machine-type=WORKER_MACHINE_TYPE) [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -38,20 +38,15 @@ REQUIRED FLAGS Command-line flags to configure the private pool: - Network configuration for Service Networking: + --[no-]public-egress + If set to true, workers in the worker pool are created with an + external IP address. - At most one of these can be specified: + If set to false, workers in the worker pool are created without an + external IP address. If the worker pool is within a VPC Service + Control perimeter, use this flag. - --public-egress - If set, workers in the worker pool are created with an external - IP address. - - --no-public-egress - If set, workers in the worker pool are created without an - external IP address. - - If the worker pool is within a VPC Service Control perimeter, - use this flag. + Use --public-egress to enable and --no-public-egress to disable. Configuration to be used for creating workers in the worker pool: diff --git a/gcloud/beta/compute/images/list b/gcloud/beta/compute/images/list index 886f858de..808a16459 100644 --- a/gcloud/beta/compute/images/list +++ b/gcloud/beta/compute/images/list @@ -57,9 +57,9 @@ FLAGS --standard-images List images from public image projects. The public image projects that - are available include the following: centos-cloud, cos-cloud, - debian-cloud, fedora-coreos-cloud, opensuse-cloud, rhel-cloud, - rhel-sap-cloud, rocky-linux-cloud, suse-cloud, suse-sap-cloud, + are available include the following: cos-cloud, debian-cloud, + rocky-linux-cloud, centos-cloud, fedora-coreos-cloud, opensuse-cloud, + rhel-cloud, rhel-sap-cloud, suse-cloud, suse-sap-cloud, ubuntu-os-cloud, ubuntu-os-pro-cloud, windows-cloud, windows-sql-cloud. Enabled by default, use --no-standard-images to disable. diff --git a/gcloud/beta/compute/instance-groups/managed/update b/gcloud/beta/compute/instance-groups/managed/update index 29f010754..61421d1da 100644 --- a/gcloud/beta/compute/instance-groups/managed/update +++ b/gcloud/beta/compute/instance-groups/managed/update @@ -10,7 +10,7 @@ SYNOPSIS [--list-managed-instances-results=MODE] [--remove-stateful-disks=DEVICE_NAME,[DEVICE_NAME,...]] [--remove-stateful-external-ips=INTERFACE_NAME,[...]] - [--remove-stateful-internal-ips=INTERFACE_NAME,[...]] + [--remove-stateful-internal-ips=INTERFACE_NAME,[...]] [--size=SIZE] [--standby-policy-initial-delay=STANDBY_POLICY_INITIAL_DELAY] [--standby-policy-mode=STANDBY_POLICY_MODE] [--stateful-disk=[auto-delete=AUTO-DELETE],[device-name=DEVICE-NAME]] @@ -133,6 +133,9 @@ FLAGS Remove stateful configuration for the specified interfaces for internal IPs. + --size=SIZE + Target number of running instances in managed instance group. + --standby-policy-initial-delay=STANDBY_POLICY_INITIAL_DELAY Specifies the number of seconds that the MIG should wait before suspending or stopping a VM. The initial delay gives the initialization diff --git a/gcloud/beta/container/clusters/create b/gcloud/beta/container/clusters/create index d824c32dc..2f5ef50dd 100644 --- a/gcloud/beta/container/clusters/create +++ b/gcloud/beta/container/clusters/create @@ -66,7 +66,7 @@ SYNOPSIS [--placement-policy=PLACEMENT_POLICY] [--placement-type=PLACEMENT_TYPE] [--preemptible] [--private-endpoint-subnetwork=NAME] [--private-ipv6-google-access-type=PRIVATE_IPV6_GOOGLE_ACCESS_TYPE] - [--release-channel=CHANNEL] [--resource-manager-tags=[KEY=VALUE,...]] + [--release-channel=[CHANNEL]] [--resource-manager-tags=[KEY=VALUE,...]] [--security-group=SECURITY_GROUP] [--security-posture=SECURITY_POSTURE] [--services-ipv4-cidr=CIDR] [--services-secondary-range-name=NAME] [--shielded-integrity-monitoring] [--shielded-secure-boot] [--spot] @@ -1063,7 +1063,7 @@ FLAGS PRIVATE_IPV6_GOOGLE_ACCESS_TYPE must be one of: bidirectional, disabled, outbound-only. - --release-channel=CHANNEL + --release-channel=[CHANNEL] Release channel a cluster is subscribed to. If left unspecified and a version is specified, the cluster is enrolled @@ -1079,10 +1079,8 @@ FLAGS CHANNEL must be one of: - None - Use 'None' to opt-out of any release channel. + rapid - rapid 'rapid' channel is offered on an early access basis for customers who want to test new releases. @@ -1090,14 +1088,23 @@ FLAGS to unresolved issues with no known workaround and are not subject to any SLAs. - regular + regular + Clusters subscribed to 'regular' receive versions that are considered GA quality. 'regular' is intended for production users who want to take advantage of new features. - stable + + stable + Clusters subscribed to 'stable' receive versions that are known to be stable and reliable in production. + None + + Use 'None' to opt-out of any release channel. + + CHANNEL must be one of: rapid, regular, stable, None. + --resource-manager-tags=[KEY=VALUE,...] Applies the specified comma-separated resource manager tags that has the GCE_FIREWALL purpose to all nodes in the new default node pool(s) @@ -1144,6 +1151,9 @@ FLAGS To disable in an existing cluster, explicitly set the flag to --security-posture=disabled. + For more information on enablement, see + https://cloud.google.com/kubernetes-engine/docs/concepts/about-security-posture-dashboard#feature-enablement. + SECURITY_POSTURE must be one of: disabled, standard, enterprise. --services-ipv4-cidr=CIDR @@ -1342,6 +1352,9 @@ FLAGS To disable in an existing cluster, explicitly set the flag to --workload-vulnerability-scanning=disabled. + For more information on enablement, see + https://cloud.google.com/kubernetes-engine/docs/concepts/about-security-posture-dashboard#feature-enablement. + WORKLOAD_VULNERABILITY_SCANNING must be one of: disabled, standard, enterprise. diff --git a/gcloud/beta/container/clusters/create-auto b/gcloud/beta/container/clusters/create-auto index 8a7e5be50..88aa7e282 100644 --- a/gcloud/beta/container/clusters/create-auto +++ b/gcloud/beta/container/clusters/create-auto @@ -21,7 +21,7 @@ SYNOPSIS [--fleet-project=PROJECT_ID_OR_NUMBER] [--labels=[KEY=VALUE,...]] [--logging=[COMPONENT,...]] [--monitoring=[COMPONENT,...]] [--network=NETWORK] [--private-endpoint-subnetwork=NAME] - [--release-channel=CHANNEL] [--security-group=SECURITY_GROUP] + [--release-channel=[CHANNEL]] [--security-group=SECURITY_GROUP] [--security-posture=SECURITY_POSTURE] [--services-ipv4-cidr=CIDR] [--services-secondary-range-name=NAME] [--subnetwork=SUBNETWORK] [--workload-policies=WORKLOAD_POLICIES] @@ -311,7 +311,7 @@ FLAGS Sets the subnetwork GKE uses to provision the control plane's private endpoint. - --release-channel=CHANNEL + --release-channel=[CHANNEL] Release channel a cluster is subscribed to. If left unspecified and a version is specified, the cluster is enrolled @@ -327,7 +327,8 @@ FLAGS CHANNEL must be one of: - rapid + rapid + 'rapid' channel is offered on an early access basis for customers who want to test new releases. @@ -335,14 +336,19 @@ FLAGS to unresolved issues with no known workaround and are not subject to any SLAs. - regular + regular + Clusters subscribed to 'regular' receive versions that are considered GA quality. 'regular' is intended for production users who want to take advantage of new features. - stable + + stable + Clusters subscribed to 'stable' receive versions that are known to be stable and reliable in production. + CHANNEL must be one of: rapid, regular, stable. + --security-group=SECURITY_GROUP The name of the RBAC security group for use with Google security groups in Kubernetes RBAC @@ -367,6 +373,9 @@ FLAGS To disable in an existing cluster, explicitly set the flag to --security-posture=disabled. + For more information on enablement, see + https://cloud.google.com/kubernetes-engine/docs/concepts/about-security-posture-dashboard#feature-enablement. + SECURITY_POSTURE must be one of: disabled, standard, enterprise. --services-ipv4-cidr=CIDR @@ -417,6 +426,9 @@ FLAGS To disable in an existing cluster, explicitly set the flag to --workload-vulnerability-scanning=disabled. + For more information on enablement, see + https://cloud.google.com/kubernetes-engine/docs/concepts/about-security-posture-dashboard#feature-enablement. + WORKLOAD_VULNERABILITY_SCANNING must be one of: disabled, standard, enterprise. diff --git a/gcloud/beta/container/clusters/update b/gcloud/beta/container/clusters/update index 0e92e778b..b5b0deb90 100644 --- a/gcloud/beta/container/clusters/update +++ b/gcloud/beta/container/clusters/update @@ -36,7 +36,7 @@ SYNOPSIS | --notification-config=[pubsub=ENABLED|DISABLED, pubsub-topic=TOPIC,...] | --private-ipv6-google-access-type=PRIVATE_IPV6_GOOGLE_ACCESS_TYPE - | --release-channel=CHANNEL | --remove-labels=[KEY,...] + | --release-channel=[CHANNEL] | --remove-labels=[KEY,...] | --remove-workload-policies=REMOVE_WORKLOAD_POLICIES | --security-group=SECURITY_GROUP | --security-posture=SECURITY_POSTURE | --set-password @@ -574,7 +574,7 @@ REQUIRED FLAGS PRIVATE_IPV6_GOOGLE_ACCESS_TYPE must be one of: bidirectional, disabled, outbound-only. - --release-channel=CHANNEL + --release-channel=[CHANNEL] Subscribe or unsubscribe this cluster to a release channel. When a cluster is subscribed to a release channel, Google maintains @@ -585,10 +585,8 @@ REQUIRED FLAGS CHANNEL must be one of: - None - Use 'None' to opt-out of any release channel. + rapid - rapid 'rapid' channel is offered on an early access basis for customers who want to test new releases. @@ -596,13 +594,22 @@ REQUIRED FLAGS to unresolved issues with no known workaround and are not subject to any SLAs. - regular + regular + Clusters subscribed to 'regular' receive versions that are considered GA quality. 'regular' is intended for production users who want to take advantage of new features. - stable - Clusters subscribed to 'stable' receive versions that are known - to be stable and reliable in production. + + stable + + Clusters subscribed to 'stable' receive versions that are known to + be stable and reliable in production. + + None + + Use 'None' to opt-out of any release channel. + + CHANNEL must be one of: rapid, regular, stable, None. --remove-labels=[KEY,...] Labels to remove from the Google Cloud resources in use by the @@ -647,6 +654,9 @@ REQUIRED FLAGS To disable in an existing cluster, explicitly set the flag to --security-posture=disabled. + For more information on enablement, see + https://cloud.google.com/kubernetes-engine/docs/concepts/about-security-posture-dashboard#feature-enablement. + SECURITY_POSTURE must be one of: disabled, standard, enterprise. --set-password @@ -735,6 +745,9 @@ REQUIRED FLAGS To disable in an existing cluster, explicitly set the flag to --workload-vulnerability-scanning=disabled. + For more information on enablement, see + https://cloud.google.com/kubernetes-engine/docs/concepts/about-security-posture-dashboard#feature-enablement. + WORKLOAD_VULNERABILITY_SCANNING must be one of: disabled, standard, enterprise. diff --git a/gcloud/beta/dataflow/help b/gcloud/beta/dataflow/help index 7eb69c17a..2a14a16c3 100644 --- a/gcloud/beta/dataflow/help +++ b/gcloud/beta/dataflow/help @@ -41,7 +41,8 @@ GROUPS snapshots. sql - (BETA) A group of subcommands for working with Dataflow SQL. + (BETA) (DEPRECATED) A group of subcommands for working with Dataflow + SQL. yaml (BETA) A group of subcommands for launching Beam YAML jobs on Dataflow. diff --git a/gcloud/beta/dataflow/sql/help b/gcloud/beta/dataflow/sql/help index 0b45ef8da..1eb8b4271 100644 --- a/gcloud/beta/dataflow/sql/help +++ b/gcloud/beta/dataflow/sql/help @@ -6,7 +6,13 @@ SYNOPSIS gcloud beta dataflow sql COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) A group of subcommands for working with Dataflow SQL. + (BETA) (DEPRECATED) A group of subcommands for working with Dataflow SQL. + + This command is deprecated and will be removed January 31, 2025. Please see + Beam YAML (https://beam.apache.org/documentation/sdks/yaml/) and Beam + notebooks + (https://cloud.google.com/dataflow/docs/guides/notebook-advanced#beam-sql) + for alternatives. GCLOUD WIDE FLAGS These flags are available to all commands: --help. @@ -17,7 +23,7 @@ COMMANDS COMMAND is one of the following: query - (BETA) Execute the user-specified SQL query on Dataflow. + (BETA) (DEPRECATED) Execute the user-specified SQL query on Dataflow. NOTES This command is currently in beta and might change without notice. This diff --git a/gcloud/beta/dataflow/sql/query b/gcloud/beta/dataflow/sql/query index fda89aecd..fba8e8979 100644 --- a/gcloud/beta/dataflow/sql/query +++ b/gcloud/beta/dataflow/sql/query @@ -20,9 +20,15 @@ SYNOPSIS | --zone=ZONE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Execute the user-specified SQL query on Dataflow. Queries must - comply to the ZetaSQL dialect (https://github.com/google/zetasql). Results - may be written to either BigQuery or Cloud Pub/Sub. + (BETA) (DEPRECATED) This command is deprecated and will be removed January + 31, 2025. Please see Beam YAML + (https://beam.apache.org/documentation/sdks/yaml/) and Beam notebooks + (https://cloud.google.com/dataflow/docs/guides/notebook-advanced#beam-sql) + for alternatives. + + Execute the user-specified SQL query on Dataflow. Queries must comply to + the ZetaSQL dialect (https://github.com/google/zetasql). Results may be + written to either BigQuery or Cloud Pub/Sub. EXAMPLES To execute a simple SQL query on Dataflow that reads from and writes to diff --git a/gcloud/beta/domains/registrations/google-domains-dns/export-dns-record-sets b/gcloud/beta/domains/registrations/google-domains-dns/export-dns-record-sets new file mode 100644 index 000000000..0b4bd0e01 --- /dev/null +++ b/gcloud/beta/domains/registrations/google-domains-dns/export-dns-record-sets @@ -0,0 +1,84 @@ +NAME + gcloud beta domains registrations google-domains-dns export-dns-record-sets + - export your registration's Google Domains DNS zone's record-sets into + a file + +SYNOPSIS + gcloud beta domains registrations google-domains-dns export-dns-record-sets + REGISTRATION --records-file=RECORDS_FILE [--zone-file-format] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Export your registration's Google Domains DNS (deprecated) zone's + record-sets into a file. The formats you can export to are YAML records + format (default) and BIND zone file format. + +EXAMPLES + To export DNS record-sets of example.com into a YAML file, run: + + $ gcloud domains registrations google-domains-dns \ + export-dns-record-sets example.com --records-file=records.yaml + + To export DNS record-sets of example.com into a BIND zone formatted file, + run: + + $ gcloud domains registrations google-domains-dns \ + export-dns-record-sets example.com \ + --records-file=records.zonefile --zone-file-format + +POSITIONAL ARGUMENTS + Registration resource - The domain registration to get the DNS records + 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 registration on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument registration on the command line with a fully + specified name; + ◆ location is always global. + + This must be specified. + + REGISTRATION + ID of the registration or fully qualified identifier for the + registration. + + To set the registration attribute: + ▸ provide the argument registration on the command line. + +REQUIRED FLAGS + --records-file=RECORDS_FILE + File to which record-sets should be exported. + +OPTIONAL FLAGS + --zone-file-format + Indicates that records-file should be in the zone file format. When + using this flag, expect the record-set to be exported to a BIND zone + formatted file. If you omit this flag, the record-set is exported into + a YAML formatted records file. Note, this format flag determines the + format of the output recorded in the records-file; it is different from + the global --format flag which affects console output alone. + +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 domains registrations google-domains-dns \ + export-dns-record-sets + + $ gcloud alpha domains registrations google-domains-dns \ + export-dns-record-sets + diff --git a/gcloud/beta/domains/registrations/google-domains-dns/get-forwarding-config b/gcloud/beta/domains/registrations/google-domains-dns/get-forwarding-config new file mode 100644 index 000000000..1fbfd8c18 --- /dev/null +++ b/gcloud/beta/domains/registrations/google-domains-dns/get-forwarding-config @@ -0,0 +1,61 @@ +NAME + gcloud beta domains registrations google-domains-dns get-forwarding-config + - get forwarding configuration of a specific Cloud Domains registration + +SYNOPSIS + gcloud beta domains registrations google-domains-dns get-forwarding-config + REGISTRATION [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Get forwarding configuration (deprecated) of a specific + registration. + +EXAMPLES + To get forwarding configuration of example.com, run: + + $ gcloud domains registrations google-domains-dns \ + get-forwarding-config example.com + +POSITIONAL ARGUMENTS + Registration resource - The domain registration to get the forwarding + config 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 registration on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument registration on the command line with a fully + specified name; + ◆ location is always global. + + This must be specified. + + REGISTRATION + ID of the registration or fully qualified identifier for the + registration. + + To set the registration attribute: + ▸ provide the argument registration on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud domains registrations google-domains-dns \ + get-forwarding-config + + $ gcloud alpha domains registrations google-domains-dns \ + get-forwarding-config + diff --git a/gcloud/beta/domains/registrations/google-domains-dns/help b/gcloud/beta/domains/registrations/google-domains-dns/help new file mode 100644 index 000000000..911af7122 --- /dev/null +++ b/gcloud/beta/domains/registrations/google-domains-dns/help @@ -0,0 +1,36 @@ +NAME + gcloud beta domains registrations google-domains-dns - manage deprecated + Google Domains DNS configuration + +SYNOPSIS + gcloud beta domains registrations google-domains-dns COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Commands for managing DNS records and forwarding configuration of + Cloud Domains registrations that use deprecated Google Domains DNS. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + export-dns-record-sets + (BETA) Export your registration's Google Domains DNS zone's record-sets + into a file. + + get-forwarding-config + (BETA) Get forwarding configuration of a specific Cloud Domains + registration. + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud domains registrations google-domains-dns + + $ gcloud alpha domains registrations google-domains-dns + diff --git a/gcloud/beta/domains/registrations/help b/gcloud/beta/domains/registrations/help index 18aa74fa9..34e33012e 100644 --- a/gcloud/beta/domains/registrations/help +++ b/gcloud/beta/domains/registrations/help @@ -22,6 +22,9 @@ GROUPS (BETA) Configure Cloud Domains registrations' management, DNS or contact settings. + google-domains-dns + (BETA) Manage deprecated Google Domains DNS configuration. + operations (BETA) Manage Cloud Domains operations. diff --git a/gcloud/beta/filestore/instances/create b/gcloud/beta/filestore/instances/create index c85f5eb80..931a48d42 100644 --- a/gcloud/beta/filestore/instances/create +++ b/gcloud/beta/filestore/instances/create @@ -12,7 +12,7 @@ SYNOPSIS [--location=LOCATION] [--managed-ad=[computer=COMPUTER],[domain=DOMAIN]] [--protocol=PROTOCOL; default="NFS_V3"] [--region=REGION] - [--tier=TIER; default="BASIC_HDD"] + [--source-instance=SOURCE_INSTANCE] [--tier=TIER; default="BASIC_HDD"] [--kms-key=KMS_KEY : --kms-keyring=KMS_KEYRING --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT] [GCLOUD_WIDE_FLAG ...] @@ -32,7 +32,7 @@ EXAMPLES --zone=ZONE --kms-key=KMS-KEY --kms-keyring=KMS_KEYRING \ --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT \ --managed-ad=domain=DOMAIN,computer=COMPUTER \ - --flags-file=FLAGS_FILE + --flags-file=FLAGS_FILE --source-instance=SOURCE_INSTANCE Example json configuration file: { "--file-share": { "capacity": "61440", @@ -253,6 +253,9 @@ OPTIONAL FLAGS --region=REGION Region of the Cloud Filestore instance. + --source-instance=SOURCE_INSTANCE + The replication source instance of the Cloud Filestore instance. + --tier=TIER; default="BASIC_HDD" The service tier for the Cloud Filestore instance. For more details, see: https://cloud.google.com/filestore/docs/instance-tiers diff --git a/gcloud/beta/filestore/instances/help b/gcloud/beta/filestore/instances/help index 7dc4d8273..1e69926ac 100644 --- a/gcloud/beta/filestore/instances/help +++ b/gcloud/beta/filestore/instances/help @@ -33,6 +33,9 @@ COMMANDS list (BETA) List Filestore instances. + promote-replica + (BETA) Promote a Filestore standby replication instance. + restore (BETA) Restore a Filestore instance from a backup. diff --git a/gcloud/beta/filestore/instances/promote-replica b/gcloud/beta/filestore/instances/promote-replica new file mode 100644 index 000000000..64d8e32a9 --- /dev/null +++ b/gcloud/beta/filestore/instances/promote-replica @@ -0,0 +1,79 @@ +NAME + gcloud beta filestore instances promote-replica - promote a Filestore + standby replication instance + +SYNOPSIS + gcloud beta filestore instances promote-replica (INSTANCE : --zone=ZONE) + [--async] [--location=LOCATION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Promote a Filestore standby replication instance to a regular + instance. + + This command can fail for the following reasons: + ▪ The target instance does not exist. + ▪ The instance is not a standby replication member. + +EXAMPLES + To promote an instance with the name my-instance that's located in + us-central1, run: + + $ gcloud beta filestore instances promote-replica my-instance \ + --zone=us-central1 + +POSITIONAL ARGUMENTS + Instance resource - Arguments and flags that specify the Filestore + instance to promote. The arguments in this group can be used to specify + the attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument instance on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + INSTANCE + ID of the instance or fully qualified identifier for the instance. + + To set the instance attribute: + ▸ provide the argument instance on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --zone=ZONE + The zone of the Filestore instance. + + To set the zone attribute: + ▸ provide the argument instance on the command line with a fully + specified name; + ▸ provide the argument --zone on the command line; + ▸ provide the argument --location on the command line; + ▸ set the property filestore/zone. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --location=LOCATION + Location of the Filestore instance to promote. + +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 file/v1beta1 API. The full documentation for this API + can be found at: https://cloud.google.com/filestore/ + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/functions/deploy b/gcloud/beta/functions/deploy index 3951e05dd..ce8fbd40b 100644 --- a/gcloud/beta/functions/deploy +++ b/gcloud/beta/functions/deploy @@ -107,7 +107,8 @@ FLAGS --build-service-account=BUILD_SERVICE_ACCOUNT IAM service account whose credentials will be used for the build step. Must be of the format - projects/${PROJECT_ID}/serviceAccounts/${ACCOUNT_EMAIL_ADDRESS}. + projects/${PROJECT_ID}/serviceAccounts/${ACCOUNT_EMAIL_ADDRESS} or + {ACCOUNT_EMAIL_ADDRESS}. If not provided, the function will use the project's default service account for Cloud Build. diff --git a/gcloud/beta/iam/principal-access-boundary-policies/help b/gcloud/beta/iam/principal-access-boundary-policies/help index 8ea648ddc..67eaaa473 100644 --- a/gcloud/beta/iam/principal-access-boundary-policies/help +++ b/gcloud/beta/iam/principal-access-boundary-policies/help @@ -26,6 +26,9 @@ COMMANDS describe (BETA) Get PrincipalAccessBoundaryPolicy instance. + list + (BETA) List PrincipalAccessBoundaryPolicy instances. + search-policy-bindings (BETA) Search Principal Access Boundary Policy Bindings. diff --git a/gcloud/alpha/number-registry/registry-books/registry-nodes/list b/gcloud/beta/iam/principal-access-boundary-policies/list similarity index 57% rename from gcloud/alpha/number-registry/registry-books/registry-nodes/list rename to gcloud/beta/iam/principal-access-boundary-policies/list index a9e1693b7..1fc2ec029 100644 --- a/gcloud/alpha/number-registry/registry-books/registry-nodes/list +++ b/gcloud/beta/iam/principal-access-boundary-policies/list @@ -1,54 +1,47 @@ NAME - gcloud alpha number-registry registry-books registry-nodes list - list - registry node resources in a registry book + gcloud beta iam principal-access-boundary-policies list - list + PrincipalAccessBoundaryPolicy instances SYNOPSIS - gcloud alpha number-registry registry-books registry-nodes list - (--registry-book=REGISTRY_BOOK : --location=LOCATION) + gcloud beta iam principal-access-boundary-policies list + (--location=LOCATION : --organization=ORGANIZATION) [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) List registry node resources in a registry book. + (BETA) List PrincipalAccessBoundaryPolicy instances. EXAMPLES - To list all registry nodes in registry book my-registry-book in location - global run: + To list all policy instances in organization 123, run: - $ gcloud alpha number-registry registry-books registry-nodes list \ - --registry-book=my-registry-book --location=global + $ gcloud beta iam principal-access-boundary-policies list \ + --organization=123 --location=global REQUIRED FLAGS - RegistryBook resource - Parent value for ListRegistryNodesRequest 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. + Location resource - The parent resource, which owns the collection of + principal access boundary policies. - To set the project attribute: - ◆ provide the argument --registry-book on the command line with a fully - specified name; - ◆ set the property core/project; - ◆ provide the argument --project on the command line. + Format: organizations/{organization_id}/locations/{location} The arguments + in this group can be used to specify the attributes of this resource. This must be specified. - --registry-book=REGISTRY_BOOK - ID of the registryBook or fully qualified identifier for the - registryBook. + --location=LOCATION + ID of the location or fully qualified identifier for the location. - To set the registry-book attribute: - ▸ provide the argument --registry-book on the command line. + To set the location attribute: + ▸ provide the argument --location on the command line. This flag argument must be specified if any of the other arguments in this group are specified. - --location=LOCATION - locations TBD + --organization=ORGANIZATION + The organization id of the location resource. - To set the location attribute: - ▸ provide the argument --registry-book on the command line with a - fully specified name; - ▸ provide the argument --location on the command line. + To set the organization attribute: + ▸ provide the argument --location on the command line with a fully + specified name; + ▸ provide the argument --organization on the command line. LIST COMMAND FLAGS --filter=EXPRESSION @@ -91,12 +84,9 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the cloudnumberregistry/v1alpha API. The full - documentation for this API can be found at: http://go/cloud-number-registry + This command uses the iam/v3beta API. The full documentation for this API + can be found at: https://cloud.google.com/iam/ 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 command is currently in beta and might change without notice. diff --git a/gcloud/beta/iap/settings/get b/gcloud/beta/iap/settings/get index b01e37310..4311170e5 100644 --- a/gcloud/beta/iap/settings/get +++ b/gcloud/beta/iap/settings/get @@ -4,6 +4,7 @@ NAME SYNOPSIS gcloud beta iap settings get [--folder=FOLDER --organization=ORGANIZATION --project=PROJECT + --region=REGION --resource-type=RESOURCE_TYPE --service=SERVICE --version=VERSION] [GCLOUD_WIDE_FLAG ...] @@ -55,6 +56,12 @@ EXAMPLES $ gcloud beta iap settings get --project=PROJECT_ID \ --resource-type=compute --service=SERVICE_ID + To get the IAP setting for a regional backend service within a project, + run: + + $ gcloud beta iap settings get --project=PROJECT_ID \ + --resource-type=compute --service=SERVICE_ID --region=REGION_ID + FLAGS --folder=FOLDER Folder ID. @@ -65,6 +72,11 @@ FLAGS --project=PROJECT Project ID. + --region=REGION + Region name. Not applicable for app-engine. Required when resource-type + is compute and regional scoped. Not applicable for compute when global + scoped. + --resource-type=RESOURCE_TYPE Resource type of the IAP resource. RESOURCE_TYPE must be one of: app-engine, iap_web, compute, organization, folder. diff --git a/gcloud/beta/iap/settings/set b/gcloud/beta/iap/settings/set index 0ea3c5454..d7b281f6e 100644 --- a/gcloud/beta/iap/settings/set +++ b/gcloud/beta/iap/settings/set @@ -4,6 +4,7 @@ NAME SYNOPSIS gcloud beta iap settings set SETTING_FILE [--folder=FOLDER --organization=ORGANIZATION --project=PROJECT + --region=REGION --resource-type=RESOURCE_TYPE --service=SERVICE --version=VERSION] [GCLOUD_WIDE_FLAG ...] @@ -58,6 +59,12 @@ EXAMPLES --project=PROJECT_ID --resource-type=compute \ --service=SERVICE_ID + To set the IAP setting for a region backend service within a project, run: + + $ gcloud beta iap settings set iap_settings.yaml \ + --project=PROJECT_ID --resource-type=compute \ + --service=SERVICE_ID --region=REGION_ID + POSITIONAL ARGUMENTS SETTING_FILE JSON or YAML file containing the IAP resource settings. @@ -116,6 +123,11 @@ FLAGS --project=PROJECT Project ID. + --region=REGION + Region name. Not applicable for app-engine. Required when resource-type + is compute and regional scoped. Not applicable for compute when global + scoped. + --resource-type=RESOURCE_TYPE Resource type of the IAP resource. RESOURCE_TYPE must be one of: app-engine, iap_web, compute, organization, folder. diff --git a/gcloud/beta/iap/web/add-iam-policy-binding b/gcloud/beta/iap/web/add-iam-policy-binding index d3c2f8614..260736f9f 100644 --- a/gcloud/beta/iap/web/add-iam-policy-binding +++ b/gcloud/beta/iap/web/add-iam-policy-binding @@ -6,7 +6,8 @@ SYNOPSIS gcloud beta iap web add-iam-policy-binding --member=PRINCIPAL --role=ROLE [--condition=[KEY=VALUE,...] | --condition-from-file=CONDITION_FROM_FILE] - [--resource-type=RESOURCE_TYPE : --service=SERVICE --version=VERSION] + [--resource-type=RESOURCE_TYPE + : --region=REGION --service=SERVICE --version=VERSION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -26,6 +27,14 @@ EXAMPLES --resource-type=IAP_IAM_RESOURCE \ --member='user:test-user@gmail.com' --role='roles/editor' + To add an IAM policy binding for the role of 'roles/editor' for the user + 'test-user@gmail.com' on regional IAP IAM resource IAP_IAM_RESOURCE, run: + + $ gcloud beta iap web add-iam-policy-binding \ + --resource-type=IAP_IAM_RESOURCE \ + --member='user:test-user@gmail.com' --role='roles/editor' \ + --region=REGION + To add an IAM policy binding for the role of 'roles/editor' for all authenticated users on IAP IAM resource IAP_IAM_RESOURCE, run: @@ -110,6 +119,11 @@ OPTIONAL FLAGS Resource type of the IAP resource. RESOURCE_TYPE must be one of: app-engine, backend-services. + --region=REGION + Region name. Should only be specified with + --resource-type=backend-services if it is a regional scoped. Not + applicable for global scoped backend services. + --service=SERVICE Service name. diff --git a/gcloud/beta/iap/web/get-iam-policy b/gcloud/beta/iap/web/get-iam-policy index 34142caa3..b605d7249 100644 --- a/gcloud/beta/iap/web/get-iam-policy +++ b/gcloud/beta/iap/web/get-iam-policy @@ -3,7 +3,8 @@ NAME SYNOPSIS gcloud beta iap web get-iam-policy - [--resource-type=RESOURCE_TYPE : --service=SERVICE --version=VERSION] + [--resource-type=RESOURCE_TYPE + : --region=REGION --service=SERVICE --version=VERSION] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] @@ -54,11 +55,23 @@ EXAMPLES $ gcloud beta iap web get-iam-policy \ --resource-type=backend-services --service=SERVICE_ID + To get the IAM policy for the web accesses to the IAP protected resources + within a regional backend service, run: + + $ gcloud beta iap web get-iam-policy \ + --resource-type=backend-services --service=SERVICE_ID \ + --region=REGION + FLAGS --resource-type=RESOURCE_TYPE Resource type of the IAP resource. RESOURCE_TYPE must be one of: app-engine, backend-services. + --region=REGION + Region name. Should only be specified with + --resource-type=backend-services if it is a regional scoped. Not + applicable for global scoped backend services. + --service=SERVICE Service name. diff --git a/gcloud/beta/iap/web/remove-iam-policy-binding b/gcloud/beta/iap/web/remove-iam-policy-binding index 62552ace2..5552a37a0 100644 --- a/gcloud/beta/iap/web/remove-iam-policy-binding +++ b/gcloud/beta/iap/web/remove-iam-policy-binding @@ -7,7 +7,8 @@ SYNOPSIS --role=ROLE [--all | --condition=[KEY=VALUE,...] | --condition-from-file=CONDITION_FROM_FILE] - [--resource-type=RESOURCE_TYPE : --service=SERVICE --version=VERSION] + [--resource-type=RESOURCE_TYPE + : --region=REGION --service=SERVICE --version=VERSION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -27,6 +28,14 @@ EXAMPLES --resource-type=IAP_IAM_RESOURCE \ --member='user:test-user@gmail.com' --role='roles/editor' + To remove an IAM policy binding for the role of 'roles/editor' for the user + 'test-user@gmail.com' on regional IAP IAM resource IAP_IAM_RESOURCE, run: + + $ gcloud beta iap web remove-iam-policy-binding \ + --resource-type=IAP_IAM_RESOURCE \ + --member='user:test-user@gmail.com' --role='roles/editor' \ + --region=REGION + To remove an IAM policy binding for the role of 'roles/editor' from all authenticated users on IAP IAM resource IAP_IAM_RESOURCE,run: @@ -126,6 +135,11 @@ OPTIONAL FLAGS Resource type of the IAP resource. RESOURCE_TYPE must be one of: app-engine, backend-services. + --region=REGION + Region name. Should only be specified with + --resource-type=backend-services if it is a regional scoped. Not + applicable for global scoped backend services. + --service=SERVICE Service name. diff --git a/gcloud/beta/iap/web/set-iam-policy b/gcloud/beta/iap/web/set-iam-policy index 3b7121ad5..e6ecd22ed 100644 --- a/gcloud/beta/iap/web/set-iam-policy +++ b/gcloud/beta/iap/web/set-iam-policy @@ -4,7 +4,8 @@ NAME SYNOPSIS gcloud beta iap web set-iam-policy POLICY_FILE - [--resource-type=RESOURCE_TYPE : --service=SERVICE --version=VERSION] + [--resource-type=RESOURCE_TYPE + : --region=REGION --service=SERVICE --version=VERSION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -59,6 +60,13 @@ EXAMPLES $ gcloud beta iap web set-iam-policy POLICY_FILE \ --resource-type=backend-services --service=SERVICE_ID + To set the IAM policy for the web accesses to the IAP protected resources + within a regional backend service, run: + + $ gcloud beta iap web set-iam-policy POLICY_FILE \ + --resource-type=backend-services --service=SERVICE_ID \ + --region=REGION + POSITIONAL ARGUMENTS POLICY_FILE JSON or YAML file containing the IAM policy. @@ -68,6 +76,11 @@ FLAGS Resource type of the IAP resource. RESOURCE_TYPE must be one of: app-engine, backend-services. + --region=REGION + Region name. Should only be specified with + --resource-type=backend-services if it is a regional scoped. Not + applicable for global scoped backend services. + --service=SERVICE Service name. diff --git a/gcloud/beta/managed-kafka/clusters/update b/gcloud/beta/managed-kafka/clusters/update index 175af1572..ec38d71f6 100644 --- a/gcloud/beta/managed-kafka/clusters/update +++ b/gcloud/beta/managed-kafka/clusters/update @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud beta managed-kafka clusters update (CLUSTER : --location=LOCATION) - (--no-auto-rebalance --cpu=CPU + (--auto-rebalance --cpu=CPU --labels=[KEY=VALUE,...] --memory=MEMORY --subnets=[SUBNETS,...]) [--async] [GCLOUD_WIDE_FLAG ...] @@ -59,7 +59,6 @@ REQUIRED FLAGS rebalancing is enabled, topic partitions are rebalanced among brokers when the number of CPUs in the cluster changes. Automatic rebalancing is enabled by default. Use --no-auto-rebalance to disable this flag. - Enabled by default, use --no-auto-rebalance to disable. --cpu=CPU The number of vCPUs to provision for the cluster. The minimum is 3. diff --git a/gcloud/beta/managed-kafka/topics/create b/gcloud/beta/managed-kafka/topics/create index 8b4fb2076..a902a619b 100644 --- a/gcloud/beta/managed-kafka/topics/create +++ b/gcloud/beta/managed-kafka/topics/create @@ -74,7 +74,10 @@ OPTIONAL FLAGS --configs=[KEY=VALUE,...] Configuration for the topic that are overridden from the cluster defaults. The key of the map is a Kafka topic property name, for - example: cleanup.policy=compact, compression.type=producer. + example: cleanup.policy=compact,compression.type=producer. If you + provide a map with a key that already exists, only that configuration + is updated. If the map contains a key that does not exist, the entry is + appended to the topic configuration. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/managed-kafka/topics/update b/gcloud/beta/managed-kafka/topics/update index 04925c4d3..ea6474bde 100644 --- a/gcloud/beta/managed-kafka/topics/update +++ b/gcloud/beta/managed-kafka/topics/update @@ -65,7 +65,10 @@ REQUIRED FLAGS --configs=[KEY=VALUE,...] Configuration for the topic that are overridden from the cluster defaults. The key of the map is a Kafka topic property name, for - example: cleanup.policy=compact, compression.type=producer. + example: cleanup.policy=compact,compression.type=producer. If you + provide a map with a key that already exists, only that configuration + is updated. If the map contains a key that does not exist, the entry + is appended to the topic configuration. --partitions=PARTITIONS The number of partitions in a topic. You can increase the partition diff --git a/gcloud/beta/pubsub/subscriptions/create b/gcloud/beta/pubsub/subscriptions/create index ec5cc54b1..d5670fe3b 100644 --- a/gcloud/beta/pubsub/subscriptions/create +++ b/gcloud/beta/pubsub/subscriptions/create @@ -16,7 +16,7 @@ SYNOPSIS : --bigquery-service-account-email=BIGQUERY_SERVICE_ACCOUNT_EMAIL --drop-unknown-fields --write-metadata --use-table-schema | --use-topic-schema] | [--cloud-storage-bucket=CLOUD_STORAGE_BUCKET - : --cloud-storage-file-datetime-format=CLOUD_STORAGE_FILE_DATETIME_FORMAT --cloud-storage-file-prefix=CLOUD_STORAGE_FILE_PREFIX --cloud-storage-file-suffix=CLOUD_STORAGE_FILE_SUFFIX --cloud-storage-max-bytes=CLOUD_STORAGE_MAX_BYTES --cloud-storage-max-duration=CLOUD_STORAGE_MAX_DURATION --cloud-storage-output-format=OUTPUT_FORMAT; default="text" --cloud-storage-service-account-email=CLOUD_STORAGE_SERVICE_ACCOUNT_EMAIL --cloud-storage-write-metadata]] + : --cloud-storage-file-datetime-format=CLOUD_STORAGE_FILE_DATETIME_FORMAT --cloud-storage-file-prefix=CLOUD_STORAGE_FILE_PREFIX --cloud-storage-file-suffix=CLOUD_STORAGE_FILE_SUFFIX --cloud-storage-max-bytes=CLOUD_STORAGE_MAX_BYTES --cloud-storage-max-duration=CLOUD_STORAGE_MAX_DURATION --cloud-storage-output-format=OUTPUT_FORMAT; default="text" --cloud-storage-service-account-email=CLOUD_STORAGE_SERVICE_ACCOUNT_EMAIL --cloud-storage-use-topic-schema --cloud-storage-write-metadata]] [--max-delivery-attempts=MAX_DELIVERY_ATTEMPTS [--dead-letter-topic=DEAD_LETTER_TOPIC : --dead-letter-topic-project=DEAD_LETTER_TOPIC_PROJECT]] @@ -242,6 +242,13 @@ OPTIONAL FLAGS unspecified, uses the Pub/Sub service agent (https://cloud.google.com/iam/docs/service-account-types#service-agents). + --cloud-storage-use-topic-schema + Whether or not to use the schema for the subscription's topic (if + it exists) when writing messages to Cloud Storage. This has an + effect only for subscriptions with + --cloud-storage-output-format=avro. Use + --no-cloud-storage-use-topic-schema to disable this flag. + --cloud-storage-write-metadata Whether or not to write the subscription name, message_id, publish_time, attributes, and ordering_key as additional fields in diff --git a/gcloud/beta/pubsub/subscriptions/update b/gcloud/beta/pubsub/subscriptions/update index 1f137adea..3b71858f4 100644 --- a/gcloud/beta/pubsub/subscriptions/update +++ b/gcloud/beta/pubsub/subscriptions/update @@ -16,7 +16,7 @@ SYNOPSIS --drop-unknown-fields --write-metadata --use-table-schema | --use-topic-schema] | --clear-cloud-storage-config | [--cloud-storage-bucket=CLOUD_STORAGE_BUCKET - : --cloud-storage-file-datetime-format=CLOUD_STORAGE_FILE_DATETIME_FORMAT --cloud-storage-file-prefix=CLOUD_STORAGE_FILE_PREFIX --cloud-storage-file-suffix=CLOUD_STORAGE_FILE_SUFFIX --cloud-storage-max-bytes=CLOUD_STORAGE_MAX_BYTES --cloud-storage-max-duration=CLOUD_STORAGE_MAX_DURATION --cloud-storage-output-format=OUTPUT_FORMAT; default="text" --cloud-storage-service-account-email=CLOUD_STORAGE_SERVICE_ACCOUNT_EMAIL --cloud-storage-write-metadata]] + : --cloud-storage-file-datetime-format=CLOUD_STORAGE_FILE_DATETIME_FORMAT --cloud-storage-file-prefix=CLOUD_STORAGE_FILE_PREFIX --cloud-storage-file-suffix=CLOUD_STORAGE_FILE_SUFFIX --cloud-storage-max-bytes=CLOUD_STORAGE_MAX_BYTES --cloud-storage-max-duration=CLOUD_STORAGE_MAX_DURATION --cloud-storage-output-format=OUTPUT_FORMAT; default="text" --cloud-storage-service-account-email=CLOUD_STORAGE_SERVICE_ACCOUNT_EMAIL --cloud-storage-use-topic-schema --cloud-storage-write-metadata]] [--clear-dead-letter-policy | --max-delivery-attempts=MAX_DELIVERY_ATTEMPTS [--dead-letter-topic=DEAD_LETTER_TOPIC @@ -222,6 +222,13 @@ FLAGS If unspecified, uses the Pub/Sub service agent (https://cloud.google.com/iam/docs/service-account-types#service-agents). + --cloud-storage-use-topic-schema + Whether or not to use the schema for the subscription's topic (if + it exists) when writing messages to Cloud Storage. This has an + effect only for subscriptions with + --cloud-storage-output-format=avro. Use + --no-cloud-storage-use-topic-schema to disable this flag. + --cloud-storage-write-metadata Whether or not to write the subscription name, message_id, publish_time, attributes, and ordering_key as additional fields diff --git a/gcloud/beta/spanner/help b/gcloud/beta/spanner/help index bbee8a924..cf25f0434 100644 --- a/gcloud/beta/spanner/help +++ b/gcloud/beta/spanner/help @@ -24,6 +24,9 @@ GROUPS instance-configs (BETA) Manage Cloud Spanner instance configs. + instance-partitions + (BETA) Manage Cloud Spanner instance partitions. + instances (BETA) Manage Cloud Spanner instances. diff --git a/gcloud/beta/spanner/instance-partitions/create b/gcloud/beta/spanner/instance-partitions/create new file mode 100644 index 000000000..924870598 --- /dev/null +++ b/gcloud/beta/spanner/instance-partitions/create @@ -0,0 +1,91 @@ +NAME + gcloud beta spanner instance-partitions create - create a Cloud Spanner + instance partition + +SYNOPSIS + gcloud beta spanner instance-partitions create + (INSTANCE_PARTITION : --instance=INSTANCE) --config=CONFIG + --description=DESCRIPTION [--async] + [--nodes=NODES | --processing-units=PROCESSING_UNITS] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Create a Cloud Spanner instance partition. + +EXAMPLES + To create a Cloud Spanner instance partition, run: + + $ gcloud beta spanner instance-partitions create \ + my-instance-partition-id --instance=my-instance-id \ + --config=regional-us-east1 \ + --description=my-instance-display-name --nodes=3 + +POSITIONAL ARGUMENTS + Instance partition resource - The Cloud Spanner instance partition to + create. The arguments in this group can be used to specify the attributes + of this resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument instance_partition 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. + + INSTANCE_PARTITION + ID of the instance-partition or fully qualified identifier for the + instance-partition. + + To set the instance-partition attribute: + ▸ provide the argument instance_partition on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --instance=INSTANCE + The Cloud Spanner instance for the instance-partition. + + To set the instance attribute: + ▸ provide the argument instance_partition on the command line with + a fully specified name; + ▸ provide the argument --instance on the command line; + ▸ set the property spanner/instance. + +REQUIRED FLAGS + --config=CONFIG + Instance configuration defines the geographic placement and replication + used by the instance partition. Available configurations can be found + by running "gcloud spanner instance-configs list" + + --description=DESCRIPTION + Description of the instance partition. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + At most one of these can be specified: + + --nodes=NODES + Number of nodes for the instance partition. + + --processing-units=PROCESSING_UNITS + Number of processing units for the instance partition. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha spanner instance-partitions create + diff --git a/gcloud/beta/spanner/instance-partitions/delete b/gcloud/beta/spanner/instance-partitions/delete new file mode 100644 index 000000000..06b3b7d4e --- /dev/null +++ b/gcloud/beta/spanner/instance-partitions/delete @@ -0,0 +1,64 @@ +NAME + gcloud beta spanner instance-partitions delete - delete a Cloud Spanner + instance partition + +SYNOPSIS + gcloud beta spanner instance-partitions delete + (INSTANCE_PARTITION : --instance=INSTANCE) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Delete a Cloud Spanner instance partition. + +EXAMPLES + To delete a Cloud Spanner instance partition, run: + + $ gcloud beta spanner instance-partitions delete \ + my-instance-partition-id --instance=my-instance-id + +POSITIONAL ARGUMENTS + Instance partition resource - The Cloud Spanner instance partition 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 instance_partition 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. + + INSTANCE_PARTITION + ID of the instance-partition or fully qualified identifier for the + instance-partition. + + To set the instance-partition attribute: + ▸ provide the argument instance_partition on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --instance=INSTANCE + The Cloud Spanner instance for the instance-partition. + + To set the instance attribute: + ▸ provide the argument instance_partition on the command line with + a fully specified name; + ▸ provide the argument --instance on the command line; + ▸ set the property spanner/instance. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha spanner instance-partitions delete + diff --git a/gcloud/beta/spanner/instance-partitions/describe b/gcloud/beta/spanner/instance-partitions/describe new file mode 100644 index 000000000..9fd0b2996 --- /dev/null +++ b/gcloud/beta/spanner/instance-partitions/describe @@ -0,0 +1,64 @@ +NAME + gcloud beta spanner instance-partitions describe - describe a Cloud Spanner + instance partition + +SYNOPSIS + gcloud beta spanner instance-partitions describe + (INSTANCE_PARTITION : --instance=INSTANCE) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Describe a Cloud Spanner instance partition. + +EXAMPLES + To describe a Cloud Spanner instance partition, run: + + $ gcloud beta spanner instance-partitions describe \ + my-instance-partition-id --instance=my-instance-id + +POSITIONAL ARGUMENTS + Instance partition resource - The Cloud Spanner instance partition 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 instance_partition 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. + + INSTANCE_PARTITION + ID of the instance-partition or fully qualified identifier for the + instance-partition. + + To set the instance-partition attribute: + ▸ provide the argument instance_partition on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --instance=INSTANCE + The Cloud Spanner instance for the instance-partition. + + To set the instance attribute: + ▸ provide the argument instance_partition on the command line with + a fully specified name; + ▸ provide the argument --instance on the command line; + ▸ set the property spanner/instance. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha spanner instance-partitions describe + diff --git a/gcloud/beta/spanner/instance-partitions/help b/gcloud/beta/spanner/instance-partitions/help new file mode 100644 index 000000000..2f6eaa344 --- /dev/null +++ b/gcloud/beta/spanner/instance-partitions/help @@ -0,0 +1,40 @@ +NAME + gcloud beta spanner instance-partitions - manage Cloud Spanner instance + partitions + +SYNOPSIS + gcloud beta spanner instance-partitions COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Manage Cloud Spanner instance partitions. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (BETA) Create a Cloud Spanner instance partition. + + delete + (BETA) Delete a Cloud Spanner instance partition. + + describe + (BETA) Describe a Cloud Spanner instance partition. + + list + (BETA) List the Cloud Spanner instance partitions contained within the + given instance. + + update + (BETA) Update a Cloud Spanner instance partition. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha spanner instance-partitions + diff --git a/gcloud/beta/spanner/instance-partitions/list b/gcloud/beta/spanner/instance-partitions/list new file mode 100644 index 000000000..33cb90c9c --- /dev/null +++ b/gcloud/beta/spanner/instance-partitions/list @@ -0,0 +1,77 @@ +NAME + gcloud beta spanner instance-partitions list - list the Cloud Spanner + instance partitions contained within the given instance + +SYNOPSIS + gcloud beta spanner instance-partitions list [--instance=INSTANCE] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) List the Cloud Spanner instance partitions contained within the + given instance. + +EXAMPLES + To list all Cloud Spanner instances partitions in an instance, run: + + $ gcloud beta spanner instance-partitions list \ + --instance=my-instance-id + +FLAGS + Instance resource - The Cloud Spanner instance in which to list instance + partitions. 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 --instance on the command line with a fully + specified name; + ◆ set the property spanner/instance with a fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --instance=INSTANCE + ID of the instance or fully qualified identifier for the instance. + + To set the instance attribute: + ▸ provide the argument --instance on the command line; + ▸ set the property spanner/instance. + +LIST COMMAND FLAGS + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha spanner instance-partitions list + diff --git a/gcloud/beta/spanner/instance-partitions/update b/gcloud/beta/spanner/instance-partitions/update new file mode 100644 index 000000000..1bc27ab04 --- /dev/null +++ b/gcloud/beta/spanner/instance-partitions/update @@ -0,0 +1,89 @@ +NAME + gcloud beta spanner instance-partitions update - update a Cloud Spanner + instance partition + +SYNOPSIS + gcloud beta spanner instance-partitions update + (INSTANCE_PARTITION : --instance=INSTANCE) [--async] + [--description=DESCRIPTION] + [--nodes=NODES | --processing-units=PROCESSING_UNITS] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Update a Cloud Spanner instance partition. + +EXAMPLES + To update the display name of a Cloud Spanner instance partition, run: + + $ gcloud beta spanner instance-partitions update \ + my-instance-partition-id --instance=my-instance-id \ + --description=my-new-display-name + + To update the node count of a Cloud Spanner instance partition, run: + + $ gcloud beta spanner instance-partitions update \ + my-instance-partition-id --instance=my-instance-id --nodes=1 + +POSITIONAL ARGUMENTS + Instance partition resource - The Cloud Spanner instance partition 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 instance_partition 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. + + INSTANCE_PARTITION + ID of the instance-partition or fully qualified identifier for the + instance-partition. + + To set the instance-partition attribute: + ▸ provide the argument instance_partition on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --instance=INSTANCE + The Cloud Spanner instance for the instance-partition. + + To set the instance attribute: + ▸ provide the argument instance_partition on the command line with + a fully specified name; + ▸ provide the argument --instance on the command line; + ▸ set the property spanner/instance. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + Description of the instance partition. + + At most one of these can be specified: + + --nodes=NODES + Number of nodes for the instance partition. + + --processing-units=PROCESSING_UNITS + Number of processing units for the instance partition. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha spanner instance-partitions update + diff --git a/gcloud/beta/spanner/operations/cancel b/gcloud/beta/spanner/operations/cancel index dcd2ab9f8..192b5afd2 100644 --- a/gcloud/beta/spanner/operations/cancel +++ b/gcloud/beta/spanner/operations/cancel @@ -4,7 +4,8 @@ NAME SYNOPSIS gcloud beta spanner operations cancel OPERATION-ID (--instance=INSTANCE | --instance-config=INSTANCE_CONFIG) - [--backup=BACKUP] [--database=DATABASE] [GCLOUD_WIDE_FLAG ...] + [--backup=BACKUP] [--database=DATABASE] + [--instance-partition=INSTANCE_PARTITION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Cancel a Cloud Spanner operation. @@ -53,6 +54,10 @@ OPTIONAL FLAGS For a database operation, the name of the database the operation is executing on. + --instance-partition=INSTANCE_PARTITION + For instance partition operations, the name of the instance partition + the operation is executing on. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/beta/spanner/operations/describe b/gcloud/beta/spanner/operations/describe index 32753c33a..4c5168f4d 100644 --- a/gcloud/beta/spanner/operations/describe +++ b/gcloud/beta/spanner/operations/describe @@ -5,7 +5,8 @@ NAME SYNOPSIS gcloud beta spanner operations describe OPERATION-ID (--instance=INSTANCE | --instance-config=INSTANCE_CONFIG) - [--backup=BACKUP] [--database=DATABASE] [GCLOUD_WIDE_FLAG ...] + [--backup=BACKUP] [--database=DATABASE] + [--instance-partition=INSTANCE_PARTITION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Describe a Cloud Spanner operation. @@ -53,6 +54,10 @@ OPTIONAL FLAGS For a database operation, the name of the database the operation is executing on. + --instance-partition=INSTANCE_PARTITION + For instance partition operations, the name of the instance partition + the operation is executing on. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/beta/spanner/operations/list b/gcloud/beta/spanner/operations/list index 80d448f7d..0e4d6e441 100644 --- a/gcloud/beta/spanner/operations/list +++ b/gcloud/beta/spanner/operations/list @@ -4,7 +4,8 @@ NAME SYNOPSIS gcloud beta spanner operations list (--instance=INSTANCE | --instance-config=INSTANCE_CONFIG) - [--backup=BACKUP] [--database=DATABASE] [--type=TYPE] + [--backup=BACKUP] [--database=DATABASE] + [--instance-partition=INSTANCE_PARTITION] [--type=TYPE] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] @@ -71,6 +72,10 @@ FLAGS For database operations, the name of the database the operations are executing on. + --instance-partition=INSTANCE_PARTITION + For instance partition operations, the name of the instance partition + the operation is executing on. + --type=TYPE (optional) List only the operations of the given type. TYPE must be one of: diff --git a/gcloud/builds/worker-pools/update b/gcloud/builds/worker-pools/update index 2554de942..77bcc916b 100644 --- a/gcloud/builds/worker-pools/update +++ b/gcloud/builds/worker-pools/update @@ -4,10 +4,9 @@ NAME SYNOPSIS gcloud builds worker-pools update WORKER_POOL --region=REGION - (--config-from-file=CONFIG_FROM_FILE - | --worker-disk-size=WORKER_DISK_SIZE - --worker-machine-type=WORKER_MACHINE_TYPE --public-egress - | --no-public-egress) [GCLOUD_WIDE_FLAG ...] + (--config-from-file=CONFIG_FROM_FILE | --[no-]public-egress + --worker-disk-size=WORKER_DISK_SIZE + --worker-machine-type=WORKER_MACHINE_TYPE) [GCLOUD_WIDE_FLAG ...] DESCRIPTION Update a worker pool used by Cloud Build. @@ -39,6 +38,16 @@ REQUIRED FLAGS Command-line flags to configure the private pool: + --[no-]public-egress + If set to true, workers in the worker pool are created with an + external IP address. + + If set to false, workers in the worker pool are created without an + external IP address. If the worker pool is within a VPC Service + Control perimeter, use this flag. + + Use --public-egress to enable and --no-public-egress to disable. + Configuration to be used for creating workers in the worker pool: --worker-disk-size=WORKER_DISK_SIZE @@ -51,21 +60,6 @@ REQUIRED FLAGS If unspecified, Cloud Build uses a standard machine type. - Network configuration for Service Networking: - - At most one of these can be specified: - - --public-egress - If set, workers in the worker pool are created with an external - IP address. - - --no-public-egress - If set, workers in the worker pool are created without an - external IP address. - - If the worker pool is within a VPC Service Control perimeter, - use this 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/compute/images/list b/gcloud/compute/images/list index 6164cf693..8448a4672 100644 --- a/gcloud/compute/images/list +++ b/gcloud/compute/images/list @@ -51,9 +51,9 @@ FLAGS --standard-images List images from public image projects. The public image projects that - are available include the following: centos-cloud, cos-cloud, - debian-cloud, fedora-coreos-cloud, opensuse-cloud, rhel-cloud, - rhel-sap-cloud, rocky-linux-cloud, suse-cloud, suse-sap-cloud, + are available include the following: cos-cloud, debian-cloud, + rocky-linux-cloud, centos-cloud, fedora-coreos-cloud, opensuse-cloud, + rhel-cloud, rhel-sap-cloud, suse-cloud, suse-sap-cloud, ubuntu-os-cloud, ubuntu-os-pro-cloud, windows-cloud, windows-sql-cloud. Enabled by default, use --no-standard-images to disable. diff --git a/gcloud/compute/instance-groups/managed/update b/gcloud/compute/instance-groups/managed/update index 3d14c40ea..f64c4351b 100644 --- a/gcloud/compute/instance-groups/managed/update +++ b/gcloud/compute/instance-groups/managed/update @@ -10,7 +10,7 @@ SYNOPSIS [--list-managed-instances-results=MODE] [--remove-stateful-disks=DEVICE_NAME,[DEVICE_NAME,...]] [--remove-stateful-external-ips=INTERFACE_NAME,[...]] - [--remove-stateful-internal-ips=INTERFACE_NAME,[...]] + [--remove-stateful-internal-ips=INTERFACE_NAME,[...]] [--size=SIZE] [--stateful-disk=[auto-delete=AUTO-DELETE],[device-name=DEVICE-NAME]] [--stateful-external-ip=[enabled], [auto-delete=AUTO-DELETE],[interface-name=INTERFACE-NAME]] @@ -129,6 +129,9 @@ FLAGS Remove stateful configuration for the specified interfaces for internal IPs. + --size=SIZE + Target number of running instances in managed instance group. + --stateful-disk=[auto-delete=AUTO-DELETE],[device-name=DEVICE-NAME] Disks considered stateful by the instance group. Managed instance groups preserve and reattach stateful disks on VM autohealing, update, diff --git a/gcloud/compute/instance-templates/create b/gcloud/compute/instance-templates/create index f132e8dd9..d64c8a353 100644 --- a/gcloud/compute/instance-templates/create +++ b/gcloud/compute/instance-templates/create @@ -9,8 +9,7 @@ SYNOPSIS [--boot-disk-provisioned-iops=BOOT_DISK_PROVISIONED_IOPS] [--boot-disk-provisioned-throughput=BOOT_DISK_PROVISIONED_THROUGHPUT] [--boot-disk-size=BOOT_DISK_SIZE] [--boot-disk-type=BOOT_DISK_TYPE] - [--can-ip-forward] [--confidential-compute] - [--configure-disk=[PROPERTY=VALUE,...]] + [--can-ip-forward] [--configure-disk=[PROPERTY=VALUE,...]] [--create-disk=[PROPERTY=VALUE,...]] [--description=DESCRIPTION] [--disk=[auto-delete=AUTO-DELETE], [boot=BOOT],[device-name=DEVICE-NAME],[mode=MODE],[name=NAME]] @@ -49,6 +48,8 @@ SYNOPSIS : --boot-disk-kms-keyring=BOOT_DISK_KMS_KEYRING --boot-disk-kms-location=BOOT_DISK_KMS_LOCATION --boot-disk-kms-project=BOOT_DISK_KMS_PROJECT] + [--confidential-compute + | --confidential-compute-type=CONFIDENTIAL_COMPUTE_TYPE] [--custom-cpu=CUSTOM_CPU --custom-memory=CUSTOM_MEMORY : --custom-extensions --custom-vm-type=CUSTOM_VM_TYPE] [--image-project=IMAGE_PROJECT --image=IMAGE @@ -130,11 +131,6 @@ FLAGS If provided, allows the instances to send and receive packets with non-matching destination or source IP addresses. - --confidential-compute - The instance boots with Confidential Computing enabled. Confidential - Computing is based on Secure Encrypted Virtualization (SEV), an AMD - virtualization feature for running confidential instances. - --configure-disk=[PROPERTY=VALUE,...] This option has effect only when used with --source-instance. It allows you to override how the source-instance's disks are defined in the @@ -859,6 +855,29 @@ FLAGS ▸ provide the argument --boot-disk-kms-project on the command line; ▸ set the property core/project. + At most one of these can be specified: + + --confidential-compute + (DEPRECATED) The instance boots with Confidential Computing enabled. + Confidential Computing is based on Secure Encrypted Virtualization + (SEV), an AMD virtualization feature for running confidential + instances. + + The --confidential-compute flag will soon be deprecated. Please use + --confidential-compute-type=SEV instead + + --confidential-compute-type=CONFIDENTIAL_COMPUTE_TYPE + The instance boots with Confidential Computing enabled. Confidential + Computing can be based on Secure Encrypted Virtualization (SEV) or + Secure Encrypted Virtualization - Secure Nested Paging (SEV-SNP), + both of which are AMD virtualization features for running + confidential instances. CONFIDENTIAL_COMPUTE_TYPE must be one of: + + SEV + Secure Encrypted Virtualization + SEV_SNP + Secure Encrypted Virtualization - Secure Nested Paging + Custom machine type extensions. --custom-cpu=CUSTOM_CPU diff --git a/gcloud/compute/instances/bulk/create b/gcloud/compute/instances/bulk/create index 91a6f9288..15942b845 100644 --- a/gcloud/compute/instances/bulk/create +++ b/gcloud/compute/instances/bulk/create @@ -12,8 +12,8 @@ SYNOPSIS [--boot-disk-provisioned-iops=BOOT_DISK_PROVISIONED_IOPS] [--boot-disk-provisioned-throughput=BOOT_DISK_PROVISIONED_THROUGHPUT] [--boot-disk-size=BOOT_DISK_SIZE] [--boot-disk-type=BOOT_DISK_TYPE] - [--can-ip-forward] [--confidential-compute] [--count=COUNT] - [--create-disk=[PROPERTY=VALUE,...]] [--description=DESCRIPTION] + [--can-ip-forward] [--count=COUNT] [--create-disk=[PROPERTY=VALUE,...]] + [--description=DESCRIPTION] [--disk=[boot=BOOT], [device-name=DEVICE-NAME],[name=NAME],[scope=SCOPE]] [--[no-]enable-nested-virtualization] [--[no-]enable-uefi-networking] @@ -46,6 +46,8 @@ SYNOPSIS : --boot-disk-kms-keyring=BOOT_DISK_KMS_KEYRING --boot-disk-kms-location=BOOT_DISK_KMS_LOCATION --boot-disk-kms-project=BOOT_DISK_KMS_PROJECT] + [--confidential-compute + | --confidential-compute-type=CONFIDENTIAL_COMPUTE_TYPE] [--custom-cpu=CUSTOM_CPU --custom-memory=CUSTOM_MEMORY : --custom-extensions --custom-vm-type=CUSTOM_VM_TYPE] [--image-project=IMAGE_PROJECT --image=IMAGE @@ -180,11 +182,6 @@ OPTIONAL FLAGS If provided, allows the instances to send and receive packets with non-matching destination or source IP addresses. - --confidential-compute - The instance boots with Confidential Computing enabled. Confidential - Computing is based on Secure Encrypted Virtualization (SEV), an AMD - virtualization feature for running confidential instances. - --count=COUNT Number of Compute Engine virtual machines to create. If specified, and --predefined-names is specified, count must equal the amount of names @@ -788,6 +785,29 @@ OPTIONAL FLAGS ▸ provide the argument --boot-disk-kms-project on the command line; ▸ set the property core/project. + At most one of these can be specified: + + --confidential-compute + (DEPRECATED) The instance boots with Confidential Computing enabled. + Confidential Computing is based on Secure Encrypted Virtualization + (SEV), an AMD virtualization feature for running confidential + instances. + + The --confidential-compute flag will soon be deprecated. Please use + --confidential-compute-type=SEV instead + + --confidential-compute-type=CONFIDENTIAL_COMPUTE_TYPE + The instance boots with Confidential Computing enabled. Confidential + Computing can be based on Secure Encrypted Virtualization (SEV) or + Secure Encrypted Virtualization - Secure Nested Paging (SEV-SNP), + both of which are AMD virtualization features for running + confidential instances. CONFIDENTIAL_COMPUTE_TYPE must be one of: + + SEV + Secure Encrypted Virtualization + SEV_SNP + Secure Encrypted Virtualization - Secure Nested Paging + Custom machine type extensions. --custom-cpu=CUSTOM_CPU diff --git a/gcloud/compute/instances/create b/gcloud/compute/instances/create index c58a74c0e..906297c02 100644 --- a/gcloud/compute/instances/create +++ b/gcloud/compute/instances/create @@ -10,9 +10,9 @@ SYNOPSIS [--boot-disk-provisioned-iops=BOOT_DISK_PROVISIONED_IOPS] [--boot-disk-provisioned-throughput=BOOT_DISK_PROVISIONED_THROUGHPUT] [--boot-disk-size=BOOT_DISK_SIZE] [--boot-disk-type=BOOT_DISK_TYPE] - [--can-ip-forward] [--confidential-compute] - [--create-disk=[PROPERTY=VALUE,...]] [--csek-key-file=FILE] - [--deletion-protection] [--description=DESCRIPTION] + [--can-ip-forward] [--create-disk=[PROPERTY=VALUE,...]] + [--csek-key-file=FILE] [--deletion-protection] + [--description=DESCRIPTION] [--disk=[auto-delete=AUTO-DELETE],[boot=BOOT],[device-name=DEVICE-NAME], [force-attach=FORCE-ATTACH],[mode=MODE],[name=NAME],[scope=SCOPE]] [--enable-display-device] [--[no-]enable-nested-virtualization] @@ -55,6 +55,8 @@ SYNOPSIS : --boot-disk-kms-keyring=BOOT_DISK_KMS_KEYRING --boot-disk-kms-location=BOOT_DISK_KMS_LOCATION --boot-disk-kms-project=BOOT_DISK_KMS_PROJECT] + [--confidential-compute + | --confidential-compute-type=CONFIDENTIAL_COMPUTE_TYPE] [--custom-cpu=CUSTOM_CPU --custom-memory=CUSTOM_MEMORY : --custom-extensions --custom-vm-type=CUSTOM_VM_TYPE] [--image-family-scope=IMAGE_FAMILY_SCOPE @@ -183,11 +185,6 @@ FLAGS If provided, allows the instances to send and receive packets with non-matching destination or source IP addresses. - --confidential-compute - The instance boots with Confidential Computing enabled. Confidential - Computing is based on Secure Encrypted Virtualization (SEV), an AMD - virtualization feature for running confidential instances. - --create-disk=[PROPERTY=VALUE,...] Creates and attaches persistent disks to the instances. @@ -967,6 +964,29 @@ FLAGS ▸ provide the argument --boot-disk-kms-project on the command line; ▸ set the property core/project. + At most one of these can be specified: + + --confidential-compute + (DEPRECATED) The instance boots with Confidential Computing enabled. + Confidential Computing is based on Secure Encrypted Virtualization + (SEV), an AMD virtualization feature for running confidential + instances. + + The --confidential-compute flag will soon be deprecated. Please use + --confidential-compute-type=SEV instead + + --confidential-compute-type=CONFIDENTIAL_COMPUTE_TYPE + The instance boots with Confidential Computing enabled. Confidential + Computing can be based on Secure Encrypted Virtualization (SEV) or + Secure Encrypted Virtualization - Secure Nested Paging (SEV-SNP), + both of which are AMD virtualization features for running + confidential instances. CONFIDENTIAL_COMPUTE_TYPE must be one of: + + SEV + Secure Encrypted Virtualization + SEV_SNP + Secure Encrypted Virtualization - Secure Nested Paging + Custom machine type extensions. --custom-cpu=CUSTOM_CPU diff --git a/gcloud/compute/instances/create-with-container b/gcloud/compute/instances/create-with-container index a58b430a5..fb6235987 100644 --- a/gcloud/compute/instances/create-with-container +++ b/gcloud/compute/instances/create-with-container @@ -10,8 +10,8 @@ SYNOPSIS [--boot-disk-provisioned-iops=BOOT_DISK_PROVISIONED_IOPS] [--boot-disk-provisioned-throughput=BOOT_DISK_PROVISIONED_THROUGHPUT] [--boot-disk-size=BOOT_DISK_SIZE] [--boot-disk-type=BOOT_DISK_TYPE] - [--can-ip-forward] [--confidential-compute] - [--container-arg=CONTAINER_ARG] [--container-command=CONTAINER_COMMAND] + [--can-ip-forward] [--container-arg=CONTAINER_ARG] + [--container-command=CONTAINER_COMMAND] [--container-env=[KEY=VALUE, ...,...]] [--container-env-file=CONTAINER_ENV_FILE] [--container-image=CONTAINER_IMAGE] @@ -51,6 +51,8 @@ SYNOPSIS [--threads-per-core=THREADS_PER_CORE] [--visible-core-count=VISIBLE_CORE_COUNT] [--zone=ZONE] [--address=ADDRESS | --no-address] + [--confidential-compute + | --confidential-compute-type=CONFIDENTIAL_COMPUTE_TYPE] [--custom-cpu=CUSTOM_CPU --custom-memory=CUSTOM_MEMORY : --custom-extensions --custom-vm-type=CUSTOM_VM_TYPE] [--image-project=IMAGE_PROJECT --image=IMAGE @@ -145,11 +147,6 @@ FLAGS If provided, allows the instances to send and receive packets with non-matching destination or source IP addresses. - --confidential-compute - The instance boots with Confidential Computing enabled. Confidential - Computing is based on Secure Encrypted Virtualization (SEV), an AMD - virtualization feature for running confidential instances. - --container-arg=CONTAINER_ARG Argument to append to container entrypoint or to override container CMD. Each argument must have a separate flag. Arguments are appended in @@ -832,6 +829,29 @@ FLAGS ▸ https://cloud.google.com/vpc/docs/configure-private-google-access ▸ https://cloud.google.com/nat/docs/using-nat + At most one of these can be specified: + + --confidential-compute + (DEPRECATED) The instance boots with Confidential Computing enabled. + Confidential Computing is based on Secure Encrypted Virtualization + (SEV), an AMD virtualization feature for running confidential + instances. + + The --confidential-compute flag will soon be deprecated. Please use + --confidential-compute-type=SEV instead + + --confidential-compute-type=CONFIDENTIAL_COMPUTE_TYPE + The instance boots with Confidential Computing enabled. Confidential + Computing can be based on Secure Encrypted Virtualization (SEV) or + Secure Encrypted Virtualization - Secure Nested Paging (SEV-SNP), + both of which are AMD virtualization features for running + confidential instances. CONFIDENTIAL_COMPUTE_TYPE must be one of: + + SEV + Secure Encrypted Virtualization + SEV_SNP + Secure Encrypted Virtualization - Secure Nested Paging + Custom machine type extensions. --custom-cpu=CUSTOM_CPU diff --git a/gcloud/container/clusters/create b/gcloud/container/clusters/create index 20cfc7f73..8ff2f6266 100644 --- a/gcloud/container/clusters/create +++ b/gcloud/container/clusters/create @@ -63,7 +63,7 @@ SYNOPSIS [--placement-policy=PLACEMENT_POLICY] [--placement-type=PLACEMENT_TYPE] [--preemptible] [--private-endpoint-subnetwork=NAME] [--private-ipv6-google-access-type=PRIVATE_IPV6_GOOGLE_ACCESS_TYPE] - [--release-channel=CHANNEL] [--resource-manager-tags=[KEY=VALUE,...]] + [--release-channel=[CHANNEL]] [--resource-manager-tags=[KEY=VALUE,...]] [--security-group=SECURITY_GROUP] [--security-posture=SECURITY_POSTURE] [--services-ipv4-cidr=CIDR] [--services-secondary-range-name=NAME] [--shielded-integrity-monitoring] [--shielded-secure-boot] [--spot] @@ -1010,7 +1010,7 @@ FLAGS PRIVATE_IPV6_GOOGLE_ACCESS_TYPE must be one of: bidirectional, disabled, outbound-only. - --release-channel=CHANNEL + --release-channel=[CHANNEL] Release channel a cluster is subscribed to. If left unspecified and a version is specified, the cluster is enrolled @@ -1026,10 +1026,8 @@ FLAGS CHANNEL must be one of: - None - Use 'None' to opt-out of any release channel. + rapid - rapid 'rapid' channel is offered on an early access basis for customers who want to test new releases. @@ -1037,14 +1035,23 @@ FLAGS to unresolved issues with no known workaround and are not subject to any SLAs. - regular + regular + Clusters subscribed to 'regular' receive versions that are considered GA quality. 'regular' is intended for production users who want to take advantage of new features. - stable + + stable + Clusters subscribed to 'stable' receive versions that are known to be stable and reliable in production. + None + + Use 'None' to opt-out of any release channel. + + CHANNEL must be one of: rapid, regular, stable, None. + --resource-manager-tags=[KEY=VALUE,...] Applies the specified comma-separated resource manager tags that has the GCE_FIREWALL purpose to all nodes in the new default node pool(s) @@ -1091,6 +1098,9 @@ FLAGS To disable in an existing cluster, explicitly set the flag to --security-posture=disabled. + For more information on enablement, see + https://cloud.google.com/kubernetes-engine/docs/concepts/about-security-posture-dashboard#feature-enablement. + SECURITY_POSTURE must be one of: disabled, standard, enterprise. --services-ipv4-cidr=CIDR @@ -1263,6 +1273,9 @@ FLAGS To disable in an existing cluster, explicitly set the flag to --workload-vulnerability-scanning=disabled. + For more information on enablement, see + https://cloud.google.com/kubernetes-engine/docs/concepts/about-security-posture-dashboard#feature-enablement. + WORKLOAD_VULNERABILITY_SCANNING must be one of: disabled, standard, enterprise. diff --git a/gcloud/container/clusters/create-auto b/gcloud/container/clusters/create-auto index 62220a4eb..082b02671 100644 --- a/gcloud/container/clusters/create-auto +++ b/gcloud/container/clusters/create-auto @@ -21,7 +21,7 @@ SYNOPSIS [--enable-master-global-access] [--fleet-project=PROJECT_ID_OR_NUMBER] [--labels=[KEY=VALUE,...]] [--logging=[COMPONENT,...]] [--monitoring=[COMPONENT,...]] [--network=NETWORK] - [--private-endpoint-subnetwork=NAME] [--release-channel=CHANNEL] + [--private-endpoint-subnetwork=NAME] [--release-channel=[CHANNEL]] [--security-group=SECURITY_GROUP] [--security-posture=SECURITY_POSTURE] [--services-ipv4-cidr=CIDR] [--services-secondary-range-name=NAME] [--subnetwork=SUBNETWORK] [--workload-policies=WORKLOAD_POLICIES] @@ -305,7 +305,7 @@ FLAGS Sets the subnetwork GKE uses to provision the control plane's private endpoint. - --release-channel=CHANNEL + --release-channel=[CHANNEL] Release channel a cluster is subscribed to. If left unspecified and a version is specified, the cluster is enrolled @@ -321,7 +321,8 @@ FLAGS CHANNEL must be one of: - rapid + rapid + 'rapid' channel is offered on an early access basis for customers who want to test new releases. @@ -329,14 +330,19 @@ FLAGS to unresolved issues with no known workaround and are not subject to any SLAs. - regular + regular + Clusters subscribed to 'regular' receive versions that are considered GA quality. 'regular' is intended for production users who want to take advantage of new features. - stable + + stable + Clusters subscribed to 'stable' receive versions that are known to be stable and reliable in production. + CHANNEL must be one of: rapid, regular, stable. + --security-group=SECURITY_GROUP The name of the RBAC security group for use with Google security groups in Kubernetes RBAC @@ -361,6 +367,9 @@ FLAGS To disable in an existing cluster, explicitly set the flag to --security-posture=disabled. + For more information on enablement, see + https://cloud.google.com/kubernetes-engine/docs/concepts/about-security-posture-dashboard#feature-enablement. + SECURITY_POSTURE must be one of: disabled, standard, enterprise. --services-ipv4-cidr=CIDR @@ -411,6 +420,9 @@ FLAGS To disable in an existing cluster, explicitly set the flag to --workload-vulnerability-scanning=disabled. + For more information on enablement, see + https://cloud.google.com/kubernetes-engine/docs/concepts/about-security-posture-dashboard#feature-enablement. + WORKLOAD_VULNERABILITY_SCANNING must be one of: disabled, standard, enterprise. diff --git a/gcloud/container/clusters/update b/gcloud/container/clusters/update index 00261caf9..598066cda 100644 --- a/gcloud/container/clusters/update +++ b/gcloud/container/clusters/update @@ -34,7 +34,7 @@ SYNOPSIS | --notification-config=[pubsub=ENABLED|DISABLED, pubsub-topic=TOPIC,...] | --private-ipv6-google-access-type=PRIVATE_IPV6_GOOGLE_ACCESS_TYPE - | --release-channel=CHANNEL | --remove-labels=[KEY,...] + | --release-channel=[CHANNEL] | --remove-labels=[KEY,...] | --remove-workload-policies=REMOVE_WORKLOAD_POLICIES | --security-group=SECURITY_GROUP | --security-posture=SECURITY_POSTURE | --set-password @@ -544,7 +544,7 @@ REQUIRED FLAGS PRIVATE_IPV6_GOOGLE_ACCESS_TYPE must be one of: bidirectional, disabled, outbound-only. - --release-channel=CHANNEL + --release-channel=[CHANNEL] Subscribe or unsubscribe this cluster to a release channel. When a cluster is subscribed to a release channel, Google maintains @@ -555,10 +555,8 @@ REQUIRED FLAGS CHANNEL must be one of: - None - Use 'None' to opt-out of any release channel. + rapid - rapid 'rapid' channel is offered on an early access basis for customers who want to test new releases. @@ -566,13 +564,22 @@ REQUIRED FLAGS to unresolved issues with no known workaround and are not subject to any SLAs. - regular + regular + Clusters subscribed to 'regular' receive versions that are considered GA quality. 'regular' is intended for production users who want to take advantage of new features. - stable - Clusters subscribed to 'stable' receive versions that are known - to be stable and reliable in production. + + stable + + Clusters subscribed to 'stable' receive versions that are known to + be stable and reliable in production. + + None + + Use 'None' to opt-out of any release channel. + + CHANNEL must be one of: rapid, regular, stable, None. --remove-labels=[KEY,...] Labels to remove from the Google Cloud resources in use by the @@ -617,6 +624,9 @@ REQUIRED FLAGS To disable in an existing cluster, explicitly set the flag to --security-posture=disabled. + For more information on enablement, see + https://cloud.google.com/kubernetes-engine/docs/concepts/about-security-posture-dashboard#feature-enablement. + SECURITY_POSTURE must be one of: disabled, standard, enterprise. --set-password @@ -704,6 +714,9 @@ REQUIRED FLAGS To disable in an existing cluster, explicitly set the flag to --workload-vulnerability-scanning=disabled. + For more information on enablement, see + https://cloud.google.com/kubernetes-engine/docs/concepts/about-security-posture-dashboard#feature-enablement. + WORKLOAD_VULNERABILITY_SCANNING must be one of: disabled, standard, enterprise. diff --git a/gcloud/dataflow/help b/gcloud/dataflow/help index 22e50c2ee..7024b31aa 100644 --- a/gcloud/dataflow/help +++ b/gcloud/dataflow/help @@ -34,7 +34,7 @@ GROUPS A group of subcommands for working with Cloud Dataflow snapshots. sql - A group of subcommands for working with Dataflow SQL. + (DEPRECATED) A group of subcommands for working with Dataflow SQL. yaml A group of subcommands for launching Beam YAML jobs on Dataflow. diff --git a/gcloud/dataflow/sql/help b/gcloud/dataflow/sql/help index f3236fec9..480321d7b 100644 --- a/gcloud/dataflow/sql/help +++ b/gcloud/dataflow/sql/help @@ -5,7 +5,13 @@ SYNOPSIS gcloud dataflow sql COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION - A group of subcommands for working with Dataflow SQL. + (DEPRECATED) A group of subcommands for working with Dataflow SQL. + + This command is deprecated and will be removed January 31, 2025. Please see + Beam YAML (https://beam.apache.org/documentation/sdks/yaml/) and Beam + notebooks + (https://cloud.google.com/dataflow/docs/guides/notebook-advanced#beam-sql) + for alternatives. GCLOUD WIDE FLAGS These flags are available to all commands: --help. @@ -16,7 +22,7 @@ COMMANDS COMMAND is one of the following: query - Execute the user-specified SQL query on Dataflow. + (DEPRECATED) Execute the user-specified SQL query on Dataflow. NOTES This variant is also available: diff --git a/gcloud/dataflow/sql/query b/gcloud/dataflow/sql/query index a37af0bc3..3d29fdc08 100644 --- a/gcloud/dataflow/sql/query +++ b/gcloud/dataflow/sql/query @@ -20,6 +20,12 @@ SYNOPSIS | --zone=ZONE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) This command is deprecated and will be removed January 31, + 2025. Please see Beam YAML + (https://beam.apache.org/documentation/sdks/yaml/) and Beam notebooks + (https://cloud.google.com/dataflow/docs/guides/notebook-advanced#beam-sql) + for alternatives. + Execute the user-specified SQL query on Dataflow. Queries must comply to the ZetaSQL dialect (https://github.com/google/zetasql). Results may be written to either BigQuery or Cloud Pub/Sub. diff --git a/gcloud/domains/registrations/google-domains-dns/export-dns-record-sets b/gcloud/domains/registrations/google-domains-dns/export-dns-record-sets new file mode 100644 index 000000000..4ea8578eb --- /dev/null +++ b/gcloud/domains/registrations/google-domains-dns/export-dns-record-sets @@ -0,0 +1,83 @@ +NAME + gcloud domains registrations google-domains-dns export-dns-record-sets - + export your registration's Google Domains DNS zone's record-sets into a + file + +SYNOPSIS + gcloud domains registrations google-domains-dns export-dns-record-sets + REGISTRATION --records-file=RECORDS_FILE [--zone-file-format] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Export your registration's Google Domains DNS (deprecated) zone's + record-sets into a file. The formats you can export to are YAML records + format (default) and BIND zone file format. + +EXAMPLES + To export DNS record-sets of example.com into a YAML file, run: + + $ gcloud domains registrations google-domains-dns \ + export-dns-record-sets example.com --records-file=records.yaml + + To export DNS record-sets of example.com into a BIND zone formatted file, + run: + + $ gcloud domains registrations google-domains-dns \ + export-dns-record-sets example.com \ + --records-file=records.zonefile --zone-file-format + +POSITIONAL ARGUMENTS + Registration resource - The domain registration to get the DNS records + 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 registration on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument registration on the command line with a fully + specified name; + ◆ location is always global. + + This must be specified. + + REGISTRATION + ID of the registration or fully qualified identifier for the + registration. + + To set the registration attribute: + ▸ provide the argument registration on the command line. + +REQUIRED FLAGS + --records-file=RECORDS_FILE + File to which record-sets should be exported. + +OPTIONAL FLAGS + --zone-file-format + Indicates that records-file should be in the zone file format. When + using this flag, expect the record-set to be exported to a BIND zone + formatted file. If you omit this flag, the record-set is exported into + a YAML formatted records file. Note, this format flag determines the + format of the output recorded in the records-file; it is different from + the global --format flag which affects console output alone. + +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 domains registrations google-domains-dns \ + export-dns-record-sets + + $ gcloud beta domains registrations google-domains-dns \ + export-dns-record-sets + diff --git a/gcloud/domains/registrations/google-domains-dns/get-forwarding-config b/gcloud/domains/registrations/google-domains-dns/get-forwarding-config new file mode 100644 index 000000000..205e6852d --- /dev/null +++ b/gcloud/domains/registrations/google-domains-dns/get-forwarding-config @@ -0,0 +1,59 @@ +NAME + gcloud domains registrations google-domains-dns get-forwarding-config - get + forwarding configuration of a specific Cloud Domains registration + +SYNOPSIS + gcloud domains registrations google-domains-dns get-forwarding-config + REGISTRATION [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Get forwarding configuration (deprecated) of a specific registration. + +EXAMPLES + To get forwarding configuration of example.com, run: + + $ gcloud domains registrations google-domains-dns \ + get-forwarding-config example.com + +POSITIONAL ARGUMENTS + Registration resource - The domain registration to get the forwarding + config 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 registration on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument registration on the command line with a fully + specified name; + ◆ location is always global. + + This must be specified. + + REGISTRATION + ID of the registration or fully qualified identifier for the + registration. + + To set the registration attribute: + ▸ provide the argument registration 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 + These variants are also available: + + $ gcloud alpha domains registrations google-domains-dns \ + get-forwarding-config + + $ gcloud beta domains registrations google-domains-dns \ + get-forwarding-config + diff --git a/gcloud/domains/registrations/google-domains-dns/help b/gcloud/domains/registrations/google-domains-dns/help new file mode 100644 index 000000000..8cd4a20c7 --- /dev/null +++ b/gcloud/domains/registrations/google-domains-dns/help @@ -0,0 +1,34 @@ +NAME + gcloud domains registrations google-domains-dns - manage deprecated Google + Domains DNS configuration + +SYNOPSIS + gcloud domains registrations google-domains-dns COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Commands for managing DNS records and forwarding configuration of Cloud + Domains registrations that use deprecated Google Domains DNS. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + export-dns-record-sets + Export your registration's Google Domains DNS zone's record-sets into a + file. + + get-forwarding-config + Get forwarding configuration of a specific Cloud Domains registration. + +NOTES + These variants are also available: + + $ gcloud alpha domains registrations google-domains-dns + + $ gcloud beta domains registrations google-domains-dns + diff --git a/gcloud/domains/registrations/help b/gcloud/domains/registrations/help index fd8555fa1..fb9df964f 100644 --- a/gcloud/domains/registrations/help +++ b/gcloud/domains/registrations/help @@ -22,6 +22,9 @@ GROUPS Configure Cloud Domains registrations' management, DNS or contact settings. + google-domains-dns + Manage deprecated Google Domains DNS configuration. + operations Manage Cloud Domains operations. diff --git a/gcloud/filestore/instances/create b/gcloud/filestore/instances/create index ca8ba270c..23c7a3bc8 100644 --- a/gcloud/filestore/instances/create +++ b/gcloud/filestore/instances/create @@ -10,7 +10,7 @@ SYNOPSIS [name=NAME],[reserved-ip-range=RESERVED-IP-RANGE] [--async] [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] [--location=LOCATION] [--region=REGION] - [--tier=TIER; default="BASIC_HDD"] + [--source-instance=SOURCE_INSTANCE] [--tier=TIER; default="BASIC_HDD"] [--kms-key=KMS_KEY : --kms-keyring=KMS_KEYRING --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT] [GCLOUD_WIDE_FLAG ...] @@ -28,7 +28,7 @@ EXAMPLES reserved-ip-range=RESERVED_IP_RANGE,connect-mode=CONNECT_MODE \ --zone=ZONE --kms-key=KMS-KEY --kms-keyring=KMS_KEYRING \ --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT \ - --flags-file=FLAGS_FILE + --flags-file=FLAGS_FILE --source-instance=SOURCE_INSTANCE Example json configuration file: { "--file-share": { "capacity": "61440", @@ -209,6 +209,9 @@ OPTIONAL FLAGS --region=REGION Region of the Cloud Filestore instance. + --source-instance=SOURCE_INSTANCE + The replication source instance of the Cloud Filestore instance. + --tier=TIER; default="BASIC_HDD" The service tier for the Cloud Filestore instance. For more details, see: https://cloud.google.com/filestore/docs/instance-tiers diff --git a/gcloud/functions/deploy b/gcloud/functions/deploy index 8101310c4..705cc8093 100644 --- a/gcloud/functions/deploy +++ b/gcloud/functions/deploy @@ -3,9 +3,11 @@ NAME SYNOPSIS gcloud functions deploy (NAME : --region=REGION) - [--[no-]allow-unauthenticated] [--concurrency=CONCURRENCY] - [--docker-registry=DOCKER_REGISTRY] [--egress-settings=EGRESS_SETTINGS] - [--entry-point=ENTRY_POINT] [--gen2] [--ignore-file=IGNORE_FILE] + [--[no-]allow-unauthenticated] + [--build-service-account=BUILD_SERVICE_ACCOUNT] + [--concurrency=CONCURRENCY] [--docker-registry=DOCKER_REGISTRY] + [--egress-settings=EGRESS_SETTINGS] [--entry-point=ENTRY_POINT] + [--gen2] [--ignore-file=IGNORE_FILE] [--ingress-settings=INGRESS_SETTINGS] [--retry] [--run-service-account=RUN_SERVICE_ACCOUNT] [--runtime=RUNTIME] [--runtime-update-policy=RUNTIME_UPDATE_POLICY] @@ -102,6 +104,15 @@ FLAGS without checking authentication. Use --allow-unauthenticated to enable and --no-allow-unauthenticated to disable. + --build-service-account=BUILD_SERVICE_ACCOUNT + IAM service account whose credentials will be used for the build step. + Must be of the format + projects/${PROJECT_ID}/serviceAccounts/${ACCOUNT_EMAIL_ADDRESS} or + {ACCOUNT_EMAIL_ADDRESS}. + + If not provided, the function will use the project's default service + account for Cloud Build. + --concurrency=CONCURRENCY Set the maximum number of concurrent requests allowed per container instance. Leave concurrency unspecified to receive the server default diff --git a/gcloud/iap/settings/get b/gcloud/iap/settings/get index eab7b9301..5c75c5f4a 100644 --- a/gcloud/iap/settings/get +++ b/gcloud/iap/settings/get @@ -4,6 +4,7 @@ NAME SYNOPSIS gcloud iap settings get [--folder=FOLDER --organization=ORGANIZATION --project=PROJECT + --region=REGION --resource-type=RESOURCE_TYPE --service=SERVICE --version=VERSION] [GCLOUD_WIDE_FLAG ...] @@ -55,6 +56,12 @@ EXAMPLES $ gcloud iap settings get --project=PROJECT_ID \ --resource-type=compute --service=SERVICE_ID + To get the IAP setting for a regional backend service within a project, + run: + + $ gcloud iap settings get --project=PROJECT_ID \ + --resource-type=compute --service=SERVICE_ID --region=REGION_ID + FLAGS --folder=FOLDER Folder ID. @@ -65,6 +72,11 @@ FLAGS --project=PROJECT Project ID. + --region=REGION + Region name. Not applicable for app-engine. Required when resource-type + is compute and regional scoped. Not applicable for compute when global + scoped. + --resource-type=RESOURCE_TYPE Resource type of the IAP resource. RESOURCE_TYPE must be one of: app-engine, iap_web, compute, organization, folder. diff --git a/gcloud/iap/settings/set b/gcloud/iap/settings/set index 17da87ca4..014047eda 100644 --- a/gcloud/iap/settings/set +++ b/gcloud/iap/settings/set @@ -4,6 +4,7 @@ NAME SYNOPSIS gcloud iap settings set SETTING_FILE [--folder=FOLDER --organization=ORGANIZATION --project=PROJECT + --region=REGION --resource-type=RESOURCE_TYPE --service=SERVICE --version=VERSION] [GCLOUD_WIDE_FLAG ...] @@ -56,6 +57,11 @@ EXAMPLES $ gcloud iap settings set iap_settings.yaml --project=PROJECT_ID \ --resource-type=compute --service=SERVICE_ID + To set the IAP setting for a region backend service within a project, run: + + $ gcloud iap settings set iap_settings.yaml --project=PROJECT_ID \ + --resource-type=compute --service=SERVICE_ID --region=REGION_ID + POSITIONAL ARGUMENTS SETTING_FILE JSON or YAML file containing the IAP resource settings. @@ -114,6 +120,11 @@ FLAGS --project=PROJECT Project ID. + --region=REGION + Region name. Not applicable for app-engine. Required when resource-type + is compute and regional scoped. Not applicable for compute when global + scoped. + --resource-type=RESOURCE_TYPE Resource type of the IAP resource. RESOURCE_TYPE must be one of: app-engine, iap_web, compute, organization, folder. diff --git a/gcloud/iap/web/add-iam-policy-binding b/gcloud/iap/web/add-iam-policy-binding index c02ae6f97..81ac4083f 100644 --- a/gcloud/iap/web/add-iam-policy-binding +++ b/gcloud/iap/web/add-iam-policy-binding @@ -6,7 +6,8 @@ SYNOPSIS gcloud iap web add-iam-policy-binding --member=PRINCIPAL --role=ROLE [--condition=[KEY=VALUE,...] | --condition-from-file=CONDITION_FROM_FILE] - [--resource-type=RESOURCE_TYPE : --service=SERVICE --version=VERSION] + [--resource-type=RESOURCE_TYPE + : --region=REGION --service=SERVICE --version=VERSION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -25,6 +26,14 @@ EXAMPLES --resource-type=IAP_IAM_RESOURCE \ --member='user:test-user@gmail.com' --role='roles/editor' + To add an IAM policy binding for the role of 'roles/editor' for the user + 'test-user@gmail.com' on regional IAP IAM resource IAP_IAM_RESOURCE, run: + + $ gcloud iap web add-iam-policy-binding \ + --resource-type=IAP_IAM_RESOURCE \ + --member='user:test-user@gmail.com' --role='roles/editor' \ + --region=REGION + To add an IAM policy binding for the role of 'roles/editor' for all authenticated users on IAP IAM resource IAP_IAM_RESOURCE, run: @@ -109,6 +118,11 @@ OPTIONAL FLAGS Resource type of the IAP resource. RESOURCE_TYPE must be one of: app-engine, backend-services. + --region=REGION + Region name. Should only be specified with + --resource-type=backend-services if it is a regional scoped. Not + applicable for global scoped backend services. + --service=SERVICE Service name. diff --git a/gcloud/iap/web/get-iam-policy b/gcloud/iap/web/get-iam-policy index 57505d825..e4c16e072 100644 --- a/gcloud/iap/web/get-iam-policy +++ b/gcloud/iap/web/get-iam-policy @@ -3,7 +3,8 @@ NAME SYNOPSIS gcloud iap web get-iam-policy - [--resource-type=RESOURCE_TYPE : --service=SERVICE --version=VERSION] + [--resource-type=RESOURCE_TYPE + : --region=REGION --service=SERVICE --version=VERSION] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] @@ -53,11 +54,22 @@ EXAMPLES $ gcloud iap web get-iam-policy --resource-type=backend-services \ --service=SERVICE_ID + To get the IAM policy for the web accesses to the IAP protected resources + within a regional backend service, run: + + $ gcloud iap web get-iam-policy --resource-type=backend-services \ + --service=SERVICE_ID --region=REGION + FLAGS --resource-type=RESOURCE_TYPE Resource type of the IAP resource. RESOURCE_TYPE must be one of: app-engine, backend-services. + --region=REGION + Region name. Should only be specified with + --resource-type=backend-services if it is a regional scoped. Not + applicable for global scoped backend services. + --service=SERVICE Service name. diff --git a/gcloud/iap/web/remove-iam-policy-binding b/gcloud/iap/web/remove-iam-policy-binding index 24b1f8a87..e13d1d28c 100644 --- a/gcloud/iap/web/remove-iam-policy-binding +++ b/gcloud/iap/web/remove-iam-policy-binding @@ -6,7 +6,8 @@ SYNOPSIS gcloud iap web remove-iam-policy-binding --member=PRINCIPAL --role=ROLE [--all | --condition=[KEY=VALUE,...] | --condition-from-file=CONDITION_FROM_FILE] - [--resource-type=RESOURCE_TYPE : --service=SERVICE --version=VERSION] + [--resource-type=RESOURCE_TYPE + : --region=REGION --service=SERVICE --version=VERSION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -26,6 +27,14 @@ EXAMPLES --resource-type=IAP_IAM_RESOURCE \ --member='user:test-user@gmail.com' --role='roles/editor' + To remove an IAM policy binding for the role of 'roles/editor' for the user + 'test-user@gmail.com' on regional IAP IAM resource IAP_IAM_RESOURCE, run: + + $ gcloud iap web remove-iam-policy-binding \ + --resource-type=IAP_IAM_RESOURCE \ + --member='user:test-user@gmail.com' --role='roles/editor' \ + --region=REGION + To remove an IAM policy binding for the role of 'roles/editor' from all authenticated users on IAP IAM resource IAP_IAM_RESOURCE,run: @@ -125,6 +134,11 @@ OPTIONAL FLAGS Resource type of the IAP resource. RESOURCE_TYPE must be one of: app-engine, backend-services. + --region=REGION + Region name. Should only be specified with + --resource-type=backend-services if it is a regional scoped. Not + applicable for global scoped backend services. + --service=SERVICE Service name. diff --git a/gcloud/iap/web/set-iam-policy b/gcloud/iap/web/set-iam-policy index efa7c4629..f2dc85ced 100644 --- a/gcloud/iap/web/set-iam-policy +++ b/gcloud/iap/web/set-iam-policy @@ -3,7 +3,8 @@ NAME SYNOPSIS gcloud iap web set-iam-policy POLICY_FILE - [--resource-type=RESOURCE_TYPE : --service=SERVICE --version=VERSION] + [--resource-type=RESOURCE_TYPE + : --region=REGION --service=SERVICE --version=VERSION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -58,6 +59,13 @@ EXAMPLES $ gcloud iap web set-iam-policy POLICY_FILE \ --resource-type=backend-services --service=SERVICE_ID + To set the IAM policy for the web accesses to the IAP protected resources + within a regional backend service, run: + + $ gcloud iap web set-iam-policy POLICY_FILE \ + --resource-type=backend-services --service=SERVICE_ID \ + --region=REGION + POSITIONAL ARGUMENTS POLICY_FILE JSON or YAML file containing the IAM policy. @@ -67,6 +75,11 @@ FLAGS Resource type of the IAP resource. RESOURCE_TYPE must be one of: app-engine, backend-services. + --region=REGION + Region name. Should only be specified with + --resource-type=backend-services if it is a regional scoped. Not + applicable for global scoped backend services. + --service=SERVICE Service name. diff --git a/gcloud/network-connectivity/internal-ranges/update b/gcloud/network-connectivity/internal-ranges/update index 761ed5887..31e00b443 100644 --- a/gcloud/network-connectivity/internal-ranges/update +++ b/gcloud/network-connectivity/internal-ranges/update @@ -5,6 +5,7 @@ NAME SYNOPSIS gcloud network-connectivity internal-ranges update (INTERNAL_RANGE : --region=REGION) [--async] + [--clear-labels | --labels=[KEY=VALUE,...]] [--clear-overlaps | --overlaps=[OVERLAPS,...]] [--ip-cidr-range=IP_CIDR_RANGE | --prefix-length=PREFIX_LENGTH] [GCLOUD_WIDE_FLAG ...] @@ -61,6 +62,14 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + At most one of these can be specified: + + --clear-labels + Clear existing labels for the range. + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs for the range being updated. + At most one of these can be specified: --clear-overlaps diff --git a/gcloud/network-connectivity/spokes/linked-vpc-network/create b/gcloud/network-connectivity/spokes/linked-vpc-network/create index f229bfbf6..bdd546e2a 100644 --- a/gcloud/network-connectivity/spokes/linked-vpc-network/create +++ b/gcloud/network-connectivity/spokes/linked-vpc-network/create @@ -6,7 +6,8 @@ SYNOPSIS gcloud network-connectivity spokes linked-vpc-network create SPOKE --hub=HUB --vpc-network=VPC_NETWORK [--async] [--description=DESCRIPTION] [--exclude-export-ranges=[CIDR_RANGE,...]] - [--global] [--labels=[KEY=VALUE,...]] [GCLOUD_WIDE_FLAG ...] + [--global] [--include-export-ranges=[CIDR_RANGE,...]] + [--labels=[KEY=VALUE,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION Create a new VPC spoke. @@ -62,12 +63,16 @@ OPTIONAL FLAGS Description of the spoke to create. --exclude-export-ranges=[CIDR_RANGE,...] - IP address range(s) to hide from subnets in VPC networks that are - peered through Network Connectivity Center peering. + Subnet IP address range(s) to hide from other VPC networks that are + connected through Network Connectivity Center. --global Indicates that the spoke is global. + --include-export-ranges=[CIDR_RANGE,...] + Subnet IP address range(s) to export to other VPC networks that are + connected through Network Connectivity Center. + --labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to add. diff --git a/gcloud/pubsub/subscriptions/create b/gcloud/pubsub/subscriptions/create index 3a3a489ad..04edea57d 100644 --- a/gcloud/pubsub/subscriptions/create +++ b/gcloud/pubsub/subscriptions/create @@ -16,7 +16,7 @@ SYNOPSIS : --bigquery-service-account-email=BIGQUERY_SERVICE_ACCOUNT_EMAIL --drop-unknown-fields --write-metadata --use-table-schema | --use-topic-schema] | [--cloud-storage-bucket=CLOUD_STORAGE_BUCKET - : --cloud-storage-file-datetime-format=CLOUD_STORAGE_FILE_DATETIME_FORMAT --cloud-storage-file-prefix=CLOUD_STORAGE_FILE_PREFIX --cloud-storage-file-suffix=CLOUD_STORAGE_FILE_SUFFIX --cloud-storage-max-bytes=CLOUD_STORAGE_MAX_BYTES --cloud-storage-max-duration=CLOUD_STORAGE_MAX_DURATION --cloud-storage-output-format=OUTPUT_FORMAT; default="text" --cloud-storage-service-account-email=CLOUD_STORAGE_SERVICE_ACCOUNT_EMAIL --cloud-storage-write-metadata]] + : --cloud-storage-file-datetime-format=CLOUD_STORAGE_FILE_DATETIME_FORMAT --cloud-storage-file-prefix=CLOUD_STORAGE_FILE_PREFIX --cloud-storage-file-suffix=CLOUD_STORAGE_FILE_SUFFIX --cloud-storage-max-bytes=CLOUD_STORAGE_MAX_BYTES --cloud-storage-max-duration=CLOUD_STORAGE_MAX_DURATION --cloud-storage-output-format=OUTPUT_FORMAT; default="text" --cloud-storage-service-account-email=CLOUD_STORAGE_SERVICE_ACCOUNT_EMAIL --cloud-storage-use-topic-schema --cloud-storage-write-metadata]] [--max-delivery-attempts=MAX_DELIVERY_ATTEMPTS [--dead-letter-topic=DEAD_LETTER_TOPIC : --dead-letter-topic-project=DEAD_LETTER_TOPIC_PROJECT]] @@ -242,6 +242,13 @@ OPTIONAL FLAGS unspecified, uses the Pub/Sub service agent (https://cloud.google.com/iam/docs/service-account-types#service-agents). + --cloud-storage-use-topic-schema + Whether or not to use the schema for the subscription's topic (if + it exists) when writing messages to Cloud Storage. This has an + effect only for subscriptions with + --cloud-storage-output-format=avro. Use + --no-cloud-storage-use-topic-schema to disable this flag. + --cloud-storage-write-metadata Whether or not to write the subscription name, message_id, publish_time, attributes, and ordering_key as additional fields in diff --git a/gcloud/pubsub/subscriptions/update b/gcloud/pubsub/subscriptions/update index e169980ea..b799705f6 100644 --- a/gcloud/pubsub/subscriptions/update +++ b/gcloud/pubsub/subscriptions/update @@ -16,7 +16,7 @@ SYNOPSIS --drop-unknown-fields --write-metadata --use-table-schema | --use-topic-schema] | --clear-cloud-storage-config | [--cloud-storage-bucket=CLOUD_STORAGE_BUCKET - : --cloud-storage-file-datetime-format=CLOUD_STORAGE_FILE_DATETIME_FORMAT --cloud-storage-file-prefix=CLOUD_STORAGE_FILE_PREFIX --cloud-storage-file-suffix=CLOUD_STORAGE_FILE_SUFFIX --cloud-storage-max-bytes=CLOUD_STORAGE_MAX_BYTES --cloud-storage-max-duration=CLOUD_STORAGE_MAX_DURATION --cloud-storage-output-format=OUTPUT_FORMAT; default="text" --cloud-storage-service-account-email=CLOUD_STORAGE_SERVICE_ACCOUNT_EMAIL --cloud-storage-write-metadata]] + : --cloud-storage-file-datetime-format=CLOUD_STORAGE_FILE_DATETIME_FORMAT --cloud-storage-file-prefix=CLOUD_STORAGE_FILE_PREFIX --cloud-storage-file-suffix=CLOUD_STORAGE_FILE_SUFFIX --cloud-storage-max-bytes=CLOUD_STORAGE_MAX_BYTES --cloud-storage-max-duration=CLOUD_STORAGE_MAX_DURATION --cloud-storage-output-format=OUTPUT_FORMAT; default="text" --cloud-storage-service-account-email=CLOUD_STORAGE_SERVICE_ACCOUNT_EMAIL --cloud-storage-use-topic-schema --cloud-storage-write-metadata]] [--clear-dead-letter-policy | --max-delivery-attempts=MAX_DELIVERY_ATTEMPTS [--dead-letter-topic=DEAD_LETTER_TOPIC @@ -222,6 +222,13 @@ FLAGS If unspecified, uses the Pub/Sub service agent (https://cloud.google.com/iam/docs/service-account-types#service-agents). + --cloud-storage-use-topic-schema + Whether or not to use the schema for the subscription's topic (if + it exists) when writing messages to Cloud Storage. This has an + effect only for subscriptions with + --cloud-storage-output-format=avro. Use + --no-cloud-storage-use-topic-schema to disable this flag. + --cloud-storage-write-metadata Whether or not to write the subscription name, message_id, publish_time, attributes, and ordering_key as additional fields diff --git a/gcloud/resource-settings/describe b/gcloud/resource-settings/describe index 97f3ba52c..e4f8aadc1 100644 --- a/gcloud/resource-settings/describe +++ b/gcloud/resource-settings/describe @@ -7,6 +7,12 @@ SYNOPSIS | --project=PROJECT_ID) [--effective] [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) Show the value of a resource setting. + + Resource Settings is deprecated. As of November 7, 2023, no organizations + will be onboarded for any of the enabled settings, and the service will be + shut down on October 1, 2024. + Show the value of a resource setting. EXAMPLES diff --git a/gcloud/resource-settings/help b/gcloud/resource-settings/help index 2c86277d2..dfceeffab 100644 --- a/gcloud/resource-settings/help +++ b/gcloud/resource-settings/help @@ -5,6 +5,12 @@ SYNOPSIS gcloud resource-settings COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) Create and manage Resource Settings. + + Resource Settings is deprecated. As of November 7, 2023, no organizations + will be onboarded for any of the enabled settings, and the service will be + shut down on October 1, 2024. + The gcloud Resource Settings command group lets you create and manipulate resource settings. @@ -25,19 +31,19 @@ COMMANDS COMMAND is one of the following: describe - Show the value of a resource setting. + (DEPRECATED) Show the value of a resource setting. list - List all available resource settings. + (DEPRECATED) List all available resource settings. list-values - List the values for any configured resource settings. + (DEPRECATED) List the values for any configured resource settings. set-value - Update the value of a resource setting. + (DEPRECATED) Update the value of a resource setting. unset-value - Remove the value of a resource setting. + (DEPRECATED) Remove the value of a resource setting. NOTES This variant is also available: diff --git a/gcloud/resource-settings/list b/gcloud/resource-settings/list index 898ea6ec7..1092118dd 100644 --- a/gcloud/resource-settings/list +++ b/gcloud/resource-settings/list @@ -9,6 +9,12 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) List all available resource settings. + + Resource Settings is deprecated. As of November 7, 2023, no organizations + will be onboarded for any of the enabled settings, and the service will be + shut down on October 1, 2024. + List all available resource settings. EXAMPLES diff --git a/gcloud/resource-settings/list-values b/gcloud/resource-settings/list-values index 41b1e4f83..3f9c806e3 100644 --- a/gcloud/resource-settings/list-values +++ b/gcloud/resource-settings/list-values @@ -10,6 +10,12 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) List the values for any configured resource settings. + + Resource Settings is deprecated. As of November 7, 2023, no organizations + will be onboarded for any of the enabled settings, and the service will be + shut down on October 1, 2024. + List the values for any configured resource settings. EXAMPLES diff --git a/gcloud/resource-settings/set-value b/gcloud/resource-settings/set-value index 8a60ce78c..440287a22 100644 --- a/gcloud/resource-settings/set-value +++ b/gcloud/resource-settings/set-value @@ -6,6 +6,12 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) Update the value of a resource setting. + + Resource Settings is deprecated. As of November 7, 2023, no organizations + will be onboarded for any of the enabled settings, and the service will be + shut down on October 1, 2024. + Update the value of a resource setting. EXAMPLES diff --git a/gcloud/resource-settings/unset-value b/gcloud/resource-settings/unset-value index 003fd289a..8d0a73ec0 100644 --- a/gcloud/resource-settings/unset-value +++ b/gcloud/resource-settings/unset-value @@ -8,6 +8,12 @@ SYNOPSIS | --project=PROJECT_ID) [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) Remove the value of a resource setting. + + Resource Settings is deprecated. As of November 7, 2023, no organizations + will be onboarded for any of the enabled settings, and the service will be + shut down on October 1, 2024. + Remove the value of a resource setting. This reverts the resource to inheriting the resource settings from above it in the resource hierarchy, if any is set on a resource above it.