From 3a4c5997b9b0ee95fd130b6bfe1f192301e8cda8 Mon Sep 17 00:00:00 2001 From: Automated Date: Thu, 25 Jul 2024 09:27:13 +0000 Subject: [PATCH] gcloud: Thu Jul 25 09:27:13 UTC 2024 --- gcloud/_version | 8 +- gcloud/alloydb/clusters/create | 5 + gcloud/alloydb/clusters/update | 5 + gcloud/alloydb/instances/create-secondary | 11 +- .../cloud-bindings/create | 44 ++++-- gcloud/alpha/ai/endpoints/deploy-model | 6 +- gcloud/alpha/alloydb/instances/create | 6 +- .../alpha/alloydb/instances/create-secondary | 20 ++- gcloud/alpha/alloydb/instances/update | 6 +- gcloud/alpha/builds/worker-pools/apply | 37 +++++ gcloud/alpha/builds/worker-pools/help | 3 + gcloud/alpha/compute/addresses/create | 3 +- gcloud/alpha/compute/commitments/create | 5 + gcloud/alpha/compute/commitments/update | 7 +- .../firewall-policies/mirroring-rules/create | 54 +------ .../firewall-policies/mirroring-rules/update | 54 +------ gcloud/alpha/compute/forwarding-rules/create | 3 +- .../alpha/compute/instance-templates/create | 7 +- .../instance-templates/create-with-container | 7 +- .../alpha/compute/instances/add-access-config | 3 +- gcloud/alpha/compute/instances/bulk/create | 4 +- gcloud/alpha/compute/instances/create | 7 +- .../compute/instances/create-with-container | 7 +- gcloud/alpha/compute/instances/import | 4 +- .../mirroring-rules/create | 70 +-------- .../mirroring-rules/update | 71 +-------- gcloud/alpha/compute/project-info/update | 2 +- gcloud/alpha/compute/queued-resources/create | 4 +- gcloud/alpha/container/clusters/create | 32 +++- gcloud/alpha/container/clusters/create-auto | 27 +++- gcloud/alpha/container/clusters/update | 27 +++- gcloud/alpha/container/node-pools/create | 3 +- gcloud/alpha/container/node-pools/update | 3 +- gcloud/alpha/deploy/apply | 8 +- gcloud/alpha/deploy/deploy-policies/delete | 77 ++++++++++ gcloud/alpha/deploy/deploy-policies/describe | 71 +++++++++ gcloud/alpha/deploy/deploy-policies/export | 77 ++++++++++ gcloud/alpha/deploy/deploy-policies/help | 37 +++++ gcloud/alpha/deploy/help | 8 +- gcloud/alpha/functions/deploy | 4 +- gcloud/alpha/network-connectivity/spokes/help | 4 +- .../service-lb-policies/create | 4 +- .../service-lb-policies/update | 4 +- gcloud/alpha/pubsub/subscriptions/create | 7 +- gcloud/alpha/pubsub/subscriptions/update | 7 +- gcloud/alpha/scc/settings/services/describe | 4 +- .../scc/settings/services/describe-explicit | 4 +- gcloud/alpha/scc/settings/services/disable | 4 +- gcloud/alpha/scc/settings/services/enable | 4 +- gcloud/alpha/scc/settings/services/inherit | 4 +- .../scc/settings/services/modules/describe | 4 +- .../services/modules/describe-explicit | 4 +- .../scc/settings/services/modules/disable | 4 +- .../scc/settings/services/modules/enable | 4 +- .../scc/settings/services/modules/update | 4 +- gcloud/alpha/workstations/configs/create | 10 ++ gcloud/alpha/workstations/configs/update | 17 +++ gcloud/artifacts/repositories/create | 17 ++- gcloud/beta/ai/endpoints/deploy-model | 6 +- gcloud/beta/alloydb/instances/create | 6 +- .../beta/alloydb/instances/create-secondary | 20 ++- gcloud/beta/alloydb/instances/update | 6 +- gcloud/beta/builds/worker-pools/create | 91 ++++++++---- gcloud/beta/builds/worker-pools/delete | 6 +- gcloud/beta/builds/worker-pools/describe | 6 +- gcloud/beta/builds/worker-pools/list | 10 +- gcloud/beta/builds/worker-pools/update | 16 +- gcloud/beta/compute/addresses/create | 3 +- gcloud/beta/compute/forwarding-rules/create | 3 +- gcloud/beta/compute/instance-templates/create | 7 +- .../instance-templates/create-with-container | 7 +- .../beta/compute/instances/add-access-config | 3 +- gcloud/beta/compute/instances/bulk/create | 4 +- gcloud/beta/compute/instances/create | 7 +- .../compute/instances/create-with-container | 7 +- gcloud/beta/compute/instances/import | 4 +- gcloud/beta/compute/project-info/update | 2 +- gcloud/beta/container/clusters/create | 12 +- gcloud/beta/container/clusters/create-auto | 7 +- gcloud/beta/container/clusters/update | 7 +- gcloud/beta/container/node-pools/create | 3 +- gcloud/beta/container/node-pools/update | 3 +- gcloud/beta/deploy/apply | 8 +- gcloud/beta/deploy/deploy-policies/delete | 75 ++++++++++ gcloud/beta/deploy/deploy-policies/describe | 69 +++++++++ gcloud/beta/deploy/deploy-policies/export | 73 ++++++++++ gcloud/beta/deploy/deploy-policies/help | 35 +++++ gcloud/beta/deploy/help | 8 +- gcloud/beta/functions/deploy | 4 +- gcloud/beta/network-connectivity/help | 10 ++ .../network-connectivity/locations/describe | 54 +++++++ .../beta/network-connectivity/locations/help | 31 ++++ .../beta/network-connectivity/locations/list | 76 ++++++++++ .../network-connectivity/operations/describe | 68 +++++++++ .../beta/network-connectivity/operations/help | 30 ++++ .../beta/network-connectivity/operations/list | 91 ++++++++++++ gcloud/beta/network-connectivity/spokes/help | 35 +++++ .../linked-interconnect-attachments/create | 117 +++++++++++++++ .../linked-interconnect-attachments/help | 31 ++++ .../linked-interconnect-attachments/update | 116 +++++++++++++++ .../spokes/linked-router-appliances/create | 122 ++++++++++++++++ .../spokes/linked-router-appliances/help | 31 ++++ .../spokes/linked-router-appliances/update | 137 ++++++++++++++++++ .../spokes/linked-vpn-tunnels/create | 114 +++++++++++++++ .../spokes/linked-vpn-tunnels/help | 31 ++++ .../spokes/linked-vpn-tunnels/update | 114 +++++++++++++++ .../service-lb-policies/create | 4 +- .../service-lb-policies/update | 4 +- gcloud/beta/pubsub/subscriptions/create | 7 +- gcloud/beta/pubsub/subscriptions/update | 7 +- gcloud/beta/workstations/configs/create | 10 ++ gcloud/beta/workstations/configs/update | 17 +++ gcloud/compute/addresses/create | 3 +- gcloud/compute/forwarding-rules/create | 3 +- gcloud/compute/instance-templates/create | 7 +- .../instance-templates/create-with-container | 7 +- gcloud/compute/instances/add-access-config | 3 +- gcloud/compute/instances/bulk/create | 4 +- gcloud/compute/instances/create | 7 +- .../compute/instances/create-with-container | 7 +- gcloud/compute/instances/import | 4 +- gcloud/compute/project-info/update | 2 +- gcloud/container/clusters/create | 12 +- gcloud/container/clusters/create-auto | 7 +- gcloud/container/clusters/update | 7 +- gcloud/container/node-pools/create | 3 +- gcloud/container/node-pools/update | 3 +- gcloud/deploy/apply | 7 +- gcloud/deploy/deploy-policies/delete | 74 ++++++++++ gcloud/deploy/deploy-policies/describe | 67 +++++++++ gcloud/deploy/deploy-policies/export | 72 +++++++++ gcloud/deploy/deploy-policies/help | 34 +++++ gcloud/deploy/help | 7 +- gcloud/functions/deploy | 4 +- .../network-connectivity/locations/describe | 6 + gcloud/network-connectivity/locations/help | 6 + gcloud/network-connectivity/locations/list | 6 + .../network-connectivity/operations/describe | 6 + gcloud/network-connectivity/operations/help | 6 + gcloud/network-connectivity/operations/list | 6 + gcloud/network-connectivity/spokes/help | 4 +- .../linked-interconnect-attachments/create | 7 + .../linked-interconnect-attachments/help | 7 + .../linked-interconnect-attachments/update | 13 ++ .../spokes/linked-router-appliances/create | 7 + .../spokes/linked-router-appliances/help | 6 + .../spokes/linked-router-appliances/update | 13 ++ .../spokes/linked-vpn-tunnels/create | 6 + .../spokes/linked-vpn-tunnels/help | 6 + .../spokes/linked-vpn-tunnels/update | 12 ++ .../service-lb-policies/create | 4 +- .../service-lb-policies/update | 4 +- gcloud/vmware/private-clouds/clusters/update | 49 ++++++- 153 files changed, 2744 insertions(+), 496 deletions(-) create mode 100644 gcloud/alpha/builds/worker-pools/apply create mode 100644 gcloud/alpha/deploy/deploy-policies/delete create mode 100644 gcloud/alpha/deploy/deploy-policies/describe create mode 100644 gcloud/alpha/deploy/deploy-policies/export create mode 100644 gcloud/alpha/deploy/deploy-policies/help create mode 100644 gcloud/beta/deploy/deploy-policies/delete create mode 100644 gcloud/beta/deploy/deploy-policies/describe create mode 100644 gcloud/beta/deploy/deploy-policies/export create mode 100644 gcloud/beta/deploy/deploy-policies/help create mode 100644 gcloud/beta/network-connectivity/locations/describe create mode 100644 gcloud/beta/network-connectivity/locations/help create mode 100644 gcloud/beta/network-connectivity/locations/list create mode 100644 gcloud/beta/network-connectivity/operations/describe create mode 100644 gcloud/beta/network-connectivity/operations/help create mode 100644 gcloud/beta/network-connectivity/operations/list create mode 100644 gcloud/beta/network-connectivity/spokes/help create mode 100644 gcloud/beta/network-connectivity/spokes/linked-interconnect-attachments/create create mode 100644 gcloud/beta/network-connectivity/spokes/linked-interconnect-attachments/help create mode 100644 gcloud/beta/network-connectivity/spokes/linked-interconnect-attachments/update create mode 100644 gcloud/beta/network-connectivity/spokes/linked-router-appliances/create create mode 100644 gcloud/beta/network-connectivity/spokes/linked-router-appliances/help create mode 100644 gcloud/beta/network-connectivity/spokes/linked-router-appliances/update create mode 100644 gcloud/beta/network-connectivity/spokes/linked-vpn-tunnels/create create mode 100644 gcloud/beta/network-connectivity/spokes/linked-vpn-tunnels/help create mode 100644 gcloud/beta/network-connectivity/spokes/linked-vpn-tunnels/update create mode 100644 gcloud/deploy/deploy-policies/delete create mode 100644 gcloud/deploy/deploy-policies/describe create mode 100644 gcloud/deploy/deploy-policies/export create mode 100644 gcloud/deploy/deploy-policies/help diff --git a/gcloud/_version b/gcloud/_version index afd3c2fc9..73910b220 100644 --- a/gcloud/_version +++ b/gcloud/_version @@ -1,8 +1,8 @@ -Google Cloud SDK 484.0.0 -alpha 2024.07.12 -beta 2024.07.12 +Google Cloud SDK 485.0.0 +alpha 2024.07.19 +beta 2024.07.19 bq 2.1.7 bundled-python3-unix 3.11.8 -core 2024.07.12 +core 2024.07.19 gcloud-crc32c 1.0.0 gsutil 5.30 diff --git a/gcloud/alloydb/clusters/create b/gcloud/alloydb/clusters/create index 30ec843e2..36da73bd8 100644 --- a/gcloud/alloydb/clusters/create +++ b/gcloud/alloydb/clusters/create @@ -7,6 +7,7 @@ SYNOPSIS [--allocated-ip-range-name=ALLOCATED_IP_RANGE_NAME] [--async] [--database-version=DATABASE_VERSION] [--enable-private-service-connect] [--network=NETWORK] + [--subscription-type=SUBSCRIPTION_TYPE] [--continuous-backup-recovery-window-days=RECOVERY_PERIOD --enable-continuous-backup [--continuous-backup-encryption-key=CONTINUOUS_BACKUP_ENCRYPTION_KEY @@ -71,6 +72,10 @@ OPTIONAL FLAGS testsharednetwork, this would be of the form:--network=projects/testproject/global/networks/testsharednetwork + --subscription-type=SUBSCRIPTION_TYPE + Subscription type of the cluster. SUBSCRIPTION_TYPE must be one of: + STANDARD, TRIAL. + Continuous Backup configuration. If unspecified, continuous backups are enabled. diff --git a/gcloud/alloydb/clusters/update b/gcloud/alloydb/clusters/update index abd54d750..3c2f86a51 100644 --- a/gcloud/alloydb/clusters/update +++ b/gcloud/alloydb/clusters/update @@ -4,6 +4,7 @@ NAME SYNOPSIS gcloud alloydb clusters update CLUSTER --region=REGION [--async] + [--subscription-type=SUBSCRIPTION_TYPE] [--clear-automated-backup | --disable-automated-backup | --automated-backup-days-of-week=[DAYS_OF_WEEK,...] --automated-backup-start-times=[START_TIMES,...] @@ -43,6 +44,10 @@ OPTIONAL FLAGS Return immediately, without waiting for the operation in progress to complete. + --subscription-type=SUBSCRIPTION_TYPE + Subscription type of the cluster. SUBSCRIPTION_TYPE must be one of: + STANDARD, TRIAL. + Automated backup policy. At most one of these can be specified: diff --git a/gcloud/alloydb/instances/create-secondary b/gcloud/alloydb/instances/create-secondary index 0d4664607..74165e062 100644 --- a/gcloud/alloydb/instances/create-secondary +++ b/gcloud/alloydb/instances/create-secondary @@ -4,8 +4,9 @@ NAME SYNOPSIS gcloud alloydb instances create-secondary INSTANCE --cluster=CLUSTER - --region=REGION [--assign-inbound-public-ip=ASSIGN_INBOUND_PUBLIC_IP] - [--async] [--authorized-external-networks=[AUTHORIZED_NETWORK,...]] + --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] [--[no-]require-connectors] [--ssl-mode=SSL_MODE] [GCLOUD_WIDE_FLAG ...] @@ -31,6 +32,12 @@ REQUIRED FLAGS regions at https://cloud.google.com/sql/docs/instance-locations. OPTIONAL FLAGS + --allowed-psc-projects=[ALLOWED_PSC_PROJECTS,...] + Comma-separated list of allowed consumer projects to create endpoints + for Private Service Connect (PSC) connectivity for the instance. Only + instances in PSC-enabled clusters are allowed to set this field.(e.g., + --allowed-psc-projects=project1,12345678,project2) + --assign-inbound-public-ip=ASSIGN_INBOUND_PUBLIC_IP Specify to enable or disable public IP on an instance. ASSIGN_INBOUND_PUBLIC_IP must be one of: diff --git a/gcloud/alpha/access-context-manager/cloud-bindings/create b/gcloud/alpha/access-context-manager/cloud-bindings/create index 602bc2d63..36dd079c3 100644 --- a/gcloud/alpha/access-context-manager/cloud-bindings/create +++ b/gcloud/alpha/access-context-manager/cloud-bindings/create @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud alpha access-context-manager cloud-bindings create - --group-key=GROUP_KEY [--dry-run-level=[DRY_RUN_LEVEL,...]] + [--dry-run-level=[DRY_RUN_LEVEL,...]] [--group-key=GROUP_KEY] [--level=[LEVEL,...]] [--organization=ORGANIZATION] [--restricted-client-application-client-ids=[RESTRICTED_CLIENT_APPLICATION_CLIENT_IDS, ...]] @@ -13,11 +13,19 @@ SYNOPSIS 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 binding. If a restricted client application is - specified, then the enforcement applies only to the specified application, - and not to the entire organization. + + ▪ a group and the restricted client application + ▪ a specific service account or all service accounts in a specified + project. + + If a group key is specified, the access level is enforced at the + organization level for all context-aware access group members, as specified + in the binding. If a restricted client application is also specified, then + the enforcement applies only to the specified application, and not to the + entire organization. If a service account is specified, then the + enforcement applies only to the specified service account. If a service + account project is specified, then the enforcement applies to all the + service accounts belongs to the specified project. EXAMPLES To create a new cloud access binding at the organization level, run: @@ -58,12 +66,22 @@ EXAMPLES --restricted-client-application-client-ids='123456789.apps.googl\ eusercontent.com' -REQUIRED FLAGS - --group-key=GROUP_KEY - Google Group id whose members are subject to the restrictions of this - binding. + To create a new cloud access binding for a particular service account, run: -OPTIONAL FLAGS + $ gcloud alpha access-context-manager cloud-bindings create \ + --service-account=service-account@project.iam.gserviceaccount.co\ + m --level=accessPolicies/123/accessLevels/abc \ + --organization='1234567890' + + To create a new cloud access binding for all service accounts in a + particular project, run: + + $ gcloud alpha access-context-manager cloud-bindings create \ + --service-account-project-number='987654321' \ + --level=accessPolicies/123/accessLevels/abc \ + --organization='1234567890' \ + +FLAGS --dry-run-level=[DRY_RUN_LEVEL,...] The dry run access level that binds to the given group and restricted client applications. The dry run access level is evaluated but isn't @@ -74,6 +92,10 @@ OPTIONAL FLAGS restricted-client-application-names are provided, then the access level is applied to the entire organization. + --group-key=GROUP_KEY + Google Group id whose members are subject to the restrictions of this + binding. + --level=[LEVEL,...] The access level that binds to the given group and restricted client applications. The input must be the full identifier of an access level, diff --git a/gcloud/alpha/ai/endpoints/deploy-model b/gcloud/alpha/ai/endpoints/deploy-model index cb1b7917e..52765c3e3 100644 --- a/gcloud/alpha/ai/endpoints/deploy-model +++ b/gcloud/alpha/ai/endpoints/deploy-model @@ -73,9 +73,9 @@ OPTIONAL FLAGS type The type of the accelerator. Choices are 'nvidia-a100-80gb', - 'nvidia-h100-80gb', 'nvidia-l4', 'nvidia-tesla-a100', - 'nvidia-tesla-k80', 'nvidia-tesla-p100', 'nvidia-tesla-p4', - 'nvidia-tesla-t4', 'nvidia-tesla-v100'. + 'nvidia-h100-80gb', 'nvidia-h100-mega-80gb', 'nvidia-l4', + 'nvidia-tesla-a100', 'nvidia-tesla-k80', 'nvidia-tesla-p100', + 'nvidia-tesla-p4', 'nvidia-tesla-t4', 'nvidia-tesla-v100'. count The number of accelerators to attach to each machine running the diff --git a/gcloud/alpha/alloydb/instances/create b/gcloud/alpha/alloydb/instances/create index bbfff1bf1..0559982df 100644 --- a/gcloud/alpha/alloydb/instances/create +++ b/gcloud/alpha/alloydb/instances/create @@ -20,7 +20,7 @@ SYNOPSIS [--observability-config-query-plans-per-minute=OBSERVABILITY_CONFIG_QUERY_PLANS_PER_MINUTE] [--[no-]observability-config-record-application-tags] [--[no-]observability-config-track-active-queries] - [--observability-config-track-wait-events] + [--observability-config-track-wait-events] [--[no-]outbound-public-ip] [--read-pool-node-count=READ_POOL_NODE_COUNT] [--[no-]require-connectors] [--ssl-mode=SSL_MODE; default="ENCRYPTED_ONLY"] [GCLOUD_WIDE_FLAG ...] @@ -174,6 +174,10 @@ OPTIONAL FLAGS --observability-config-track-wait-events Track wait events during query execution. + --[no-]outbound-public-ip + Add outbound Public IP connectivity to an AlloyDB instance. Use + --outbound-public-ip to enable and --no-outbound-public-ip to disable. + --read-pool-node-count=READ_POOL_NODE_COUNT Read capacity, i.e. number of nodes in a read pool instance. diff --git a/gcloud/alpha/alloydb/instances/create-secondary b/gcloud/alpha/alloydb/instances/create-secondary index b44d0d185..edae8d4c9 100644 --- a/gcloud/alpha/alloydb/instances/create-secondary +++ b/gcloud/alpha/alloydb/instances/create-secondary @@ -4,10 +4,12 @@ NAME SYNOPSIS gcloud alpha alloydb instances create-secondary INSTANCE --cluster=CLUSTER - --region=REGION [--assign-inbound-public-ip=ASSIGN_INBOUND_PUBLIC_IP] - [--async] [--authorized-external-networks=[AUTHORIZED_NETWORK,...]] - [--availability-type=AVAILABILITY_TYPE] [--[no-]require-connectors] - [--ssl-mode=SSL_MODE] [GCLOUD_WIDE_FLAG ...] + --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] [--[no-]outbound-public-ip] + [--[no-]require-connectors] [--ssl-mode=SSL_MODE] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Creates a new AlloyDB SECONDARY instance within a given cluster. @@ -31,6 +33,12 @@ REQUIRED FLAGS regions at https://cloud.google.com/sql/docs/instance-locations. OPTIONAL FLAGS + --allowed-psc-projects=[ALLOWED_PSC_PROJECTS,...] + Comma-separated list of allowed consumer projects to create endpoints + for Private Service Connect (PSC) connectivity for the instance. Only + instances in PSC-enabled clusters are allowed to set this field.(e.g., + --allowed-psc-projects=project1,12345678,project2) + --assign-inbound-public-ip=ASSIGN_INBOUND_PUBLIC_IP Specify to enable or disable public IP on an instance. ASSIGN_INBOUND_PUBLIC_IP must be one of: @@ -63,6 +71,10 @@ OPTIONAL FLAGS production instances; instance does not automatically fail over to another zone. + --[no-]outbound-public-ip + Add outbound Public IP connectivity to an AlloyDB instance. Use + --outbound-public-ip to enable and --no-outbound-public-ip to disable. + --[no-]require-connectors Enable or disable enforcing connectors only (ex: AuthProxy) connections to the database. Use --require-connectors to enable and diff --git a/gcloud/alpha/alloydb/instances/update b/gcloud/alpha/alloydb/instances/update index 612bdeb1a..35bb32f1f 100644 --- a/gcloud/alpha/alloydb/instances/update +++ b/gcloud/alpha/alloydb/instances/update @@ -19,7 +19,7 @@ SYNOPSIS [--observability-config-query-plans-per-minute=OBSERVABILITY_CONFIG_QUERY_PLANS_PER_MINUTE] [--[no-]observability-config-record-application-tags] [--[no-]observability-config-track-active-queries] - [--observability-config-track-wait-events] + [--observability-config-track-wait-events] [--[no-]outbound-public-ip] [--read-pool-node-count=READ_POOL_NODE_COUNT] [--[no-]require-connectors] [--ssl-mode=SSL_MODE] [--update-mode=UPDATE_MODE] [GCLOUD_WIDE_FLAG ...] @@ -156,6 +156,10 @@ OPTIONAL FLAGS --observability-config-track-wait-events Track wait events during query execution. + --[no-]outbound-public-ip + Add outbound Public IP connectivity to an AlloyDB instance. Use + --outbound-public-ip to enable and --no-outbound-public-ip to disable. + --read-pool-node-count=READ_POOL_NODE_COUNT Read capacity, i.e. number of nodes in a read pool instance. diff --git a/gcloud/alpha/builds/worker-pools/apply b/gcloud/alpha/builds/worker-pools/apply new file mode 100644 index 000000000..d272c98c1 --- /dev/null +++ b/gcloud/alpha/builds/worker-pools/apply @@ -0,0 +1,37 @@ +NAME + gcloud alpha builds worker-pools apply - create a private pool for use by + Cloud Build + +SYNOPSIS + gcloud alpha builds worker-pools apply --file=FILE + [--generation=GENERATION; default=2] [--region=REGION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create a private pool for use by Cloud Build. + +REQUIRED FLAGS + --file=FILE + The YAML file to use as the worker pool configuration file. + +OPTIONAL FLAGS + --generation=GENERATION; default=2 + Generation of the worker pool. + + --region=REGION + Region for Cloud Build. + +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/builds/worker-pools/help b/gcloud/alpha/builds/worker-pools/help index aa565d1cb..94da38a65 100644 --- a/gcloud/alpha/builds/worker-pools/help +++ b/gcloud/alpha/builds/worker-pools/help @@ -16,6 +16,9 @@ GCLOUD WIDE FLAGS COMMANDS COMMAND is one of the following: + apply + (ALPHA) Create a private pool for use by Cloud Build. + create (ALPHA) Create a private pool for use by Cloud Build. diff --git a/gcloud/alpha/compute/addresses/create b/gcloud/alpha/compute/addresses/create index 87e237b97..6ceaf23d9 100644 --- a/gcloud/alpha/compute/addresses/create +++ b/gcloud/alpha/compute/addresses/create @@ -85,8 +85,7 @@ FLAGS --network-tier=NETWORK_TIER The network tier to assign to the reserved IP addresses. NETWORK_TIER - must be one of: PREMIUM, STANDARD, FIXED_STANDARD. The default value is - PREMIUM. + must be one of: PREMIUM, STANDARD. The default value is PREMIUM. While regional external addresses (--region specified, --subnet omitted) can use either PREMIUM or STANDARD, global external addresses diff --git a/gcloud/alpha/compute/commitments/create b/gcloud/alpha/compute/commitments/create index 5b46e23fb..c14fc43db 100644 --- a/gcloud/alpha/compute/commitments/create +++ b/gcloud/alpha/compute/commitments/create @@ -5,6 +5,7 @@ SYNOPSIS gcloud alpha compute commitments create COMMITMENT --plan=PLAN (--resources=[local-ssd=LOCAL-SSD],[memory=MEMORY],[vcpu=VCPU] --resources-accelerator=[count=COUNT],[type=TYPE]) [--auto-renew] + [--custom-end-time=CUSTOM_END_TIME] [--merge-source-commitments=MERGE_SOURCE_COMMITMENTS] [--region=REGION] [--split-source-commitment=SPLIT_SOURCE_COMMITMENT] [--type=TYPE; default="general-purpose"] @@ -69,6 +70,10 @@ OPTIONAL FLAGS --auto-renew Enable auto renewal for the commitment. + --custom-end-time=CUSTOM_END_TIME + Specifies a custom future end date and extends the commitment's ongoing + term. + --merge-source-commitments=MERGE_SOURCE_COMMITMENTS Creates the new commitment by merging the specified source commitments and combining their resources. diff --git a/gcloud/alpha/compute/commitments/update b/gcloud/alpha/compute/commitments/update index e687cc028..343f958f3 100644 --- a/gcloud/alpha/compute/commitments/update +++ b/gcloud/alpha/compute/commitments/update @@ -3,7 +3,8 @@ NAME SYNOPSIS gcloud alpha compute commitments update COMMITMENT [--auto-renew] - [--plan=PLAN] [--region=REGION] [GCLOUD_WIDE_FLAG ...] + [--custom-end-time=CUSTOM_END_TIME] [--plan=PLAN] [--region=REGION] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Update Compute Engine commitments. @@ -35,6 +36,10 @@ FLAGS --auto-renew Enable auto renewal for the commitment. + --custom-end-time=CUSTOM_END_TIME + Specifies a custom future end date and extends the commitment's ongoing + term. + --plan=PLAN Duration of the commitment. PLAN must be (only one value is supported): 36-month. diff --git a/gcloud/alpha/compute/firewall-policies/mirroring-rules/create b/gcloud/alpha/compute/firewall-policies/mirroring-rules/create index 9ef5a81e1..64d1bd762 100644 --- a/gcloud/alpha/compute/firewall-policies/mirroring-rules/create +++ b/gcloud/alpha/compute/firewall-policies/mirroring-rules/create @@ -5,21 +5,12 @@ NAME SYNOPSIS gcloud alpha compute firewall-policies mirroring-rules create PRIORITY --action=ACTION --firewall-policy=FIREWALL_POLICY - [--description=DESCRIPTION] - [--dest-address-groups=[DEST_ADDRESS_GROUPS,...]] - [--dest-fqdns=[DEST_FQDNS,...]] [--dest-ip-ranges=[DEST_IP_RANGE,...]] - [--dest-region-codes=[DEST_REGION_CODES,...]] - [--dest-threat-intelligence=[DEST_THREAT_INTELLIGENCE_LISTS,...]] + [--description=DESCRIPTION] [--dest-ip-ranges=[DEST_IP_RANGE,...]] [--direction=DIRECTION] [--[no-]disabled] [--layer4-configs=[LAYER4_CONFIG,...]] [--organization=ORGANIZATION] [--security-profile-group=SECURITY_PROFILE_GROUP] - [--src-address-groups=[SOURCE_ADDRESS_GROUPS,...]] - [--src-fqdns=[SOURCE_FQDNS,...]] [--src-ip-ranges=[SRC_IP_RANGE,...]] - [--src-region-codes=[SOURCE_REGION_CODES,...]] - [--src-threat-intelligence=[SOURCE_THREAT_INTELLIGENCE_LISTS,...]] - [--target-resources=[TARGET_RESOURCES,...]] - [--target-service-accounts=[TARGET_SERVICE_ACCOUNTS,...]] - [GCLOUD_WIDE_FLAG ...] + [--src-ip-ranges=[SRC_IP_RANGE,...]] + [--target-resources=[TARGET_RESOURCES,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) gcloud alpha compute firewall-policies mirroring-rules create is @@ -52,27 +43,9 @@ OPTIONAL FLAGS --description=DESCRIPTION An optional, textual description for the rule. - --dest-address-groups=[DEST_ADDRESS_GROUPS,...] - Destination address groups to match for this rule. Can only be - specified if DIRECTION is egress. - - --dest-fqdns=[DEST_FQDNS,...] - Destination FQDNs to match for this rule. Can only be specified if - DIRECTION is egress. - --dest-ip-ranges=[DEST_IP_RANGE,...] Destination IP ranges to match for this rule. - --dest-region-codes=[DEST_REGION_CODES,...] - Destination Region Code to match for this rule. Can only be specified - if DIRECTION is egress. - - --dest-threat-intelligence=[DEST_THREAT_INTELLIGENCE_LISTS,...] - Destination Threat Intelligence lists to match for this rule. Can only - be specified if DIRECTION is egress. The available lists can be found - here: - https://cloud.google.com/vpc/docs/firewall-policies-rule-details#threat-intelligence-fw-policy. - --direction=DIRECTION Direction of the traffic the rule is applied. The default is to apply on incoming traffic. DIRECTION must be one of: INGRESS, EGRESS. @@ -101,33 +74,12 @@ OPTIONAL FLAGS In order to set this property, please run the command gcloud config set api_endpoint_overrides/networksecurity https:///. - --src-address-groups=[SOURCE_ADDRESS_GROUPS,...] - Source address groups to match for this rule. Can only be specified if - DIRECTION is ingress. - - --src-fqdns=[SOURCE_FQDNS,...] - Source FQDNs to match for this rule. Can only be specified if DIRECTION - is ingress. - --src-ip-ranges=[SRC_IP_RANGE,...] Source IP ranges to match for this rule. - --src-region-codes=[SOURCE_REGION_CODES,...] - Source Region Code to match for this rule. Can only be specified if - DIRECTION is ingress. - - --src-threat-intelligence=[SOURCE_THREAT_INTELLIGENCE_LISTS,...] - Source Threat Intelligence lists to match for this rule. Can only be - specified if DIRECTION is ingress. The available lists can be found - here: - https://cloud.google.com/vpc/docs/firewall-policies-rule-details#threat-intelligence-fw-policy. - --target-resources=[TARGET_RESOURCES,...] List of URLs of target resources to which the rule is applied. - --target-service-accounts=[TARGET_SERVICE_ACCOUNTS,...] - List of target service accounts for the rule. - GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/compute/firewall-policies/mirroring-rules/update b/gcloud/alpha/compute/firewall-policies/mirroring-rules/update index e100a1a84..5a637bfaa 100644 --- a/gcloud/alpha/compute/firewall-policies/mirroring-rules/update +++ b/gcloud/alpha/compute/firewall-policies/mirroring-rules/update @@ -5,22 +5,13 @@ NAME SYNOPSIS gcloud alpha compute firewall-policies mirroring-rules update PRIORITY --firewall-policy=FIREWALL_POLICY [--action=ACTION] - [--description=DESCRIPTION] - [--dest-address-groups=[DEST_ADDRESS_GROUPS,...]] - [--dest-fqdns=[DEST_FQDNS,...]] [--dest-ip-ranges=[DEST_IP_RANGE,...]] - [--dest-region-codes=[DEST_REGION_CODES,...]] - [--dest-threat-intelligence=[DEST_THREAT_INTELLIGENCE_LISTS,...]] + [--description=DESCRIPTION] [--dest-ip-ranges=[DEST_IP_RANGE,...]] [--direction=DIRECTION] [--[no-]disabled] [--layer4-configs=[LAYER4_CONFIG,...]] [--new-priority=NEW_PRIORITY] [--organization=ORGANIZATION] [--security-profile-group=SECURITY_PROFILE_GROUP] - [--src-address-groups=[SOURCE_ADDRESS_GROUPS,...]] - [--src-fqdns=[SOURCE_FQDNS,...]] [--src-ip-ranges=[SRC_IP_RANGE,...]] - [--src-region-codes=[SOURCE_REGION_CODES,...]] - [--src-threat-intelligence=[SOURCE_THREAT_INTELLIGENCE_LISTS,...]] - [--target-resources=[TARGET_RESOURCES,...]] - [--target-service-accounts=[TARGET_SERVICE_ACCOUNTS,...]] - [GCLOUD_WIDE_FLAG ...] + [--src-ip-ranges=[SRC_IP_RANGE,...]] + [--target-resources=[TARGET_RESOURCES,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) gcloud alpha compute firewall-policies mirroring-rules update is @@ -52,27 +43,9 @@ OPTIONAL FLAGS --description=DESCRIPTION An optional, textual description for the rule. - --dest-address-groups=[DEST_ADDRESS_GROUPS,...] - Destination address groups to match for this rule. Can only be - specified if DIRECTION is egress. - - --dest-fqdns=[DEST_FQDNS,...] - Destination FQDNs to match for this rule. Can only be specified if - DIRECTION is egress. - --dest-ip-ranges=[DEST_IP_RANGE,...] Destination IP ranges to match for this rule. - --dest-region-codes=[DEST_REGION_CODES,...] - Destination Region Code to match for this rule. Can only be specified - if DIRECTION is egress. - - --dest-threat-intelligence=[DEST_THREAT_INTELLIGENCE_LISTS,...] - Destination Threat Intelligence lists to match for this rule. Can only - be specified if DIRECTION is egress. The available lists can be found - here: - https://cloud.google.com/vpc/docs/firewall-policies-rule-details#threat-intelligence-fw-policy. - --direction=DIRECTION Direction of the traffic the rule is applied. The default is to apply on incoming traffic. DIRECTION must be one of: INGRESS, EGRESS. @@ -104,33 +77,12 @@ OPTIONAL FLAGS In order to set this property, please run the command gcloud config set api_endpoint_overrides/networksecurity https:///. - --src-address-groups=[SOURCE_ADDRESS_GROUPS,...] - Source address groups to match for this rule. Can only be specified if - DIRECTION is ingress. - - --src-fqdns=[SOURCE_FQDNS,...] - Source FQDNs to match for this rule. Can only be specified if DIRECTION - is ingress. - --src-ip-ranges=[SRC_IP_RANGE,...] Source IP ranges to match for this rule. - --src-region-codes=[SOURCE_REGION_CODES,...] - Source Region Code to match for this rule. Can only be specified if - DIRECTION is ingress. - - --src-threat-intelligence=[SOURCE_THREAT_INTELLIGENCE_LISTS,...] - Source Threat Intelligence lists to match for this rule. Can only be - specified if DIRECTION is ingress. The available lists can be found - here: - https://cloud.google.com/vpc/docs/firewall-policies-rule-details#threat-intelligence-fw-policy. - --target-resources=[TARGET_RESOURCES,...] List of URLs of target resources to which the rule is applied. - --target-service-accounts=[TARGET_SERVICE_ACCOUNTS,...] - List of target service accounts for the rule. - GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/compute/forwarding-rules/create b/gcloud/alpha/compute/forwarding-rules/create index fcd516c37..e874e238a 100644 --- a/gcloud/alpha/compute/forwarding-rules/create +++ b/gcloud/alpha/compute/forwarding-rules/create @@ -287,8 +287,7 @@ OPTIONAL FLAGS --network-tier=NETWORK_TIER Network tier to assign to the forwarding rules. NETWORK_TIER must be - one of: PREMIUM, STANDARD, FIXED_STANDARD. The default value is - PREMIUM. + one of: PREMIUM, STANDARD. The default value is PREMIUM. --service-directory-registration=SERVICE_DIRECTORY_REGISTRATION The Service Directory service in which to register this forwarding rule diff --git a/gcloud/alpha/compute/instance-templates/create b/gcloud/alpha/compute/instance-templates/create index ea8adcae6..66ce421fb 100644 --- a/gcloud/alpha/compute/instance-templates/create +++ b/gcloud/alpha/compute/instance-templates/create @@ -680,8 +680,7 @@ FLAGS network-tier Specifies the network tier of the interface. NETWORK_TIER must be - one of: PREMIUM, STANDARD, FIXED_STANDARD. The default value is - PREMIUM. + one of: PREMIUM, STANDARD. The default value is PREMIUM. private-network-ip Assigns the given RFC1918 IP address to the interface. @@ -776,8 +775,8 @@ FLAGS --network-tier=NETWORK_TIER Specifies the network tier that will be used to configure the instance. - NETWORK_TIER must be one of: PREMIUM, STANDARD, FIXED_STANDARD. The - default value is PREMIUM. + NETWORK_TIER must be one of: PREMIUM, STANDARD. The default value is + PREMIUM. --numa-node-count=NUMA_NODE_COUNT The number of virtual NUMA nodes for the instance. Valid values are: 0, diff --git a/gcloud/alpha/compute/instance-templates/create-with-container b/gcloud/alpha/compute/instance-templates/create-with-container index 4a0495841..5e7e07419 100644 --- a/gcloud/alpha/compute/instance-templates/create-with-container +++ b/gcloud/alpha/compute/instance-templates/create-with-container @@ -597,8 +597,7 @@ FLAGS network-tier Specifies the network tier of the interface. NETWORK_TIER must be - one of: PREMIUM, STANDARD, FIXED_STANDARD. The default value is - PREMIUM. + one of: PREMIUM, STANDARD. The default value is PREMIUM. private-network-ip Assigns the given RFC1918 IP address to the interface. @@ -664,8 +663,8 @@ FLAGS --network-tier=NETWORK_TIER Specifies the network tier that will be used to configure the instance. - NETWORK_TIER must be one of: PREMIUM, STANDARD, FIXED_STANDARD. The - default value is PREMIUM. + NETWORK_TIER must be one of: PREMIUM, STANDARD. The default value is + PREMIUM. --preemptible If provided, instances will be preemptible and time-limited. Instances diff --git a/gcloud/alpha/compute/instances/add-access-config b/gcloud/alpha/compute/instances/add-access-config index 782e83b5f..97a647868 100644 --- a/gcloud/alpha/compute/instances/add-access-config +++ b/gcloud/alpha/compute/instances/add-access-config @@ -58,8 +58,7 @@ FLAGS --network-tier=NETWORK_TIER Specifies the network tier of the access configuration. NETWORK_TIER - must be one of: PREMIUM, STANDARD, FIXED_STANDARD. The default value is - PREMIUM. + must be one of: PREMIUM, STANDARD. The default value is PREMIUM. --zone=ZONE Zone of the instance to operate on. If not specified, you might be diff --git a/gcloud/alpha/compute/instances/bulk/create b/gcloud/alpha/compute/instances/bulk/create index 3f1bc0b67..2eccbc7c5 100644 --- a/gcloud/alpha/compute/instances/bulk/create +++ b/gcloud/alpha/compute/instances/bulk/create @@ -682,8 +682,8 @@ OPTIONAL FLAGS --network-tier=NETWORK_TIER Specifies the network tier that will be used to configure the instance. - NETWORK_TIER must be one of: PREMIUM, STANDARD, FIXED_STANDARD. The - default value is PREMIUM. + NETWORK_TIER must be one of: PREMIUM, STANDARD. The default value is + PREMIUM. --numa-node-count=NUMA_NODE_COUNT The number of virtual NUMA nodes for the instance. Valid values are: 0, diff --git a/gcloud/alpha/compute/instances/create b/gcloud/alpha/compute/instances/create index 0249d25c2..e27730412 100644 --- a/gcloud/alpha/compute/instances/create +++ b/gcloud/alpha/compute/instances/create @@ -793,8 +793,8 @@ FLAGS --network-tier=NETWORK_TIER Specifies the network tier that will be used to configure the instance. - NETWORK_TIER must be one of: PREMIUM, STANDARD, FIXED_STANDARD. The - default value is PREMIUM. + NETWORK_TIER must be one of: PREMIUM, STANDARD. The default value is + PREMIUM. --node-project=NODE_PROJECT The name of the project with shared sole tenant node groups to create @@ -1303,8 +1303,7 @@ FLAGS network-tier Specifies the network tier of the interface. NETWORK_TIER must be - one of: PREMIUM, STANDARD, FIXED_STANDARD. The default value is - PREMIUM. + one of: PREMIUM, STANDARD. The default value is PREMIUM. private-network-ip Assigns the given RFC1918 IP address to the interface. diff --git a/gcloud/alpha/compute/instances/create-with-container b/gcloud/alpha/compute/instances/create-with-container index b548844cc..2094b51b0 100644 --- a/gcloud/alpha/compute/instances/create-with-container +++ b/gcloud/alpha/compute/instances/create-with-container @@ -682,8 +682,7 @@ FLAGS network-tier Specifies the network tier of the interface. NETWORK_TIER must be - one of: PREMIUM, STANDARD, FIXED_STANDARD. The default value is - PREMIUM. + one of: PREMIUM, STANDARD. The default value is PREMIUM. private-network-ip Assigns the given RFC1918 IP address to the interface. @@ -765,8 +764,8 @@ FLAGS --network-tier=NETWORK_TIER Specifies the network tier that will be used to configure the instance. - NETWORK_TIER must be one of: PREMIUM, STANDARD, FIXED_STANDARD. The - default value is PREMIUM. + NETWORK_TIER must be one of: PREMIUM, STANDARD. The default value is + PREMIUM. --numa-node-count=NUMA_NODE_COUNT The number of virtual NUMA nodes for the instance. Valid values are: 0, diff --git a/gcloud/alpha/compute/instances/import b/gcloud/alpha/compute/instances/import index 5faf4fe53..4ca4976d0 100644 --- a/gcloud/alpha/compute/instances/import +++ b/gcloud/alpha/compute/instances/import @@ -183,8 +183,8 @@ OPTIONAL FLAGS --network-tier=NETWORK_TIER Specifies the network tier that will be used to configure the instance. - NETWORK_TIER must be one of: PREMIUM, STANDARD, FIXED_STANDARD. The - default value is PREMIUM. + NETWORK_TIER must be one of: PREMIUM, STANDARD. The default value is + PREMIUM. --os=OS Specifies the OS of the image being imported. OS must be one of: diff --git a/gcloud/alpha/compute/network-firewall-policies/mirroring-rules/create b/gcloud/alpha/compute/network-firewall-policies/mirroring-rules/create index 01a9a6480..643a882cc 100644 --- a/gcloud/alpha/compute/network-firewall-policies/mirroring-rules/create +++ b/gcloud/alpha/compute/network-firewall-policies/mirroring-rules/create @@ -6,21 +6,10 @@ SYNOPSIS gcloud alpha compute network-firewall-policies mirroring-rules create PRIORITY --action=ACTION --firewall-policy=FIREWALL_POLICY --global-firewall-policy [--description=DESCRIPTION] - [--dest-address-groups=[DEST_ADDRESS_GROUPS,...]] - [--dest-fqdns=[DEST_FQDNS,...]] [--dest-ip-ranges=[DEST_IP_RANGE,...]] - [--dest-region-codes=[DEST_REGION_CODES,...]] - [--dest-threat-intelligence=[DEST_THREAT_INTELLIGENCE_LISTS,...]] - [--direction=DIRECTION] [--[no-]disabled] - [--layer4-configs=[LAYER4_CONFIG,...]] + [--dest-ip-ranges=[DEST_IP_RANGE,...]] [--direction=DIRECTION] + [--[no-]disabled] [--layer4-configs=[LAYER4_CONFIG,...]] [--security-profile-group=SECURITY_PROFILE_GROUP] - [--src-address-groups=[SOURCE_ADDRESS_GROUPS,...]] - [--src-fqdns=[SOURCE_FQDNS,...]] [--src-ip-ranges=[SRC_IP_RANGE,...]] - [--src-region-codes=[SOURCE_REGION_CODES,...]] - [--src-secure-tags=[SOURCE_SECURE_TAGS,...]] - [--src-threat-intelligence=[SOURCE_THREAT_INTELLIGENCE_LISTS,...]] - [--target-secure-tags=[TARGET_SECURE_TAGS,...]] - [--target-service-accounts=[TARGET_SERVICE_ACCOUNTS,...]] - [GCLOUD_WIDE_FLAG ...] + [--src-ip-ranges=[SRC_IP_RANGE,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) gcloud alpha compute network-firewall-policies mirroring-rules @@ -53,27 +42,9 @@ OPTIONAL FLAGS --description=DESCRIPTION An optional, textual description for the rule. - --dest-address-groups=[DEST_ADDRESS_GROUPS,...] - Destination address groups to match for this rule. Can only be - specified if DIRECTION is engress. - - --dest-fqdns=[DEST_FQDNS,...] - Destination FQDNs to match for this rule. Can only be specified if - DIRECTION is egress. - --dest-ip-ranges=[DEST_IP_RANGE,...] Destination IP ranges to match for this rule. - --dest-region-codes=[DEST_REGION_CODES,...] - Destination Region Code to match for this rule. Can only be specified - if DIRECTION is egress. - - --dest-threat-intelligence=[DEST_THREAT_INTELLIGENCE_LISTS,...] - Destination Threat Intelligence lists to match for this rule. Can only - be specified if DIRECTION is egress. The available lists can be found - here: - https://cloud.google.com/vpc/docs/firewall-policies-rule-details#threat-intelligence-fw-policy. - --direction=DIRECTION Direction of the traffic the rule is applied. The default is to apply on incoming traffic. DIRECTION must be one of: INGRESS, EGRESS. @@ -90,14 +61,6 @@ OPTIONAL FLAGS A security profile group to be used with apply_security_profile_group action. - --src-address-groups=[SOURCE_ADDRESS_GROUPS,...] - Source address groups to match for this rule. Can only be specified if - DIRECTION is ingress. - - --src-fqdns=[SOURCE_FQDNS,...] - Source FQDNs to match for this rule. Can only be specified if DIRECTION - is ingress. - --src-ip-ranges=[SRC_IP_RANGE,...] A list of IP address blocks that are allowed to make inbound connections that match the firewall rule to the instances on the @@ -110,33 +73,6 @@ OPTIONAL FLAGS --src-secure-tags.Multiple IP address blocks can be specified if they are separated by commas. - --src-region-codes=[SOURCE_REGION_CODES,...] - Source Region Code to match for this rule. Can only be specified if - DIRECTION is ingress. - - --src-secure-tags=[SOURCE_SECURE_TAGS,...] - A list of instance secure tags indicating the set of instances on the - network to which the rule applies if all other fields match. Either - --src-ip-ranges or --src-secure-tags must be specified for ingress - traffic. If both --src-ip-ranges and --src-secure-tags are specified, - an inbound connection is allowed if either the range of the source - matches --src-ip-ranges or the tag of the source matches - --src-secure-tags. Secure Tags can be assigned to instances during - instance creation. - - --src-threat-intelligence=[SOURCE_THREAT_INTELLIGENCE_LISTS,...] - Source Threat Intelligence lists to match for this rule. Can only be - specified if DIRECTION is ingress. The available lists can be found - here: - https://cloud.google.com/vpc/docs/firewall-policies-rule-details#threat-intelligence-fw-policy. - - --target-secure-tags=[TARGET_SECURE_TAGS,...] - An optional, list of target secure tags with a name of the format - tagValues/ or full namespaced name - - --target-service-accounts=[TARGET_SERVICE_ACCOUNTS,...] - List of target service accounts for the rule. - GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/compute/network-firewall-policies/mirroring-rules/update b/gcloud/alpha/compute/network-firewall-policies/mirroring-rules/update index 832819a5a..092a8b8cb 100644 --- a/gcloud/alpha/compute/network-firewall-policies/mirroring-rules/update +++ b/gcloud/alpha/compute/network-firewall-policies/mirroring-rules/update @@ -6,21 +6,11 @@ SYNOPSIS gcloud alpha compute network-firewall-policies mirroring-rules update PRIORITY --firewall-policy=FIREWALL_POLICY --global-firewall-policy [--action=ACTION] [--description=DESCRIPTION] - [--dest-address-groups=[DEST_ADDRESS_GROUPS,...]] - [--dest-fqdns=[DEST_FQDNS,...]] [--dest-ip-ranges=[DEST_IP_RANGE,...]] - [--dest-region-codes=[DEST_REGION_CODES,...]] - [--dest-threat-intelligence=[DEST_THREAT_INTELLIGENCE_LISTS,...]] - [--direction=DIRECTION] [--[no-]disabled] - [--layer4-configs=[LAYER4_CONFIG,...]] [--new-priority=NEW_PRIORITY] + [--dest-ip-ranges=[DEST_IP_RANGE,...]] [--direction=DIRECTION] + [--[no-]disabled] [--layer4-configs=[LAYER4_CONFIG,...]] + [--new-priority=NEW_PRIORITY] [--security-profile-group=SECURITY_PROFILE_GROUP] - [--src-address-groups=[SOURCE_ADDRESS_GROUPS,...]] - [--src-fqdns=[SOURCE_FQDNS,...]] [--src-ip-ranges=[SRC_IP_RANGE,...]] - [--src-region-codes=[SOURCE_REGION_CODES,...]] - [--src-secure-tags=[SOURCE_SECURE_TAGS,...]] - [--src-threat-intelligence=[SOURCE_THREAT_INTELLIGENCE_LISTS,...]] - [--target-secure-tags=[TARGET_SECURE_TAGS,...]] - [--target-service-accounts=[TARGET_SERVICE_ACCOUNTS,...]] - [GCLOUD_WIDE_FLAG ...] + [--src-ip-ranges=[SRC_IP_RANGE,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) gcloud alpha compute network-firewall-policies mirroring-rules @@ -54,27 +44,9 @@ OPTIONAL FLAGS --description=DESCRIPTION An optional, textual description for the rule. - --dest-address-groups=[DEST_ADDRESS_GROUPS,...] - Destination address groups to match for this rule. Can only be - specified if DIRECTION is engress. - - --dest-fqdns=[DEST_FQDNS,...] - Destination FQDNs to match for this rule. Can only be specified if - DIRECTION is egress. - --dest-ip-ranges=[DEST_IP_RANGE,...] Destination IP ranges to match for this rule. - --dest-region-codes=[DEST_REGION_CODES,...] - Destination Region Code to match for this rule. Can only be specified - if DIRECTION is egress. - - --dest-threat-intelligence=[DEST_THREAT_INTELLIGENCE_LISTS,...] - Destination Threat Intelligence lists to match for this rule. Can only - be specified if DIRECTION is egress. The available lists can be found - here: - https://cloud.google.com/vpc/docs/firewall-policies-rule-details#threat-intelligence-fw-policy. - --direction=DIRECTION Direction of the traffic the rule is applied. The default is to apply on incoming traffic. DIRECTION must be one of: INGRESS, EGRESS. @@ -94,14 +66,6 @@ OPTIONAL FLAGS A security profile group to be used with apply_security_profile_group action. - --src-address-groups=[SOURCE_ADDRESS_GROUPS,...] - Source address groups to match for this rule. Can only be specified if - DIRECTION is ingress. - - --src-fqdns=[SOURCE_FQDNS,...] - Source FQDNs to match for this rule. Can only be specified if DIRECTION - is ingress. - --src-ip-ranges=[SRC_IP_RANGE,...] A list of IP address blocks that are allowed to make inbound connections that match the firewall rule to the instances on the @@ -114,33 +78,6 @@ OPTIONAL FLAGS --src-secure-tags.Multiple IP address blocks can be specified if they are separated by commas. - --src-region-codes=[SOURCE_REGION_CODES,...] - Source Region Code to match for this rule. Can only be specified if - DIRECTION is ingress. - - --src-secure-tags=[SOURCE_SECURE_TAGS,...] - A list of instance secure tags indicating the set of instances on the - network to which the rule applies if all other fields match. Either - --src-ip-ranges or --src-secure-tags must be specified for ingress - traffic. If both --src-ip-ranges and --src-secure-tags are specified, - an inbound connection is allowed if either the range of the source - matches --src-ip-ranges or the tag of the source matches - --src-secure-tags. Secure Tags can be assigned to instances during - instance creation. - - --src-threat-intelligence=[SOURCE_THREAT_INTELLIGENCE_LISTS,...] - Source Threat Intelligence lists to match for this rule. Can only be - specified if DIRECTION is ingress. The available lists can be found - here: - https://cloud.google.com/vpc/docs/firewall-policies-rule-details#threat-intelligence-fw-policy. - - --target-secure-tags=[TARGET_SECURE_TAGS,...] - An optional, list of target secure tags with a name of the format - tagValues/ or full namespaced name - - --target-service-accounts=[TARGET_SERVICE_ACCOUNTS,...] - List of target service accounts for the rule. - GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/compute/project-info/update b/gcloud/alpha/compute/project-info/update index 750b9baed..6fa96151b 100644 --- a/gcloud/alpha/compute/project-info/update +++ b/gcloud/alpha/compute/project-info/update @@ -20,7 +20,7 @@ FLAGS --default-network-tier=DEFAULT_NETWORK_TIER The default network tier to assign to the project. DEFAULT_NETWORK_TIER - must be one of: PREMIUM, STANDARD, FIXED_STANDARD. + must be one of: PREMIUM, STANDARD. --managed-protection-tier=MANAGED_PROTECTION_TIER Managed protection tier to assign to the project. diff --git a/gcloud/alpha/compute/queued-resources/create b/gcloud/alpha/compute/queued-resources/create index e28ac8e87..5221d772c 100644 --- a/gcloud/alpha/compute/queued-resources/create +++ b/gcloud/alpha/compute/queued-resources/create @@ -655,8 +655,8 @@ OPTIONAL FLAGS --network-tier=NETWORK_TIER Specifies the network tier that will be used to configure the instance. - NETWORK_TIER must be one of: PREMIUM, STANDARD, FIXED_STANDARD. The - default value is PREMIUM. + NETWORK_TIER must be one of: PREMIUM, STANDARD. The default value is + PREMIUM. --numa-node-count=NUMA_NODE_COUNT The number of virtual NUMA nodes for the instance. Valid values are: 0, diff --git a/gcloud/alpha/container/clusters/create b/gcloud/alpha/container/clusters/create index 88f1ff1a3..1b0350ea1 100644 --- a/gcloud/alpha/container/clusters/create +++ b/gcloud/alpha/container/clusters/create @@ -79,7 +79,8 @@ SYNOPSIS [--workload-metadata=WORKLOAD_METADATA] [--workload-pool=WORKLOAD_POOL] [--workload-vulnerability-scanning=WORKLOAD_VULNERABILITY_SCANNING] [--additional-zones=ZONE,[ZONE,...] | --node-locations=ZONE,[ZONE,...]] - [--binauthz-policy-bindings=[name=BINAUTHZ_POLICY] + [--binauthz-policy-bindings=[name=BINAUTHZ_POLICY, + enforcement-mode=ENFORCEMENT_MODE,...] --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE | --enable-binauthz] [--cluster-dns=CLUSTER_DNS --cluster-dns-domain=CLUSTER_DNS_DOMAIN @@ -830,7 +831,7 @@ FLAGS The maximum number of nodes to allocate per default initial node pool. Kubernetes Engine will automatically create enough nodes pools such that each node pool contains less than --max-nodes-per-pool nodes. - Defaults to 2000 nodes, but can be set as low as 100 nodes per pool on + Defaults to 1000 nodes, but can be set as low as 100 nodes per pool on initial create. --max-pods-per-node=MAX_PODS_PER_NODE @@ -970,7 +971,8 @@ FLAGS New nodes, including ones created by resize or recreate, will have these labels on the Kubernetes API node object and can be used in - nodeSelectors. See http://kubernetes.io/docs/user-guide/node-selection/ + nodeSelectors. See + https://kubernetes.io/docs/concepts/scheduling-eviction/assign-pod-node/ for examples. Note that Kubernetes labels, intended to associate cluster components @@ -1134,6 +1136,11 @@ FLAGS considered GA quality. 'regular' is intended for production users who want to take advantage of new features. + extended + + Clusters subscribed to 'extended' can remain on a minor version for 24 months + from when the minor version is made available in the Regular channel. + stable Clusters subscribed to 'stable' receive versions that are known to @@ -1143,7 +1150,7 @@ FLAGS Use 'None' to opt-out of any release channel. - CHANNEL must be one of: rapid, regular, stable, None. + CHANNEL must be one of: rapid, regular, extended, stable, None. --resource-manager-tags=[KEY=VALUE,...] Applies the specified comma-separated resource manager tags that has @@ -1443,10 +1450,19 @@ FLAGS Flags for Binary Authorization: - --binauthz-policy-bindings=[name=BINAUTHZ_POLICY] - The relative resource name of the Binary Authorization policy to - audit and/or enforce. GKE policies have the following format: - projects/{project_number}/platforms/gke/policies/{policy_id}. + --binauthz-policy-bindings=[name=BINAUTHZ_POLICY,enforcement-mode=ENFORCEMENT_MODE,...] + Binds a Binary Authorization policy to the cluster. + + name + (Required) The relative resource name of the Binary Authorization + policy to audit and/or enforce. GKE policies have the following + format: + projects/{project_number}/platforms/gke/policies/{policy_id}. + + enforcement-mode + (Optional) The mode of enforcement for the policy. Must be one + of: audit, audit-and-enforce, audit-and-dryrun. Defaults to + audit, if unset. At most one of these can be specified: diff --git a/gcloud/alpha/container/clusters/create-auto b/gcloud/alpha/container/clusters/create-auto index aca913116..e60d5d264 100644 --- a/gcloud/alpha/container/clusters/create-auto +++ b/gcloud/alpha/container/clusters/create-auto @@ -30,7 +30,8 @@ SYNOPSIS [--additive-vpc-scope-dns-domain=ADDITIVE_VPC_SCOPE_DNS_DOMAIN | --disable-additive-vpc-scope] [--binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE - --binauthz-policy-bindings=[name=BINAUTHZ_POLICY]] + --binauthz-policy-bindings=[name=BINAUTHZ_POLICY, + enforcement-mode=ENFORCEMENT_MODE,...]] [--dataplane-v2-observability-mode=DATAPLANE_V2_OBSERVABILITY_MODE | --disable-dataplane-v2-flow-observability | --enable-dataplane-v2-flow-observability] @@ -352,12 +353,17 @@ FLAGS considered GA quality. 'regular' is intended for production users who want to take advantage of new features. + extended + + Clusters subscribed to 'extended' can remain on a minor version for 24 months + from when the minor version is made available in the Regular channel. + 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. + CHANNEL must be one of: rapid, regular, extended, stable. --security-group=SECURITY_GROUP The name of the RBAC security group for use with Google security groups @@ -460,10 +466,19 @@ FLAGS policy-bindings-and-project-singleton-policy-enforce, project-singleton-policy-enforce. - --binauthz-policy-bindings=[name=BINAUTHZ_POLICY] - The relative resource name of the Binary Authorization policy to - audit and/or enforce. GKE policies have the following format: - projects/{project_number}/platforms/gke/policies/{policy_id}. + --binauthz-policy-bindings=[name=BINAUTHZ_POLICY,enforcement-mode=ENFORCEMENT_MODE,...] + Binds a Binary Authorization policy to the cluster. + + name + (Required) The relative resource name of the Binary Authorization + policy to audit and/or enforce. GKE policies have the following + format: + projects/{project_number}/platforms/gke/policies/{policy_id}. + + enforcement-mode + (Optional) The mode of enforcement for the policy. Must be one + of: audit, audit-and-enforce, audit-and-dryrun. Defaults to + audit, if unset. At most one of these can be specified: diff --git a/gcloud/alpha/container/clusters/update b/gcloud/alpha/container/clusters/update index f79a4f440..52681aacf 100644 --- a/gcloud/alpha/container/clusters/update +++ b/gcloud/alpha/container/clusters/update @@ -51,7 +51,8 @@ SYNOPSIS | --additional-pod-ipv4-ranges=NAME,[NAME,...] --remove-additional-pod-ipv4-ranges=NAME,[NAME,...] | --additional-zones=[ZONE,...] | --node-locations=ZONE,[ZONE,...] - | --binauthz-policy-bindings=[name=BINAUTHZ_POLICY] + | --binauthz-policy-bindings=[name=BINAUTHZ_POLICY, + enforcement-mode=ENFORCEMENT_MODE,...] --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE | --enable-binauthz | --clear-maintenance-window | --remove-maintenance-exclusion=NAME @@ -612,6 +613,11 @@ REQUIRED FLAGS considered GA quality. 'regular' is intended for production users who want to take advantage of new features. + extended + + Clusters subscribed to 'extended' can remain on a minor version for 24 months + from when the minor version is made available in the Regular channel. + stable Clusters subscribed to 'stable' receive versions that are known to @@ -621,7 +627,7 @@ REQUIRED FLAGS Use 'None' to opt-out of any release channel. - CHANNEL must be one of: rapid, regular, stable, None. + CHANNEL must be one of: rapid, regular, extended, stable, None. --remove-labels=[KEY,...] Labels to remove from the Google Cloud resources in use by the @@ -842,10 +848,19 @@ REQUIRED FLAGS Flags for Binary Authorization: - --binauthz-policy-bindings=[name=BINAUTHZ_POLICY] - The relative resource name of the Binary Authorization policy to - audit and/or enforce. GKE policies have the following format: - projects/{project_number}/platforms/gke/policies/{policy_id}. + --binauthz-policy-bindings=[name=BINAUTHZ_POLICY,enforcement-mode=ENFORCEMENT_MODE,...] + Binds a Binary Authorization policy to the cluster. + + name + (Required) The relative resource name of the Binary + Authorization policy to audit and/or enforce. GKE policies have + the following format: + projects/{project_number}/platforms/gke/policies/{policy_id}. + + enforcement-mode + (Optional) The mode of enforcement for the policy. Must be one + of: audit, audit-and-enforce, audit-and-dryrun. Defaults to + audit, if unset. At most one of these can be specified: diff --git a/gcloud/alpha/container/node-pools/create b/gcloud/alpha/container/node-pools/create index 36e60b63a..171520187 100644 --- a/gcloud/alpha/container/node-pools/create +++ b/gcloud/alpha/container/node-pools/create @@ -493,7 +493,8 @@ FLAGS New nodes, including ones created by resize or recreate, will have these labels on the Kubernetes API node object and can be used in - nodeSelectors. See http://kubernetes.io/docs/user-guide/node-selection/ + nodeSelectors. See + https://kubernetes.io/docs/concepts/scheduling-eviction/assign-pod-node/ for examples. Note that Kubernetes labels, intended to associate cluster components diff --git a/gcloud/alpha/container/node-pools/update b/gcloud/alpha/container/node-pools/update index 722bc9dfc..1f631a96c 100644 --- a/gcloud/alpha/container/node-pools/update +++ b/gcloud/alpha/container/node-pools/update @@ -141,7 +141,8 @@ REQUIRED FLAGS New nodes, including ones created by resize or recreate, will have these labels on the Kubernetes API node object and can be used in nodeSelectors. See - http://kubernetes.io/docs/user-guide/node-selection/ for examples. + https://kubernetes.io/docs/concepts/scheduling-eviction/assign-pod-node/ + for examples. Note that Kubernetes labels, intended to associate cluster components and resources with one another and manage resource lifecycles, are diff --git a/gcloud/alpha/deploy/apply b/gcloud/alpha/deploy/apply index 71c70a5b8..ce490e422 100644 --- a/gcloud/alpha/deploy/apply +++ b/gcloud/alpha/deploy/apply @@ -1,7 +1,7 @@ NAME gcloud alpha deploy apply - applies a yaml configuration containing - Delivery Pipeline(s), Target(s), Custom Target Type(s), and - Automation(s) declarative definitions + Delivery Pipeline(s), Target(s), Custom Target Type(s), Deploy + Policy(ies), and Automation(s) declarative definitions SYNOPSIS gcloud alpha deploy apply --file=FILE [--region=REGION] @@ -9,8 +9,8 @@ SYNOPSIS DESCRIPTION (ALPHA) Applies a yaml configuration containing Delivery Pipeline(s), - Target(s), Custom Target Type(s), and Automation(s) declarative - definitions. + Target(s), Custom Target Type(s), Deploy Policy(ies), and Automation(s) + declarative definitions. EXAMPLES To apply a Cloud Deploy YAML file deploy.yaml: diff --git a/gcloud/alpha/deploy/deploy-policies/delete b/gcloud/alpha/deploy/deploy-policies/delete new file mode 100644 index 000000000..759097188 --- /dev/null +++ b/gcloud/alpha/deploy/deploy-policies/delete @@ -0,0 +1,77 @@ +NAME + gcloud alpha deploy deploy-policies delete - delete a deploy policy + +SYNOPSIS + gcloud alpha deploy deploy-policies delete + (DEPLOY_POLICY : --region=REGION) [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete a deploy policy for a specified region. + +EXAMPLES + The following command will delete deploy policy test-policy, in region + us-central1: + + $ gcloud alpha deploy deploy-policies delete test-policy \ + --region=us-central1 + +POSITIONAL ARGUMENTS + Deploy policy resource - The name of the deploy policy to delete. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument deploy_policy on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + DEPLOY_POLICY + ID of the deploy policy or fully qualified identifier for the deploy + policy. + + To set the deploy_policy attribute: + ▸ provide the argument deploy_policy on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Location of the deploy policy. + + To set the region attribute: + ▸ provide the argument deploy_policy on the command line with a + fully specified name; + ▸ provide the argument --region on the command line; + ▸ set the property deploy/region. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the clouddeploy/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/deploy/ + +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 deploy deploy-policies delete + + $ gcloud beta deploy deploy-policies delete + diff --git a/gcloud/alpha/deploy/deploy-policies/describe b/gcloud/alpha/deploy/deploy-policies/describe new file mode 100644 index 000000000..19cee2f70 --- /dev/null +++ b/gcloud/alpha/deploy/deploy-policies/describe @@ -0,0 +1,71 @@ +NAME + gcloud alpha deploy deploy-policies describe - show details for a deploy + policy + +SYNOPSIS + gcloud alpha deploy deploy-policies describe + (DEPLOY_POLICY : --region=REGION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Show details for a specified deploy policy. + +EXAMPLES + To show details about a deploy policy test-policy in region us-central, + run: $ gcloud alpha deploy deploy-policies describe test-policy \ + --region=us-central1 + +POSITIONAL ARGUMENTS + Deploy policy resource - The name of the deploy policy to describe. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument deploy_policy on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + DEPLOY_POLICY + ID of the deploy policy or fully qualified identifier for the deploy + policy. + + To set the deploy_policy attribute: + ▸ provide the argument deploy_policy on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Location of the deploy policy. + + To set the region attribute: + ▸ provide the argument deploy_policy on the command line with a + fully specified name; + ▸ provide the argument --region on the command line; + ▸ set the property deploy/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 clouddeploy/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/deploy/ + +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 deploy deploy-policies describe + + $ gcloud beta deploy deploy-policies describe + diff --git a/gcloud/alpha/deploy/deploy-policies/export b/gcloud/alpha/deploy/deploy-policies/export new file mode 100644 index 000000000..ad5b12917 --- /dev/null +++ b/gcloud/alpha/deploy/deploy-policies/export @@ -0,0 +1,77 @@ +NAME + gcloud alpha deploy deploy-policies export - returns the .yaml definition + of the specified deploy policy + +SYNOPSIS + gcloud alpha deploy deploy-policies export + (DEPLOY_POLICY : --region=REGION) [--destination=DESTINATION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) The exported yaml definition can be applied by deploy apply + command. + +EXAMPLES + To return the .yaml definition of the deploy policy test-policy, in region + us-central1, run: + + $ gcloud alpha deploy deploy-policies export test-policy \ + --region=us-central1 + +POSITIONAL ARGUMENTS + Deploy policy resource - The name of the Deploy Policy. 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 deploy_policy on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + DEPLOY_POLICY + ID of the deploy_policy or fully qualified identifier for the + deploy_policy. + + To set the deploy_policy attribute: + ▸ provide the argument deploy_policy on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + The Cloud region for the deploy_policy. Alternatively, set the + property [deploy/region]. + + To set the region attribute: + ▸ provide the argument deploy_policy on the command line with a + fully specified name; + ▸ provide the argument --region on the command line; + ▸ set the property deploy/region. + +FLAGS + --destination=DESTINATION + Path to a YAML file where the configuration will be exported. + Alternatively, you may omit this flag to write to standard output. + +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 deploy deploy-policies export + + $ gcloud beta deploy deploy-policies export + diff --git a/gcloud/alpha/deploy/deploy-policies/help b/gcloud/alpha/deploy/deploy-policies/help new file mode 100644 index 000000000..6b37048f1 --- /dev/null +++ b/gcloud/alpha/deploy/deploy-policies/help @@ -0,0 +1,37 @@ +NAME + gcloud alpha deploy deploy-policies - create and manage Deploy Policy + resources for Google Cloud Deploy + +SYNOPSIS + gcloud alpha deploy deploy-policies COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create and manage Deploy Policy resources for Google Cloud Deploy. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + delete + (ALPHA) Delete a deploy policy. + + describe + (ALPHA) Show details for a deploy policy. + + export + (ALPHA) Returns the .yaml definition of the specified deploy policy. + +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 deploy deploy-policies + + $ gcloud beta deploy deploy-policies + diff --git a/gcloud/alpha/deploy/help b/gcloud/alpha/deploy/help index d2fb4e46e..538d40ae0 100644 --- a/gcloud/alpha/deploy/help +++ b/gcloud/alpha/deploy/help @@ -28,6 +28,10 @@ GROUPS delivery-pipelines (ALPHA) Create and manage Delivery Pipeline resources for Cloud Deploy. + deploy-policies + (ALPHA) Create and manage Deploy Policy resources for Google Cloud + Deploy. + job-runs (ALPHA) Manages job runs resources for Cloud Deploy. @@ -45,8 +49,8 @@ COMMANDS apply (ALPHA) Applies a yaml configuration containing Delivery Pipeline(s), - Target(s), Custom Target Type(s), and Automation(s) declarative - definitions. + Target(s), Custom Target Type(s), Deploy Policy(ies), and Automation(s) + declarative definitions. delete (ALPHA) Deletes Delivery Pipeline(s), Target(s), Custom Target Type(s), diff --git a/gcloud/alpha/functions/deploy b/gcloud/alpha/functions/deploy index 7aa9dd8dd..030f711f1 100644 --- a/gcloud/alpha/functions/deploy +++ b/gcloud/alpha/functions/deploy @@ -603,9 +603,9 @@ FLAGS Allowed values for GCF 2nd gen are in the format: with allowed units of "k", "M", "G", "Ki", "Mi", "Gi". Ending 'b' or 'B' is - allowed. + allowed, but both are interpreted as bytes as opposed to bits. - Examples: 100000k, 128M, 10Mb, 1024Mi, 750K, 4Gi. + Examples: 1000000K, 1000000Ki, 256Mb, 512M, 1024Mi, 2G, 4Gi. By default, a new function is limited to 256MB of memory. When deploying an update to an existing function, the function keeps its old diff --git a/gcloud/alpha/network-connectivity/spokes/help b/gcloud/alpha/network-connectivity/spokes/help index ebaaa3557..06744fd52 100644 --- a/gcloud/alpha/network-connectivity/spokes/help +++ b/gcloud/alpha/network-connectivity/spokes/help @@ -35,7 +35,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: $ gcloud network-connectivity spokes + $ gcloud beta network-connectivity spokes + diff --git a/gcloud/alpha/network-services/service-lb-policies/create b/gcloud/alpha/network-services/service-lb-policies/create index 9adfed606..44645ebb7 100644 --- a/gcloud/alpha/network-services/service-lb-policies/create +++ b/gcloud/alpha/network-services/service-lb-policies/create @@ -74,8 +74,8 @@ FLAGS traffic to failover backends. If the percentage of endpoints in a MIG/NEG is smaller than this value, traffic would be sent to failover backends if possible. This field should be set to a value between 1 and - 99. The default value is 50 for Global external HTTP(S) load balancer - (classic) and Proxyless service mesh, and 70 for others. + 99. The default value is 50 for Proxyless service mesh, and 70 for + others. --load-balancing-algorithm=LOAD_BALANCING_ALGORITHM; default="waterfall-by-region" The global load balancing algorithm to be used. diff --git a/gcloud/alpha/network-services/service-lb-policies/update b/gcloud/alpha/network-services/service-lb-policies/update index de9c17e63..79f70246a 100644 --- a/gcloud/alpha/network-services/service-lb-policies/update +++ b/gcloud/alpha/network-services/service-lb-policies/update @@ -73,8 +73,8 @@ FLAGS traffic to failover backends. If the percentage of endpoints in a MIG/NEG is smaller than this value, traffic would be sent to failover backends if possible. This field should be set to a value between 1 and - 99. The default value is 50 for Global external HTTP(S) load balancer - (classic) and Proxyless service mesh, and 70 for others. + 99. The default value is 50 for Proxyless service mesh, and 70 for + others. --load-balancing-algorithm=LOAD_BALANCING_ALGORITHM; default="waterfall-by-region" The global load balancing algorithm to be used. diff --git a/gcloud/alpha/pubsub/subscriptions/create b/gcloud/alpha/pubsub/subscriptions/create index 6d2804e9e..dc46c038c 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-use-topic-schema --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-max-messages=CLOUD_STORAGE_MAX_MESSAGES --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]] @@ -231,6 +231,11 @@ OPTIONAL FLAGS "m", "h", and "d" for seconds, minutes, hours, and days, respectively. If the unit is omitted, seconds is assumed. + --cloud-storage-max-messages=CLOUD_STORAGE_MAX_MESSAGES + The maximum number of messages that can be written to a Cloud + Storage file before a new file is created. The value must be + greater than or equal to 1000. + --cloud-storage-output-format=OUTPUT_FORMAT; default="text" The output format for data written to Cloud Storage. Values: text (messages will be written as raw text, separated by a newline) or diff --git a/gcloud/alpha/pubsub/subscriptions/update b/gcloud/alpha/pubsub/subscriptions/update index 060380b40..46741ddba 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-use-topic-schema --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-max-messages=CLOUD_STORAGE_MAX_MESSAGES --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 @@ -211,6 +211,11 @@ FLAGS of "s", "m", "h", and "d" for seconds, minutes, hours, and days, respectively. If the unit is omitted, seconds is assumed. + --cloud-storage-max-messages=CLOUD_STORAGE_MAX_MESSAGES + The maximum number of messages that can be written to a Cloud + Storage file before a new file is created. The value must be + greater than or equal to 1000. + --cloud-storage-output-format=OUTPUT_FORMAT; default="text" The output format for data written to Cloud Storage. Values: text (messages will be written as raw text, separated by a newline) or diff --git a/gcloud/alpha/scc/settings/services/describe b/gcloud/alpha/scc/settings/services/describe index 13be76da4..8eaea7b12 100644 --- a/gcloud/alpha/scc/settings/services/describe +++ b/gcloud/alpha/scc/settings/services/describe @@ -21,8 +21,8 @@ REQUIRED FLAGS --service=SERVICE_NAME Service name in Security Command Center. SERVICE_NAME must be one of: container-threat-detection, event-threat-detection, - rapid-vulnerability-detection, security-health-analytics, - virtual-machine-threat-detection, web-security-scanner. + security-health-analytics, virtual-machine-threat-detection, + web-security-scanner. OPTIONAL FLAGS At most one of these can be specified: diff --git a/gcloud/alpha/scc/settings/services/describe-explicit b/gcloud/alpha/scc/settings/services/describe-explicit index eb51421c9..5064b27b4 100644 --- a/gcloud/alpha/scc/settings/services/describe-explicit +++ b/gcloud/alpha/scc/settings/services/describe-explicit @@ -20,8 +20,8 @@ REQUIRED FLAGS --service=SERVICE_NAME Service name in Security Command Center. SERVICE_NAME must be one of: container-threat-detection, event-threat-detection, - rapid-vulnerability-detection, security-health-analytics, - virtual-machine-threat-detection, web-security-scanner. + security-health-analytics, virtual-machine-threat-detection, + web-security-scanner. OPTIONAL FLAGS At most one of these can be specified: diff --git a/gcloud/alpha/scc/settings/services/disable b/gcloud/alpha/scc/settings/services/disable index 25edcc52a..0d1b950e2 100644 --- a/gcloud/alpha/scc/settings/services/disable +++ b/gcloud/alpha/scc/settings/services/disable @@ -20,8 +20,8 @@ REQUIRED FLAGS --service=SERVICE_NAME Service name in Security Command Center. SERVICE_NAME must be one of: container-threat-detection, event-threat-detection, - rapid-vulnerability-detection, security-health-analytics, - virtual-machine-threat-detection, web-security-scanner. + security-health-analytics, virtual-machine-threat-detection, + web-security-scanner. OPTIONAL FLAGS At most one of these can be specified: diff --git a/gcloud/alpha/scc/settings/services/enable b/gcloud/alpha/scc/settings/services/enable index 1e758cc6e..21256c483 100644 --- a/gcloud/alpha/scc/settings/services/enable +++ b/gcloud/alpha/scc/settings/services/enable @@ -20,8 +20,8 @@ REQUIRED FLAGS --service=SERVICE_NAME Service name in Security Command Center. SERVICE_NAME must be one of: container-threat-detection, event-threat-detection, - rapid-vulnerability-detection, security-health-analytics, - virtual-machine-threat-detection, web-security-scanner. + security-health-analytics, virtual-machine-threat-detection, + web-security-scanner. OPTIONAL FLAGS At most one of these can be specified: diff --git a/gcloud/alpha/scc/settings/services/inherit b/gcloud/alpha/scc/settings/services/inherit index 55b059556..c5a40053b 100644 --- a/gcloud/alpha/scc/settings/services/inherit +++ b/gcloud/alpha/scc/settings/services/inherit @@ -21,8 +21,8 @@ REQUIRED FLAGS --service=SERVICE_NAME Service name in Security Command Center. SERVICE_NAME must be one of: container-threat-detection, event-threat-detection, - rapid-vulnerability-detection, security-health-analytics, - virtual-machine-threat-detection, web-security-scanner. + security-health-analytics, virtual-machine-threat-detection, + web-security-scanner. OPTIONAL FLAGS At most one of these can be specified: diff --git a/gcloud/alpha/scc/settings/services/modules/describe b/gcloud/alpha/scc/settings/services/modules/describe index 4a520f9f6..3c7c8306f 100644 --- a/gcloud/alpha/scc/settings/services/modules/describe +++ b/gcloud/alpha/scc/settings/services/modules/describe @@ -26,8 +26,8 @@ REQUIRED FLAGS --service=SERVICE_NAME Service name in Security Command Center. SERVICE_NAME must be one of: container-threat-detection, event-threat-detection, - rapid-vulnerability-detection, security-health-analytics, - virtual-machine-threat-detection, web-security-scanner. + security-health-analytics, virtual-machine-threat-detection, + web-security-scanner. OPTIONAL FLAGS At most one of these can be specified: diff --git a/gcloud/alpha/scc/settings/services/modules/describe-explicit b/gcloud/alpha/scc/settings/services/modules/describe-explicit index 1d2d6e384..d8380f8a3 100644 --- a/gcloud/alpha/scc/settings/services/modules/describe-explicit +++ b/gcloud/alpha/scc/settings/services/modules/describe-explicit @@ -26,8 +26,8 @@ REQUIRED FLAGS --service=SERVICE_NAME Service name in Security Command Center. SERVICE_NAME must be one of: container-threat-detection, event-threat-detection, - rapid-vulnerability-detection, security-health-analytics, - virtual-machine-threat-detection, web-security-scanner. + security-health-analytics, virtual-machine-threat-detection, + web-security-scanner. OPTIONAL FLAGS At most one of these can be specified: diff --git a/gcloud/alpha/scc/settings/services/modules/disable b/gcloud/alpha/scc/settings/services/modules/disable index 3c787c6a4..dcd7de1d8 100644 --- a/gcloud/alpha/scc/settings/services/modules/disable +++ b/gcloud/alpha/scc/settings/services/modules/disable @@ -26,8 +26,8 @@ REQUIRED FLAGS --service=SERVICE_NAME Service name in Security Command Center. SERVICE_NAME must be one of: container-threat-detection, event-threat-detection, - rapid-vulnerability-detection, security-health-analytics, - virtual-machine-threat-detection, web-security-scanner. + security-health-analytics, virtual-machine-threat-detection, + web-security-scanner. OPTIONAL FLAGS At most one of these can be specified: diff --git a/gcloud/alpha/scc/settings/services/modules/enable b/gcloud/alpha/scc/settings/services/modules/enable index 7ac54ebde..2f18d48e8 100644 --- a/gcloud/alpha/scc/settings/services/modules/enable +++ b/gcloud/alpha/scc/settings/services/modules/enable @@ -26,8 +26,8 @@ REQUIRED FLAGS --service=SERVICE_NAME Service name in Security Command Center. SERVICE_NAME must be one of: container-threat-detection, event-threat-detection, - rapid-vulnerability-detection, security-health-analytics, - virtual-machine-threat-detection, web-security-scanner. + security-health-analytics, virtual-machine-threat-detection, + web-security-scanner. OPTIONAL FLAGS At most one of these can be specified: diff --git a/gcloud/alpha/scc/settings/services/modules/update b/gcloud/alpha/scc/settings/services/modules/update index 8ead4f703..6bac986db 100644 --- a/gcloud/alpha/scc/settings/services/modules/update +++ b/gcloud/alpha/scc/settings/services/modules/update @@ -52,8 +52,8 @@ REQUIRED FLAGS --service=SERVICE_NAME Service name in Security Command Center. SERVICE_NAME must be one of: container-threat-detection, event-threat-detection, - rapid-vulnerability-detection, security-health-analytics, - virtual-machine-threat-detection, web-security-scanner. + security-health-analytics, virtual-machine-threat-detection, + web-security-scanner. OPTIONAL FLAGS Config value group in Security Command Center. diff --git a/gcloud/alpha/workstations/configs/create b/gcloud/alpha/workstations/configs/create index 68842548d..231905087 100644 --- a/gcloud/alpha/workstations/configs/create +++ b/gcloud/alpha/workstations/configs/create @@ -5,6 +5,7 @@ NAME SYNOPSIS gcloud alpha workstations configs create (CONFIG : --cluster=CLUSTER --region=REGION) + [--allow-unauthenticated-cors-preflight-requests] [--allowed-ports=[ALLOWED_PORTS,...]] [--async] [--boost-config=[BOOST_CONFIG,...]] [--boot-disk-size=BOOT_DISK_SIZE; default=50] @@ -102,6 +103,15 @@ POSITIONAL ARGUMENTS ▸ set the property workstations/region. FLAGS + --allow-unauthenticated-cors-preflight-requests + By default, the workstations service makes sure that all requests to + the workstation are authenticated. CORS preflight requests do not + include cookies or custom headers, and so are considered + unauthenticated and blocked by the workstations service. Enabling this + option allows these unauthenticated CORS preflight requests through to + the workstation, where it becomes the responsibility of the destination + server in the workstation to validate the request + --allowed-ports=[ALLOWED_PORTS,...] A Single or Range of ports externally accessible in the workstation. If not specified defaults to ports 22, 80 and ports 1024-65535. diff --git a/gcloud/alpha/workstations/configs/update b/gcloud/alpha/workstations/configs/update index d2ee06f3c..54cc877b3 100644 --- a/gcloud/alpha/workstations/configs/update +++ b/gcloud/alpha/workstations/configs/update @@ -23,6 +23,8 @@ SYNOPSIS [--shielded-vtpm] [--vm-tags=[VM_TAGS,...]] [--accelerator-count=ACCELERATOR_COUNT : --accelerator-type=ACCELERATOR_TYPE] + [--allow-unauthenticated-cors-preflight-requests + | --disallow-unauthenticated-cors-preflight-requests] [--container-custom-image=CONTAINER_CUSTOM_IMAGE | --container-predefined-image=CONTAINER_PREDEFINED_IMAGE] [--disable-ssh-to-vm | --enable-ssh-to-vm] @@ -304,6 +306,21 @@ FLAGS The type of accelerator resource to attach to the instance, for example, "nvidia-tesla-p100". + At most one of these can be specified: + + --allow-unauthenticated-cors-preflight-requests + By default, the workstations service makes sure that all requests to + the workstation are authenticated. CORS preflight requests do not + include cookies or custom headers, and so are considered + unauthenticated and blocked by the workstations service. Enabling + this option allows these unauthenticated CORS preflight requests + through to the workstation, where it becomes the responsibility of + the destination server in the workstation to validate the request + + --disallow-unauthenticated-cors-preflight-requests + If set, requires that all requests to the workstation are + authenticated. + At most one of these can be specified: --container-custom-image=CONTAINER_CUSTOM_IMAGE diff --git a/gcloud/artifacts/repositories/create b/gcloud/artifacts/repositories/create index 2dcd306bf..13b9d8a1a 100644 --- a/gcloud/artifacts/repositories/create +++ b/gcloud/artifacts/repositories/create @@ -28,15 +28,18 @@ DESCRIPTION ▪ A valid repository format was not provided. EXAMPLES - To create a repository with the name my-repo under the current project, - run: - - $ gcloud artifacts repositories create my-repo - - To create repository my-repo with a KMS key - projects/my-project/locations/us/keyRings/my-kr/cryptoKeys/my-key, run: + To create a docker repository with the name my-repo in the default project + and location, run the following command: $ gcloud artifacts repositories create my-repo \ + --repository-format=docker + + To create a docker repository my-repo with a KMS key + projects/my-project/locations/us/keyRings/my-kr/cryptoKeys/my-key in the + default project and location, run the following command: + + $ gcloud artifacts repositories create my-repo \ + --repository-format=docker \ --kms-key=projects/my-project/locations/us/keyRings/my-kr/\ cryptoKeys/my-key diff --git a/gcloud/beta/ai/endpoints/deploy-model b/gcloud/beta/ai/endpoints/deploy-model index 6feb2c46d..9cea3d7f8 100644 --- a/gcloud/beta/ai/endpoints/deploy-model +++ b/gcloud/beta/ai/endpoints/deploy-model @@ -73,9 +73,9 @@ OPTIONAL FLAGS type The type of the accelerator. Choices are 'nvidia-a100-80gb', - 'nvidia-h100-80gb', 'nvidia-l4', 'nvidia-tesla-a100', - 'nvidia-tesla-k80', 'nvidia-tesla-p100', 'nvidia-tesla-p4', - 'nvidia-tesla-t4', 'nvidia-tesla-v100'. + 'nvidia-h100-80gb', 'nvidia-h100-mega-80gb', 'nvidia-l4', + 'nvidia-tesla-a100', 'nvidia-tesla-k80', 'nvidia-tesla-p100', + 'nvidia-tesla-p4', 'nvidia-tesla-t4', 'nvidia-tesla-v100'. count The number of accelerators to attach to each machine running the diff --git a/gcloud/beta/alloydb/instances/create b/gcloud/beta/alloydb/instances/create index 03a8d531f..3fb46da90 100644 --- a/gcloud/beta/alloydb/instances/create +++ b/gcloud/beta/alloydb/instances/create @@ -20,7 +20,7 @@ SYNOPSIS [--observability-config-query-plans-per-minute=OBSERVABILITY_CONFIG_QUERY_PLANS_PER_MINUTE] [--[no-]observability-config-record-application-tags] [--[no-]observability-config-track-active-queries] - [--observability-config-track-wait-events] + [--observability-config-track-wait-events] [--[no-]outbound-public-ip] [--read-pool-node-count=READ_POOL_NODE_COUNT] [--[no-]require-connectors] [--ssl-mode=SSL_MODE; default="ENCRYPTED_ONLY"] [GCLOUD_WIDE_FLAG ...] @@ -174,6 +174,10 @@ OPTIONAL FLAGS --observability-config-track-wait-events Track wait events during query execution. + --[no-]outbound-public-ip + Add outbound Public IP connectivity to an AlloyDB instance. Use + --outbound-public-ip to enable and --no-outbound-public-ip to disable. + --read-pool-node-count=READ_POOL_NODE_COUNT Read capacity, i.e. number of nodes in a read pool instance. diff --git a/gcloud/beta/alloydb/instances/create-secondary b/gcloud/beta/alloydb/instances/create-secondary index 9bcaa98e0..508143234 100644 --- a/gcloud/beta/alloydb/instances/create-secondary +++ b/gcloud/beta/alloydb/instances/create-secondary @@ -4,10 +4,12 @@ NAME SYNOPSIS gcloud beta alloydb instances create-secondary INSTANCE --cluster=CLUSTER - --region=REGION [--assign-inbound-public-ip=ASSIGN_INBOUND_PUBLIC_IP] - [--async] [--authorized-external-networks=[AUTHORIZED_NETWORK,...]] - [--availability-type=AVAILABILITY_TYPE] [--[no-]require-connectors] - [--ssl-mode=SSL_MODE] [GCLOUD_WIDE_FLAG ...] + --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] [--[no-]outbound-public-ip] + [--[no-]require-connectors] [--ssl-mode=SSL_MODE] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Creates a new AlloyDB SECONDARY instance within a given cluster. @@ -31,6 +33,12 @@ REQUIRED FLAGS regions at https://cloud.google.com/sql/docs/instance-locations. OPTIONAL FLAGS + --allowed-psc-projects=[ALLOWED_PSC_PROJECTS,...] + Comma-separated list of allowed consumer projects to create endpoints + for Private Service Connect (PSC) connectivity for the instance. Only + instances in PSC-enabled clusters are allowed to set this field.(e.g., + --allowed-psc-projects=project1,12345678,project2) + --assign-inbound-public-ip=ASSIGN_INBOUND_PUBLIC_IP Specify to enable or disable public IP on an instance. ASSIGN_INBOUND_PUBLIC_IP must be one of: @@ -63,6 +71,10 @@ OPTIONAL FLAGS production instances; instance does not automatically fail over to another zone. + --[no-]outbound-public-ip + Add outbound Public IP connectivity to an AlloyDB instance. Use + --outbound-public-ip to enable and --no-outbound-public-ip to disable. + --[no-]require-connectors Enable or disable enforcing connectors only (ex: AuthProxy) connections to the database. Use --require-connectors to enable and diff --git a/gcloud/beta/alloydb/instances/update b/gcloud/beta/alloydb/instances/update index f71c17236..d656bb601 100644 --- a/gcloud/beta/alloydb/instances/update +++ b/gcloud/beta/alloydb/instances/update @@ -19,7 +19,7 @@ SYNOPSIS [--observability-config-query-plans-per-minute=OBSERVABILITY_CONFIG_QUERY_PLANS_PER_MINUTE] [--[no-]observability-config-record-application-tags] [--[no-]observability-config-track-active-queries] - [--observability-config-track-wait-events] + [--observability-config-track-wait-events] [--[no-]outbound-public-ip] [--read-pool-node-count=READ_POOL_NODE_COUNT] [--[no-]require-connectors] [--ssl-mode=SSL_MODE] [--update-mode=UPDATE_MODE] [GCLOUD_WIDE_FLAG ...] @@ -156,6 +156,10 @@ OPTIONAL FLAGS --observability-config-track-wait-events Track wait events during query execution. + --[no-]outbound-public-ip + Add outbound Public IP connectivity to an AlloyDB instance. Use + --outbound-public-ip to enable and --no-outbound-public-ip to disable. + --read-pool-node-count=READ_POOL_NODE_COUNT Read capacity, i.e. number of nodes in a read pool instance. diff --git a/gcloud/beta/builds/worker-pools/create b/gcloud/beta/builds/worker-pools/create index 7d6353997..8df67d4ec 100644 --- a/gcloud/beta/builds/worker-pools/create +++ b/gcloud/beta/builds/worker-pools/create @@ -3,8 +3,11 @@ NAME Cloud Build SYNOPSIS - gcloud beta builds worker-pools create WORKER_POOL [--region=REGION] - [--config-from-file=CONFIG_FROM_FILE | --peered-network=PEERED_NETWORK + gcloud beta builds worker-pools create WORKER_POOL + [--generation=GENERATION; default=1] [--region=REGION] + [--config-from-file=CONFIG_FROM_FILE | --disable-public-ip-address + --network-attachment=NETWORK_ATTACHMENT --route-all-traffic + | --peered-network=PEERED_NETWORK --peered-network-ip-range=PEERED_NETWORK_IP_RANGE --no-public-egress --worker-disk-size=WORKER_DISK_SIZE --worker-machine-type=WORKER_MACHINE_TYPE] [GCLOUD_WIDE_FLAG ...] @@ -34,6 +37,9 @@ POSITIONAL ARGUMENTS 1-63 characters, and valid characters are [a-z][0-9]- FLAGS + --generation=GENERATION; default=1 + Generation of the worker pool. + --region=REGION Cloud region where the worker pool is created. See https://cloud.google.com/build/docs/locations for available locations. @@ -42,40 +48,73 @@ FLAGS --config-from-file=CONFIG_FROM_FILE File that contains the configuration for the worker pool to be - created. See - https://cloud.google.com/build/docs/private-pools/worker-pool-config-file-schema - for options. + created. + + Private pool options: + + https://cloud.google.com/build/docs/private-pools/worker-pool-config-file-schema Command-line flags to configure the private pool: - Network configuration for Service Networking: + At most one of these can be specified: - --peered-network=PEERED_NETWORK - Existing network to which workers are peered. The network is - specified in resource URL format - projects/{network_project}/global/networks/{network_name}. + Network configuration for Private Service Connect interface: - If not specified, the workers are not peered to any network. + --disable-public-ip-address + If set, workers in the worker pool are created without an + external IP address. - --peered-network-ip-range=PEERED_NETWORK_IP_RANGE - An IP range for your peered network. Specify the IP range using - Classless Inter-Domain Routing (CIDR) notation with a slash and - the subnet prefix size, such as /29. + If the worker pool is within a VPC Service Control perimeter, + use this flag. - Your subnet prefix size must be between 1 and 29. Optional: you - can specify an IP address before the subnet prefix value - for - example 192.168.0.0/24. + --network-attachment=NETWORK_ATTACHMENT + The network attachment that the worker network interface is + peered to. The network attachment is specified in resource URL + format + projects/{project}/regions/{region}/networkAttachments/{name}. + The region of network attachment must be the same as the worker + pool. See + https://cloud.google.com/vpc/docs/about-network-attachments for + details. - If no IP address is specified, your VPC automatically determines - the starting IP for the range. If no IP range is specified, Cloud - Build uses /24 as the default network IP range. + --route-all-traffic + Route all traffic through PSC interface. Enable this if you + want full control of traffic in the private pool. Configure + Cloud NAT for the subnet of network attachment if you need to + access public Internet. - --no-public-egress - If set, workers in the worker pool are created without an - external IP address. + If unset, Only route private IPs, e.g. 10.0.0.0/8, + 172.16.0.0/12, and 192.168.0.0/16 through PSC interface. - If the worker pool is within a VPC Service Control perimeter, use - this flag. + Network configuration for Service Networking: + + --peered-network=PEERED_NETWORK + Existing network to which workers are peered. The network is + specified in resource URL format + projects/{network_project}/global/networks/{network_name}. + + If not specified, the workers are not peered to any network. + + --peered-network-ip-range=PEERED_NETWORK_IP_RANGE + An IP range for your peered network. Specify the IP range using + Classless Inter-Domain Routing (CIDR) notation with a slash and + the subnet prefix size, such as /29. + + Your subnet prefix size must be between 1 and 29. Optional: you + can specify an IP address before the subnet prefix value - for + example 192.168.0.0/24. + + If no IP address is specified, your VPC automatically + determines the starting IP for the range. If no IP range is + specified, Cloud Build uses /24 as the default network IP + range. + + --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. Configuration to be used for creating workers in the worker pool: diff --git a/gcloud/beta/builds/worker-pools/delete b/gcloud/beta/builds/worker-pools/delete index 00b94a5af..d8b2a8bb6 100644 --- a/gcloud/beta/builds/worker-pools/delete +++ b/gcloud/beta/builds/worker-pools/delete @@ -3,7 +3,8 @@ NAME Cloud Build SYNOPSIS - gcloud beta builds worker-pools delete WORKER_POOL [--region=REGION] + gcloud beta builds worker-pools delete WORKER_POOL + [--generation=GENERATION; default=1] [--region=REGION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -19,6 +20,9 @@ POSITIONAL ARGUMENTS The ID of the worker pool to delete. FLAGS + --generation=GENERATION; default=1 + Generation of the worker pool. + --region=REGION The Cloud region where the worker pool is. diff --git a/gcloud/beta/builds/worker-pools/describe b/gcloud/beta/builds/worker-pools/describe index 131a6c028..5bda66047 100644 --- a/gcloud/beta/builds/worker-pools/describe +++ b/gcloud/beta/builds/worker-pools/describe @@ -3,7 +3,8 @@ NAME Cloud Build SYNOPSIS - gcloud beta builds worker-pools describe WORKER_POOL [--region=REGION] + gcloud beta builds worker-pools describe WORKER_POOL + [--generation=GENERATION; default=1] [--region=REGION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -20,6 +21,9 @@ POSITIONAL ARGUMENTS The ID of the worker pool to describe. FLAGS + --generation=GENERATION; default=1 + Generation of the worker pool. + --region=REGION The Cloud region where the worker pool is. diff --git a/gcloud/beta/builds/worker-pools/list b/gcloud/beta/builds/worker-pools/list index 796a3307d..9635b6f75 100644 --- a/gcloud/beta/builds/worker-pools/list +++ b/gcloud/beta/builds/worker-pools/list @@ -3,9 +3,10 @@ NAME Cloud project SYNOPSIS - gcloud beta builds worker-pools list [--region=REGION] - [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] - [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + gcloud beta builds worker-pools list [--generation=GENERATION; default=1] + [--region=REGION] [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) List all worker pools in a Google Cloud project. @@ -16,6 +17,9 @@ EXAMPLES $ gcloud beta builds worker-pools list --region=us-central1 FLAGS + --generation=GENERATION; default=1 + Generation of the worker pool. + --region=REGION The Cloud region to list worker pools in. diff --git a/gcloud/beta/builds/worker-pools/update b/gcloud/beta/builds/worker-pools/update index 11a1fc919..2da938e7b 100644 --- a/gcloud/beta/builds/worker-pools/update +++ b/gcloud/beta/builds/worker-pools/update @@ -6,7 +6,8 @@ SYNOPSIS gcloud beta builds worker-pools update WORKER_POOL (--config-from-file=CONFIG_FROM_FILE | --[no-]public-egress --worker-disk-size=WORKER_DISK_SIZE - --worker-machine-type=WORKER_MACHINE_TYPE) [--region=REGION] + --worker-machine-type=WORKER_MACHINE_TYPE) + [--generation=GENERATION; default=1] [--region=REGION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -28,10 +29,12 @@ REQUIRED FLAGS Exactly one of these must be specified: --config-from-file=CONFIG_FROM_FILE - File that contains updates to the configuration for the worker pool. - See - https://cloud.google.com/build/docs/private-pools/worker-pool-config-file-schema - for options. + File that contains updates to the configuration for worker pool to be + created. + + Private pool options: + + https://cloud.google.com/build/docs/private-pools/worker-pool-config-file-schema Command-line flags to configure the private pool: @@ -58,6 +61,9 @@ REQUIRED FLAGS If unspecified, Cloud Build uses a standard machine type. OPTIONAL FLAGS + --generation=GENERATION; default=1 + Generation of the worker pool. + --region=REGION Cloud region where the worker pool is updated. See https://cloud.google.com/build/docs/locations for available locations. diff --git a/gcloud/beta/compute/addresses/create b/gcloud/beta/compute/addresses/create index 75c113b91..468ee18cf 100644 --- a/gcloud/beta/compute/addresses/create +++ b/gcloud/beta/compute/addresses/create @@ -85,8 +85,7 @@ FLAGS --network-tier=NETWORK_TIER The network tier to assign to the reserved IP addresses. NETWORK_TIER - must be one of: PREMIUM, STANDARD, FIXED_STANDARD. The default value is - PREMIUM. + must be one of: PREMIUM, STANDARD. The default value is PREMIUM. While regional external addresses (--region specified, --subnet omitted) can use either PREMIUM or STANDARD, global external addresses diff --git a/gcloud/beta/compute/forwarding-rules/create b/gcloud/beta/compute/forwarding-rules/create index 912f6a8a2..0934f2375 100644 --- a/gcloud/beta/compute/forwarding-rules/create +++ b/gcloud/beta/compute/forwarding-rules/create @@ -286,8 +286,7 @@ OPTIONAL FLAGS --network-tier=NETWORK_TIER Network tier to assign to the forwarding rules. NETWORK_TIER must be - one of: PREMIUM, STANDARD, FIXED_STANDARD. The default value is - PREMIUM. + one of: PREMIUM, STANDARD. The default value is PREMIUM. --service-directory-registration=SERVICE_DIRECTORY_REGISTRATION The Service Directory service in which to register this forwarding rule diff --git a/gcloud/beta/compute/instance-templates/create b/gcloud/beta/compute/instance-templates/create index 3029108cb..4233d6d82 100644 --- a/gcloud/beta/compute/instance-templates/create +++ b/gcloud/beta/compute/instance-templates/create @@ -655,8 +655,7 @@ FLAGS network-tier Specifies the network tier of the interface. NETWORK_TIER must be - one of: PREMIUM, STANDARD, FIXED_STANDARD. The default value is - PREMIUM. + one of: PREMIUM, STANDARD. The default value is PREMIUM. private-network-ip Assigns the given RFC1918 IP address to the interface. @@ -746,8 +745,8 @@ FLAGS --network-tier=NETWORK_TIER Specifies the network tier that will be used to configure the instance. - NETWORK_TIER must be one of: PREMIUM, STANDARD, FIXED_STANDARD. The - default value is PREMIUM. + NETWORK_TIER must be one of: PREMIUM, STANDARD. The default value is + PREMIUM. --partner-metadata=[NAMESPACE/KEY=VALUE,...] Partner metadata specifying namespace and its entries. The entries can diff --git a/gcloud/beta/compute/instance-templates/create-with-container b/gcloud/beta/compute/instance-templates/create-with-container index ab1cedcc4..4752b0e42 100644 --- a/gcloud/beta/compute/instance-templates/create-with-container +++ b/gcloud/beta/compute/instance-templates/create-with-container @@ -579,8 +579,7 @@ FLAGS network-tier Specifies the network tier of the interface. NETWORK_TIER must be - one of: PREMIUM, STANDARD, FIXED_STANDARD. The default value is - PREMIUM. + one of: PREMIUM, STANDARD. The default value is PREMIUM. private-network-ip Assigns the given RFC1918 IP address to the interface. @@ -646,8 +645,8 @@ FLAGS --network-tier=NETWORK_TIER Specifies the network tier that will be used to configure the instance. - NETWORK_TIER must be one of: PREMIUM, STANDARD, FIXED_STANDARD. The - default value is PREMIUM. + NETWORK_TIER must be one of: PREMIUM, STANDARD. The default value is + PREMIUM. --preemptible If provided, instances will be preemptible and time-limited. Instances diff --git a/gcloud/beta/compute/instances/add-access-config b/gcloud/beta/compute/instances/add-access-config index 5e1e55565..583442ee9 100644 --- a/gcloud/beta/compute/instances/add-access-config +++ b/gcloud/beta/compute/instances/add-access-config @@ -58,8 +58,7 @@ FLAGS --network-tier=NETWORK_TIER Specifies the network tier of the access configuration. NETWORK_TIER - must be one of: PREMIUM, STANDARD, FIXED_STANDARD. The default value is - PREMIUM. + must be one of: PREMIUM, STANDARD. The default value is PREMIUM. --zone=ZONE Zone of the instance to operate on. If not specified, you might be diff --git a/gcloud/beta/compute/instances/bulk/create b/gcloud/beta/compute/instances/bulk/create index 428363d96..279ada1e0 100644 --- a/gcloud/beta/compute/instances/bulk/create +++ b/gcloud/beta/compute/instances/bulk/create @@ -654,8 +654,8 @@ OPTIONAL FLAGS --network-tier=NETWORK_TIER Specifies the network tier that will be used to configure the instance. - NETWORK_TIER must be one of: PREMIUM, STANDARD, FIXED_STANDARD. The - default value is PREMIUM. + NETWORK_TIER must be one of: PREMIUM, STANDARD. The default value is + PREMIUM. --per-instance-hostnames=[INSTANCE_NAME=INSTANCE_HOSTNAME,...] Specify the hostname of the instance to be created. The specified diff --git a/gcloud/beta/compute/instances/create b/gcloud/beta/compute/instances/create index f5997739b..726eea5bf 100644 --- a/gcloud/beta/compute/instances/create +++ b/gcloud/beta/compute/instances/create @@ -707,8 +707,7 @@ FLAGS network-tier Specifies the network tier of the interface. NETWORK_TIER must be - one of: PREMIUM, STANDARD, FIXED_STANDARD. The default value is - PREMIUM. + one of: PREMIUM, STANDARD. The default value is PREMIUM. private-network-ip Assigns the given RFC1918 IP address to the interface. @@ -803,8 +802,8 @@ FLAGS --network-tier=NETWORK_TIER Specifies the network tier that will be used to configure the instance. - NETWORK_TIER must be one of: PREMIUM, STANDARD, FIXED_STANDARD. The - default value is PREMIUM. + NETWORK_TIER must be one of: PREMIUM, STANDARD. The default value is + PREMIUM. --node-project=NODE_PROJECT The name of the project with shared sole tenant node groups to create diff --git a/gcloud/beta/compute/instances/create-with-container b/gcloud/beta/compute/instances/create-with-container index 9d5f066d6..db002ec86 100644 --- a/gcloud/beta/compute/instances/create-with-container +++ b/gcloud/beta/compute/instances/create-with-container @@ -663,8 +663,7 @@ FLAGS network-tier Specifies the network tier of the interface. NETWORK_TIER must be - one of: PREMIUM, STANDARD, FIXED_STANDARD. The default value is - PREMIUM. + one of: PREMIUM, STANDARD. The default value is PREMIUM. private-network-ip Assigns the given RFC1918 IP address to the interface. @@ -746,8 +745,8 @@ FLAGS --network-tier=NETWORK_TIER Specifies the network tier that will be used to configure the instance. - NETWORK_TIER must be one of: PREMIUM, STANDARD, FIXED_STANDARD. The - default value is PREMIUM. + NETWORK_TIER must be one of: PREMIUM, STANDARD. The default value is + PREMIUM. --preemptible If provided, instances will be preemptible and time-limited. Instances diff --git a/gcloud/beta/compute/instances/import b/gcloud/beta/compute/instances/import index 9d4263668..68cce19f4 100644 --- a/gcloud/beta/compute/instances/import +++ b/gcloud/beta/compute/instances/import @@ -183,8 +183,8 @@ OPTIONAL FLAGS --network-tier=NETWORK_TIER Specifies the network tier that will be used to configure the instance. - NETWORK_TIER must be one of: PREMIUM, STANDARD, FIXED_STANDARD. The - default value is PREMIUM. + NETWORK_TIER must be one of: PREMIUM, STANDARD. The default value is + PREMIUM. --os=OS Specifies the OS of the image being imported. OS must be one of: diff --git a/gcloud/beta/compute/project-info/update b/gcloud/beta/compute/project-info/update index f2b92e46a..24a599faa 100644 --- a/gcloud/beta/compute/project-info/update +++ b/gcloud/beta/compute/project-info/update @@ -20,7 +20,7 @@ FLAGS --default-network-tier=DEFAULT_NETWORK_TIER The default network tier to assign to the project. DEFAULT_NETWORK_TIER - must be one of: PREMIUM, STANDARD, FIXED_STANDARD. + must be one of: PREMIUM, STANDARD. --managed-protection-tier=MANAGED_PROTECTION_TIER Managed protection tier to assign to the project. diff --git a/gcloud/beta/container/clusters/create b/gcloud/beta/container/clusters/create index aa1dd661f..f81520408 100644 --- a/gcloud/beta/container/clusters/create +++ b/gcloud/beta/container/clusters/create @@ -812,7 +812,7 @@ FLAGS The maximum number of nodes to allocate per default initial node pool. Kubernetes Engine will automatically create enough nodes pools such that each node pool contains less than --max-nodes-per-pool nodes. - Defaults to 2000 nodes, but can be set as low as 100 nodes per pool on + Defaults to 1000 nodes, but can be set as low as 100 nodes per pool on initial create. --max-pods-per-node=MAX_PODS_PER_NODE @@ -952,7 +952,8 @@ FLAGS New nodes, including ones created by resize or recreate, will have these labels on the Kubernetes API node object and can be used in - nodeSelectors. See http://kubernetes.io/docs/user-guide/node-selection/ + nodeSelectors. See + https://kubernetes.io/docs/concepts/scheduling-eviction/assign-pod-node/ for examples. Note that Kubernetes labels, intended to associate cluster components @@ -1101,6 +1102,11 @@ FLAGS considered GA quality. 'regular' is intended for production users who want to take advantage of new features. + extended + + Clusters subscribed to 'extended' can remain on a minor version for 24 months + from when the minor version is made available in the Regular channel. + stable Clusters subscribed to 'stable' receive versions that are known to @@ -1110,7 +1116,7 @@ FLAGS Use 'None' to opt-out of any release channel. - CHANNEL must be one of: rapid, regular, stable, None. + CHANNEL must be one of: rapid, regular, extended, stable, None. --resource-manager-tags=[KEY=VALUE,...] Applies the specified comma-separated resource manager tags that has diff --git a/gcloud/beta/container/clusters/create-auto b/gcloud/beta/container/clusters/create-auto index 48caaf07d..02d4a36ca 100644 --- a/gcloud/beta/container/clusters/create-auto +++ b/gcloud/beta/container/clusters/create-auto @@ -352,12 +352,17 @@ FLAGS considered GA quality. 'regular' is intended for production users who want to take advantage of new features. + extended + + Clusters subscribed to 'extended' can remain on a minor version for 24 months + from when the minor version is made available in the Regular channel. + 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. + CHANNEL must be one of: rapid, regular, extended, stable. --security-group=SECURITY_GROUP The name of the RBAC security group for use with Google security groups diff --git a/gcloud/beta/container/clusters/update b/gcloud/beta/container/clusters/update index 3c413eca7..b66c42c25 100644 --- a/gcloud/beta/container/clusters/update +++ b/gcloud/beta/container/clusters/update @@ -611,6 +611,11 @@ REQUIRED FLAGS considered GA quality. 'regular' is intended for production users who want to take advantage of new features. + extended + + Clusters subscribed to 'extended' can remain on a minor version for 24 months + from when the minor version is made available in the Regular channel. + stable Clusters subscribed to 'stable' receive versions that are known to @@ -620,7 +625,7 @@ REQUIRED FLAGS Use 'None' to opt-out of any release channel. - CHANNEL must be one of: rapid, regular, stable, None. + CHANNEL must be one of: rapid, regular, extended, stable, None. --remove-labels=[KEY,...] Labels to remove from the Google Cloud resources in use by the diff --git a/gcloud/beta/container/node-pools/create b/gcloud/beta/container/node-pools/create index b68da2eea..70b9438fe 100644 --- a/gcloud/beta/container/node-pools/create +++ b/gcloud/beta/container/node-pools/create @@ -477,7 +477,8 @@ FLAGS New nodes, including ones created by resize or recreate, will have these labels on the Kubernetes API node object and can be used in - nodeSelectors. See http://kubernetes.io/docs/user-guide/node-selection/ + nodeSelectors. See + https://kubernetes.io/docs/concepts/scheduling-eviction/assign-pod-node/ for examples. Note that Kubernetes labels, intended to associate cluster components diff --git a/gcloud/beta/container/node-pools/update b/gcloud/beta/container/node-pools/update index a442b00d0..ccb63045b 100644 --- a/gcloud/beta/container/node-pools/update +++ b/gcloud/beta/container/node-pools/update @@ -141,7 +141,8 @@ REQUIRED FLAGS New nodes, including ones created by resize or recreate, will have these labels on the Kubernetes API node object and can be used in nodeSelectors. See - http://kubernetes.io/docs/user-guide/node-selection/ for examples. + https://kubernetes.io/docs/concepts/scheduling-eviction/assign-pod-node/ + for examples. Note that Kubernetes labels, intended to associate cluster components and resources with one another and manage resource lifecycles, are diff --git a/gcloud/beta/deploy/apply b/gcloud/beta/deploy/apply index be719c0d2..4297c9799 100644 --- a/gcloud/beta/deploy/apply +++ b/gcloud/beta/deploy/apply @@ -1,7 +1,7 @@ NAME gcloud beta deploy apply - applies a yaml configuration containing Delivery - Pipeline(s), Target(s), Custom Target Type(s), and Automation(s) - declarative definitions + Pipeline(s), Target(s), Custom Target Type(s), Deploy Policy(ies), and + Automation(s) declarative definitions SYNOPSIS gcloud beta deploy apply --file=FILE [--region=REGION] @@ -9,8 +9,8 @@ SYNOPSIS DESCRIPTION (BETA) Applies a yaml configuration containing Delivery Pipeline(s), - Target(s), Custom Target Type(s), and Automation(s) declarative - definitions. + Target(s), Custom Target Type(s), Deploy Policy(ies), and Automation(s) + declarative definitions. EXAMPLES To apply a Cloud Deploy YAML file deploy.yaml: diff --git a/gcloud/beta/deploy/deploy-policies/delete b/gcloud/beta/deploy/deploy-policies/delete new file mode 100644 index 000000000..40768d1a1 --- /dev/null +++ b/gcloud/beta/deploy/deploy-policies/delete @@ -0,0 +1,75 @@ +NAME + gcloud beta deploy deploy-policies delete - delete a deploy policy + +SYNOPSIS + gcloud beta deploy deploy-policies delete (DEPLOY_POLICY : --region=REGION) + [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Delete a deploy policy for a specified region. + +EXAMPLES + The following command will delete deploy policy test-policy, in region + us-central1: + + $ gcloud beta deploy deploy-policies delete test-policy \ + --region=us-central1 + +POSITIONAL ARGUMENTS + Deploy policy resource - The name of the deploy policy to delete. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument deploy_policy on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + DEPLOY_POLICY + ID of the deploy policy or fully qualified identifier for the deploy + policy. + + To set the deploy_policy attribute: + ▸ provide the argument deploy_policy on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Location of the deploy policy. + + To set the region attribute: + ▸ provide the argument deploy_policy on the command line with a + fully specified name; + ▸ provide the argument --region on the command line; + ▸ set the property deploy/region. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the clouddeploy/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/deploy/ + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud deploy deploy-policies delete + + $ gcloud alpha deploy deploy-policies delete + diff --git a/gcloud/beta/deploy/deploy-policies/describe b/gcloud/beta/deploy/deploy-policies/describe new file mode 100644 index 000000000..bc1e666c6 --- /dev/null +++ b/gcloud/beta/deploy/deploy-policies/describe @@ -0,0 +1,69 @@ +NAME + gcloud beta deploy deploy-policies describe - show details for a deploy + policy + +SYNOPSIS + gcloud beta deploy deploy-policies describe + (DEPLOY_POLICY : --region=REGION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Show details for a specified deploy policy. + +EXAMPLES + To show details about a deploy policy test-policy in region us-central, + run: $ gcloud beta deploy deploy-policies describe test-policy \ + --region=us-central1 + +POSITIONAL ARGUMENTS + Deploy policy resource - The name of the deploy policy to describe. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument deploy_policy on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + DEPLOY_POLICY + ID of the deploy policy or fully qualified identifier for the deploy + policy. + + To set the deploy_policy attribute: + ▸ provide the argument deploy_policy on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Location of the deploy policy. + + To set the region attribute: + ▸ provide the argument deploy_policy on the command line with a + fully specified name; + ▸ provide the argument --region on the command line; + ▸ set the property deploy/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 clouddeploy/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/deploy/ + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud deploy deploy-policies describe + + $ gcloud alpha deploy deploy-policies describe + diff --git a/gcloud/beta/deploy/deploy-policies/export b/gcloud/beta/deploy/deploy-policies/export new file mode 100644 index 000000000..aa1e48666 --- /dev/null +++ b/gcloud/beta/deploy/deploy-policies/export @@ -0,0 +1,73 @@ +NAME + gcloud beta deploy deploy-policies export - returns the .yaml definition of + the specified deploy policy + +SYNOPSIS + gcloud beta deploy deploy-policies export (DEPLOY_POLICY : --region=REGION) + [--destination=DESTINATION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) The exported yaml definition can be applied by deploy apply command. + +EXAMPLES + To return the .yaml definition of the deploy policy test-policy, in region + us-central1, run: + + $ gcloud beta deploy deploy-policies export test-policy \ + --region=us-central1 + +POSITIONAL ARGUMENTS + Deploy policy resource - The name of the Deploy Policy. 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 deploy_policy on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + DEPLOY_POLICY + ID of the deploy_policy or fully qualified identifier for the + deploy_policy. + + To set the deploy_policy attribute: + ▸ provide the argument deploy_policy on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + The Cloud region for the deploy_policy. Alternatively, set the + property [deploy/region]. + + To set the region attribute: + ▸ provide the argument deploy_policy on the command line with a + fully specified name; + ▸ provide the argument --region on the command line; + ▸ set the property deploy/region. + +FLAGS + --destination=DESTINATION + Path to a YAML file where the configuration will be exported. + Alternatively, you may omit this flag to write to standard output. + +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 deploy deploy-policies export + + $ gcloud alpha deploy deploy-policies export + diff --git a/gcloud/beta/deploy/deploy-policies/help b/gcloud/beta/deploy/deploy-policies/help new file mode 100644 index 000000000..e509c7962 --- /dev/null +++ b/gcloud/beta/deploy/deploy-policies/help @@ -0,0 +1,35 @@ +NAME + gcloud beta deploy deploy-policies - create and manage Deploy Policy + resources for Google Cloud Deploy + +SYNOPSIS + gcloud beta deploy deploy-policies COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Create and manage Deploy Policy resources for Google Cloud Deploy. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + delete + (BETA) Delete a deploy policy. + + describe + (BETA) Show details for a deploy policy. + + export + (BETA) Returns the .yaml definition of the specified deploy policy. + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud deploy deploy-policies + + $ gcloud alpha deploy deploy-policies + diff --git a/gcloud/beta/deploy/help b/gcloud/beta/deploy/help index f382c22e3..27dd993f3 100644 --- a/gcloud/beta/deploy/help +++ b/gcloud/beta/deploy/help @@ -27,6 +27,10 @@ GROUPS delivery-pipelines (BETA) Create and manage Delivery Pipeline resources for Cloud Deploy. + deploy-policies + (BETA) Create and manage Deploy Policy resources for Google Cloud + Deploy. + job-runs (BETA) Manages job runs resources for Cloud Deploy. @@ -44,8 +48,8 @@ COMMANDS apply (BETA) Applies a yaml configuration containing Delivery Pipeline(s), - Target(s), Custom Target Type(s), and Automation(s) declarative - definitions. + Target(s), Custom Target Type(s), Deploy Policy(ies), and Automation(s) + declarative definitions. delete (BETA) Deletes Delivery Pipeline(s), Target(s), Custom Target Type(s), diff --git a/gcloud/beta/functions/deploy b/gcloud/beta/functions/deploy index d61d8444a..d4afd6c8a 100644 --- a/gcloud/beta/functions/deploy +++ b/gcloud/beta/functions/deploy @@ -599,9 +599,9 @@ FLAGS Allowed values for GCF 2nd gen are in the format: with allowed units of "k", "M", "G", "Ki", "Mi", "Gi". Ending 'b' or 'B' is - allowed. + allowed, but both are interpreted as bytes as opposed to bits. - Examples: 100000k, 128M, 10Mb, 1024Mi, 750K, 4Gi. + Examples: 1000000K, 1000000Ki, 256Mb, 512M, 1024Mi, 2G, 4Gi. By default, a new function is limited to 256MB of memory. When deploying an update to an existing function, the function keeps its old diff --git a/gcloud/beta/network-connectivity/help b/gcloud/beta/network-connectivity/help index 629586809..3a75f706e 100644 --- a/gcloud/beta/network-connectivity/help +++ b/gcloud/beta/network-connectivity/help @@ -19,12 +19,22 @@ GROUPS hubs (BETA) Manage Network Connectivity Center hubs. + locations + (BETA) Get information about supported Network Connectivity Center + locations. + + operations + (BETA) Manage Network Connectivity Center operations. + policy-based-routes (BETA) Manage Policy-based Routes. regional-endpoints (BETA) Manage Network Connectivity RegionalEndpoints. + spokes + (BETA) Manage Network Connectivity Center spokes. + NOTES This command is currently in beta and might change without notice. These variants are also available: diff --git a/gcloud/beta/network-connectivity/locations/describe b/gcloud/beta/network-connectivity/locations/describe new file mode 100644 index 000000000..0ad15e9a2 --- /dev/null +++ b/gcloud/beta/network-connectivity/locations/describe @@ -0,0 +1,54 @@ +NAME + gcloud beta network-connectivity locations describe - describe a Network + Connectivity Center location + +SYNOPSIS + gcloud beta network-connectivity locations describe LOCATION + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Retrieve details about a location. + +EXAMPLES + To describe location us-central1, run: + + $ gcloud beta network-connectivity locations describe us-central1 + +POSITIONAL ARGUMENTS + Location resource - Name of the location to describe. This represents a + Cloud resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument location on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ 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 networkconnectivity/v1beta API. The full + documentation for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud network-connectivity locations describe + diff --git a/gcloud/beta/network-connectivity/locations/help b/gcloud/beta/network-connectivity/locations/help new file mode 100644 index 000000000..58ecf25c1 --- /dev/null +++ b/gcloud/beta/network-connectivity/locations/help @@ -0,0 +1,31 @@ +NAME + gcloud beta network-connectivity locations - get information about + supported Network Connectivity Center locations + +SYNOPSIS + gcloud beta network-connectivity locations COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Get information about supported Network Connectivity Center + locations. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + (BETA) Describe a Network Connectivity Center location. + + list + (BETA) List Network Connectivity Center locations. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud network-connectivity locations + diff --git a/gcloud/beta/network-connectivity/locations/list b/gcloud/beta/network-connectivity/locations/list new file mode 100644 index 000000000..1007b231a --- /dev/null +++ b/gcloud/beta/network-connectivity/locations/list @@ -0,0 +1,76 @@ +NAME + gcloud beta network-connectivity locations list - list Network Connectivity + Center locations + +SYNOPSIS + gcloud beta network-connectivity locations list [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Retrieve and display a list of locations. + + Network Connectivity Center includes two general types of spokes: those + that use the site-to-site data transfer feature and those that don't. To + get a list of the locations that support one of these features, use the + --filter flag (see examples). The full list of location features can be + found here: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest/Shared.Types/LocationFeature + + To specify the maximum number of locations to return, use the --limit flag. + +EXAMPLES + To list all locations, run: + + $ gcloud beta network-connectivity locations list + + To list locations that support the site-to-site data transfer feature, run: + + $ gcloud beta network-connectivity locations list \ + --filter="metadata.locationFeatures=SITE_TO_SITE_SPOKES" + +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 networkconnectivity/v1beta API. The full + documentation for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud network-connectivity locations list + diff --git a/gcloud/beta/network-connectivity/operations/describe b/gcloud/beta/network-connectivity/operations/describe new file mode 100644 index 000000000..32583f227 --- /dev/null +++ b/gcloud/beta/network-connectivity/operations/describe @@ -0,0 +1,68 @@ +NAME + gcloud beta network-connectivity operations describe - describe a Network + Connectivity Center operation + +SYNOPSIS + gcloud beta network-connectivity operations describe + (OPERATION : --region=REGION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Retrieve details about an operation; this command is useful if you + want to check on a long-running operation. + +EXAMPLES + To describe operation operation-12345 in us-central1, run: + + $ gcloud beta network-connectivity operations describe \ + operation-12345 --region=us-central1 + +POSITIONAL ARGUMENTS + Operation resource - Name of the operation 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 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. + + --region=REGION + The location Id. + + To set the region attribute: + ▸ provide the argument operation on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkconnectivity/v1beta API. The full + documentation for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud network-connectivity operations describe + diff --git a/gcloud/beta/network-connectivity/operations/help b/gcloud/beta/network-connectivity/operations/help new file mode 100644 index 000000000..5f4c3ef7d --- /dev/null +++ b/gcloud/beta/network-connectivity/operations/help @@ -0,0 +1,30 @@ +NAME + gcloud beta network-connectivity operations - manage Network Connectivity + Center operations + +SYNOPSIS + gcloud beta network-connectivity operations COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Manage Network Connectivity Center operations. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + (BETA) Describe a Network Connectivity Center operation. + + list + (BETA) List Network Connectivity Center operations. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud network-connectivity operations + diff --git a/gcloud/beta/network-connectivity/operations/list b/gcloud/beta/network-connectivity/operations/list new file mode 100644 index 000000000..dfbc5a951 --- /dev/null +++ b/gcloud/beta/network-connectivity/operations/list @@ -0,0 +1,91 @@ +NAME + gcloud beta network-connectivity operations list - list Network + Connectivity Center operations + +SYNOPSIS + gcloud beta network-connectivity operations list --region=REGION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Retrieve and display a list of operations in the specified region, + sorted by creation time. + + To specify the maximum number of operations to return, use the --limit + flag. + +EXAMPLES + To list all operations in region us-central1, run: + + $ gcloud beta network-connectivity operations list \ + --region=us-central1 + + To list a maximum of five operations in us-central1, run: + + $ gcloud beta network-connectivity operations list \ + --region=us-central1 --limit=5 + +REQUIRED FLAGS + Region resource - Region of the operations to display. This represents a + Cloud resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --region 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. + + --region=REGION + ID of the region or fully qualified identifier for the region. + + To set the region attribute: + ▸ provide the argument --region 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 networkconnectivity/v1beta API. The full + documentation for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud network-connectivity operations list + diff --git a/gcloud/beta/network-connectivity/spokes/help b/gcloud/beta/network-connectivity/spokes/help new file mode 100644 index 000000000..5d4518ca5 --- /dev/null +++ b/gcloud/beta/network-connectivity/spokes/help @@ -0,0 +1,35 @@ +NAME + gcloud beta network-connectivity spokes - manage Network Connectivity + Center spokes + +SYNOPSIS + gcloud beta network-connectivity spokes GROUP [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Manage Network Connectivity Center spokes. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + linked-interconnect-attachments + (BETA) Manage VLAN attachment spokes. + + linked-router-appliances + (BETA) Manage Router appliance spokes. + + linked-vpn-tunnels + (BETA) Manage VPN spokes. + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-connectivity spokes + + $ gcloud alpha network-connectivity spokes + diff --git a/gcloud/beta/network-connectivity/spokes/linked-interconnect-attachments/create b/gcloud/beta/network-connectivity/spokes/linked-interconnect-attachments/create new file mode 100644 index 000000000..6cacc4cae --- /dev/null +++ b/gcloud/beta/network-connectivity/spokes/linked-interconnect-attachments/create @@ -0,0 +1,117 @@ +NAME + gcloud beta network-connectivity spokes linked-interconnect-attachments + create - create a new VLAN attachment spoke + +SYNOPSIS + gcloud beta network-connectivity spokes linked-interconnect-attachments + create (SPOKE : --region=REGION) --hub=HUB + --interconnect-attachments=[INTERCONNECT_ATTACHMENTS,...] [--async] + [--description=DESCRIPTION] + [--include-import-ranges=[INCLUDE_IMPORT_RANGES,...]] + [--labels=[KEY=VALUE,...]] [--site-to-site-data-transfer] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Create a new VLAN attachment spoke + (https://cloud.google.com/network-connectivity/docs/network-connectivity-center/how-to/working-with-hubs-spokes#create-vlan-spoke). + +EXAMPLES + To create a spoke in region us-central1 that uses data transfer and has two + VLAN attachments, run: + + $ gcloud beta network-connectivity spokes \ + linked-interconnect-attachments create my-spoke \ + --hub="https://www.googleapis.com/networkconnectivity/v1beta/pro\ + jects/my-project/locations/global/hubs/my-hub" \ + --region=us-central1 \ + --interconnect-attachments=https://www.googleapis.com/compute/\ + v1/projects/my-project/regions/us-central1/interconnectAttachments/\ + ic1,https://www.googleapis.com/compute/v1/projects/my-project/\ + regions/us-central1/interconnectAttachments/ic2 \ + --site-to-site-data-transfer + +POSITIONAL ARGUMENTS + Spoke resource - Name of the spoke to be created. 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 spoke 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. + + SPOKE + ID of the spoke or fully qualified identifier for the spoke. + + To set the spoke attribute: + ▸ provide the argument spoke on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + The location Id. + + To set the region attribute: + ▸ provide the argument spoke on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + +REQUIRED FLAGS + --hub=HUB + Hub that the spoke will attach to. The hub must already exist. + + --interconnect-attachments=[INTERCONNECT_ATTACHMENTS,...] + VLAN attachments that the spoke provides connectivity to. The resources + must already exist. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + Description of the spoke to create. + + --include-import-ranges=[INCLUDE_IMPORT_RANGES,...] + IP address range(s) allowed to be imported from hub subnets. Only + ``ALL_IPV4_RANGES`` can be added to the list. If it's empty, the spoke + does not import any subnets from the hub. + + --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. + + --site-to-site-data-transfer + Whether to enable site-to-site data transfer for this spoke. Data + transfer is available only in supported locations + (https://cloud.google.com/network-connectivity/docs/network-connectivity-center/concepts/locations). + +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 networkconnectivity/v1beta API. The full + documentation for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud network-connectivity spokes \ + linked-interconnect-attachments create + diff --git a/gcloud/beta/network-connectivity/spokes/linked-interconnect-attachments/help b/gcloud/beta/network-connectivity/spokes/linked-interconnect-attachments/help new file mode 100644 index 000000000..8f055640f --- /dev/null +++ b/gcloud/beta/network-connectivity/spokes/linked-interconnect-attachments/help @@ -0,0 +1,31 @@ +NAME + gcloud beta network-connectivity spokes linked-interconnect-attachments - + manage VLAN attachment spokes + +SYNOPSIS + gcloud beta network-connectivity spokes linked-interconnect-attachments + COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Manage VLAN attachment spokes. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (BETA) Create a new VLAN attachment spoke. + + update + (BETA) Update a VLAN attachment spoke. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud network-connectivity spokes linked-interconnect-attachments + diff --git a/gcloud/beta/network-connectivity/spokes/linked-interconnect-attachments/update b/gcloud/beta/network-connectivity/spokes/linked-interconnect-attachments/update new file mode 100644 index 000000000..c3728a1da --- /dev/null +++ b/gcloud/beta/network-connectivity/spokes/linked-interconnect-attachments/update @@ -0,0 +1,116 @@ +NAME + gcloud beta network-connectivity spokes linked-interconnect-attachments + update - update a VLAN attachment spoke + +SYNOPSIS + gcloud beta network-connectivity spokes linked-interconnect-attachments + update (SPOKE : --region=REGION) [--async] [--description=DESCRIPTION] + [--include-import-ranges=[INCLUDE_IMPORT_RANGES,...]] + [--update-labels=[KEY=VALUE,...]] + [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Update the details of a VLAN attachment spoke. + +EXAMPLES + To update the description of a VLAN attachment spoke named my-spoke, run: + + $ gcloud beta network-connectivity spokes \ + linked-interconnect-attachments update my-spoke \ + --region=us-central1 --description="new spoke description" + +POSITIONAL ARGUMENTS + Spoke resource - Name of the spoke 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 spoke 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. + + SPOKE + ID of the spoke or fully qualified identifier for the spoke. + + To set the spoke attribute: + ▸ provide the argument spoke on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + The location Id. + + To set the region attribute: + ▸ provide the argument spoke on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + New description of the spoke. + + --include-import-ranges=[INCLUDE_IMPORT_RANGES,...] + IP address range(s) allowed to be imported from hub subnets. Only + ``ALL_IPV4_RANGES`` can be added to the list. If it's empty, the spoke + does not import any subnets from the hub. + + --update-labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to update. If a label exists, its value + is modified. Otherwise, a new label is created. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + At most one of these can be specified: + + --clear-labels + Remove all labels. If --update-labels is also specified then + --clear-labels is applied first. + + For example, to remove all labels: + + $ gcloud beta network-connectivity spokes \ + linked-interconnect-attachments update --clear-labels + + To remove all existing labels and create two new labels, foo and baz: + + $ gcloud beta network-connectivity spokes \ + linked-interconnect-attachments update --clear-labels \ + --update-labels foo=bar,baz=qux + + --remove-labels=[KEY,...] + List of label keys to remove. If a label does not exist it is + silently ignored. If --update-labels is also specified then + --update-labels is applied first. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkconnectivity/v1beta API. The full + documentation for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud network-connectivity spokes \ + linked-interconnect-attachments update + diff --git a/gcloud/beta/network-connectivity/spokes/linked-router-appliances/create b/gcloud/beta/network-connectivity/spokes/linked-router-appliances/create new file mode 100644 index 000000000..3cc1295aa --- /dev/null +++ b/gcloud/beta/network-connectivity/spokes/linked-router-appliances/create @@ -0,0 +1,122 @@ +NAME + gcloud beta network-connectivity spokes linked-router-appliances create - + create a new Router appliance spoke + +SYNOPSIS + gcloud beta network-connectivity spokes linked-router-appliances create + (SPOKE : --region=REGION) --hub=HUB + --router-appliance=[instance=INSTANCE],[ip=IP] [--async] + [--description=DESCRIPTION] + [--include-import-ranges=[INCLUDE_IMPORT_RANGES,...]] + [--labels=[KEY=VALUE,...]] [--site-to-site-data-transfer] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Create a new Router appliance spoke + (https://cloud.google.com/network-connectivity/docs/network-connectivity-center/how-to/working-with-hubs-spokes#create-ra-spoke). + +EXAMPLES + To create a spoke in region us-central1 that uses data transfer and has two + router appliance instances, run: + + $ gcloud beta network-connectivity spokes linked-router-appliances \ + create my-spoke \ + --hub="https://www.googleapis.com/networkconnectivity/v1/project\ + s/my-project/locations/global/hubs/my-hub" --region=us-central1 \ + --router-appliance=instance=https://www.googleapis.com/compute/\ + v1/projects/my-project/zones/us-central1-a/instances/vm1,\ + ip=10.10.0.1 \ + --router-appliance=instance=https://www.googleapis.com/compute/\ + v1/projects/my-project/zones/us-central1-a/instances/vm2,\ + ip=10.10.0.2 --site-to-site-data-transfer + +POSITIONAL ARGUMENTS + Spoke resource - Name of the spoke to be created. 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 spoke 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. + + SPOKE + ID of the spoke or fully qualified identifier for the spoke. + + To set the spoke attribute: + ▸ provide the argument spoke on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + The location Id. + + To set the region attribute: + ▸ provide the argument spoke on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + +REQUIRED FLAGS + --hub=HUB + Hub that the spoke will attach to. The hub must already exist. + + --router-appliance=[instance=INSTANCE],[ip=IP] + Router appliance instance(s) that the spoke provides connectivity to. + The resources must already exist. + + For example, use --router-appliance=instance=ins_uri_1,ip=10.10.0.1 to + add a single router appliance instance, or + --router-appliance=instance=ins_uri_1,ip=10.10.0.1 + --router-appliance=instance=ins_uri_2,ip=10.10.0.2 ... to add multiple + instances. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + Description of the spoke to create. + + --include-import-ranges=[INCLUDE_IMPORT_RANGES,...] + IP address range(s) allowed to be imported from hub subnets. Only + ``ALL_IPV4_RANGES`` can be added to the list. If it's empty, the spoke + does not import any subnets from the hub. + + --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. + + --site-to-site-data-transfer + Whether to enable site-to-site data transfer for this spoke. Data + transfer is available only in supported locations + (https://cloud.google.com/network-connectivity/docs/network-connectivity-center/concepts/locations). + +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 networkconnectivity/v1beta API. The full + documentation for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud network-connectivity spokes linked-router-appliances create + diff --git a/gcloud/beta/network-connectivity/spokes/linked-router-appliances/help b/gcloud/beta/network-connectivity/spokes/linked-router-appliances/help new file mode 100644 index 000000000..52af5f861 --- /dev/null +++ b/gcloud/beta/network-connectivity/spokes/linked-router-appliances/help @@ -0,0 +1,31 @@ +NAME + gcloud beta network-connectivity spokes linked-router-appliances - manage + Router appliance spokes + +SYNOPSIS + gcloud beta network-connectivity spokes linked-router-appliances COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Manage Router appliance spokes. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (BETA) Create a new Router appliance spoke. + + update + (BETA) Update a Router appliance spoke. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud network-connectivity spokes linked-router-appliances + diff --git a/gcloud/beta/network-connectivity/spokes/linked-router-appliances/update b/gcloud/beta/network-connectivity/spokes/linked-router-appliances/update new file mode 100644 index 000000000..910261ca7 --- /dev/null +++ b/gcloud/beta/network-connectivity/spokes/linked-router-appliances/update @@ -0,0 +1,137 @@ +NAME + gcloud beta network-connectivity spokes linked-router-appliances update - + update a Router appliance spoke + +SYNOPSIS + gcloud beta network-connectivity spokes linked-router-appliances update + (SPOKE : --region=REGION) [--async] [--description=DESCRIPTION] + [--include-import-ranges=[INCLUDE_IMPORT_RANGES,...]] + [--router-appliance=[instance=INSTANCE],[ip=IP]] + [--update-labels=[KEY=VALUE,...]] + [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Update the details of a Router appliance spoke. + +EXAMPLES + To update the description of a Router appliance spoke named my-spoke, run: + + $ gcloud beta network-connectivity spokes linked-router-appliances \ + update my-spoke --region=us-central1 \ + --description="new spoke description" + + To replace the router appliance instances linked to a spoke with two new + instances, run: + + $ gcloud beta network-connectivity spokes linked-router-appliances \ + update my-spoke --region=us-central1 \ + --router-appliance=instance=https://www.googleapis.com/compute/\ + v1/projects/my-project/zones/us-central1-a/instances/vm1,\ + ip=10.10.0.1 \ + --router-appliance=instance=https://www.googleapis.com/compute/\ + v1/projects/my-project/zones/us-central1-a/instances/vm2,\ + ip=10.10.0.2 + +POSITIONAL ARGUMENTS + Spoke resource - Name of the spoke 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 spoke 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. + + SPOKE + ID of the spoke or fully qualified identifier for the spoke. + + To set the spoke attribute: + ▸ provide the argument spoke on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + The location Id. + + To set the region attribute: + ▸ provide the argument spoke on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + New description of the spoke. + + --include-import-ranges=[INCLUDE_IMPORT_RANGES,...] + IP address range(s) allowed to be imported from hub subnets. Only + ``ALL_IPV4_RANGES`` can be added to the list. If it's empty, the spoke + does not import any subnets from the hub. + + --router-appliance=[instance=INSTANCE],[ip=IP] + Router appliance instance(s) with which to replace the set of instances + already linked to this spoke. Pass this flag multiple times to replace + with multiple instances. For example, use + --router-appliance=instance=new_ins_uri,ip=10.10.0.1 for a single + router appliance instance, or + --router-appliance=instance=new_ins_uri_1,ip=10.10.0.1 + --router-appliance=instance=new_ins_uri_2,ip=10.10.0.2 ... for multiple + instances. + + --update-labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to update. If a label exists, its value + is modified. Otherwise, a new label is created. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + At most one of these can be specified: + + --clear-labels + Remove all labels. If --update-labels is also specified then + --clear-labels is applied first. + + For example, to remove all labels: + + $ gcloud beta network-connectivity spokes linked-router-appliances \ + update --clear-labels + + To remove all existing labels and create two new labels, foo and baz: + + $ gcloud beta network-connectivity spokes linked-router-appliances \ + update --clear-labels --update-labels foo=bar,baz=qux + + --remove-labels=[KEY,...] + List of label keys to remove. If a label does not exist it is + silently ignored. If --update-labels is also specified then + --update-labels is applied first. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkconnectivity/v1beta API. The full + documentation for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud network-connectivity spokes linked-router-appliances update + diff --git a/gcloud/beta/network-connectivity/spokes/linked-vpn-tunnels/create b/gcloud/beta/network-connectivity/spokes/linked-vpn-tunnels/create new file mode 100644 index 000000000..cbd0df62f --- /dev/null +++ b/gcloud/beta/network-connectivity/spokes/linked-vpn-tunnels/create @@ -0,0 +1,114 @@ +NAME + gcloud beta network-connectivity spokes linked-vpn-tunnels create - create + a new VPN spoke + +SYNOPSIS + gcloud beta network-connectivity spokes linked-vpn-tunnels create + (SPOKE : --region=REGION) --hub=HUB --vpn-tunnels=[VPN_TUNNELS,...] + [--async] [--description=DESCRIPTION] + [--include-import-ranges=[INCLUDE_IMPORT_RANGES,...]] + [--labels=[KEY=VALUE,...]] [--site-to-site-data-transfer] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Create a new VPN spoke + (https://cloud.google.com/network-connectivity/docs/network-connectivity-center/how-to/working-with-hubs-spokes#create-vpn-spoke). + +EXAMPLES + To create a VPN spoke in region us-central1 that uses data transfer and has + two tunnels, run: + + $ gcloud beta network-connectivity spokes linked-vpn-tunnels \ + create my-spoke \ + --hub="https://www.googleapis.com/networkconnectivity/v1beta/pro\ + jects/my-project/locations/global/hubs/my-hub" \ + --region=us-central1 \ + --vpn-tunnels=https://www.googleapis.com/compute/v1/projects/\ + my-project/regions/us-central1/vpnTunnels/vpn-tunnel1,https://\ + www.googleapis.com/compute/v1/projects/my-project/regions/\ + us-central1/vpnTunnels/vpn-tunnel2 --site-to-site-data-transfer + +POSITIONAL ARGUMENTS + Spoke resource - Name of the spoke to be created. 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 spoke 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. + + SPOKE + ID of the spoke or fully qualified identifier for the spoke. + + To set the spoke attribute: + ▸ provide the argument spoke on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + The location Id. + + To set the region attribute: + ▸ provide the argument spoke on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + +REQUIRED FLAGS + --hub=HUB + Hub that the spoke will attach to. The hub must already exist. + + --vpn-tunnels=[VPN_TUNNELS,...] + HA VPN tunnels that the spoke provides connectivity to. The resources + must already exist. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + Description of the spoke to create. + + --include-import-ranges=[INCLUDE_IMPORT_RANGES,...] + IP address range(s) allowed to be imported from hub subnets. Only + ``ALL_IPV4_RANGES`` can be added to the list. If it's empty, the spoke + does not import any subnets from the hub. + + --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. + + --site-to-site-data-transfer + Whether to enable site-to-site data transfer for this spoke. Data + transfer is available only in supported locations + (https://cloud.google.com/network-connectivity/docs/network-connectivity-center/concepts/locations). + +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 networkconnectivity/v1beta API. The full + documentation for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud network-connectivity spokes linked-vpn-tunnels create + diff --git a/gcloud/beta/network-connectivity/spokes/linked-vpn-tunnels/help b/gcloud/beta/network-connectivity/spokes/linked-vpn-tunnels/help new file mode 100644 index 000000000..2bdeceb2f --- /dev/null +++ b/gcloud/beta/network-connectivity/spokes/linked-vpn-tunnels/help @@ -0,0 +1,31 @@ +NAME + gcloud beta network-connectivity spokes linked-vpn-tunnels - manage VPN + spokes + +SYNOPSIS + gcloud beta network-connectivity spokes linked-vpn-tunnels COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Manage VPN spokes. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (BETA) Create a new VPN spoke. + + update + (BETA) Update a VPN spoke. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud network-connectivity spokes linked-vpn-tunnels + diff --git a/gcloud/beta/network-connectivity/spokes/linked-vpn-tunnels/update b/gcloud/beta/network-connectivity/spokes/linked-vpn-tunnels/update new file mode 100644 index 000000000..5c0206ce1 --- /dev/null +++ b/gcloud/beta/network-connectivity/spokes/linked-vpn-tunnels/update @@ -0,0 +1,114 @@ +NAME + gcloud beta network-connectivity spokes linked-vpn-tunnels update - update + a VPN spoke + +SYNOPSIS + gcloud beta network-connectivity spokes linked-vpn-tunnels update + (SPOKE : --region=REGION) [--async] [--description=DESCRIPTION] + [--include-import-ranges=[INCLUDE_IMPORT_RANGES,...]] + [--update-labels=[KEY=VALUE,...]] + [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Update the details of a VPN spoke. + +EXAMPLES + To update the description of a VPN spoke named my-spoke, run: + + $ gcloud beta network-connectivity spokes linked-vpn-tunnels \ + update my-spoke --region=us-central1 \ + --description="new spoke description" + +POSITIONAL ARGUMENTS + Spoke resource - Name of the spoke 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 spoke 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. + + SPOKE + ID of the spoke or fully qualified identifier for the spoke. + + To set the spoke attribute: + ▸ provide the argument spoke on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + The location Id. + + To set the region attribute: + ▸ provide the argument spoke on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + New description of the spoke. + + --include-import-ranges=[INCLUDE_IMPORT_RANGES,...] + IP address range(s) allowed to be imported from hub subnets. Only + ``ALL_IPV4_RANGES`` can be added to the list. If it's empty, the spoke + does not import any subnets from the hub. + + --update-labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to update. If a label exists, its value + is modified. Otherwise, a new label is created. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + At most one of these can be specified: + + --clear-labels + Remove all labels. If --update-labels is also specified then + --clear-labels is applied first. + + For example, to remove all labels: + + $ gcloud beta network-connectivity spokes linked-vpn-tunnels \ + update --clear-labels + + To remove all existing labels and create two new labels, foo and baz: + + $ gcloud beta network-connectivity spokes linked-vpn-tunnels \ + update --clear-labels --update-labels foo=bar,baz=qux + + --remove-labels=[KEY,...] + List of label keys to remove. If a label does not exist it is + silently ignored. If --update-labels is also specified then + --update-labels is applied first. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkconnectivity/v1beta API. The full + documentation for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud network-connectivity spokes linked-vpn-tunnels update + diff --git a/gcloud/beta/network-services/service-lb-policies/create b/gcloud/beta/network-services/service-lb-policies/create index d89ae16c9..020b13522 100644 --- a/gcloud/beta/network-services/service-lb-policies/create +++ b/gcloud/beta/network-services/service-lb-policies/create @@ -74,8 +74,8 @@ FLAGS traffic to failover backends. If the percentage of endpoints in a MIG/NEG is smaller than this value, traffic would be sent to failover backends if possible. This field should be set to a value between 1 and - 99. The default value is 50 for Global external HTTP(S) load balancer - (classic) and Proxyless service mesh, and 70 for others. + 99. The default value is 50 for Proxyless service mesh, and 70 for + others. --load-balancing-algorithm=LOAD_BALANCING_ALGORITHM; default="waterfall-by-region" The global load balancing algorithm to be used. diff --git a/gcloud/beta/network-services/service-lb-policies/update b/gcloud/beta/network-services/service-lb-policies/update index 0175d4d46..797921a15 100644 --- a/gcloud/beta/network-services/service-lb-policies/update +++ b/gcloud/beta/network-services/service-lb-policies/update @@ -73,8 +73,8 @@ FLAGS traffic to failover backends. If the percentage of endpoints in a MIG/NEG is smaller than this value, traffic would be sent to failover backends if possible. This field should be set to a value between 1 and - 99. The default value is 50 for Global external HTTP(S) load balancer - (classic) and Proxyless service mesh, and 70 for others. + 99. The default value is 50 for Proxyless service mesh, and 70 for + others. --load-balancing-algorithm=LOAD_BALANCING_ALGORITHM; default="waterfall-by-region" The global load balancing algorithm to be used. diff --git a/gcloud/beta/pubsub/subscriptions/create b/gcloud/beta/pubsub/subscriptions/create index d5670fe3b..5d8d937db 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-use-topic-schema --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-max-messages=CLOUD_STORAGE_MAX_MESSAGES --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]] @@ -231,6 +231,11 @@ OPTIONAL FLAGS "m", "h", and "d" for seconds, minutes, hours, and days, respectively. If the unit is omitted, seconds is assumed. + --cloud-storage-max-messages=CLOUD_STORAGE_MAX_MESSAGES + The maximum number of messages that can be written to a Cloud + Storage file before a new file is created. The value must be + greater than or equal to 1000. + --cloud-storage-output-format=OUTPUT_FORMAT; default="text" The output format for data written to Cloud Storage. Values: text (messages will be written as raw text, separated by a newline) or diff --git a/gcloud/beta/pubsub/subscriptions/update b/gcloud/beta/pubsub/subscriptions/update index 3b71858f4..f1dab2263 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-use-topic-schema --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-max-messages=CLOUD_STORAGE_MAX_MESSAGES --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 @@ -211,6 +211,11 @@ FLAGS of "s", "m", "h", and "d" for seconds, minutes, hours, and days, respectively. If the unit is omitted, seconds is assumed. + --cloud-storage-max-messages=CLOUD_STORAGE_MAX_MESSAGES + The maximum number of messages that can be written to a Cloud + Storage file before a new file is created. The value must be + greater than or equal to 1000. + --cloud-storage-output-format=OUTPUT_FORMAT; default="text" The output format for data written to Cloud Storage. Values: text (messages will be written as raw text, separated by a newline) or diff --git a/gcloud/beta/workstations/configs/create b/gcloud/beta/workstations/configs/create index 6a8d39d79..740cd1658 100644 --- a/gcloud/beta/workstations/configs/create +++ b/gcloud/beta/workstations/configs/create @@ -5,6 +5,7 @@ NAME SYNOPSIS gcloud beta workstations configs create (CONFIG : --cluster=CLUSTER --region=REGION) + [--allow-unauthenticated-cors-preflight-requests] [--allowed-ports=[ALLOWED_PORTS,...]] [--async] [--boost-config=[BOOST_CONFIG,...]] [--boot-disk-size=BOOT_DISK_SIZE; default=50] @@ -102,6 +103,15 @@ POSITIONAL ARGUMENTS ▸ set the property workstations/region. FLAGS + --allow-unauthenticated-cors-preflight-requests + By default, the workstations service makes sure that all requests to + the workstation are authenticated. CORS preflight requests do not + include cookies or custom headers, and so are considered + unauthenticated and blocked by the workstations service. Enabling this + option allows these unauthenticated CORS preflight requests through to + the workstation, where it becomes the responsibility of the destination + server in the workstation to validate the request + --allowed-ports=[ALLOWED_PORTS,...] A Single or Range of ports externally accessible in the workstation. If not specified defaults to ports 22, 80 and ports 1024-65535. diff --git a/gcloud/beta/workstations/configs/update b/gcloud/beta/workstations/configs/update index de5aa92ac..eeddb9db9 100644 --- a/gcloud/beta/workstations/configs/update +++ b/gcloud/beta/workstations/configs/update @@ -23,6 +23,8 @@ SYNOPSIS [--shielded-vtpm] [--vm-tags=[VM_TAGS,...]] [--accelerator-count=ACCELERATOR_COUNT : --accelerator-type=ACCELERATOR_TYPE] + [--allow-unauthenticated-cors-preflight-requests + | --disallow-unauthenticated-cors-preflight-requests] [--container-custom-image=CONTAINER_CUSTOM_IMAGE | --container-predefined-image=CONTAINER_PREDEFINED_IMAGE] [--disable-ssh-to-vm | --enable-ssh-to-vm] @@ -304,6 +306,21 @@ FLAGS The type of accelerator resource to attach to the instance, for example, "nvidia-tesla-p100". + At most one of these can be specified: + + --allow-unauthenticated-cors-preflight-requests + By default, the workstations service makes sure that all requests to + the workstation are authenticated. CORS preflight requests do not + include cookies or custom headers, and so are considered + unauthenticated and blocked by the workstations service. Enabling + this option allows these unauthenticated CORS preflight requests + through to the workstation, where it becomes the responsibility of + the destination server in the workstation to validate the request + + --disallow-unauthenticated-cors-preflight-requests + If set, requires that all requests to the workstation are + authenticated. + At most one of these can be specified: --container-custom-image=CONTAINER_CUSTOM_IMAGE diff --git a/gcloud/compute/addresses/create b/gcloud/compute/addresses/create index cf2117c7f..1ad11a914 100644 --- a/gcloud/compute/addresses/create +++ b/gcloud/compute/addresses/create @@ -78,8 +78,7 @@ FLAGS --network-tier=NETWORK_TIER The network tier to assign to the reserved IP addresses. NETWORK_TIER - must be one of: PREMIUM, STANDARD, FIXED_STANDARD. The default value is - PREMIUM. + must be one of: PREMIUM, STANDARD. The default value is PREMIUM. While regional external addresses (--region specified, --subnet omitted) can use either PREMIUM or STANDARD, global external addresses diff --git a/gcloud/compute/forwarding-rules/create b/gcloud/compute/forwarding-rules/create index 460da3fad..228565a8a 100644 --- a/gcloud/compute/forwarding-rules/create +++ b/gcloud/compute/forwarding-rules/create @@ -286,8 +286,7 @@ OPTIONAL FLAGS --network-tier=NETWORK_TIER Network tier to assign to the forwarding rules. NETWORK_TIER must be - one of: PREMIUM, STANDARD, FIXED_STANDARD. The default value is - PREMIUM. + one of: PREMIUM, STANDARD. The default value is PREMIUM. --service-directory-registration=SERVICE_DIRECTORY_REGISTRATION The Service Directory service in which to register this forwarding rule diff --git a/gcloud/compute/instance-templates/create b/gcloud/compute/instance-templates/create index c12f2287a..fcdb5fae8 100644 --- a/gcloud/compute/instance-templates/create +++ b/gcloud/compute/instance-templates/create @@ -599,8 +599,7 @@ FLAGS network-tier Specifies the network tier of the interface. NETWORK_TIER must be - one of: PREMIUM, STANDARD, FIXED_STANDARD. The default value is - PREMIUM. + one of: PREMIUM, STANDARD. The default value is PREMIUM. private-network-ip Assigns the given RFC1918 IP address to the interface. @@ -690,8 +689,8 @@ FLAGS --network-tier=NETWORK_TIER Specifies the network tier that will be used to configure the instance. - NETWORK_TIER must be one of: PREMIUM, STANDARD, FIXED_STANDARD. The - default value is PREMIUM. + NETWORK_TIER must be one of: PREMIUM, STANDARD. The default value is + PREMIUM. --performance-monitoring-unit=PERFORMANCE_MONITORING_UNIT The type of performance monitoring counters (PMCs) to enable in the diff --git a/gcloud/compute/instance-templates/create-with-container b/gcloud/compute/instance-templates/create-with-container index a6a34a870..b03747077 100644 --- a/gcloud/compute/instance-templates/create-with-container +++ b/gcloud/compute/instance-templates/create-with-container @@ -532,8 +532,7 @@ FLAGS network-tier Specifies the network tier of the interface. NETWORK_TIER must be - one of: PREMIUM, STANDARD, FIXED_STANDARD. The default value is - PREMIUM. + one of: PREMIUM, STANDARD. The default value is PREMIUM. private-network-ip Assigns the given RFC1918 IP address to the interface. @@ -599,8 +598,8 @@ FLAGS --network-tier=NETWORK_TIER Specifies the network tier that will be used to configure the instance. - NETWORK_TIER must be one of: PREMIUM, STANDARD, FIXED_STANDARD. The - default value is PREMIUM. + NETWORK_TIER must be one of: PREMIUM, STANDARD. The default value is + PREMIUM. --preemptible If provided, instances will be preemptible and time-limited. Instances diff --git a/gcloud/compute/instances/add-access-config b/gcloud/compute/instances/add-access-config index 5951e1054..449b5b6eb 100644 --- a/gcloud/compute/instances/add-access-config +++ b/gcloud/compute/instances/add-access-config @@ -57,8 +57,7 @@ FLAGS --network-tier=NETWORK_TIER Specifies the network tier of the access configuration. NETWORK_TIER - must be one of: PREMIUM, STANDARD, FIXED_STANDARD. The default value is - PREMIUM. + must be one of: PREMIUM, STANDARD. The default value is PREMIUM. --zone=ZONE Zone of the instance to operate on. If not specified, you might be diff --git a/gcloud/compute/instances/bulk/create b/gcloud/compute/instances/bulk/create index 6f2b03fb7..b31bd85a0 100644 --- a/gcloud/compute/instances/bulk/create +++ b/gcloud/compute/instances/bulk/create @@ -643,8 +643,8 @@ OPTIONAL FLAGS --network-tier=NETWORK_TIER Specifies the network tier that will be used to configure the instance. - NETWORK_TIER must be one of: PREMIUM, STANDARD, FIXED_STANDARD. The - default value is PREMIUM. + NETWORK_TIER must be one of: PREMIUM, STANDARD. The default value is + PREMIUM. --performance-monitoring-unit=PERFORMANCE_MONITORING_UNIT The type of performance monitoring counters (PMCs) to enable in the diff --git a/gcloud/compute/instances/create b/gcloud/compute/instances/create index 11b122c36..c787aea84 100644 --- a/gcloud/compute/instances/create +++ b/gcloud/compute/instances/create @@ -681,8 +681,7 @@ FLAGS network-tier Specifies the network tier of the interface. NETWORK_TIER must be - one of: PREMIUM, STANDARD, FIXED_STANDARD. The default value is - PREMIUM. + one of: PREMIUM, STANDARD. The default value is PREMIUM. private-network-ip Assigns the given RFC1918 IP address to the interface. @@ -777,8 +776,8 @@ FLAGS --network-tier=NETWORK_TIER Specifies the network tier that will be used to configure the instance. - NETWORK_TIER must be one of: PREMIUM, STANDARD, FIXED_STANDARD. The - default value is PREMIUM. + NETWORK_TIER must be one of: PREMIUM, STANDARD. The default value is + PREMIUM. --node-project=NODE_PROJECT The name of the project with shared sole tenant node groups to create diff --git a/gcloud/compute/instances/create-with-container b/gcloud/compute/instances/create-with-container index dbec99b06..2cf8f6b33 100644 --- a/gcloud/compute/instances/create-with-container +++ b/gcloud/compute/instances/create-with-container @@ -624,8 +624,7 @@ FLAGS network-tier Specifies the network tier of the interface. NETWORK_TIER must be - one of: PREMIUM, STANDARD, FIXED_STANDARD. The default value is - PREMIUM. + one of: PREMIUM, STANDARD. The default value is PREMIUM. private-network-ip Assigns the given RFC1918 IP address to the interface. @@ -707,8 +706,8 @@ FLAGS --network-tier=NETWORK_TIER Specifies the network tier that will be used to configure the instance. - NETWORK_TIER must be one of: PREMIUM, STANDARD, FIXED_STANDARD. The - default value is PREMIUM. + NETWORK_TIER must be one of: PREMIUM, STANDARD. The default value is + PREMIUM. --preemptible If provided, instances will be preemptible and time-limited. Instances diff --git a/gcloud/compute/instances/import b/gcloud/compute/instances/import index 8453632b5..668d9c656 100644 --- a/gcloud/compute/instances/import +++ b/gcloud/compute/instances/import @@ -183,8 +183,8 @@ OPTIONAL FLAGS --network-tier=NETWORK_TIER Specifies the network tier that will be used to configure the instance. - NETWORK_TIER must be one of: PREMIUM, STANDARD, FIXED_STANDARD. The - default value is PREMIUM. + NETWORK_TIER must be one of: PREMIUM, STANDARD. The default value is + PREMIUM. --os=OS Specifies the OS of the image being imported. OS must be one of: diff --git a/gcloud/compute/project-info/update b/gcloud/compute/project-info/update index 98f1e32f5..62052518e 100644 --- a/gcloud/compute/project-info/update +++ b/gcloud/compute/project-info/update @@ -17,7 +17,7 @@ FLAGS --default-network-tier=DEFAULT_NETWORK_TIER The default network tier to assign to the project. DEFAULT_NETWORK_TIER - must be one of: PREMIUM, STANDARD, FIXED_STANDARD. + must be one of: PREMIUM, STANDARD. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/container/clusters/create b/gcloud/container/clusters/create index d58a092d5..c76196d14 100644 --- a/gcloud/container/clusters/create +++ b/gcloud/container/clusters/create @@ -741,7 +741,7 @@ FLAGS The maximum number of nodes to allocate per default initial node pool. Kubernetes Engine will automatically create enough nodes pools such that each node pool contains less than --max-nodes-per-pool nodes. - Defaults to 2000 nodes, but can be set as low as 100 nodes per pool on + Defaults to 1000 nodes, but can be set as low as 100 nodes per pool on initial create. --max-pods-per-node=MAX_PODS_PER_NODE @@ -879,7 +879,8 @@ FLAGS New nodes, including ones created by resize or recreate, will have these labels on the Kubernetes API node object and can be used in - nodeSelectors. See http://kubernetes.io/docs/user-guide/node-selection/ + nodeSelectors. See + https://kubernetes.io/docs/concepts/scheduling-eviction/assign-pod-node/ for examples. Note that Kubernetes labels, intended to associate cluster components @@ -1048,6 +1049,11 @@ FLAGS considered GA quality. 'regular' is intended for production users who want to take advantage of new features. + extended + + Clusters subscribed to 'extended' can remain on a minor version for 24 months + from when the minor version is made available in the Regular channel. + stable Clusters subscribed to 'stable' receive versions that are known to @@ -1057,7 +1063,7 @@ FLAGS Use 'None' to opt-out of any release channel. - CHANNEL must be one of: rapid, regular, stable, None. + CHANNEL must be one of: rapid, regular, extended, stable, None. --resource-manager-tags=[KEY=VALUE,...] Applies the specified comma-separated resource manager tags that has diff --git a/gcloud/container/clusters/create-auto b/gcloud/container/clusters/create-auto index 4e6e415b3..ef0138b10 100644 --- a/gcloud/container/clusters/create-auto +++ b/gcloud/container/clusters/create-auto @@ -347,12 +347,17 @@ FLAGS considered GA quality. 'regular' is intended for production users who want to take advantage of new features. + extended + + Clusters subscribed to 'extended' can remain on a minor version for 24 months + from when the minor version is made available in the Regular channel. + 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. + CHANNEL must be one of: rapid, regular, extended, stable. --security-group=SECURITY_GROUP The name of the RBAC security group for use with Google security groups diff --git a/gcloud/container/clusters/update b/gcloud/container/clusters/update index 4abf9ce23..f9ae65cc9 100644 --- a/gcloud/container/clusters/update +++ b/gcloud/container/clusters/update @@ -581,6 +581,11 @@ REQUIRED FLAGS considered GA quality. 'regular' is intended for production users who want to take advantage of new features. + extended + + Clusters subscribed to 'extended' can remain on a minor version for 24 months + from when the minor version is made available in the Regular channel. + stable Clusters subscribed to 'stable' receive versions that are known to @@ -590,7 +595,7 @@ REQUIRED FLAGS Use 'None' to opt-out of any release channel. - CHANNEL must be one of: rapid, regular, stable, None. + CHANNEL must be one of: rapid, regular, extended, stable, None. --remove-labels=[KEY,...] Labels to remove from the Google Cloud resources in use by the diff --git a/gcloud/container/node-pools/create b/gcloud/container/node-pools/create index b8eee14a6..d70810996 100644 --- a/gcloud/container/node-pools/create +++ b/gcloud/container/node-pools/create @@ -466,7 +466,8 @@ FLAGS New nodes, including ones created by resize or recreate, will have these labels on the Kubernetes API node object and can be used in - nodeSelectors. See http://kubernetes.io/docs/user-guide/node-selection/ + nodeSelectors. See + https://kubernetes.io/docs/concepts/scheduling-eviction/assign-pod-node/ for examples. Note that Kubernetes labels, intended to associate cluster components diff --git a/gcloud/container/node-pools/update b/gcloud/container/node-pools/update index 3f856b12e..6e5a86424 100644 --- a/gcloud/container/node-pools/update +++ b/gcloud/container/node-pools/update @@ -142,7 +142,8 @@ REQUIRED FLAGS New nodes, including ones created by resize or recreate, will have these labels on the Kubernetes API node object and can be used in nodeSelectors. See - http://kubernetes.io/docs/user-guide/node-selection/ for examples. + https://kubernetes.io/docs/concepts/scheduling-eviction/assign-pod-node/ + for examples. Note that Kubernetes labels, intended to associate cluster components and resources with one another and manage resource lifecycles, are diff --git a/gcloud/deploy/apply b/gcloud/deploy/apply index 00283a1df..333c02deb 100644 --- a/gcloud/deploy/apply +++ b/gcloud/deploy/apply @@ -1,14 +1,15 @@ NAME gcloud deploy apply - applies a yaml configuration containing Delivery - Pipeline(s), Target(s), Custom Target Type(s), and Automation(s) - declarative definitions + Pipeline(s), Target(s), Custom Target Type(s), Deploy Policy(ies), and + Automation(s) declarative definitions SYNOPSIS gcloud deploy apply --file=FILE [--region=REGION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION Applies a yaml configuration containing Delivery Pipeline(s), Target(s), - Custom Target Type(s), and Automation(s) declarative definitions. + Custom Target Type(s), Deploy Policy(ies), and Automation(s) declarative + definitions. EXAMPLES To apply a Cloud Deploy YAML file deploy.yaml: diff --git a/gcloud/deploy/deploy-policies/delete b/gcloud/deploy/deploy-policies/delete new file mode 100644 index 000000000..c3f8d52eb --- /dev/null +++ b/gcloud/deploy/deploy-policies/delete @@ -0,0 +1,74 @@ +NAME + gcloud deploy deploy-policies delete - delete a deploy policy + +SYNOPSIS + gcloud deploy deploy-policies delete (DEPLOY_POLICY : --region=REGION) + [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete a deploy policy for a specified region. + +EXAMPLES + The following command will delete deploy policy test-policy, in region + us-central1: + + $ gcloud deploy deploy-policies delete test-policy \ + --region=us-central1 + +POSITIONAL ARGUMENTS + Deploy policy resource - The name of the deploy policy to delete. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument deploy_policy on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + DEPLOY_POLICY + ID of the deploy policy or fully qualified identifier for the deploy + policy. + + To set the deploy_policy attribute: + ▸ provide the argument deploy_policy on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Location of the deploy policy. + + To set the region attribute: + ▸ provide the argument deploy_policy on the command line with a + fully specified name; + ▸ provide the argument --region on the command line; + ▸ set the property deploy/region. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the clouddeploy/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/deploy/ + +NOTES + These variants are also available: + + $ gcloud alpha deploy deploy-policies delete + + $ gcloud beta deploy deploy-policies delete + diff --git a/gcloud/deploy/deploy-policies/describe b/gcloud/deploy/deploy-policies/describe new file mode 100644 index 000000000..b769642f2 --- /dev/null +++ b/gcloud/deploy/deploy-policies/describe @@ -0,0 +1,67 @@ +NAME + gcloud deploy deploy-policies describe - show details for a deploy policy + +SYNOPSIS + gcloud deploy deploy-policies describe (DEPLOY_POLICY : --region=REGION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Show details for a specified deploy policy. + +EXAMPLES + To show details about a deploy policy test-policy in region us-central, + run: $ gcloud deploy deploy-policies describe test-policy \ + --region=us-central1 + +POSITIONAL ARGUMENTS + Deploy policy resource - The name of the deploy policy to describe. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument deploy_policy on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + DEPLOY_POLICY + ID of the deploy policy or fully qualified identifier for the deploy + policy. + + To set the deploy_policy attribute: + ▸ provide the argument deploy_policy on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Location of the deploy policy. + + To set the region attribute: + ▸ provide the argument deploy_policy on the command line with a + fully specified name; + ▸ provide the argument --region on the command line; + ▸ set the property deploy/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 clouddeploy/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/deploy/ + +NOTES + These variants are also available: + + $ gcloud alpha deploy deploy-policies describe + + $ gcloud beta deploy deploy-policies describe + diff --git a/gcloud/deploy/deploy-policies/export b/gcloud/deploy/deploy-policies/export new file mode 100644 index 000000000..8bbd17ef3 --- /dev/null +++ b/gcloud/deploy/deploy-policies/export @@ -0,0 +1,72 @@ +NAME + gcloud deploy deploy-policies export - returns the .yaml definition of the + specified deploy policy + +SYNOPSIS + gcloud deploy deploy-policies export (DEPLOY_POLICY : --region=REGION) + [--destination=DESTINATION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + The exported yaml definition can be applied by deploy apply command. + +EXAMPLES + To return the .yaml definition of the deploy policy test-policy, in region + us-central1, run: + + $ gcloud deploy deploy-policies export test-policy \ + --region=us-central1 + +POSITIONAL ARGUMENTS + Deploy policy resource - The name of the Deploy Policy. 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 deploy_policy on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + DEPLOY_POLICY + ID of the deploy_policy or fully qualified identifier for the + deploy_policy. + + To set the deploy_policy attribute: + ▸ provide the argument deploy_policy on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + The Cloud region for the deploy_policy. Alternatively, set the + property [deploy/region]. + + To set the region attribute: + ▸ provide the argument deploy_policy on the command line with a + fully specified name; + ▸ provide the argument --region on the command line; + ▸ set the property deploy/region. + +FLAGS + --destination=DESTINATION + Path to a YAML file where the configuration will be exported. + Alternatively, you may omit this flag to write to standard output. + +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 deploy deploy-policies export + + $ gcloud beta deploy deploy-policies export + diff --git a/gcloud/deploy/deploy-policies/help b/gcloud/deploy/deploy-policies/help new file mode 100644 index 000000000..bcba28d4a --- /dev/null +++ b/gcloud/deploy/deploy-policies/help @@ -0,0 +1,34 @@ +NAME + gcloud deploy deploy-policies - create and manage Deploy Policy resources + for Google Cloud Deploy + +SYNOPSIS + gcloud deploy deploy-policies COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create and manage Deploy Policy resources for Google Cloud Deploy. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + delete + Delete a deploy policy. + + describe + Show details for a deploy policy. + + export + Returns the .yaml definition of the specified deploy policy. + +NOTES + These variants are also available: + + $ gcloud alpha deploy deploy-policies + + $ gcloud beta deploy deploy-policies + diff --git a/gcloud/deploy/help b/gcloud/deploy/help index 222e01811..471d95ae0 100644 --- a/gcloud/deploy/help +++ b/gcloud/deploy/help @@ -27,6 +27,9 @@ GROUPS delivery-pipelines Create and manage Delivery Pipeline resources for Cloud Deploy. + deploy-policies + Create and manage Deploy Policy resources for Google Cloud Deploy. + job-runs Manages job runs resources for Cloud Deploy. @@ -44,8 +47,8 @@ COMMANDS apply Applies a yaml configuration containing Delivery Pipeline(s), - Target(s), Custom Target Type(s), and Automation(s) declarative - definitions. + Target(s), Custom Target Type(s), Deploy Policy(ies), and Automation(s) + declarative definitions. delete Deletes Delivery Pipeline(s), Target(s), Custom Target Type(s), and diff --git a/gcloud/functions/deploy b/gcloud/functions/deploy index ce4a7b2c3..bb22e92d0 100644 --- a/gcloud/functions/deploy +++ b/gcloud/functions/deploy @@ -584,9 +584,9 @@ FLAGS Allowed values for GCF 2nd gen are in the format: with allowed units of "k", "M", "G", "Ki", "Mi", "Gi". Ending 'b' or 'B' is - allowed. + allowed, but both are interpreted as bytes as opposed to bits. - Examples: 100000k, 128M, 10Mb, 1024Mi, 750K, 4Gi. + Examples: 1000000K, 1000000Ki, 256Mb, 512M, 1024Mi, 2G, 4Gi. By default, a new function is limited to 256MB of memory. When deploying an update to an existing function, the function keeps its old diff --git a/gcloud/network-connectivity/locations/describe b/gcloud/network-connectivity/locations/describe index 1f5efbcad..f3348b8a3 100644 --- a/gcloud/network-connectivity/locations/describe +++ b/gcloud/network-connectivity/locations/describe @@ -45,3 +45,9 @@ API REFERENCE This command uses the networkconnectivity/v1 API. The full documentation for this API can be found at: https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This variant is also available: + + $ gcloud beta network-connectivity locations describe + diff --git a/gcloud/network-connectivity/locations/help b/gcloud/network-connectivity/locations/help index e054acf16..21329825d 100644 --- a/gcloud/network-connectivity/locations/help +++ b/gcloud/network-connectivity/locations/help @@ -21,3 +21,9 @@ COMMANDS list List Network Connectivity Center locations. + +NOTES + This variant is also available: + + $ gcloud beta network-connectivity locations + diff --git a/gcloud/network-connectivity/locations/list b/gcloud/network-connectivity/locations/list index f26e31c91..32c1c0061 100644 --- a/gcloud/network-connectivity/locations/list +++ b/gcloud/network-connectivity/locations/list @@ -67,3 +67,9 @@ API REFERENCE This command uses the networkconnectivity/v1 API. The full documentation for this API can be found at: https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This variant is also available: + + $ gcloud beta network-connectivity locations list + diff --git a/gcloud/network-connectivity/operations/describe b/gcloud/network-connectivity/operations/describe index 5879361ee..c9820350d 100644 --- a/gcloud/network-connectivity/operations/describe +++ b/gcloud/network-connectivity/operations/describe @@ -59,3 +59,9 @@ API REFERENCE This command uses the networkconnectivity/v1 API. The full documentation for this API can be found at: https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This variant is also available: + + $ gcloud beta network-connectivity operations describe + diff --git a/gcloud/network-connectivity/operations/help b/gcloud/network-connectivity/operations/help index 8ba996495..4199595b7 100644 --- a/gcloud/network-connectivity/operations/help +++ b/gcloud/network-connectivity/operations/help @@ -21,3 +21,9 @@ COMMANDS list List Network Connectivity Center operations. + +NOTES + This variant is also available: + + $ gcloud beta network-connectivity operations + diff --git a/gcloud/network-connectivity/operations/list b/gcloud/network-connectivity/operations/list index adb4b4785..60840aae9 100644 --- a/gcloud/network-connectivity/operations/list +++ b/gcloud/network-connectivity/operations/list @@ -81,3 +81,9 @@ API REFERENCE This command uses the networkconnectivity/v1 API. The full documentation for this API can be found at: https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This variant is also available: + + $ gcloud beta network-connectivity operations list + diff --git a/gcloud/network-connectivity/spokes/help b/gcloud/network-connectivity/spokes/help index bb357d652..697765bbb 100644 --- a/gcloud/network-connectivity/spokes/help +++ b/gcloud/network-connectivity/spokes/help @@ -41,7 +41,9 @@ COMMANDS List spokes. NOTES - This variant is also available: + These variants are also available: $ gcloud alpha network-connectivity spokes + $ gcloud beta network-connectivity spokes + diff --git a/gcloud/network-connectivity/spokes/linked-interconnect-attachments/create b/gcloud/network-connectivity/spokes/linked-interconnect-attachments/create index 72fa72d98..20528635b 100644 --- a/gcloud/network-connectivity/spokes/linked-interconnect-attachments/create +++ b/gcloud/network-connectivity/spokes/linked-interconnect-attachments/create @@ -106,3 +106,10 @@ API REFERENCE This command uses the networkconnectivity/v1 API. The full documentation for this API can be found at: https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This variant is also available: + + $ gcloud beta network-connectivity spokes \ + linked-interconnect-attachments create + diff --git a/gcloud/network-connectivity/spokes/linked-interconnect-attachments/help b/gcloud/network-connectivity/spokes/linked-interconnect-attachments/help index 1c9891324..a58c60b47 100644 --- a/gcloud/network-connectivity/spokes/linked-interconnect-attachments/help +++ b/gcloud/network-connectivity/spokes/linked-interconnect-attachments/help @@ -22,3 +22,10 @@ COMMANDS update Update a VLAN attachment spoke. + +NOTES + This variant is also available: + + $ gcloud beta network-connectivity spokes \ + linked-interconnect-attachments + diff --git a/gcloud/network-connectivity/spokes/linked-interconnect-attachments/update b/gcloud/network-connectivity/spokes/linked-interconnect-attachments/update index d1a40c3dc..4e799fcf7 100644 --- a/gcloud/network-connectivity/spokes/linked-interconnect-attachments/update +++ b/gcloud/network-connectivity/spokes/linked-interconnect-attachments/update @@ -5,6 +5,7 @@ NAME SYNOPSIS gcloud network-connectivity spokes linked-interconnect-attachments update (SPOKE : --region=REGION) [--async] [--description=DESCRIPTION] + [--include-import-ranges=[INCLUDE_IMPORT_RANGES,...]] [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] @@ -57,6 +58,11 @@ FLAGS --description=DESCRIPTION New description of the spoke. + --include-import-ranges=[INCLUDE_IMPORT_RANGES,...] + IP address range(s) allowed to be imported from hub subnets. Only + ``ALL_IPV4_RANGES`` can be added to the list. If it's empty, the spoke + does not import any subnets from the hub. + --update-labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to update. If a label exists, its value is modified. Otherwise, a new label is created. @@ -100,3 +106,10 @@ API REFERENCE This command uses the networkconnectivity/v1 API. The full documentation for this API can be found at: https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This variant is also available: + + $ gcloud beta network-connectivity spokes \ + linked-interconnect-attachments update + diff --git a/gcloud/network-connectivity/spokes/linked-router-appliances/create b/gcloud/network-connectivity/spokes/linked-router-appliances/create index 4f44ccdde..bb18548c9 100644 --- a/gcloud/network-connectivity/spokes/linked-router-appliances/create +++ b/gcloud/network-connectivity/spokes/linked-router-appliances/create @@ -113,3 +113,10 @@ API REFERENCE This command uses the networkconnectivity/v1 API. The full documentation for this API can be found at: https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This variant is also available: + + $ gcloud beta network-connectivity spokes linked-router-appliances \ + create + diff --git a/gcloud/network-connectivity/spokes/linked-router-appliances/help b/gcloud/network-connectivity/spokes/linked-router-appliances/help index e2dad50f6..ea985b07c 100644 --- a/gcloud/network-connectivity/spokes/linked-router-appliances/help +++ b/gcloud/network-connectivity/spokes/linked-router-appliances/help @@ -22,3 +22,9 @@ COMMANDS update Update a Router appliance spoke. + +NOTES + This variant is also available: + + $ gcloud beta network-connectivity spokes linked-router-appliances + diff --git a/gcloud/network-connectivity/spokes/linked-router-appliances/update b/gcloud/network-connectivity/spokes/linked-router-appliances/update index c6733a1c9..982e80eab 100644 --- a/gcloud/network-connectivity/spokes/linked-router-appliances/update +++ b/gcloud/network-connectivity/spokes/linked-router-appliances/update @@ -5,6 +5,7 @@ NAME SYNOPSIS gcloud network-connectivity spokes linked-router-appliances update (SPOKE : --region=REGION) [--async] [--description=DESCRIPTION] + [--include-import-ranges=[INCLUDE_IMPORT_RANGES,...]] [--router-appliance=[instance=INSTANCE],[ip=IP]] [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] @@ -70,6 +71,11 @@ FLAGS --description=DESCRIPTION New description of the spoke. + --include-import-ranges=[INCLUDE_IMPORT_RANGES,...] + IP address range(s) allowed to be imported from hub subnets. Only + ``ALL_IPV4_RANGES`` can be added to the list. If it's empty, the spoke + does not import any subnets from the hub. + --router-appliance=[instance=INSTANCE],[ip=IP] Router appliance instance(s) with which to replace the set of instances already linked to this spoke. Pass this flag multiple times to replace @@ -122,3 +128,10 @@ API REFERENCE This command uses the networkconnectivity/v1 API. The full documentation for this API can be found at: https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This variant is also available: + + $ gcloud beta network-connectivity spokes linked-router-appliances \ + update + diff --git a/gcloud/network-connectivity/spokes/linked-vpn-tunnels/create b/gcloud/network-connectivity/spokes/linked-vpn-tunnels/create index 81175f99a..f932aaace 100644 --- a/gcloud/network-connectivity/spokes/linked-vpn-tunnels/create +++ b/gcloud/network-connectivity/spokes/linked-vpn-tunnels/create @@ -104,3 +104,9 @@ API REFERENCE This command uses the networkconnectivity/v1 API. The full documentation for this API can be found at: https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This variant is also available: + + $ gcloud beta network-connectivity spokes linked-vpn-tunnels create + diff --git a/gcloud/network-connectivity/spokes/linked-vpn-tunnels/help b/gcloud/network-connectivity/spokes/linked-vpn-tunnels/help index 034cc2c68..228f0bc85 100644 --- a/gcloud/network-connectivity/spokes/linked-vpn-tunnels/help +++ b/gcloud/network-connectivity/spokes/linked-vpn-tunnels/help @@ -21,3 +21,9 @@ COMMANDS update Update a VPN spoke. + +NOTES + This variant is also available: + + $ gcloud beta network-connectivity spokes linked-vpn-tunnels + diff --git a/gcloud/network-connectivity/spokes/linked-vpn-tunnels/update b/gcloud/network-connectivity/spokes/linked-vpn-tunnels/update index 8387ee679..9bc1198cf 100644 --- a/gcloud/network-connectivity/spokes/linked-vpn-tunnels/update +++ b/gcloud/network-connectivity/spokes/linked-vpn-tunnels/update @@ -5,6 +5,7 @@ NAME SYNOPSIS gcloud network-connectivity spokes linked-vpn-tunnels update (SPOKE : --region=REGION) [--async] [--description=DESCRIPTION] + [--include-import-ranges=[INCLUDE_IMPORT_RANGES,...]] [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] @@ -57,6 +58,11 @@ FLAGS --description=DESCRIPTION New description of the spoke. + --include-import-ranges=[INCLUDE_IMPORT_RANGES,...] + IP address range(s) allowed to be imported from hub subnets. Only + ``ALL_IPV4_RANGES`` can be added to the list. If it's empty, the spoke + does not import any subnets from the hub. + --update-labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to update. If a label exists, its value is modified. Otherwise, a new label is created. @@ -99,3 +105,9 @@ API REFERENCE This command uses the networkconnectivity/v1 API. The full documentation for this API can be found at: https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This variant is also available: + + $ gcloud beta network-connectivity spokes linked-vpn-tunnels update + diff --git a/gcloud/network-services/service-lb-policies/create b/gcloud/network-services/service-lb-policies/create index 1f3158617..ac7356bb2 100644 --- a/gcloud/network-services/service-lb-policies/create +++ b/gcloud/network-services/service-lb-policies/create @@ -74,8 +74,8 @@ FLAGS traffic to failover backends. If the percentage of endpoints in a MIG/NEG is smaller than this value, traffic would be sent to failover backends if possible. This field should be set to a value between 1 and - 99. The default value is 50 for Global external HTTP(S) load balancer - (classic) and Proxyless service mesh, and 70 for others. + 99. The default value is 50 for Proxyless service mesh, and 70 for + others. --load-balancing-algorithm=LOAD_BALANCING_ALGORITHM; default="waterfall-by-region" The global load balancing algorithm to be used. diff --git a/gcloud/network-services/service-lb-policies/update b/gcloud/network-services/service-lb-policies/update index 1ddd825d7..132420fff 100644 --- a/gcloud/network-services/service-lb-policies/update +++ b/gcloud/network-services/service-lb-policies/update @@ -73,8 +73,8 @@ FLAGS traffic to failover backends. If the percentage of endpoints in a MIG/NEG is smaller than this value, traffic would be sent to failover backends if possible. This field should be set to a value between 1 and - 99. The default value is 50 for Global external HTTP(S) load balancer - (classic) and Proxyless service mesh, and 70 for others. + 99. The default value is 50 for Proxyless service mesh, and 70 for + others. --load-balancing-algorithm=LOAD_BALANCING_ALGORITHM; default="waterfall-by-region" The global load balancing algorithm to be used. diff --git a/gcloud/vmware/private-clouds/clusters/update b/gcloud/vmware/private-clouds/clusters/update index f6a0a65f3..f54152498 100644 --- a/gcloud/vmware/private-clouds/clusters/update +++ b/gcloud/vmware/private-clouds/clusters/update @@ -6,8 +6,21 @@ SYNOPSIS gcloud vmware private-clouds clusters update (CLUSTER : --location=LOCATION --private-cloud=PRIVATE_CLOUD) [--async] [--node-type-config=[[count=COUNT],[type=TYPE],...]] - [--remove-nodes-config=TYPE] + [--remove-autoscaling-policy=NAME] [--remove-nodes-config=TYPE] [--update-nodes-config=[count=COUNT],[type=TYPE]] + [--autoscaling-settings-from-file=AUTOSCALING_SETTINGS_FROM_FILE + | --autoscaling-cool-down-period=AUTOSCALING_COOL_DOWN_PERIOD + --autoscaling-max-cluster-node-count=AUTOSCALING_MAX_CLUSTER_NODE_COUNT --autoscaling-min-cluster-node-count=AUTOSCALING_MIN_CLUSTER_NODE_COUNT --update-autoscaling-policy=[consumed-memory-thresholds-scale-in=CONSUMED-MEMORY-THRESHOLDS-SCALE-IN], + [consumed-memory-thresholds-scale-out=CONSUMED-MEMORY-THRESHOLDS-SCALE-OUT], + [cpu-thresholds-scale-in=CPU-THRESHOLDS-SCALE-IN], + [cpu-thresholds-scale-out=CPU-THRESHOLDS-SCALE-OUT], + [granted-memory-thresholds-scale-in=GRANTED-MEMORY-THRESHOLDS-SCALE-IN], + [granted-memory-thresholds-scale-out=GRANTED-MEMORY-THRESHOLDS-SCALE-OUT], + [max-node-count=MAX-NODE-COUNT],[min-node-count=MIN-NODE-COUNT], + [name=NAME],[node-type-id=NODE-TYPE-ID], + [scale-out-size=SCALE-OUT-SIZE], + [storage-thresholds-scale-in=STORAGE-THRESHOLDS-SCALE-IN], + [storage-thresholds-scale-out=STORAGE-THRESHOLDS-SCALE-OUT]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -32,6 +45,18 @@ EXAMPLES In the second example, the project and location are taken from gcloud properties core/project and compute/zone. + To enable autoscale in a cluster called my-cluster in private cloud + my-private-cloud and zone us-west2-a, run: + + $ gcloud vmware private-clouds clusters update my-cluster \ + --location=us-west2-a --project=my-project \ + --private-cloud=my-private-cloud \ + --autoscaling-min-cluster-node-count=3 \ + --autoscaling-max-cluster-node-count=5 \ + --update-autoscaling-policy=name=custom-policy,\ + node-type-id=standard-72,scale-out-size=1,\ + storage-thresholds-scale-in=10,storage-thresholds-scale-out=80 + POSITIONAL ARGUMENTS Cluster resource - cluster. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some attributes are not @@ -90,6 +115,9 @@ FLAGS The --node-type-config option is deprecated; please use --update-nodes-config and --remove-nodes-config instead. + --remove-autoscaling-policy=NAME + Names of autoscaling policies that should be removed from the cluster + --remove-nodes-config=TYPE Type of node that should be removed from the cluster @@ -101,6 +129,25 @@ FLAGS count (required): number of nodes of this type in the cluster. + At most one of these can be specified: + + --autoscaling-settings-from-file=AUTOSCALING_SETTINGS_FROM_FILE + A YAML file containing the autoscaling settings to be applied to the + cluster + + --autoscaling-cool-down-period=AUTOSCALING_COOL_DOWN_PERIOD + Cool down period (in minutes) between consecutive cluster + expansions/contractions + + --autoscaling-max-cluster-node-count=AUTOSCALING_MAX_CLUSTER_NODE_COUNT + Maximum number of nodes in the cluster + + --autoscaling-min-cluster-node-count=AUTOSCALING_MIN_CLUSTER_NODE_COUNT + Minimum number of nodes in the cluster + + --update-autoscaling-policy=[consumed-memory-thresholds-scale-in=CONSUMED-MEMORY-THRESHOLDS-SCALE-IN],[consumed-memory-thresholds-scale-out=CONSUMED-MEMORY-THRESHOLDS-SCALE-OUT],[cpu-thresholds-scale-in=CPU-THRESHOLDS-SCALE-IN],[cpu-thresholds-scale-out=CPU-THRESHOLDS-SCALE-OUT],[granted-memory-thresholds-scale-in=GRANTED-MEMORY-THRESHOLDS-SCALE-IN],[granted-memory-thresholds-scale-out=GRANTED-MEMORY-THRESHOLDS-SCALE-OUT],[max-node-count=MAX-NODE-COUNT],[min-node-count=MIN-NODE-COUNT],[name=NAME],[node-type-id=NODE-TYPE-ID],[scale-out-size=SCALE-OUT-SIZE],[storage-thresholds-scale-in=STORAGE-THRESHOLDS-SCALE-IN],[storage-thresholds-scale-out=STORAGE-THRESHOLDS-SCALE-OUT] + Autoscaling policy to be applied to the cluster + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format,