From dc0d916cee29b467c8b5a0a2718e5ef4aed8d7b5 Mon Sep 17 00:00:00 2001 From: Automated Date: Thu, 22 Jun 2023 10:31:35 +0000 Subject: [PATCH] gcloud: Thu Jun 22 10:31:35 UTC 2023 --- gcloud/_version | 8 +- gcloud/alloydb/instances/help | 3 + gcloud/alloydb/instances/inject-fault | 56 ++++ gcloud/alpha/alloydb/instances/inject-fault | 6 +- .../client-connector/gateways/create | 94 ------ .../client-connector/gateways/delete | 75 ----- .../client-connector/gateways/describe | 70 ----- .../client-connector/gateways/get-iam-policy | 98 ------- .../beyondcorp/client-connector/gateways/help | 50 ---- .../client-connector/gateways/set-iam-policy | 78 ----- gcloud/alpha/beyondcorp/client-connector/help | 46 --- .../client-connector/operations/describe | 71 ----- .../client-connector/operations/help | 33 --- .../client-connector/services/create | 143 ---------- .../client-connector/services/delete | 77 ----- .../client-connector/services/describe | 71 ----- .../client-connector/services/get-iam-policy | 100 ------- .../beyondcorp/client-connector/services/help | 55 ---- .../client-connector/services/set-iam-policy | 81 ------ .../client-connector/services/update | 127 -------- gcloud/alpha/beyondcorp/help | 3 - gcloud/alpha/compute/commitments/create | 7 +- gcloud/alpha/compute/disks/bulk/create | 4 +- gcloud/alpha/compute/disks/bulk/help | 4 +- .../compute/disks/start-async-replication | 4 +- .../compute/disks/stop-async-replication | 4 +- .../disks/stop-group-async-replication | 4 +- .../create/disk-consistency-group | 4 +- .../compute/security-policies/rules/create | 2 +- .../compute/security-policies/rules/update | 2 +- gcloud/alpha/compute/snapshots/create | 7 +- gcloud/alpha/compute/vpn-gateways/create | 2 + gcloud/alpha/container/clusters/create | 45 ++- gcloud/alpha/container/clusters/create-auto | 40 ++- gcloud/alpha/container/clusters/update | 51 +++- gcloud/alpha/container/node-pools/create | 44 ++- gcloud/alpha/container/node-pools/update | 2 +- gcloud/alpha/dataplex/datascan/create | 27 +- gcloud/alpha/dataplex/tasks/help | 3 + gcloud/alpha/dataplex/tasks/run | 90 ++++++ gcloud/alpha/dataproc/clusters/help | 2 +- gcloud/alpha/deploy/job-runs/terminate | 4 +- gcloud/alpha/deploy/releases/create | 14 +- gcloud/alpha/deploy/rollouts/advance | 4 +- gcloud/alpha/deploy/rollouts/cancel | 4 +- gcloud/alpha/deploy/rollouts/ignore-job | 4 +- .../firewall-endpoint-associations/create | 44 ++- gcloud/alpha/services/identity/create | 36 ++- gcloud/alpha/spanner/databases/help | 3 + gcloud/alpha/spanner/databases/update | 83 ++++++ gcloud/alpha/sql/instances/clone | 7 +- .../sql/instances/get-latest-recovery-time | 43 +++ gcloud/alpha/sql/instances/help | 4 + gcloud/alpha/storage/help | 4 + gcloud/alpha/storage/sign-url | 115 ++++++++ gcloud/alpha/workstations/clusters/create | 4 +- gcloud/alpha/workstations/clusters/delete | 4 +- gcloud/alpha/workstations/clusters/describe | 4 +- gcloud/alpha/workstations/clusters/help | 4 +- gcloud/alpha/workstations/clusters/list | 4 +- gcloud/alpha/workstations/configs/create | 4 +- gcloud/alpha/workstations/configs/delete | 4 +- gcloud/alpha/workstations/configs/describe | 4 +- .../alpha/workstations/configs/get-iam-policy | 4 +- gcloud/alpha/workstations/configs/help | 4 +- gcloud/alpha/workstations/configs/list | 4 +- .../alpha/workstations/configs/set-iam-policy | 4 +- gcloud/alpha/workstations/configs/update | 4 +- gcloud/alpha/workstations/create | 4 +- gcloud/alpha/workstations/delete | 4 +- gcloud/alpha/workstations/describe | 4 +- gcloud/alpha/workstations/get-iam-policy | 4 +- gcloud/alpha/workstations/help | 4 +- gcloud/alpha/workstations/list | 4 +- gcloud/alpha/workstations/list-usable | 4 +- gcloud/alpha/workstations/set-iam-policy | 4 +- gcloud/alpha/workstations/ssh | 4 +- gcloud/alpha/workstations/start | 4 +- gcloud/alpha/workstations/start-tcp-tunnel | 4 +- gcloud/alpha/workstations/stop | 4 +- gcloud/artifacts/repositories/create | 10 +- gcloud/batch/jobs/submit | 9 +- gcloud/beta/alloydb/instances/help | 3 + gcloud/beta/alloydb/instances/inject-fault | 57 ++++ gcloud/beta/batch/jobs/submit | 9 +- .../client-connector/gateways/create | 5 +- .../client-connector/gateways/delete | 5 +- .../client-connector/gateways/describe | 5 +- .../client-connector/gateways/get-iam-policy | 5 +- .../beyondcorp/client-connector/gateways/help | 5 +- .../beyondcorp/client-connector/gateways/list | 5 +- .../client-connector/gateways/set-iam-policy | 5 +- gcloud/beta/beyondcorp/client-connector/help | 5 +- .../client-connector/operations/describe | 5 +- .../client-connector/operations/help | 5 +- .../client-connector/operations/list | 5 +- .../client-connector/services/create | 5 +- .../client-connector/services/delete | 5 +- .../client-connector/services/describe | 5 +- .../client-connector/services/get-iam-policy | 5 +- .../beyondcorp/client-connector/services/help | 5 +- .../beyondcorp/client-connector/services/list | 5 +- .../client-connector/services/set-iam-policy | 5 +- .../client-connector/services/update | 5 +- gcloud/beta/compute/disks/bulk/create | 6 +- gcloud/beta/compute/disks/bulk/help | 6 +- .../compute/disks/start-async-replication | 6 +- .../beta/compute/disks/stop-async-replication | 6 +- .../disks/stop-group-async-replication | 6 +- gcloud/beta/compute/instances/create | 42 +++ .../create/disk-consistency-group | 6 +- .../compute/security-policies/rules/create | 4 +- .../compute/security-policies/rules/update | 4 +- gcloud/beta/compute/snapshots/create | 7 +- gcloud/beta/container/clusters/create | 45 ++- gcloud/beta/container/clusters/create-auto | 40 ++- gcloud/beta/container/clusters/update | 53 +++- gcloud/beta/container/node-pools/create | 44 ++- gcloud/beta/container/node-pools/update | 2 +- gcloud/beta/dataflow/flex-template/build | 8 +- gcloud/beta/dataproc/clusters/help | 2 +- gcloud/beta/deploy/job-runs/terminate | 6 +- gcloud/beta/deploy/releases/create | 14 +- gcloud/beta/deploy/rollouts/advance | 6 +- gcloud/beta/deploy/rollouts/cancel | 6 +- gcloud/beta/deploy/rollouts/ignore-job | 6 +- gcloud/beta/netapp/volumes/replications/stop | 11 +- gcloud/beta/services/identity/create | 36 ++- gcloud/beta/spanner/databases/help | 3 + gcloud/beta/spanner/databases/update | 81 ++++++ gcloud/beta/sql/instances/clone | 7 +- .../sql/instances/get-latest-recovery-time | 41 +++ gcloud/beta/sql/instances/help | 4 + gcloud/beta/workstations/clusters/create | 6 +- gcloud/beta/workstations/clusters/delete | 6 +- gcloud/beta/workstations/clusters/describe | 6 +- gcloud/beta/workstations/clusters/help | 6 +- gcloud/beta/workstations/clusters/list | 6 +- gcloud/beta/workstations/configs/create | 6 +- gcloud/beta/workstations/configs/delete | 6 +- gcloud/beta/workstations/configs/describe | 6 +- .../beta/workstations/configs/get-iam-policy | 6 +- gcloud/beta/workstations/configs/help | 6 +- gcloud/beta/workstations/configs/list | 6 +- .../beta/workstations/configs/set-iam-policy | 6 +- gcloud/beta/workstations/configs/update | 6 +- gcloud/beta/workstations/create | 6 +- gcloud/beta/workstations/delete | 6 +- gcloud/beta/workstations/describe | 6 +- gcloud/beta/workstations/get-iam-policy | 6 +- gcloud/beta/workstations/help | 6 +- gcloud/beta/workstations/list | 6 +- gcloud/beta/workstations/list-usable | 6 +- gcloud/beta/workstations/set-iam-policy | 6 +- gcloud/beta/workstations/ssh | 6 +- gcloud/beta/workstations/start | 6 +- gcloud/beta/workstations/start-tcp-tunnel | 6 +- gcloud/beta/workstations/stop | 6 +- gcloud/compute/disks/bulk/create | 88 ++++++ gcloud/compute/disks/bulk/help | 28 ++ gcloud/compute/disks/create | 29 +- gcloud/compute/disks/help | 18 +- gcloud/compute/disks/start-async-replication | 107 +++++++ gcloud/compute/disks/stop-async-replication | 87 ++++++ .../disks/stop-group-async-replication | 96 +++++++ gcloud/compute/instances/bulk/create | 12 + .../create/disk-consistency-group | 61 ++++ gcloud/compute/resource-policies/create/help | 3 + gcloud/compute/security-policies/rules/create | 4 +- gcloud/compute/security-policies/rules/update | 4 +- gcloud/container/clusters/create | 45 ++- gcloud/container/clusters/create-auto | 40 ++- gcloud/container/clusters/update | 53 +++- gcloud/container/node-pools/create | 44 ++- gcloud/container/node-pools/update | 2 +- gcloud/dataflow/flex-template/build | 8 +- gcloud/dataplex/tasks/help | 3 + gcloud/dataplex/tasks/run | 87 ++++++ gcloud/dataproc/clusters/help | 2 +- gcloud/deploy/job-runs/help | 3 + gcloud/deploy/job-runs/terminate | 95 ++++++ gcloud/deploy/releases/create | 14 +- gcloud/deploy/rollouts/advance | 90 ++++++ gcloud/deploy/rollouts/cancel | 85 ++++++ gcloud/deploy/rollouts/help | 9 + gcloud/deploy/rollouts/ignore-job | 95 ++++++ gcloud/spanner/databases/help | 3 + gcloud/spanner/databases/update | 80 ++++++ gcloud/sql/flags/list | 4 +- gcloud/sql/instances/clone | 7 +- gcloud/sql/instances/create | 4 +- gcloud/sql/instances/get-latest-recovery-time | 40 +++ gcloud/sql/instances/help | 4 + gcloud/sql/instances/patch | 4 +- gcloud/workstations/clusters/create | 96 +++++++ gcloud/workstations/clusters/delete | 70 +++++ gcloud/workstations/clusters/describe | 65 +++++ gcloud/workstations/clusters/help | 36 +++ .../operations => workstations/clusters}/list | 51 ++-- gcloud/workstations/configs/create | 270 ++++++++++++++++++ gcloud/workstations/configs/delete | 79 +++++ gcloud/workstations/configs/describe | 73 +++++ gcloud/workstations/configs/get-iam-policy | 107 +++++++ gcloud/workstations/configs/help | 46 +++ .../gateways => workstations/configs}/list | 60 ++-- gcloud/workstations/configs/set-iam-policy | 87 ++++++ gcloud/workstations/configs/update | 227 +++++++++++++++ gcloud/workstations/create | 92 ++++++ gcloud/workstations/delete | 88 ++++++ gcloud/workstations/describe | 83 ++++++ gcloud/workstations/get-iam-policy | 114 ++++++++ gcloud/workstations/help | 67 +++++ gcloud/workstations/list | 101 +++++++ .../list => workstations/list-usable} | 71 ++--- gcloud/workstations/set-iam-policy | 95 ++++++ gcloud/workstations/ssh | 109 +++++++ gcloud/workstations/start | 84 ++++++ gcloud/workstations/start-tcp-tunnel | 99 +++++++ gcloud/workstations/stop | 84 ++++++ 219 files changed, 5076 insertions(+), 1639 deletions(-) create mode 100644 gcloud/alloydb/instances/inject-fault delete mode 100644 gcloud/alpha/beyondcorp/client-connector/gateways/create delete mode 100644 gcloud/alpha/beyondcorp/client-connector/gateways/delete delete mode 100644 gcloud/alpha/beyondcorp/client-connector/gateways/describe delete mode 100644 gcloud/alpha/beyondcorp/client-connector/gateways/get-iam-policy delete mode 100644 gcloud/alpha/beyondcorp/client-connector/gateways/help delete mode 100644 gcloud/alpha/beyondcorp/client-connector/gateways/set-iam-policy delete mode 100644 gcloud/alpha/beyondcorp/client-connector/help delete mode 100644 gcloud/alpha/beyondcorp/client-connector/operations/describe delete mode 100644 gcloud/alpha/beyondcorp/client-connector/operations/help delete mode 100644 gcloud/alpha/beyondcorp/client-connector/services/create delete mode 100644 gcloud/alpha/beyondcorp/client-connector/services/delete delete mode 100644 gcloud/alpha/beyondcorp/client-connector/services/describe delete mode 100644 gcloud/alpha/beyondcorp/client-connector/services/get-iam-policy delete mode 100644 gcloud/alpha/beyondcorp/client-connector/services/help delete mode 100644 gcloud/alpha/beyondcorp/client-connector/services/set-iam-policy delete mode 100644 gcloud/alpha/beyondcorp/client-connector/services/update create mode 100644 gcloud/alpha/dataplex/tasks/run create mode 100644 gcloud/alpha/spanner/databases/update create mode 100644 gcloud/alpha/sql/instances/get-latest-recovery-time create mode 100644 gcloud/alpha/storage/sign-url create mode 100644 gcloud/beta/alloydb/instances/inject-fault create mode 100644 gcloud/beta/spanner/databases/update create mode 100644 gcloud/beta/sql/instances/get-latest-recovery-time create mode 100644 gcloud/compute/disks/bulk/create create mode 100644 gcloud/compute/disks/bulk/help create mode 100644 gcloud/compute/disks/start-async-replication create mode 100644 gcloud/compute/disks/stop-async-replication create mode 100644 gcloud/compute/disks/stop-group-async-replication create mode 100644 gcloud/compute/resource-policies/create/disk-consistency-group create mode 100644 gcloud/dataplex/tasks/run create mode 100644 gcloud/deploy/job-runs/terminate create mode 100644 gcloud/deploy/rollouts/advance create mode 100644 gcloud/deploy/rollouts/cancel create mode 100644 gcloud/deploy/rollouts/ignore-job create mode 100644 gcloud/spanner/databases/update create mode 100644 gcloud/sql/instances/get-latest-recovery-time create mode 100644 gcloud/workstations/clusters/create create mode 100644 gcloud/workstations/clusters/delete create mode 100644 gcloud/workstations/clusters/describe create mode 100644 gcloud/workstations/clusters/help rename gcloud/{alpha/beyondcorp/client-connector/operations => workstations/clusters}/list (51%) create mode 100644 gcloud/workstations/configs/create create mode 100644 gcloud/workstations/configs/delete create mode 100644 gcloud/workstations/configs/describe create mode 100644 gcloud/workstations/configs/get-iam-policy create mode 100644 gcloud/workstations/configs/help rename gcloud/{alpha/beyondcorp/client-connector/gateways => workstations/configs}/list (54%) create mode 100644 gcloud/workstations/configs/set-iam-policy create mode 100644 gcloud/workstations/configs/update create mode 100644 gcloud/workstations/create create mode 100644 gcloud/workstations/delete create mode 100644 gcloud/workstations/describe create mode 100644 gcloud/workstations/get-iam-policy create mode 100644 gcloud/workstations/help create mode 100644 gcloud/workstations/list rename gcloud/{alpha/beyondcorp/client-connector/services/list => workstations/list-usable} (52%) create mode 100644 gcloud/workstations/set-iam-policy create mode 100644 gcloud/workstations/ssh create mode 100644 gcloud/workstations/start create mode 100644 gcloud/workstations/start-tcp-tunnel create mode 100644 gcloud/workstations/stop diff --git a/gcloud/_version b/gcloud/_version index b61a77a04..003ce1645 100644 --- a/gcloud/_version +++ b/gcloud/_version @@ -1,8 +1,8 @@ -Google Cloud SDK 435.0.1 -alpha 2023.06.14 -beta 2023.06.14 +Google Cloud SDK 436.0.0 +alpha 2023.06.16 +beta 2023.06.16 bq 2.0.93 bundled-python3-unix 3.9.16 -core 2023.06.14 +core 2023.06.16 gcloud-crc32c 1.0.0 gsutil 5.24 diff --git a/gcloud/alloydb/instances/help b/gcloud/alloydb/instances/help index 1a02fbfe6..57752b680 100644 --- a/gcloud/alloydb/instances/help +++ b/gcloud/alloydb/instances/help @@ -31,6 +31,9 @@ COMMANDS failover Failover an AlloyDB instance within a given cluster. + inject-fault + Inject fault on an AlloyDB instance within a given cluster. + list Lists AlloyDB instances in a given cluster. diff --git a/gcloud/alloydb/instances/inject-fault b/gcloud/alloydb/instances/inject-fault new file mode 100644 index 000000000..81a5f8e79 --- /dev/null +++ b/gcloud/alloydb/instances/inject-fault @@ -0,0 +1,56 @@ +NAME + gcloud alloydb instances inject-fault - inject fault on an AlloyDB instance + within a given cluster + +SYNOPSIS + gcloud alloydb instances inject-fault INSTANCE --cluster=CLUSTER + --fault-type=FAULT_TYPE --region=REGION [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Inject fault on an AlloyDB instance within a given cluster. + +EXAMPLES + To Inject fault on an instance, run: + + $ gcloud alloydb instances inject-fault my-instance \ + --cluster=my-cluster --region=us-central1 --fault-type=stop-vm + +POSITIONAL ARGUMENTS + INSTANCE + AlloyDB instance ID + +REQUIRED FLAGS + --cluster=CLUSTER + AlloyDB cluster ID + + --fault-type=FAULT_TYPE + Specifies fault type. FAULT_TYPE must be (only one value is supported): + + stop-vm + stop-vm fault type supports stopping the VM. + + --region=REGION + Regional location (e.g. asia-east1, us-east1). See the full list of + regions at https://cloud.google.com/sql/docs/instance-locations. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha alloydb instances inject-fault + + $ gcloud beta alloydb instances inject-fault + diff --git a/gcloud/alpha/alloydb/instances/inject-fault b/gcloud/alpha/alloydb/instances/inject-fault index 191a0f4d8..df8fa9ef8 100644 --- a/gcloud/alpha/alloydb/instances/inject-fault +++ b/gcloud/alpha/alloydb/instances/inject-fault @@ -51,5 +51,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. These variants are also available: + + $ gcloud alloydb instances inject-fault + + $ gcloud beta alloydb instances inject-fault diff --git a/gcloud/alpha/beyondcorp/client-connector/gateways/create b/gcloud/alpha/beyondcorp/client-connector/gateways/create deleted file mode 100644 index 19966e919..000000000 --- a/gcloud/alpha/beyondcorp/client-connector/gateways/create +++ /dev/null @@ -1,94 +0,0 @@ -NAME - gcloud alpha beyondcorp client-connector gateways create - create a new - BeyondCorp client gateway - -SYNOPSIS - gcloud alpha beyondcorp client-connector gateways create - (CLIENT_GATEWAY : --location=LOCATION) - --client-connector-service=CLIENT_CONNECTOR_SERVICE [--async] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Create a new BeyondCorp client gateway. - -EXAMPLES - The following command creates a client gateway with ID my-client-gateway in - the default user project and location us-central1: - - $ gcloud alpha beyondcorp client-connector gateways create \ - my-client-gateway --location=us-central1 \ - --client-connector-service=projects/consumer-project-id/\ - locations/us-central1/clientConnectorServices/my-service-resource - - The following command creates a client gateway with ID my-client-gateway - with explicit values for all required and optional parameters: - - $ gcloud alpha beyondcorp client-connector gateways create \ - my-client-gateway --project=consumer-project-id \ - --location=us-central1 \ - --client-connector-service=projects/consumer-project-id/\ - locations/us-central1/clientConnectorServices/my-service-resource - -POSITIONAL ARGUMENTS - Client gateway resource - The BeyondCorp client gateway you want to - create. The arguments in this group can be used to specify the attributes - of this resource. (NOTE) Some attributes are not given arguments in this - group but can be set in other ways. - - To set the project attribute: - ◆ provide the argument client_gateway 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. - - CLIENT_GATEWAY - ID of the client_gateway or fully qualified identifier for the - client_gateway. - - To set the client_gateway attribute: - ▸ provide the argument client_gateway on the command line. - - This positional argument must be specified if any of the other - arguments in this group are specified. - - --location=LOCATION - The location of the BeyondCorp Enterprise client connector. - - To set the location attribute: - ▸ provide the argument client_gateway on the command line with a - fully specified name; - ▸ provide the argument --location on the command line. - -REQUIRED FLAGS - --client-connector-service=CLIENT_CONNECTOR_SERVICE - The client connector service that the client gateway is associated - with. Example - - projects/consumer-project-id/locations/us-central1/clientConnectorServices/my-service-resource. - -OPTIONAL FLAGS - --async - Return immediately, without waiting for the operation in progress to - complete. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the beyondcorp/v1alpha API. The full documentation for - this API can be found at: https://cloud.google.com/ - -NOTES - This command is currently in alpha and might change without notice. If this - command fails with API permission errors despite specifying the correct - project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: - - $ gcloud beta beyondcorp client-connector gateways create - diff --git a/gcloud/alpha/beyondcorp/client-connector/gateways/delete b/gcloud/alpha/beyondcorp/client-connector/gateways/delete deleted file mode 100644 index e77841288..000000000 --- a/gcloud/alpha/beyondcorp/client-connector/gateways/delete +++ /dev/null @@ -1,75 +0,0 @@ -NAME - gcloud alpha beyondcorp client-connector gateways delete - delete a single - BeyondCorp client gateway - -SYNOPSIS - gcloud alpha beyondcorp client-connector gateways delete - (CLIENT_GATEWAY : --location=LOCATION) [--async] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Delete a single BeyondCorp client gateway. - -EXAMPLES - To delete a client gateway with ID my-client-gateway run: - - $ gcloud alpha beyondcorp client-connector gateways delete \ - my-client-gateway --project=consumer-project-id \ - --location=us-central1 - -POSITIONAL ARGUMENTS - Client gateway resource - The BeyondCorp client gateway you want to - delete. The arguments in this group can be used to specify the attributes - of this resource. (NOTE) Some attributes are not given arguments in this - group but can be set in other ways. - - To set the project attribute: - ◆ provide the argument client_gateway 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. - - CLIENT_GATEWAY - ID of the client_gateway or fully qualified identifier for the - client_gateway. - - To set the client_gateway attribute: - ▸ provide the argument client_gateway on the command line. - - This positional argument must be specified if any of the other - arguments in this group are specified. - - --location=LOCATION - The location of the BeyondCorp Enterprise client connector. - - To set the location attribute: - ▸ provide the argument client_gateway on the command line with a - fully specified name; - ▸ provide the argument --location on the command line. - -FLAGS - --async - Return immediately, without waiting for the operation in progress to - complete. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the beyondcorp/v1alpha API. The full documentation for - this API can be found at: https://cloud.google.com/ - -NOTES - This command is currently in alpha and might change without notice. If this - command fails with API permission errors despite specifying the correct - project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: - - $ gcloud beta beyondcorp client-connector gateways delete - diff --git a/gcloud/alpha/beyondcorp/client-connector/gateways/describe b/gcloud/alpha/beyondcorp/client-connector/gateways/describe deleted file mode 100644 index e860a3f9a..000000000 --- a/gcloud/alpha/beyondcorp/client-connector/gateways/describe +++ /dev/null @@ -1,70 +0,0 @@ -NAME - gcloud alpha beyondcorp client-connector gateways describe - describe a - single BeyondCorp client gateway - -SYNOPSIS - gcloud alpha beyondcorp client-connector gateways describe - (CLIENT_GATEWAY : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Describe a single BeyondCorp client gateway. - -EXAMPLES - To describe a client gateway my-client-gateway run: - - $ gcloud alpha beyondcorp client-connector gateways describe \ - my-client-gateway --project=consumer-project-id \ - --location=us-central1 - -POSITIONAL ARGUMENTS - Client gateway resource - The BeyondCorp client gateway you want to get - details about. 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 client_gateway 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. - - CLIENT_GATEWAY - ID of the client_gateway or fully qualified identifier for the - client_gateway. - - To set the client_gateway attribute: - ▸ provide the argument client_gateway on the command line. - - This positional argument must be specified if any of the other - arguments in this group are specified. - - --location=LOCATION - The location of the BeyondCorp Enterprise client connector. - - To set the location attribute: - ▸ provide the argument client_gateway on the command line with a - fully specified name; - ▸ provide the argument --location on the command line. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the beyondcorp/v1alpha API. The full documentation for - this API can be found at: https://cloud.google.com/ - -NOTES - This command is currently in alpha and might change without notice. If this - command fails with API permission errors despite specifying the correct - project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: - - $ gcloud beta beyondcorp client-connector gateways describe - diff --git a/gcloud/alpha/beyondcorp/client-connector/gateways/get-iam-policy b/gcloud/alpha/beyondcorp/client-connector/gateways/get-iam-policy deleted file mode 100644 index 5b7c740ba..000000000 --- a/gcloud/alpha/beyondcorp/client-connector/gateways/get-iam-policy +++ /dev/null @@ -1,98 +0,0 @@ -NAME - gcloud alpha beyondcorp client-connector gateways get-iam-policy - get the - IAM policy for a BeyondCorp client gateway - -SYNOPSIS - gcloud alpha beyondcorp client-connector gateways get-iam-policy - (CLIENT_GATEWAY : --location=LOCATION) [--filter=EXPRESSION] - [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Gets the IAM policy for the given BeyondCorp client gateway. - -EXAMPLES - To get the IAM policy for a client gateway my-client-gateway run: - - $ gcloud alpha beyondcorp client-connector gateways get-iam-policy \ - my-client-gateway --project=consumer-project-id \ - --location=us-central1 - -POSITIONAL ARGUMENTS - Client gateway resource - The BeyondCorp client gateway for which to get - the IAM 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 client_gateway 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. - - CLIENT_GATEWAY - ID of the client_gateway or fully qualified identifier for the - client_gateway. - - To set the client_gateway attribute: - ▸ provide the argument client_gateway on the command line. - - This positional argument must be specified if any of the other - arguments in this group are specified. - - --location=LOCATION - The location of the BeyondCorp Enterprise client connector. - - To set the location attribute: - ▸ provide the argument client_gateway on the command line with a - fully specified name; - ▸ provide the argument --location on the command line. - -LIST COMMAND FLAGS - --filter=EXPRESSION - Apply a Boolean filter EXPRESSION to each resource item to be listed. - If the expression evaluates True, then that item is listed. For more - details and examples of filter expressions, run $ gcloud topic filters. - This flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --limit=LIMIT - Maximum number of resources to list. The default is unlimited. This - flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --page-size=PAGE_SIZE - Some services group resource list output into pages. This flag - specifies the maximum number of resources per page. The default is - determined by the service if it supports paging, otherwise it is - unlimited (no paging). Paging may be applied before or after --filter - and --limit depending on the service. - - --sort-by=[FIELD,...] - Comma-separated list of resource field key names to sort by. The - default order is ascending. Prefix a field with ``~'' for descending - order on that field. This flag interacts with other flags that are - applied in this order: --flatten, --sort-by, --filter, --limit. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the beyondcorp/v1alpha API. The full documentation for - this API can be found at: https://cloud.google.com/ - -NOTES - This command is currently in alpha and might change without notice. If this - command fails with API permission errors despite specifying the correct - project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: - - $ gcloud beta beyondcorp client-connector gateways get-iam-policy - diff --git a/gcloud/alpha/beyondcorp/client-connector/gateways/help b/gcloud/alpha/beyondcorp/client-connector/gateways/help deleted file mode 100644 index db0aae58f..000000000 --- a/gcloud/alpha/beyondcorp/client-connector/gateways/help +++ /dev/null @@ -1,50 +0,0 @@ -NAME - gcloud alpha beyondcorp client-connector gateways - create and manipulate - BeyondCorp client gateways - -SYNOPSIS - gcloud alpha beyondcorp client-connector gateways COMMAND - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Regional, server-side components to which clients can connect. - Client gateways are deployed by administrators. The gateways communicate - with the BeyondCorp Enterprise enforcement system to enforce context-aware - checks. The BeyondCorp Enterprise enforcement system uses Identity-Aware - Proxy and Access Context Manager, a flexible BeyondCorp Enterprise zero - trust policy engine. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -COMMANDS - COMMAND is one of the following: - - create - (ALPHA) Create a new BeyondCorp client gateway. - - delete - (ALPHA) Delete a single BeyondCorp client gateway. - - describe - (ALPHA) Describe a single BeyondCorp client gateway. - - get-iam-policy - (ALPHA) Get the IAM policy for a BeyondCorp client gateway. - - list - (ALPHA) List BeyondCorp client gateway resources. - - set-iam-policy - (ALPHA) Set the IAM policy for a BeyondCorp client gateway. - -NOTES - This command is currently in alpha and might change without notice. If this - command fails with API permission errors despite specifying the correct - project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: - - $ gcloud beta beyondcorp client-connector gateways - diff --git a/gcloud/alpha/beyondcorp/client-connector/gateways/set-iam-policy b/gcloud/alpha/beyondcorp/client-connector/gateways/set-iam-policy deleted file mode 100644 index 11d498b40..000000000 --- a/gcloud/alpha/beyondcorp/client-connector/gateways/set-iam-policy +++ /dev/null @@ -1,78 +0,0 @@ -NAME - gcloud alpha beyondcorp client-connector gateways set-iam-policy - set the - IAM policy for a BeyondCorp client gateway - -SYNOPSIS - gcloud alpha beyondcorp client-connector gateways set-iam-policy - (CLIENT_GATEWAY : --location=LOCATION) POLICY_FILE - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Sets the IAM policy for the given BeyondCorp client gateway. - -EXAMPLES - The following command will read an IAM policy defined in a JSON file - 'policy.json' and set it for the client gateway with ID my-client-gateway: - - $ gcloud alpha beyondcorp client-connector gateways set-iam-policy \ - my-client-gateway policy.json --location=us-central1 - -POSITIONAL ARGUMENTS - Client gateway resource - The BeyondCorp client gateway for which to set - the IAM 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 client_gateway 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. - - CLIENT_GATEWAY - ID of the client_gateway or fully qualified identifier for the - client_gateway. - - To set the client_gateway attribute: - ▸ provide the argument client_gateway on the command line. - - This positional argument must be specified if any of the other - arguments in this group are specified. - - --location=LOCATION - The location of the BeyondCorp Enterprise client connector. - - To set the location attribute: - ▸ provide the argument client_gateway on the command line with a - fully specified name; - ▸ provide the argument --location on the command line. - - POLICY_FILE - Path to a local JSON or YAML formatted file containing a valid policy. - - The output of the get-iam-policy command is a valid file, as is any - JSON or YAML file conforming to the structure of a Policy - (https://cloud.google.com/iam/reference/rest/v1/Policy). - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the beyondcorp/v1alpha API. The full documentation for - this API can be found at: https://cloud.google.com/ - -NOTES - This command is currently in alpha and might change without notice. If this - command fails with API permission errors despite specifying the correct - project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: - - $ gcloud beta beyondcorp client-connector gateways set-iam-policy - diff --git a/gcloud/alpha/beyondcorp/client-connector/help b/gcloud/alpha/beyondcorp/client-connector/help deleted file mode 100644 index 8d5e80615..000000000 --- a/gcloud/alpha/beyondcorp/client-connector/help +++ /dev/null @@ -1,46 +0,0 @@ -NAME - gcloud alpha beyondcorp client-connector - provides context-aware access to - non-web applications - -SYNOPSIS - gcloud alpha beyondcorp client-connector GROUP [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) BeyondCorp Enterprise is the zero trust solution from Google that - provides secure access to private applications with integrated threat and - data protection. BeyondCorp Enterprise uses Chrome to provide secure access - for all web-based (HTTPS) applications. - - The BeyondCorp Enterprise client connector extends support to non-web - applications by creating a secure connection to applications running in - both Google Cloud and non-Google Cloud environments with full context and - identity aware access. - - More information on Beyondcorp can be found here: - https://cloud.google.com/beyondcorp-enterprise/docs/client-connector - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -GROUPS - GROUP is one of the following: - - gateways - (ALPHA) Create and manipulate BeyondCorp client gateways. - - operations - (ALPHA) List and describe BeyondCorp client connector operations. - - services - (ALPHA) Create and manipulate BeyondCorp client connector services. - -NOTES - This command is currently in alpha and might change without notice. If this - command fails with API permission errors despite specifying the correct - project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: - - $ gcloud beta beyondcorp client-connector - diff --git a/gcloud/alpha/beyondcorp/client-connector/operations/describe b/gcloud/alpha/beyondcorp/client-connector/operations/describe deleted file mode 100644 index b02278282..000000000 --- a/gcloud/alpha/beyondcorp/client-connector/operations/describe +++ /dev/null @@ -1,71 +0,0 @@ -NAME - gcloud alpha beyondcorp client-connector operations describe - describe a - BeyondCorp client connector operation - -SYNOPSIS - gcloud alpha beyondcorp client-connector operations describe - (OPERATION : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Describe a BeyondCorp client connector operation given a valid - operation name. - -EXAMPLES - The following command describes an operation called - operation-1484002552235-425b144f8c3f8-81aa4b49-0830d1e9: - - $ gcloud alpha beyondcorp client-connector operations describe \ - operation-1484002552235-425b144f8c3f8-81aa4b49-0830d1e9 \ - --project=consumer-project-id --location=us-central1 - -POSITIONAL ARGUMENTS - Operation resource - Name of the client connector operation you want to - describe. The arguments in this group can be used to specify the - attributes of this resource. (NOTE) Some attributes are not given - arguments in this group but can be set in other ways. - - To set the project attribute: - ◆ provide the argument operation on the command line with a fully - specified name; - ◆ set the property core/project; - ◆ provide the argument --project on the command line. - - This must be specified. - - OPERATION - ID of the operation or fully qualified identifier for the operation. - - To set the operation attribute: - ▸ provide the argument operation on the command line. - - This positional argument must be specified if any of the other - arguments in this group are specified. - - --location=LOCATION - The location of the BeyondCorp Enterprise client connector. - - To set the location attribute: - ▸ provide the argument operation on the command line with a fully - specified name; - ▸ provide the argument --location on the command line. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the beyondcorp/v1alpha API. The full documentation for - this API can be found at: https://cloud.google.com/ - -NOTES - This command is currently in alpha and might change without notice. If this - command fails with API permission errors despite specifying the correct - project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: - - $ gcloud beta beyondcorp client-connector operations describe - diff --git a/gcloud/alpha/beyondcorp/client-connector/operations/help b/gcloud/alpha/beyondcorp/client-connector/operations/help deleted file mode 100644 index f21cf13be..000000000 --- a/gcloud/alpha/beyondcorp/client-connector/operations/help +++ /dev/null @@ -1,33 +0,0 @@ -NAME - gcloud alpha beyondcorp client-connector operations - list and describe - BeyondCorp client connector operations - -SYNOPSIS - gcloud alpha beyondcorp client-connector operations COMMAND - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) List and describe BeyondCorp client connector 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 - (ALPHA) Describe a BeyondCorp client connector operation. - - list - (ALPHA) List BeyondCorp client connector operations. - -NOTES - This command is currently in alpha and might change without notice. If this - command fails with API permission errors despite specifying the correct - project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: - - $ gcloud beta beyondcorp client-connector operations - diff --git a/gcloud/alpha/beyondcorp/client-connector/services/create b/gcloud/alpha/beyondcorp/client-connector/services/create deleted file mode 100644 index 1b6d662bd..000000000 --- a/gcloud/alpha/beyondcorp/client-connector/services/create +++ /dev/null @@ -1,143 +0,0 @@ -NAME - gcloud alpha beyondcorp client-connector services create - create a new - BeyondCorp client connector service - -SYNOPSIS - gcloud alpha beyondcorp client-connector services create - (CLIENT_CONNECTOR_SERVICE : --location=LOCATION) - (--config-from-file=CONFIG_FROM_FILE - | [--egress-peered-vpc=EGRESS_PEERED_VPC - --ingress-config=INGRESS_CONFIG : --display-name=DISPLAY_NAME]) - [--async] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Create a new BeyondCorp client connector service. - -EXAMPLES - The following command creates a client connector service with ID - my-service-resource using ingress/egress config provided: - - $ gcloud alpha beyondcorp client-connector services create \ - my-service-resource --location=us-central1 \ - --project=consumer-project-id \ - --ingress-config='{"transportProtocol":"TCP", - "destinationRoutes":[{"address":"196.0.0.1", - "netmask":"255.255.255.0"}]}' \ - --egress-peered-vpc='{"networkVpc":"projects/consumer-project-id\ - /global/networks/my-vpc-network"}' - - The following command creates a client connector service with ID - my-service-resource with configuration from file: - - $ gcloud alpha beyondcorp client-connector services create \ - my-service-resource --project=consumer-project-id \ - --location=us-central1 \ - --config-from-file=/path/to/file/configJson.txt - -POSITIONAL ARGUMENTS - Client connector service resource - The BeyondCorp client connector - service you want to create. The arguments in this group can be used to - specify the attributes of this resource. (NOTE) Some attributes are not - given arguments in this group but can be set in other ways. - - To set the project attribute: - ◆ provide the argument client_connector_service on the command line - with a fully specified name; - ◆ set the property core/project; - ◆ provide the argument --project on the command line. - - This must be specified. - - CLIENT_CONNECTOR_SERVICE - ID of the client_connector_service or fully qualified identifier for - the client_connector_service. - - To set the client_connector_service attribute: - ▸ provide the argument client_connector_service on the command - line. - - This positional argument must be specified if any of the other - arguments in this group are specified. - - --location=LOCATION - The location of the BeyondCorp Enterprise client connector. - - To set the location attribute: - ▸ provide the argument client_connector_service on the command line - with a fully specified name; - ▸ provide the argument --location on the command line. - -REQUIRED FLAGS - Client connector service configuration. - - Exactly one of these must be specified: - - --config-from-file=CONFIG_FROM_FILE - Path to json file containing client connector service configuration. - Example - "/file/path/configJson.txt" where configJson.txt contains - { - "ingress":{ - "config":{ - "transportProtocol":"TCP", - "destinationRoutes":[{ - "address":"196.0.0.0", - "netmask":"255.255.255.0" - }] - } - }, - "egress":{ - "peeredVpc":{ - "networkVpc":"projects/consumer-project-id/global/networks/my-vpc-network" - } - }, - "displayName":"my-service-resource" - } - - --egress-peered-vpc=EGRESS_PEERED_VPC - The peered VPC owned by the consumer project. Example - - {"networkVpc": - "projects/consumer-project-id/global/networks/my-vpc-network"}. - - This flag argument must be specified if any of the other arguments in - this group are specified. - - --ingress-config=INGRESS_CONFIG - The basic ingress config for client gateways. Example - - {"transportProtocol": - "TCP","destinationRoutes":[{"address":"196.0.0.1", - "netmask":"255.255.255.0"}]}. - - This flag argument must be specified if any of the other arguments in - this group are specified. - - --display-name=DISPLAY_NAME - An arbitrary user-provided name for the client connector service. The - display name should follow format - - ▸ Must be 6 to 30 characters in length. - ▸ Can only contain lowercase letters, numbers and hyphens. - ▸ Must start with a letter. - -OPTIONAL FLAGS - --async - Return immediately, without waiting for the operation in progress to - complete. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the beyondcorp/v1alpha API. The full documentation for - this API can be found at: https://cloud.google.com/ - -NOTES - This command is currently in alpha and might change without notice. If this - command fails with API permission errors despite specifying the correct - project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: - - $ gcloud beta beyondcorp client-connector services create - diff --git a/gcloud/alpha/beyondcorp/client-connector/services/delete b/gcloud/alpha/beyondcorp/client-connector/services/delete deleted file mode 100644 index 339b87bd0..000000000 --- a/gcloud/alpha/beyondcorp/client-connector/services/delete +++ /dev/null @@ -1,77 +0,0 @@ -NAME - gcloud alpha beyondcorp client-connector services delete - delete a - BeyondCorp client connector service - -SYNOPSIS - gcloud alpha beyondcorp client-connector services delete - (CLIENT_CONNECTOR_SERVICE : --location=LOCATION) [--async] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Delete a BeyondCorp client connector service. - -EXAMPLES - To delete a client connector service with ID my-service-resource run: - - $ gcloud alpha beyondcorp client-connector services delete \ - my-service-resource --project=consumer-project-id \ - --location=us-central1 - -POSITIONAL ARGUMENTS - Client connector service resource - The BeyondCorp client connector - service you want to delete. The arguments in this group can be used to - specify the attributes of this resource. (NOTE) Some attributes are not - given arguments in this group but can be set in other ways. - - To set the project attribute: - ◆ provide the argument client_connector_service on the command line - with a fully specified name; - ◆ set the property core/project; - ◆ provide the argument --project on the command line. - - This must be specified. - - CLIENT_CONNECTOR_SERVICE - ID of the client_connector_service or fully qualified identifier for - the client_connector_service. - - To set the client_connector_service attribute: - ▸ provide the argument client_connector_service on the command - line. - - This positional argument must be specified if any of the other - arguments in this group are specified. - - --location=LOCATION - The location of the BeyondCorp Enterprise client connector. - - To set the location attribute: - ▸ provide the argument client_connector_service on the command line - with a fully specified name; - ▸ provide the argument --location on the command line. - -FLAGS - --async - Return immediately, without waiting for the operation in progress to - complete. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the beyondcorp/v1alpha API. The full documentation for - this API can be found at: https://cloud.google.com/ - -NOTES - This command is currently in alpha and might change without notice. If this - command fails with API permission errors despite specifying the correct - project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: - - $ gcloud beta beyondcorp client-connector services delete - diff --git a/gcloud/alpha/beyondcorp/client-connector/services/describe b/gcloud/alpha/beyondcorp/client-connector/services/describe deleted file mode 100644 index 913000621..000000000 --- a/gcloud/alpha/beyondcorp/client-connector/services/describe +++ /dev/null @@ -1,71 +0,0 @@ -NAME - gcloud alpha beyondcorp client-connector services describe - describe a - BeyondCorp client connector service - -SYNOPSIS - gcloud alpha beyondcorp client-connector services describe - (CLIENT_CONNECTOR_SERVICE : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Describe a BeyondCorp client connector service. - -EXAMPLES - To describe a client connector service with ID my-service-resource run: - - $ gcloud alpha beyondcorp client-connector services describe \ - my-service-resource --project=consumer-project-id \ - --location=us-central1 - -POSITIONAL ARGUMENTS - Client connector service resource - The BeyondCorp client connector - service you want to get details about. 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 client_connector_service on the command line - with a fully specified name; - ◆ set the property core/project; - ◆ provide the argument --project on the command line. - - This must be specified. - - CLIENT_CONNECTOR_SERVICE - ID of the client_connector_service or fully qualified identifier for - the client_connector_service. - - To set the client_connector_service attribute: - ▸ provide the argument client_connector_service on the command - line. - - This positional argument must be specified if any of the other - arguments in this group are specified. - - --location=LOCATION - The location of the BeyondCorp Enterprise client connector. - - To set the location attribute: - ▸ provide the argument client_connector_service on the command line - with a fully specified name; - ▸ provide the argument --location on the command line. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the beyondcorp/v1alpha API. The full documentation for - this API can be found at: https://cloud.google.com/ - -NOTES - This command is currently in alpha and might change without notice. If this - command fails with API permission errors despite specifying the correct - project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: - - $ gcloud beta beyondcorp client-connector services describe - diff --git a/gcloud/alpha/beyondcorp/client-connector/services/get-iam-policy b/gcloud/alpha/beyondcorp/client-connector/services/get-iam-policy deleted file mode 100644 index 45d4f6a7f..000000000 --- a/gcloud/alpha/beyondcorp/client-connector/services/get-iam-policy +++ /dev/null @@ -1,100 +0,0 @@ -NAME - gcloud alpha beyondcorp client-connector services get-iam-policy - get the - IAM policy for a BeyondCorp client connector service - -SYNOPSIS - gcloud alpha beyondcorp client-connector services get-iam-policy - (CLIENT_CONNECTOR_SERVICE : --location=LOCATION) [--filter=EXPRESSION] - [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Gets the IAM policy for a BeyondCorp client connector service. - -EXAMPLES - To get the IAM policy for a client connector service with ID - my-service-resource run: - - $ gcloud alpha beyondcorp client-connector services get-iam-policy \ - my-service-resource --project=consumer-project-id \ - --location=us-central1 - -POSITIONAL ARGUMENTS - Client connector service resource - The BeyondCorp client connector - service for which to get the IAM 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 client_connector_service on the command line - with a fully specified name; - ◆ set the property core/project; - ◆ provide the argument --project on the command line. - - This must be specified. - - CLIENT_CONNECTOR_SERVICE - ID of the client_connector_service or fully qualified identifier for - the client_connector_service. - - To set the client_connector_service attribute: - ▸ provide the argument client_connector_service on the command - line. - - This positional argument must be specified if any of the other - arguments in this group are specified. - - --location=LOCATION - The location of the BeyondCorp Enterprise client connector. - - To set the location attribute: - ▸ provide the argument client_connector_service on the command line - with a fully specified name; - ▸ provide the argument --location on the command line. - -LIST COMMAND FLAGS - --filter=EXPRESSION - Apply a Boolean filter EXPRESSION to each resource item to be listed. - If the expression evaluates True, then that item is listed. For more - details and examples of filter expressions, run $ gcloud topic filters. - This flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --limit=LIMIT - Maximum number of resources to list. The default is unlimited. This - flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --page-size=PAGE_SIZE - Some services group resource list output into pages. This flag - specifies the maximum number of resources per page. The default is - determined by the service if it supports paging, otherwise it is - unlimited (no paging). Paging may be applied before or after --filter - and --limit depending on the service. - - --sort-by=[FIELD,...] - Comma-separated list of resource field key names to sort by. The - default order is ascending. Prefix a field with ``~'' for descending - order on that field. This flag interacts with other flags that are - applied in this order: --flatten, --sort-by, --filter, --limit. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the beyondcorp/v1alpha API. The full documentation for - this API can be found at: https://cloud.google.com/ - -NOTES - This command is currently in alpha and might change without notice. If this - command fails with API permission errors despite specifying the correct - project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: - - $ gcloud beta beyondcorp client-connector services get-iam-policy - diff --git a/gcloud/alpha/beyondcorp/client-connector/services/help b/gcloud/alpha/beyondcorp/client-connector/services/help deleted file mode 100644 index 6e37c2513..000000000 --- a/gcloud/alpha/beyondcorp/client-connector/services/help +++ /dev/null @@ -1,55 +0,0 @@ -NAME - gcloud alpha beyondcorp client-connector services - create and manipulate - BeyondCorp client connector services - -SYNOPSIS - gcloud alpha beyondcorp client-connector services COMMAND - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) The client connector service is used to define a common - configuration for a group of client gateways. Client gateways refer to the - client connector service and are used to control the regions where you want - to manage user traffic. The gateways communicate with the BeyondCorp - Enterprise enforcement system to enforce context-aware checks. The - BeyondCorp Enterprise enforcement system uses Identity-Aware Proxy and - Access Context Manager, a flexible BeyondCorp Enterprise zero trust policy - engine. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -COMMANDS - COMMAND is one of the following: - - create - (ALPHA) Create a new BeyondCorp client connector service. - - delete - (ALPHA) Delete a BeyondCorp client connector service. - - describe - (ALPHA) Describe a BeyondCorp client connector service. - - get-iam-policy - (ALPHA) Get the IAM policy for a BeyondCorp client connector service. - - list - (ALPHA) List BeyondCorp client connector service resources. - - set-iam-policy - (ALPHA) Set the IAM policy for a BeyondCorp client connector service. - - update - (ALPHA) Update a BeyondCorp client connector service. - -NOTES - This command is currently in alpha and might change without notice. If this - command fails with API permission errors despite specifying the correct - project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: - - $ gcloud beta beyondcorp client-connector services - diff --git a/gcloud/alpha/beyondcorp/client-connector/services/set-iam-policy b/gcloud/alpha/beyondcorp/client-connector/services/set-iam-policy deleted file mode 100644 index 87c331419..000000000 --- a/gcloud/alpha/beyondcorp/client-connector/services/set-iam-policy +++ /dev/null @@ -1,81 +0,0 @@ -NAME - gcloud alpha beyondcorp client-connector services set-iam-policy - set the - IAM policy for a BeyondCorp client connector service - -SYNOPSIS - gcloud alpha beyondcorp client-connector services set-iam-policy - (CLIENT_CONNECTOR_SERVICE : --location=LOCATION) POLICY_FILE - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Sets the IAM policy for the given BeyondCorp client connector - service. - -EXAMPLES - The following command will read an IAM policy defined in a JSON file - 'policy.json' and set it for the client connector service with ID - my-service-resource: - - $ gcloud alpha beyondcorp client-connector services set-iam-policy \ - my-service-resource policy.json - -POSITIONAL ARGUMENTS - Client connector service resource - The BeyondCorp client connector - service for which to set the IAM 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 client_connector_service on the command line - with a fully specified name; - ◆ set the property core/project; - ◆ provide the argument --project on the command line. - - This must be specified. - - CLIENT_CONNECTOR_SERVICE - ID of the client_connector_service or fully qualified identifier for - the client_connector_service. - - To set the client_connector_service attribute: - ▸ provide the argument client_connector_service on the command - line. - - This positional argument must be specified if any of the other - arguments in this group are specified. - - --location=LOCATION - The location of the BeyondCorp Enterprise client connector. - - To set the location attribute: - ▸ provide the argument client_connector_service on the command line - with a fully specified name; - ▸ provide the argument --location on the command line. - - POLICY_FILE - Path to a local JSON or YAML formatted file containing a valid policy. - - The output of the get-iam-policy command is a valid file, as is any - JSON or YAML file conforming to the structure of a Policy - (https://cloud.google.com/iam/reference/rest/v1/Policy). - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the beyondcorp/v1alpha API. The full documentation for - this API can be found at: https://cloud.google.com/ - -NOTES - This command is currently in alpha and might change without notice. If this - command fails with API permission errors despite specifying the correct - project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: - - $ gcloud beta beyondcorp client-connector services set-iam-policy - diff --git a/gcloud/alpha/beyondcorp/client-connector/services/update b/gcloud/alpha/beyondcorp/client-connector/services/update deleted file mode 100644 index 1629fef01..000000000 --- a/gcloud/alpha/beyondcorp/client-connector/services/update +++ /dev/null @@ -1,127 +0,0 @@ -NAME - gcloud alpha beyondcorp client-connector services update - update a - BeyondCorp client connector service - -SYNOPSIS - gcloud alpha beyondcorp client-connector services update - (CLIENT_CONNECTOR_SERVICE : --location=LOCATION) - (--config-from-file=CONFIG_FROM_FILE - | --display-name=DISPLAY_NAME --ingress-config=INGRESS_CONFIG) - [--async] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Update a BeyondCorp client connector service. Note - Mutable fields - include - \ display_name, ingress.config.destination_routes. - -EXAMPLES - Note - Mutable fields include: display_name, - ingress.config.destination_routes. - - The following command updates a client connector service with ID - my-service-resource with ingress config: - - $ gcloud alpha beyondcorp client-connector services update \ - my-service-resource --project=consumer-project-id \ - --location=us-central1 --display-name="my-new-resource" \ - --ingress-config='{"destinationRoutes":[{"address":"196.0.0.1", - "netmask":"255.255.255.0"},{"address":"197.0.0.2","netmask":"255.25\ - 5.255.0"}]}' - - The following command updates a client connector service with ID - my-service-resource with configuration from file: - - $ gcloud alpha beyondcorp client-connector services update \ - my-service-resource --project=consumer-project-id \ - --location=us-central1 \ - --config-from-file=/path/to/file/config.json - -POSITIONAL ARGUMENTS - Client connector service resource - The BeyondCorp client connector - service you want 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 client_connector_service on the command line - with a fully specified name; - ◆ set the property core/project; - ◆ provide the argument --project on the command line. - - This must be specified. - - CLIENT_CONNECTOR_SERVICE - ID of the client_connector_service or fully qualified identifier for - the client_connector_service. - - To set the client_connector_service attribute: - ▸ provide the argument client_connector_service on the command - line. - - This positional argument must be specified if any of the other - arguments in this group are specified. - - --location=LOCATION - The location of the BeyondCorp Enterprise client connector. - - To set the location attribute: - ▸ provide the argument client_connector_service on the command line - with a fully specified name; - ▸ provide the argument --location on the command line. - -REQUIRED FLAGS - Updated client connector service configuration. - - Exactly one of these must be specified: - - --config-from-file=CONFIG_FROM_FILE - Path to json file containing client connector service configuration. - Example - "/file/path/config.json" where config.json contains - { - "ingress":{ - "config":{ - "transportProtocol":"TCP", - "destinationRoutes":[{ - "address":"196.0.0.0", - "netmask":"255.255.255.0" - }] - } - }, - "displayName":"my-service-resource" - } - - --display-name=DISPLAY_NAME - An arbitrary user-provided name for the client connector service. The - display name should follow format - - ▸ Must be 6 to 30 characters in length. - ▸ Can only contain lowercase letters, numbers and hyphens. - ▸ Must start with a letter. - - --ingress-config=INGRESS_CONFIG - Ingress config for client gateways. Example - - {"destinationRoutes":[{"address":"196.0.0.0", - "netmask":"255.255.255.0"},{"address":"197.0.0.0","netmask":"255.255.255.0"}]}. - -OPTIONAL FLAGS - --async - Return immediately, without waiting for the operation in progress to - complete. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -API REFERENCE - This command uses the beyondcorp/v1alpha API. The full documentation for - this API can be found at: https://cloud.google.com/ - -NOTES - This command is currently in alpha and might change without notice. If this - command fails with API permission errors despite specifying the correct - project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: - - $ gcloud beta beyondcorp client-connector services update - diff --git a/gcloud/alpha/beyondcorp/help b/gcloud/alpha/beyondcorp/help index e5d84d511..d898c8816 100644 --- a/gcloud/alpha/beyondcorp/help +++ b/gcloud/alpha/beyondcorp/help @@ -30,9 +30,6 @@ GROUPS app (ALPHA) Manages application connectors and connections. - client-connector - (ALPHA) Provides context-aware access to non-web applications. - NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct diff --git a/gcloud/alpha/compute/commitments/create b/gcloud/alpha/compute/commitments/create index 46e26e920..47793f65d 100644 --- a/gcloud/alpha/compute/commitments/create +++ b/gcloud/alpha/compute/commitments/create @@ -99,9 +99,10 @@ OPTIONAL FLAGS Type of commitment. memory-optimized indicates that the commitment is for memory-optimized VMs. TYPE must be one of: accelerator-optimized, compute-optimized, compute-optimized-c2d, compute-optimized-c3, - compute-optimized-c3d, general-purpose, general-purpose-e2, - general-purpose-n2, general-purpose-n2d, general-purpose-t2d, - graphics-optimized, memory-optimized, memory-optimized-m3. + compute-optimized-c3d, compute-optimized-h3, general-purpose, + general-purpose-e2, general-purpose-n2, general-purpose-n2d, + general-purpose-t2d, graphics-optimized, memory-optimized, + memory-optimized-m3. Manage the reservations to be created with the commitment. diff --git a/gcloud/alpha/compute/disks/bulk/create b/gcloud/alpha/compute/disks/bulk/create index 1cd80e140..0caa83790 100644 --- a/gcloud/alpha/compute/disks/bulk/create +++ b/gcloud/alpha/compute/disks/bulk/create @@ -84,7 +84,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 compute disks bulk create $ gcloud beta compute disks bulk create diff --git a/gcloud/alpha/compute/disks/bulk/help b/gcloud/alpha/compute/disks/bulk/help index b87670cb7..c753a22e3 100644 --- a/gcloud/alpha/compute/disks/bulk/help +++ b/gcloud/alpha/compute/disks/bulk/help @@ -24,7 +24,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 compute disks bulk $ gcloud beta compute disks bulk diff --git a/gcloud/alpha/compute/disks/start-async-replication b/gcloud/alpha/compute/disks/start-async-replication index 2e087389f..7ee0ec488 100644 --- a/gcloud/alpha/compute/disks/start-async-replication +++ b/gcloud/alpha/compute/disks/start-async-replication @@ -102,7 +102,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 compute disks start-async-replication $ gcloud beta compute disks start-async-replication diff --git a/gcloud/alpha/compute/disks/stop-async-replication b/gcloud/alpha/compute/disks/stop-async-replication index 80ef01922..175ade1b5 100644 --- a/gcloud/alpha/compute/disks/stop-async-replication +++ b/gcloud/alpha/compute/disks/stop-async-replication @@ -82,7 +82,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 compute disks stop-async-replication $ gcloud beta compute disks stop-async-replication diff --git a/gcloud/alpha/compute/disks/stop-group-async-replication b/gcloud/alpha/compute/disks/stop-group-async-replication index b083a4ade..b1307c2f1 100644 --- a/gcloud/alpha/compute/disks/stop-group-async-replication +++ b/gcloud/alpha/compute/disks/stop-group-async-replication @@ -92,7 +92,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 compute disks stop-group-async-replication $ gcloud beta compute disks stop-group-async-replication diff --git a/gcloud/alpha/compute/resource-policies/create/disk-consistency-group b/gcloud/alpha/compute/resource-policies/create/disk-consistency-group index d7bf066ff..9af6fecba 100644 --- a/gcloud/alpha/compute/resource-policies/create/disk-consistency-group +++ b/gcloud/alpha/compute/resource-policies/create/disk-consistency-group @@ -55,7 +55,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 compute resource-policies create disk-consistency-group $ gcloud beta compute resource-policies create disk-consistency-group diff --git a/gcloud/alpha/compute/security-policies/rules/create b/gcloud/alpha/compute/security-policies/rules/create index 0a0eec559..06529f81a 100644 --- a/gcloud/alpha/compute/security-policies/rules/create +++ b/gcloud/alpha/compute/security-policies/rules/create @@ -62,7 +62,7 @@ REQUIRED FLAGS allow Allows the request from HTTP(S) Load Balancing. deny - Denies the request from TCP/SSL Proxy Load Balancing. + Denies the request from TCP/SSL Proxy and Network Load Balancing. deny-403 Denies the request from HTTP(S) Load Balancing, with an HTTP response status code of 403. diff --git a/gcloud/alpha/compute/security-policies/rules/update b/gcloud/alpha/compute/security-policies/rules/update index aebb4f0ab..3f6cb1d5d 100644 --- a/gcloud/alpha/compute/security-policies/rules/update +++ b/gcloud/alpha/compute/security-policies/rules/update @@ -61,7 +61,7 @@ FLAGS allow Allows the request from HTTP(S) Load Balancing. deny - Denies the request from TCP/SSL Proxy Load Balancing. + Denies the request from TCP/SSL Proxy and Network Load Balancing. deny-403 Denies the request from HTTP(S) Load Balancing, with an HTTP response status code of 403. diff --git a/gcloud/alpha/compute/snapshots/create b/gcloud/alpha/compute/snapshots/create index 57d4a1c19..6f4784579 100644 --- a/gcloud/alpha/compute/snapshots/create +++ b/gcloud/alpha/compute/snapshots/create @@ -9,7 +9,7 @@ SYNOPSIS [--snapshot-type=SNAPSHOT_TYPE] [--source-disk=SOURCE_DISK] [--source-disk-key-file=FILE] [--source-instant-snapshot=SOURCE_INSTANT_SNAPSHOT] - [--storage-location=LOCATION] + [--source-instant-snapshot-key-file=FILE] [--storage-location=LOCATION] [--source-disk-region=SOURCE_DISK_REGION | --source-disk-zone=SOURCE_DISK_ZONE] [--source-instant-snapshot-region=SOURCE_INSTANT_SNAPSHOT_REGION @@ -97,6 +97,11 @@ FLAGS the full path to the source instant snapshot. For example: https://www.googleapis.com/compute/v1/projects/MY-PROJECT/zones/MY-ZONE/instantSnapshots/MY-INSTANT-SNAPSHOT + --source-instant-snapshot-key-file=FILE + Path to the customer-supplied encryption key of the source instant + snapshot. Required if the source instant snapshot is protected by a + customer-supplied encryption key. + --storage-location=LOCATION Google Cloud Storage location, either regional or multi-regional, where snapshot content is to be stored. If absent, a nearby regional or diff --git a/gcloud/alpha/compute/vpn-gateways/create b/gcloud/alpha/compute/vpn-gateways/create index 35a8e1d21..6c185657a 100644 --- a/gcloud/alpha/compute/vpn-gateways/create +++ b/gcloud/alpha/compute/vpn-gateways/create @@ -84,6 +84,8 @@ OPTIONAL FLAGS Both IPv4 and IPv6 protocols are enabled on this VPN gateway. IPV4_ONLY Only IPv4 protocol is enabled on this VPN gateway. + IPV6_ONLY + Only IPv6 protocol is enabled on this VPN gateway. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/container/clusters/create b/gcloud/alpha/container/clusters/create index 2d429d974..852a3d2c2 100644 --- a/gcloud/alpha/container/clusters/create +++ b/gcloud/alpha/container/clusters/create @@ -5,6 +5,7 @@ NAME SYNOPSIS gcloud alpha container clusters create NAME [--accelerator=[type=TYPE,[count=COUNT, + gpu-driver-version=GPU_DRIVER_VERSION, gpu-partition-size=GPU_PARTITION_SIZE, gpu-sharing-strategy=GPU_SHARING_STRATEGY, max-shared-clients-per-gpu=MAX_SHARED_CLIENTS_PER_GPU],...]] @@ -59,12 +60,14 @@ SYNOPSIS [--private-endpoint-subnetwork=NAME] [--private-ipv6-google-access-type=PRIVATE_IPV6_GOOGLE_ACCESS_TYPE] [--release-channel=CHANNEL] [--security-group=SECURITY_GROUP] - [--services-ipv4-cidr=CIDR] [--services-secondary-range-name=NAME] + [--security-posture=SECURITY_POSTURE] [--services-ipv4-cidr=CIDR] + [--services-secondary-range-name=NAME] [--shielded-integrity-monitoring] [--shielded-secure-boot] [--spot] [--stack-type=STACK_TYPE] [--subnetwork=SUBNETWORK] [--system-config-from-file=SYSTEM_CONFIG_FROM_FILE] [--tags=TAG,[TAG,...]] [--threads-per-core=THREADS_PER_CORE] [--workload-metadata=WORKLOAD_METADATA] [--workload-pool=WORKLOAD_POOL] + [--workload-vulnerability-scanning=WORKLOAD_VULNERABILITY_SCANNING] [--additional-zones=ZONE,[ZONE,...] | --node-locations=ZONE,[ZONE,...]] [--binauthz-policy=BINAUTHZ_POLICY --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE @@ -135,7 +138,7 @@ POSITIONAL ARGUMENTS 40 characters. FLAGS - --accelerator=[type=TYPE,[count=COUNT,gpu-partition-size=GPU_PARTITION_SIZE,gpu-sharing-strategy=GPU_SHARING_STRATEGY,max-shared-clients-per-gpu=MAX_SHARED_CLIENTS_PER_GPU],...] + --accelerator=[type=TYPE,[count=COUNT,gpu-driver-version=GPU_DRIVER_VERSION,gpu-partition-size=GPU_PARTITION_SIZE,gpu-sharing-strategy=GPU_SHARING_STRATEGY,max-shared-clients-per-gpu=MAX_SHARED_CLIENTS_PER_GPU],...] Attaches accelerators (e.g. GPUs) to all nodes. type @@ -148,6 +151,20 @@ FLAGS (Optional) The number of accelerators to attach to the instances. The default value is 1. + gpu-driver-version + (Optional) The NVIDIA driver version to install. GPU_DRIVER_VERSION + must be one of: + + `default`: Install the default driver version. If you omit the flag `gpu-driver-version`, + this is the default option. + + `latest`: Install the latest available driver version. Available only for + nodes that use Container-Optimized OS. + + `disabled`: Skip automatic driver installation. You must [manually install a + driver](https://cloud.google.com/kubernetes-engine/docs/how-to/gpus#installing_drivers) + after you create the cluster. + gpu-partition-size (Optional) The GPU partition size used when running multi-instance GPUs. For information about multi-instance GPUs, refer to: @@ -997,6 +1014,18 @@ FLAGS If unspecified, no groups will be returned for use with RBAC. + --security-posture=SECURITY_POSTURE + Sets the mode of the Kubernetes security posture API's off-cluster + features. + + To enable in standard mode explicitly set the flag to + --security-posture=standard + + To disable in an existing cluster, explicitly set the flag to + --security-posture=disabled. + + SECURITY_POSTURE must be one of: disabled, standard. + --services-ipv4-cidr=CIDR Set the IP range for the services IPs. @@ -1158,6 +1187,18 @@ FLAGS https://cloud.google.com/kubernetes-engine/docs/how-to/workload-identity + --workload-vulnerability-scanning=WORKLOAD_VULNERABILITY_SCANNING + Sets the mode of the Kubernetes security posture API's workload + vulnerability scanning. + + To enable in standard mode explicitly set the flag to + --workload-vulnerability-scanning=standard. + + To disable in an existing cluster, explicitly set the flag to + --workload-vulnerability-scanning=disabled. + + WORKLOAD_VULNERABILITY_SCANNING must be one of: disabled, standard. + At most one of these can be specified: --additional-zones=ZONE,[ZONE,...] diff --git a/gcloud/alpha/container/clusters/create-auto b/gcloud/alpha/container/clusters/create-auto index 8329ead4d..0a733845b 100644 --- a/gcloud/alpha/container/clusters/create-auto +++ b/gcloud/alpha/container/clusters/create-auto @@ -17,8 +17,10 @@ SYNOPSIS [--logging=[COMPONENT,...]] [--monitoring=[COMPONENT,...]] [--network=NETWORK] [--private-endpoint-subnetwork=NAME] [--release-channel=CHANNEL] [--security-group=SECURITY_GROUP] - [--services-ipv4-cidr=CIDR] [--services-secondary-range-name=NAME] - [--subnetwork=SUBNETWORK] + [--security-posture=SECURITY_POSTURE] [--services-ipv4-cidr=CIDR] + [--services-secondary-range-name=NAME] [--subnetwork=SUBNETWORK] + [--workload-policies=WORKLOAD_POLICIES] + [--workload-vulnerability-scanning=WORKLOAD_VULNERABILITY_SCANNING] [--binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE --binauthz-policy=BINAUTHZ_POLICY] [--enable-master-authorized-networks @@ -269,6 +271,18 @@ FLAGS If unspecified, no groups will be returned for use with RBAC. + --security-posture=SECURITY_POSTURE + Sets the mode of the Kubernetes security posture API's off-cluster + features. + + To enable in standard mode explicitly set the flag to + --security-posture=standard + + To disable in an existing cluster, explicitly set the flag to + --security-posture=disabled. + + SECURITY_POSTURE must be one of: disabled, standard. + --services-ipv4-cidr=CIDR Set the IP range for the services IPs. @@ -297,6 +311,28 @@ FLAGS Cannot be used with the "--create-subnetwork" option. + --workload-policies=WORKLOAD_POLICIES + Add Autopilot workload policies to the cluster. + + Examples: + + $ gcloud alpha container clusters create-auto example-cluster \ + --workload-policies=allow-net-admin + + The only supported workload policy is 'allow-net-admin'. + + --workload-vulnerability-scanning=WORKLOAD_VULNERABILITY_SCANNING + Sets the mode of the Kubernetes security posture API's workload + vulnerability scanning. + + To enable in standard mode explicitly set the flag to + --workload-vulnerability-scanning=standard. + + To disable in an existing cluster, explicitly set the flag to + --workload-vulnerability-scanning=disabled. + + WORKLOAD_VULNERABILITY_SCANNING must be one of: disabled, standard. + Flags for Binary Authorization: --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE diff --git a/gcloud/alpha/container/clusters/update b/gcloud/alpha/container/clusters/update index 6bb2dad2b..f6e94b147 100644 --- a/gcloud/alpha/container/clusters/update +++ b/gcloud/alpha/container/clusters/update @@ -29,11 +29,16 @@ SYNOPSIS pubsub-topic=TOPIC,...] | --private-ipv6-google-access-type=PRIVATE_IPV6_GOOGLE_ACCESS_TYPE | --release-channel=CHANNEL | --remove-labels=[KEY,...] + | --remove-workload-policies=REMOVE_WORKLOAD_POLICIES | --security-group=SECURITY_GROUP + | --security-posture=SECURITY_POSTURE | --security-profile=SECURITY_PROFILE | --set-password | --stack-type=STACK_TYPE | --start-credential-rotation | --start-ip-rotation | --update-addons=[ADDON=ENABLED|DISABLED,...] - | --update-labels=[KEY=VALUE,...] | --workload-pool=WORKLOAD_POOL + | --update-labels=[KEY=VALUE,...] + | --workload-policies=WORKLOAD_POLICIES + | --workload-pool=WORKLOAD_POOL + | --workload-vulnerability-scanning=WORKLOAD_VULNERABILITY_SCANNING | --additional-pod-ipv4-ranges=NAME,[NAME,...] --remove-additional-pod-ipv4-ranges=NAME,[NAME,...] | --additional-zones=[ZONE,...] | --node-locations=ZONE,[ZONE,...] @@ -499,6 +504,16 @@ REQUIRED FLAGS $ gcloud alpha container clusters update example-cluster \ --remove-labels=label_a,label_b + --remove-workload-policies=REMOVE_WORKLOAD_POLICIES + Remove Autopilot workload policies from the cluster. + + Examples: + + $ gcloud alpha container clusters update example-cluster \ + --remove-workload-policies=allow-net-admin + + The only supported workload policy is 'allow-net-admin'. + --security-group=SECURITY_GROUP The name of the RBAC security group for use with Google security groups in Kubernetes RBAC @@ -510,6 +525,18 @@ REQUIRED FLAGS If unspecified, no groups will be returned for use with RBAC. + --security-posture=SECURITY_POSTURE + Sets the mode of the Kubernetes security posture API's off-cluster + features. + + To enable in standard mode explicitly set the flag to + --security-posture=standard + + To disable in an existing cluster, explicitly set the flag to + --security-posture=disabled. + + SECURITY_POSTURE must be one of: disabled, standard. + --security-profile=SECURITY_PROFILE Name and version of the security profile to be applied to the cluster. If not specified, the current setting of security profile @@ -570,6 +597,16 @@ REQUIRED FLAGS $ gcloud alpha container clusters update example-cluster \ --update-labels=label_a=value1,label_b=value2 + --workload-policies=WORKLOAD_POLICIES + Add Autopilot workload policies to the cluster. + + Examples: + + $ gcloud alpha container clusters update example-cluster \ + --workload-policies=allow-net-admin + + The only supported workload policy is 'allow-net-admin'. + --workload-pool=WORKLOAD_POOL Enable Workload Identity on the cluster. @@ -583,6 +620,18 @@ REQUIRED FLAGS https://cloud.google.com/kubernetes-engine/docs/how-to/workload-identity + --workload-vulnerability-scanning=WORKLOAD_VULNERABILITY_SCANNING + Sets the mode of the Kubernetes security posture API's workload + vulnerability scanning. + + To enable in standard mode explicitly set the flag to + --workload-vulnerability-scanning=standard. + + To disable in an existing cluster, explicitly set the flag to + --workload-vulnerability-scanning=disabled. + + WORKLOAD_VULNERABILITY_SCANNING must be one of: disabled, standard. + --additional-pod-ipv4-ranges=NAME,[NAME,...] Additional IP address ranges(by name) for pods that need to be added to the cluster. diff --git a/gcloud/alpha/container/node-pools/create b/gcloud/alpha/container/node-pools/create index da2068606..66c65e34e 100644 --- a/gcloud/alpha/container/node-pools/create +++ b/gcloud/alpha/container/node-pools/create @@ -5,6 +5,7 @@ NAME SYNOPSIS gcloud alpha container node-pools create NAME [--accelerator=[type=TYPE,[count=COUNT, + gpu-driver-version=GPU_DRIVER_VERSION, gpu-partition-size=GPU_PARTITION_SIZE, gpu-sharing-strategy=GPU_SHARING_STRATEGY, max-shared-clients-per-gpu=MAX_SHARED_CLIENTS_PER_GPU],...]] @@ -31,7 +32,9 @@ SYNOPSIS [--node-taints=[NODE_TAINT,...]] [--node-version=NODE_VERSION] [--num-nodes=NUM_NODES; default=3] [--placement-type=PLACEMENT_TYPE] [--preemptible] [--sandbox=[type=TYPE]] - [--shielded-integrity-monitoring] [--shielded-secure-boot] [--spot] + [--shielded-integrity-monitoring] [--shielded-secure-boot] + [--sole-tenant-node-affinity-file=SOLE_TENANT_NODE_AFFINITY_FILE] + [--spot] [--standard-rollout-policy=[batch-node-count=BATCH_NODE_COUNT, batch-percent=BATCH_NODE_PERCENTAGE, batch-soak-duration=BATCH_SOAK_DURATION,...]] @@ -82,7 +85,7 @@ POSITIONAL ARGUMENTS The name of the node pool to create. FLAGS - --accelerator=[type=TYPE,[count=COUNT,gpu-partition-size=GPU_PARTITION_SIZE,gpu-sharing-strategy=GPU_SHARING_STRATEGY,max-shared-clients-per-gpu=MAX_SHARED_CLIENTS_PER_GPU],...] + --accelerator=[type=TYPE,[count=COUNT,gpu-driver-version=GPU_DRIVER_VERSION,gpu-partition-size=GPU_PARTITION_SIZE,gpu-sharing-strategy=GPU_SHARING_STRATEGY,max-shared-clients-per-gpu=MAX_SHARED_CLIENTS_PER_GPU],...] Attaches accelerators (e.g. GPUs) to all nodes. type @@ -95,6 +98,20 @@ FLAGS (Optional) The number of accelerators to attach to the instances. The default value is 1. + gpu-driver-version + (Optional) The NVIDIA driver version to install. GPU_DRIVER_VERSION + must be one of: + + `default`: Install the default driver version. If you omit the flag `gpu-driver-version`, + this is the default option. + + `latest`: Install the latest available driver version. Available only for + nodes that use Container-Optimized OS. + + `disabled`: Skip automatic driver installation. You must [manually install a + driver](https://cloud.google.com/kubernetes-engine/docs/how-to/gpus#installing_drivers) + after you create the cluster. + gpu-partition-size (Optional) The GPU partition size used when running multi-instance GPUs. For information about multi-instance GPUs, refer to: @@ -487,6 +504,27 @@ FLAGS --shielded-secure-boot The instance will boot with secure boot enabled. + --sole-tenant-node-affinity-file=SOLE_TENANT_NODE_AFFINITY_FILE + JSON/YAML file containing the configuration of desired sole tenant + nodes onto which this node pool could be backed by. These rules filter + the nodes according to their node affinity labels. A node's affinity + labels come from the node template of the group the node is in. + + The file should contain a list of a JSON/YAML objects. For an example, + see + https://cloud.google.com/compute/docs/nodes/provisioning-sole-tenant-vms#configure_node_affinity_labels. + The following list describes the fields: + + key + Corresponds to the node affinity label keys of the Node resource. + operator + Specifies the node selection type. Must be one of: IN: Requires + Compute Engine to seek for matched nodes. NOT_IN: Requires Compute + Engine to avoid certain nodes. + values + Optional. A list of values which correspond to the node affinity + label values of the Node resource. + --spot Create nodes using spot VM instances in the new node pool. @@ -499,7 +537,7 @@ FLAGS --standard-rollout-policy=[batch-node-count=BATCH_NODE_COUNT,batch-percent=BATCH_NODE_PERCENTAGE,batch-soak-duration=BATCH_SOAK_DURATION,...] Standard rollout policy options for blue-green upgrade. - Batch sizes are specfied by one of, batch-node-count or batch-percent. + Batch sizes are specified by one of, batch-node-count or batch-percent. The duration between batches is specified by batch-soak-duration. $ gcloud alpha container node-pools create node-pool-1 \ diff --git a/gcloud/alpha/container/node-pools/update b/gcloud/alpha/container/node-pools/update index ff381fda8..a6acaffef 100644 --- a/gcloud/alpha/container/node-pools/update +++ b/gcloud/alpha/container/node-pools/update @@ -380,7 +380,7 @@ REQUIRED FLAGS --standard-rollout-policy=[batch-node-count=BATCH_NODE_COUNT,batch-percent=BATCH_NODE_PERCENTAGE,batch-soak-duration=BATCH_SOAK_DURATION,...] Standard rollout policy options for blue-green upgrade. - Batch sizes are specfied by one of, batch-node-count or + Batch sizes are specified by one of, batch-node-count or batch-percent. The duration between batches is specified by batch-soak-duration. diff --git a/gcloud/alpha/dataplex/datascan/create b/gcloud/alpha/dataplex/datascan/create index 745fecc4d..f5a7015b9 100644 --- a/gcloud/alpha/dataplex/datascan/create +++ b/gcloud/alpha/dataplex/datascan/create @@ -6,9 +6,10 @@ SYNOPSIS --scan-type=SCAN_TYPE (--data-source-entity=DATA_SOURCE_ENTITY | --data-source-resource=DATA_SOURCE_RESOURCE) - [--data-quality-spec-file=DATA_QUALITY_SPEC_FILE] [--description=DESCRIPTION] [--display-name=DISPLAY_NAME] [--labels=[KEY=VALUE,...]] [--async | --validate-only] + [--data-profile-spec-file=DATA_PROFILE_SPEC_FILE + | --data-quality-spec-file=DATA_QUALITY_SPEC_FILE] [--field=FIELD --on-demand=ON_DEMAND --schedule=SCHEDULE] [GCLOUD_WIDE_FLAG ...] @@ -76,14 +77,6 @@ REQUIRED FLAGS //bigquery.googleapis.com/projects/{project_number}/datasets/{dataset_id}/tables/{table_id}. OPTIONAL FLAGS - Additional configuration arguments for the scan. - - DataQualityScan related setting. - - --data-quality-spec-file=DATA_QUALITY_SPEC_FILE - path to the JSON file containing the Data Quality Spec for the Data - Quality Scan - --description=DESCRIPTION Description of the Datascan @@ -109,6 +102,22 @@ OPTIONAL FLAGS --validate-only Validate the create action, but don't actually perform it. + Additional configuration arguments for the scan. + + At most one of these can be specified: + + DataProfileScan related setting. + + --data-profile-spec-file=DATA_PROFILE_SPEC_FILE + path to the JSON file containing the Data Profile Spec for the Data + Profile Scan + + DataQualityScan related setting. + + --data-quality-spec-file=DATA_QUALITY_SPEC_FILE + path to the JSON file containing the Data Quality Spec for the Data + Quality Scan + Datascan execution settings. If not specified, the fields under it will use their default values. diff --git a/gcloud/alpha/dataplex/tasks/help b/gcloud/alpha/dataplex/tasks/help index 663987c76..97840f187 100644 --- a/gcloud/alpha/dataplex/tasks/help +++ b/gcloud/alpha/dataplex/tasks/help @@ -42,6 +42,9 @@ COMMANDS remove-iam-policy-binding (ALPHA) Remove IAM policy binding from a Dataplex task resource. + run + (ALPHA) Trigger one-time run of a Dataplex task. + set-iam-policy (ALPHA) Set the IAM policy to a Dataplex task as defined in a JSON or YAML file. diff --git a/gcloud/alpha/dataplex/tasks/run b/gcloud/alpha/dataplex/tasks/run new file mode 100644 index 000000000..6d1e15cf9 --- /dev/null +++ b/gcloud/alpha/dataplex/tasks/run @@ -0,0 +1,90 @@ +NAME + gcloud alpha dataplex tasks run - trigger one-time run of a Dataplex task + +SYNOPSIS + gcloud alpha dataplex tasks run (TASK : --lake=LAKE --location=LOCATION) + [--labels=[KEY=VALUE,...]] [GCLOUD_WIDE_FLAG ...] + [-- execution-spec-args ...] + +DESCRIPTION + (ALPHA) Trigger one-time run of a Dataplex task. + +EXAMPLES + To trigger a one-time run of a Dataplex task test-task within lake + test-lake in location us-central1, run: + + $ gcloud alpha dataplex tasks run test-task --location=us-central1 \ + --lake=test-lake + +POSITIONAL ARGUMENTS + Tasks resource - Arguments and flags that define the Dataplex task you + want to run. 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 task 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. + + TASK + ID of the tasks or fully qualified identifier for the tasks. + + To set the task attribute: + ▸ provide the argument task on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --lake=LAKE + The identifier of the Dataplex lake resource. + + To set the lake attribute: + ▸ provide the argument task on the command line with a fully + specified name; + ▸ provide the argument --lake on the command line. + + --location=LOCATION + The location of the Dataplex resource. + + To set the location attribute: + ▸ provide the argument task on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property dataplex/location. + + [-- execution-spec-args ...] + Execution spec arguments to pass to the driver. Follows the format + argKey=argValue. + + The '--' argument must be specified between gcloud specific args on the + left and execution-spec-args on the right. + +FLAGS + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud dataplex tasks run + diff --git a/gcloud/alpha/dataproc/clusters/help b/gcloud/alpha/dataproc/clusters/help index 642c016a4..41a1270c3 100644 --- a/gcloud/alpha/dataproc/clusters/help +++ b/gcloud/alpha/dataproc/clusters/help @@ -16,7 +16,7 @@ EXAMPLES To resize a cluster, run: $ gcloud alpha dataproc clusters update my-cluster \ - --region=us-central1 --num_workers 5 + --region=us-central1 --num-workers 5 To delete a cluster, run: diff --git a/gcloud/alpha/deploy/job-runs/terminate b/gcloud/alpha/deploy/job-runs/terminate index c8b820795..cb7b61f03 100644 --- a/gcloud/alpha/deploy/job-runs/terminate +++ b/gcloud/alpha/deploy/job-runs/terminate @@ -90,7 +90,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 deploy job-runs terminate $ gcloud beta deploy job-runs terminate diff --git a/gcloud/alpha/deploy/releases/create b/gcloud/alpha/deploy/releases/create index 986d327e1..3b6c638a2 100644 --- a/gcloud/alpha/deploy/releases/create +++ b/gcloud/alpha/deploy/releases/create @@ -5,7 +5,8 @@ NAME SYNOPSIS gcloud alpha deploy releases create (RELEASE : --delivery-pipeline=DELIVERY_PIPELINE --region=REGION) - [--annotations=[KEY=VALUE,...]] [--description=DESCRIPTION] + [--annotations=[KEY=VALUE,...]] [--deploy-parameters=[KEY=VALUE,...]] + [--description=DESCRIPTION] [--gcs-source-staging-dir=GCS_SOURCE_STAGING_DIR] [--ignore-file=IGNORE_FILE] [--labels=[KEY=VALUE,...]] [--skaffold-version=SKAFFOLD_VERSION] [--to-target=TO_TARGET] @@ -113,6 +114,17 @@ FLAGS $ gcloud alpha deploy releases create \ --annotations="from_target=test,status=stable" + --deploy-parameters=[KEY=VALUE,...] + Deployment parameters to apply to the release. Deployment parameters + take the form of key/value string pairs. + + Examples: + + Add deployment parameters: + + $ gcloud alpha deploy releases create \ + --deploy-parameters="key1=value1,key2=value2" + --description=DESCRIPTION Description of the release. diff --git a/gcloud/alpha/deploy/rollouts/advance b/gcloud/alpha/deploy/rollouts/advance index 4ba8c80b4..0cc0f4d5a 100644 --- a/gcloud/alpha/deploy/rollouts/advance +++ b/gcloud/alpha/deploy/rollouts/advance @@ -85,7 +85,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 deploy rollouts advance $ gcloud beta deploy rollouts advance diff --git a/gcloud/alpha/deploy/rollouts/cancel b/gcloud/alpha/deploy/rollouts/cancel index cf31380b3..9d5df72a9 100644 --- a/gcloud/alpha/deploy/rollouts/cancel +++ b/gcloud/alpha/deploy/rollouts/cancel @@ -80,7 +80,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 deploy rollouts cancel $ gcloud beta deploy rollouts cancel diff --git a/gcloud/alpha/deploy/rollouts/ignore-job b/gcloud/alpha/deploy/rollouts/ignore-job index e1eda03dc..0e4440f07 100644 --- a/gcloud/alpha/deploy/rollouts/ignore-job +++ b/gcloud/alpha/deploy/rollouts/ignore-job @@ -91,7 +91,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 deploy rollouts ignore-job $ gcloud beta deploy rollouts ignore-job diff --git a/gcloud/alpha/network-security/firewall-endpoint-associations/create b/gcloud/alpha/network-security/firewall-endpoint-associations/create index f9c845f96..a7e61de8e 100644 --- a/gcloud/alpha/network-security/firewall-endpoint-associations/create +++ b/gcloud/alpha/network-security/firewall-endpoint-associations/create @@ -9,7 +9,10 @@ SYNOPSIS : --endpoint-zone=ENDPOINT_ZONE --organization=ORGANIZATION) [--async] [--labels=[KEY=VALUE,...]] [--max-wait=MAX_WAIT; default="60m"] - [--tls-inspection-policy=TLS_INSPECTION_POLICY] [GCLOUD_WIDE_FLAG ...] + [--tls-inspection-policy=TLS_INSPECTION_POLICY + : --tls-inspection-policy-project=TLS_INSPECTION_POLICY_PROJECT + --tls-inspection-policy-region=TLS_INSPECTION_POLICY_REGION] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Associate the specified network with the firewall endpoint. @@ -135,9 +138,42 @@ OPTIONAL FLAGS specified. See $ gcloud topic datetimes for information on time formats. - --tls-inspection-policy=TLS_INSPECTION_POLICY - Path to TLS Inspection Policy configuration to use for intercepting - TLS-encrypted traffic in this network. + TLS Inspection Policy resource - Path to TLS Inspection Policy + configuration to use for intercepting TLS-encrypted traffic in this + network. The arguments in this group can be used to specify the attributes + of this resource. + + --tls-inspection-policy=TLS_INSPECTION_POLICY + ID of the TLS Inspection Policy or fully qualified identifier for the + TLS Inspection Policy. + + To set the tls_inspection_policy attribute: + ▸ provide the argument --tls-inspection-policy on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --tls-inspection-policy-project=TLS_INSPECTION_POLICY_PROJECT + Project of the TLS Inspection Policy. + + To set the tls-inspection-policy-project attribute: + ▸ provide the argument --tls-inspection-policy on the command line + with a fully specified name; + ▸ provide the argument --tls-inspection-policy-project on the + command line; + ▸ provide the argument --project on the command line; + ▸ provide the argument FIREWALL_ENDPOINT_ASSOCIATION on the command + line with a fully specified name. + + --tls-inspection-policy-region=TLS_INSPECTION_POLICY_REGION + Region of the TLS Inspection Policy. NOTE: TLS Inspection Policy + needs to be in the same region as Firewall Plus endpoint resource. + + To set the tls-inspection-policy-region attribute: + ▸ provide the argument --tls-inspection-policy on the command line + with a fully specified name; + ▸ provide the argument --tls-inspection-policy-region on the + command line. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/services/identity/create b/gcloud/alpha/services/identity/create index 57a18abb5..832430a6e 100644 --- a/gcloud/alpha/services/identity/create +++ b/gcloud/alpha/services/identity/create @@ -4,22 +4,54 @@ NAME SYNOPSIS gcloud alpha services identity create --service=SERVICE + [--folder=FOLDER | --organization=ORGANIZATION | --project=PROJECT_ID] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) This command creates a service identity for a consumer. The - supported consumers are projects. + supported consumers are projects, folders, and organizations. EXAMPLES - To create a service identity for a project, run: + To create a service identity for a project, folder, or organization, run: $ gcloud alpha services identity create \ --service=example.googleapis.com --project=helloworld + $ gcloud alpha services identity create \ + --service=example.googleapis.com --project=1234567890 + $ gcloud alpha services identity create \ + --service=example.googleapis.com --folder=1234567890 + $ gcloud alpha services identity create \ + --service=example.googleapis.com --organization=1234567890 REQUIRED FLAGS --service=SERVICE The service to create a service identity for. +OPTIONAL FLAGS + Container resource where the service identity will be used. + + At most one of these can be specified: + + --folder=FOLDER + Folder where the service identity will be used. + + --organization=ORGANIZATION + Organization where the service identity will be used. + + --project=PROJECT_ID + Project where the service identity will be used. + + The Google Cloud project ID to use for this invocation. If omitted, + then the current project is assumed; the current project can be + listed using gcloud config list --format='text(core.project)' and can + be set using gcloud config set project PROJECTID. + + --project and its fallback core/project property play two roles in + the invocation. It specifies the project of the resource to operate + on. It also specifies the project for API enablement check, quota, + and billing. To specify a different project for quota and billing, + use --billing-project or billing/quota_project property. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/spanner/databases/help b/gcloud/alpha/spanner/databases/help index 72e5d434c..52e28ff05 100644 --- a/gcloud/alpha/spanner/databases/help +++ b/gcloud/alpha/spanner/databases/help @@ -61,6 +61,9 @@ COMMANDS set-iam-policy (ALPHA) Set the IAM policy for a Cloud Spanner database. + update + (ALPHA) Update a Cloud Spanner database. + NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct diff --git a/gcloud/alpha/spanner/databases/update b/gcloud/alpha/spanner/databases/update new file mode 100644 index 000000000..94323ba19 --- /dev/null +++ b/gcloud/alpha/spanner/databases/update @@ -0,0 +1,83 @@ +NAME + gcloud alpha spanner databases update - update a Cloud Spanner database + +SYNOPSIS + gcloud alpha spanner databases update (DATABASE : --instance=INSTANCE) + [--async] [--[no-]enable-drop-protection] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Update a Cloud Spanner database. + +EXAMPLES + To enable database deletion protection on a Cloud Spanner database + 'my-database', run: + + $ gcloud alpha spanner databases update my-database \ + --enable-drop-protection + + To disable database deletion protection on a Cloud Spanner database + 'my-database', run: + + $ gcloud alpha spanner databases update my-database \ + --no-enable-drop-protection + +POSITIONAL ARGUMENTS + Database resource - The Cloud Spanner database 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 database 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. + + DATABASE + ID of the database or fully qualified identifier for the database. + + To set the database attribute: + ▸ provide the argument database on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --instance=INSTANCE + The Cloud Spanner instance for the database. + + To set the instance attribute: + ▸ provide the argument database on the command line with a fully + specified name; + ▸ provide the argument --instance on the command line; + ▸ set the property spanner/instance. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --[no-]enable-drop-protection + Enable database deletion protection on this database. Use + --enable-drop-protection to enable and --no-enable-drop-protection to + disable. + +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 spanner databases update + + $ gcloud beta spanner databases update + diff --git a/gcloud/alpha/sql/instances/clone b/gcloud/alpha/sql/instances/clone index 3814095ff..e341ad66b 100644 --- a/gcloud/alpha/sql/instances/clone +++ b/gcloud/alpha/sql/instances/clone @@ -6,7 +6,8 @@ SYNOPSIS [--allocated-ip-range-name=ALLOCATED_IP_RANGE_NAME] [--async] [--bin-log-file-name=BIN_LOG_FILE_NAME --bin-log-position=BIN_LOG_POSITION | [--point-in-time=POINT_IN_TIME - : --restore-database-name=RESTORE_DATABASE_NAME]] + : --preferred-zone=PREFERRED_ZONE + --restore-database-name=RESTORE_DATABASE_NAME]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -119,6 +120,10 @@ FLAGS This flag argument must be specified if any of the other arguments in this group are specified. + --preferred-zone=PREFERRED_ZONE + The preferred zone for the cloned instance. If set, the destination + instance will be created in this zone. + --restore-database-name=RESTORE_DATABASE_NAME The name of the database to be restored for a point-in-time restore. If set, the destination instance will only restore the specified diff --git a/gcloud/alpha/sql/instances/get-latest-recovery-time b/gcloud/alpha/sql/instances/get-latest-recovery-time new file mode 100644 index 000000000..424a2aadf --- /dev/null +++ b/gcloud/alpha/sql/instances/get-latest-recovery-time @@ -0,0 +1,43 @@ +NAME + gcloud alpha sql instances get-latest-recovery-time - displays the latest + recovery time to which a Cloud SQL instance can be restored to + +SYNOPSIS + gcloud alpha sql instances get-latest-recovery-time INSTANCE + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) gcloud alpha sql instances get-latest-recovery-time retrieves the + latest recovery time for a Cloud SQL instance. This is the latest time that + can be used to perform point in time recovery for the Cloud SQL instance. + + This is currently limited to PostgreSQL instances that are PITR enabled + with logs stored in cloud storage. + +EXAMPLES + To retrieve the latest recovery time for an instance: + + $ gcloud alpha sql instances get-latest-recovery-time instance-foo + +POSITIONAL ARGUMENTS + INSTANCE + Cloud SQL instance ID. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +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 sql instances get-latest-recovery-time + + $ gcloud beta sql instances get-latest-recovery-time + diff --git a/gcloud/alpha/sql/instances/help b/gcloud/alpha/sql/instances/help index 8c0d62008..40127eea5 100644 --- a/gcloud/alpha/sql/instances/help +++ b/gcloud/alpha/sql/instances/help @@ -41,6 +41,10 @@ COMMANDS failover (ALPHA) Causes a high-availability Cloud SQL instance to failover. + get-latest-recovery-time + (ALPHA) Displays the latest recovery time to which a Cloud SQL instance + can be restored to. + import (ALPHA) (DEPRECATED) Imports data into a Cloud SQL instance from Google Cloud Storage. diff --git a/gcloud/alpha/storage/help b/gcloud/alpha/storage/help index 02f83d581..a44cb3574 100644 --- a/gcloud/alpha/storage/help +++ b/gcloud/alpha/storage/help @@ -58,6 +58,10 @@ COMMANDS (ALPHA) Manage a project's Cloud Storage service agent, which is used to perform Cloud KMS operations. + sign-url + (ALPHA) Generate a URL with embedded authentication that can be used by + anyone. + NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct diff --git a/gcloud/alpha/storage/sign-url b/gcloud/alpha/storage/sign-url new file mode 100644 index 000000000..e355d718e --- /dev/null +++ b/gcloud/alpha/storage/sign-url @@ -0,0 +1,115 @@ +NAME + gcloud alpha storage sign-url - generate a URL with embedded authentication + that can be used by anyone + +SYNOPSIS + gcloud alpha storage sign-url URL [URL ...] + --private-key-file=PRIVATE_KEY_FILE + [--duration=DURATION, -d DURATION; default=3600] + [--headers=[KEY=VALUE,...]] + [--http-verb=HTTP_VERB, -m HTTP_VERB; default="GET"] + [--private-key-password=PRIVATE_KEY_PASSWORD, -p PRIVATE_KEY_PASSWORD] + [--query-params=[KEY=VALUE,...]] [--region=REGION, -r REGION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) gcloud alpha storage sign-url will generate a signed URL that + embeds authentication data so the URL can be used by someone who does not + have a Google account. Please see the Signed URLs documentation + (https://cloud.google.com/storage/docs/access-control/signed-urls) for + background about signed URLs. + + Note, gcloud alpha storage sign-url does not support operations on + sub-directories. For example, unless you have an object named + some-directory/ stored inside the bucket some-bucket, the following command + returns an error: gcloud alpha storage sign-url + gs://some-bucket/some-directory/. + +EXAMPLES + To create a signed url for downloading an object valid for 10 minutes: + + $ gcloud alpha storage sign-url gs://my-bucket/file.txt \ + --duration=10m --private-key-file=key.json + + To create a signed url that will bill to my-billing-project: + + $ gcloud alpha storage sign-url gs://my-bucket/file.txt \ + --query-params=userProject=my-billing-project \ + --private-key-file=key.json + + To create a signed url, valid for one hour, for uploading a plain text file + via HTTP PUT: + + $ gcloud alpha storage sign-url gs://my-bucket/file.txt \ + --http-verb=PUT --duration=1h \ + --headers=content-type=text/plain --private-key-file=key.json + + To create a signed URL that initiates a resumable upload for a plain text + file: + + $ gcloud alpha storage sign-url gs://my-bucket/file.txt \ + --http-verb=POST \ + --headers=x-goog-resumable=start,content-type=text/plain \ + --private-key-file=key.json + +POSITIONAL ARGUMENTS + URL [URL ...] + The URLs to be signed. May contain wildcards. + +REQUIRED FLAGS + --private-key-file=PRIVATE_KEY_FILE + The service account private key used to generate the cryptographic + signature for the generated URL. Must be in PKCS12 or JSON format. If + encrypted, will prompt for the passphrase used to protect the private + key file (default notasecret). + +OPTIONAL FLAGS + --duration=DURATION, -d DURATION; default=3600 + Specifies the duration that the signed url should be valid for, default + duration is 1 hour. For example 10s for 10 seconds. See $ gcloud topic + datetimes for information on duration formats. + + The max duration allowed is 7 days when PRIVATE_KEY_FILE is used. + + --headers=[KEY=VALUE,...] + Specifies the headers to be used in the signed request. Possible + headers are listed in the XML API's documentation: + https://cloud.google.com/storage/docs/xml-api/reference-headers#headers + + --http-verb=HTTP_VERB, -m HTTP_VERB; default="GET" + Specifies the HTTP verb to be authorized for use with the signed URL, + default is GET. When using a signed URL to start a resumable upload + session, you will need to specify the x-goog-resumable:start header in + the request or else signature validation will fail. + + --private-key-password=PRIVATE_KEY_PASSWORD, -p PRIVATE_KEY_PASSWORD + Specifies the private key password instead of prompting. + + --query-params=[KEY=VALUE,...] + Specifies the query parameters to be used in the signed request. + Possible query parameters are listed in the XML API's documentation: + https://cloud.google.com/storage/docs/xml-api/reference-headers#query + + --region=REGION, -r REGION + Specifies the region in which the resources for which you are creating + signed URLs are stored. + + Default value is auto which will cause gcloud alpha storage sign-url to + fetch the region for the resource. When auto-detecting the region, the + current user's credentials, not the credentials from PRIVATE_KEY_FILE, + are used to fetch the bucket's metadata. + +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/workstations/clusters/create b/gcloud/alpha/workstations/clusters/create index f42ae8f51..64a44c804 100644 --- a/gcloud/alpha/workstations/clusters/create +++ b/gcloud/alpha/workstations/clusters/create @@ -92,7 +92,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 workstations clusters create $ gcloud beta workstations clusters create diff --git a/gcloud/alpha/workstations/clusters/delete b/gcloud/alpha/workstations/clusters/delete index 519456668..eaaf9b9e2 100644 --- a/gcloud/alpha/workstations/clusters/delete +++ b/gcloud/alpha/workstations/clusters/delete @@ -65,7 +65,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 workstations clusters delete $ gcloud beta workstations clusters delete diff --git a/gcloud/alpha/workstations/clusters/describe b/gcloud/alpha/workstations/clusters/describe index d9d74694b..61c2486bb 100644 --- a/gcloud/alpha/workstations/clusters/describe +++ b/gcloud/alpha/workstations/clusters/describe @@ -60,7 +60,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 workstations clusters describe $ gcloud beta workstations clusters describe diff --git a/gcloud/alpha/workstations/clusters/help b/gcloud/alpha/workstations/clusters/help index 744404da5..242b93e0a 100644 --- a/gcloud/alpha/workstations/clusters/help +++ b/gcloud/alpha/workstations/clusters/help @@ -32,7 +32,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 workstations clusters $ gcloud beta workstations clusters diff --git a/gcloud/alpha/workstations/clusters/list b/gcloud/alpha/workstations/clusters/list index 165dda5d2..d7854014a 100644 --- a/gcloud/alpha/workstations/clusters/list +++ b/gcloud/alpha/workstations/clusters/list @@ -76,7 +76,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 workstations clusters list $ gcloud beta workstations clusters list diff --git a/gcloud/alpha/workstations/configs/create b/gcloud/alpha/workstations/configs/create index 6979516ee..d8239c13e 100644 --- a/gcloud/alpha/workstations/configs/create +++ b/gcloud/alpha/workstations/configs/create @@ -284,7 +284,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 workstations configs create $ gcloud beta workstations configs create diff --git a/gcloud/alpha/workstations/configs/delete b/gcloud/alpha/workstations/configs/delete index 4034c2a4d..9f7c61267 100644 --- a/gcloud/alpha/workstations/configs/delete +++ b/gcloud/alpha/workstations/configs/delete @@ -75,7 +75,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 workstations configs delete $ gcloud beta workstations configs delete diff --git a/gcloud/alpha/workstations/configs/describe b/gcloud/alpha/workstations/configs/describe index 00f0af116..5e57a3f3d 100644 --- a/gcloud/alpha/workstations/configs/describe +++ b/gcloud/alpha/workstations/configs/describe @@ -68,7 +68,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 workstations configs describe $ gcloud beta workstations configs describe diff --git a/gcloud/alpha/workstations/configs/get-iam-policy b/gcloud/alpha/workstations/configs/get-iam-policy index 6e63ead49..e13488e74 100644 --- a/gcloud/alpha/workstations/configs/get-iam-policy +++ b/gcloud/alpha/workstations/configs/get-iam-policy @@ -102,7 +102,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 workstations configs get-iam-policy $ gcloud beta workstations configs get-iam-policy diff --git a/gcloud/alpha/workstations/configs/help b/gcloud/alpha/workstations/configs/help index f8abf5afc..0ad238bbc 100644 --- a/gcloud/alpha/workstations/configs/help +++ b/gcloud/alpha/workstations/configs/help @@ -41,7 +41,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 workstations configs $ gcloud beta workstations configs diff --git a/gcloud/alpha/workstations/configs/list b/gcloud/alpha/workstations/configs/list index bb91d5188..1ec2789ea 100644 --- a/gcloud/alpha/workstations/configs/list +++ b/gcloud/alpha/workstations/configs/list @@ -88,7 +88,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 workstations configs list $ gcloud beta workstations configs list diff --git a/gcloud/alpha/workstations/configs/set-iam-policy b/gcloud/alpha/workstations/configs/set-iam-policy index 6f7f7c3d5..67a3c8f07 100644 --- a/gcloud/alpha/workstations/configs/set-iam-policy +++ b/gcloud/alpha/workstations/configs/set-iam-policy @@ -82,7 +82,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 workstations configs set-iam-policy $ gcloud beta workstations configs set-iam-policy diff --git a/gcloud/alpha/workstations/configs/update b/gcloud/alpha/workstations/configs/update index 904d7ba7a..ab183013d 100644 --- a/gcloud/alpha/workstations/configs/update +++ b/gcloud/alpha/workstations/configs/update @@ -224,7 +224,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 workstations configs update $ gcloud beta workstations configs update diff --git a/gcloud/alpha/workstations/create b/gcloud/alpha/workstations/create index 63e3604c3..e69369f2e 100644 --- a/gcloud/alpha/workstations/create +++ b/gcloud/alpha/workstations/create @@ -87,7 +87,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 workstations create $ gcloud beta workstations create diff --git a/gcloud/alpha/workstations/delete b/gcloud/alpha/workstations/delete index cde2f6e02..220ac4928 100644 --- a/gcloud/alpha/workstations/delete +++ b/gcloud/alpha/workstations/delete @@ -83,7 +83,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 workstations delete $ gcloud beta workstations delete diff --git a/gcloud/alpha/workstations/describe b/gcloud/alpha/workstations/describe index 209c2d724..b77a7c757 100644 --- a/gcloud/alpha/workstations/describe +++ b/gcloud/alpha/workstations/describe @@ -78,7 +78,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud workstations describe $ gcloud beta workstations describe diff --git a/gcloud/alpha/workstations/get-iam-policy b/gcloud/alpha/workstations/get-iam-policy index 9efac4913..a099ed36a 100644 --- a/gcloud/alpha/workstations/get-iam-policy +++ b/gcloud/alpha/workstations/get-iam-policy @@ -111,7 +111,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 workstations get-iam-policy $ gcloud beta workstations get-iam-policy diff --git a/gcloud/alpha/workstations/help b/gcloud/alpha/workstations/help index f08ee314f..94eaad61b 100644 --- a/gcloud/alpha/workstations/help +++ b/gcloud/alpha/workstations/help @@ -62,7 +62,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 workstations $ gcloud beta workstations diff --git a/gcloud/alpha/workstations/list b/gcloud/alpha/workstations/list index a3bcf15b5..7a4ccbaa4 100644 --- a/gcloud/alpha/workstations/list +++ b/gcloud/alpha/workstations/list @@ -96,7 +96,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 workstations list $ gcloud beta workstations list diff --git a/gcloud/alpha/workstations/list-usable b/gcloud/alpha/workstations/list-usable index 914768e00..067aba847 100644 --- a/gcloud/alpha/workstations/list-usable +++ b/gcloud/alpha/workstations/list-usable @@ -92,7 +92,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 workstations list-usable $ gcloud beta workstations list-usable diff --git a/gcloud/alpha/workstations/set-iam-policy b/gcloud/alpha/workstations/set-iam-policy index d4aebdf34..adcb7f0aa 100644 --- a/gcloud/alpha/workstations/set-iam-policy +++ b/gcloud/alpha/workstations/set-iam-policy @@ -91,7 +91,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 workstations set-iam-policy $ gcloud beta workstations set-iam-policy diff --git a/gcloud/alpha/workstations/ssh b/gcloud/alpha/workstations/ssh index 30f32de10..6a71e37bf 100644 --- a/gcloud/alpha/workstations/ssh +++ b/gcloud/alpha/workstations/ssh @@ -104,7 +104,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 workstations ssh $ gcloud beta workstations ssh diff --git a/gcloud/alpha/workstations/start b/gcloud/alpha/workstations/start index 01f5413e9..dfcc6c9ad 100644 --- a/gcloud/alpha/workstations/start +++ b/gcloud/alpha/workstations/start @@ -79,7 +79,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 workstations start $ gcloud beta workstations start diff --git a/gcloud/alpha/workstations/start-tcp-tunnel b/gcloud/alpha/workstations/start-tcp-tunnel index a0a0f24bb..0eb9f817b 100644 --- a/gcloud/alpha/workstations/start-tcp-tunnel +++ b/gcloud/alpha/workstations/start-tcp-tunnel @@ -94,7 +94,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 workstations start-tcp-tunnel $ gcloud beta workstations start-tcp-tunnel diff --git a/gcloud/alpha/workstations/stop b/gcloud/alpha/workstations/stop index 4e89051e3..436f694c1 100644 --- a/gcloud/alpha/workstations/stop +++ b/gcloud/alpha/workstations/stop @@ -79,7 +79,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 workstations stop $ gcloud beta workstations stop diff --git a/gcloud/artifacts/repositories/create b/gcloud/artifacts/repositories/create index 464a5d8a9..76da96288 100644 --- a/gcloud/artifacts/repositories/create +++ b/gcloud/artifacts/repositories/create @@ -134,19 +134,19 @@ OPTIONAL FLAGS --remote-docker-repo=REMOTE_DOCKER_REPO (Docker only) Repo upstream for docker remote repository. - REMOTE_DOCKER_REPO must be one of: docker-hub, none. + REMOTE_DOCKER_REPO must be one of: [docker-hub]. --remote-mvn-repo=REMOTE_MVN_REPO (Maven only) Repo upstream for maven remote repository. REMOTE_MVN_REPO - must be one of: maven-central, none. + must be one of: [maven-central]. --remote-npm-repo=REMOTE_NPM_REPO - (npm only) Repo upstream for npm remote repository. REMOTE_NPM_REPO - must be one of: none, npmjs. + (Npm only) Repo upstream for npm remote repository. REMOTE_NPM_REPO + must be one of: [npmjs]. --remote-python-repo=REMOTE_PYTHON_REPO (Python only) Repo upstream for python remote repository. - REMOTE_PYTHON_REPO must be one of: none, pypi. + REMOTE_PYTHON_REPO must be one of: [pypi]. --remote-repo-config-desc=REMOTE_REPO_CONFIG_DESC The description for the remote repository config. diff --git a/gcloud/batch/jobs/submit b/gcloud/batch/jobs/submit index 076ed8d8a..09908fb3e 100644 --- a/gcloud/batch/jobs/submit +++ b/gcloud/batch/jobs/submit @@ -7,8 +7,8 @@ SYNOPSIS --container-entrypoint=CONTAINER_ENTRYPOINT --container-image-uri=CONTAINER_IMAGE_URI | --script-file-path=SCRIPT_FILE_PATH | --script-text=SCRIPT_TEXT) - [--machine-type=MACHINE_TYPE] [--priority=PRIORITY] - [--provisioning-model=PROVISIONING_MODEL] + [--job-prefix=JOB_PREFIX] [--machine-type=MACHINE_TYPE] + [--priority=PRIORITY] [--provisioning-model=PROVISIONING_MODEL] [--network=NETWORK --subnetwork=SUBNETWORK : --no-external-ip-address] [GCLOUD_WIDE_FLAG ...] @@ -119,6 +119,11 @@ REQUIRED FLAGS Text to run as first runnable in task spec. OPTIONAL FLAGS + --job-prefix=JOB_PREFIX + Specify the job prefix. A job ID in the format of job prefix + + %Y%m%d-%H%M%S will be generated. Note that job prefix cannot be + specified while JOB ID positional argument is specified. + --machine-type=MACHINE_TYPE Specify the Compute Engine machine type, for example, e2-standard-4. Currently only one machine type is supported. diff --git a/gcloud/beta/alloydb/instances/help b/gcloud/beta/alloydb/instances/help index bf7cedf56..318785633 100644 --- a/gcloud/beta/alloydb/instances/help +++ b/gcloud/beta/alloydb/instances/help @@ -32,6 +32,9 @@ COMMANDS failover (BETA) Failover an AlloyDB instance within a given cluster. + inject-fault + (BETA) Inject fault on an AlloyDB instance within a given cluster. + list (BETA) Lists AlloyDB instances in a given cluster. diff --git a/gcloud/beta/alloydb/instances/inject-fault b/gcloud/beta/alloydb/instances/inject-fault new file mode 100644 index 000000000..711444f68 --- /dev/null +++ b/gcloud/beta/alloydb/instances/inject-fault @@ -0,0 +1,57 @@ +NAME + gcloud beta alloydb instances inject-fault - inject fault on an AlloyDB + instance within a given cluster + +SYNOPSIS + gcloud beta alloydb instances inject-fault INSTANCE --cluster=CLUSTER + --fault-type=FAULT_TYPE --region=REGION [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Inject fault on an AlloyDB instance within a given cluster. + +EXAMPLES + To Inject fault on an instance, run: + + $ gcloud beta alloydb instances inject-fault my-instance \ + --cluster=my-cluster --region=us-central1 --fault-type=stop-vm + +POSITIONAL ARGUMENTS + INSTANCE + AlloyDB instance ID + +REQUIRED FLAGS + --cluster=CLUSTER + AlloyDB cluster ID + + --fault-type=FAULT_TYPE + Specifies fault type. FAULT_TYPE must be (only one value is supported): + + stop-vm + stop-vm fault type supports stopping the VM. + + --region=REGION + Regional location (e.g. asia-east1, us-east1). See the full list of + regions at https://cloud.google.com/sql/docs/instance-locations. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud alloydb instances inject-fault + + $ gcloud alpha alloydb instances inject-fault + diff --git a/gcloud/beta/batch/jobs/submit b/gcloud/beta/batch/jobs/submit index db6a8406a..09a38dbc8 100644 --- a/gcloud/beta/batch/jobs/submit +++ b/gcloud/beta/batch/jobs/submit @@ -7,8 +7,8 @@ SYNOPSIS --container-entrypoint=CONTAINER_ENTRYPOINT --container-image-uri=CONTAINER_IMAGE_URI | --script-file-path=SCRIPT_FILE_PATH | --script-text=SCRIPT_TEXT) - [--machine-type=MACHINE_TYPE] [--priority=PRIORITY] - [--provisioning-model=PROVISIONING_MODEL] + [--job-prefix=JOB_PREFIX] [--machine-type=MACHINE_TYPE] + [--priority=PRIORITY] [--provisioning-model=PROVISIONING_MODEL] [--network=NETWORK --subnetwork=SUBNETWORK : --no-external-ip-address] [GCLOUD_WIDE_FLAG ...] @@ -119,6 +119,11 @@ REQUIRED FLAGS Text to run as first runnable in task spec. OPTIONAL FLAGS + --job-prefix=JOB_PREFIX + Specify the job prefix. A job ID in the format of job prefix + + %Y%m%d-%H%M%S will be generated. Note that job prefix cannot be + specified while JOB ID positional argument is specified. + --machine-type=MACHINE_TYPE Specify the Compute Engine machine type, for example, e2-standard-4. Currently only one machine type is supported. diff --git a/gcloud/beta/beyondcorp/client-connector/gateways/create b/gcloud/beta/beyondcorp/client-connector/gateways/create index ee0e08ee1..c16e478a7 100644 --- a/gcloud/beta/beyondcorp/client-connector/gateways/create +++ b/gcloud/beta/beyondcorp/client-connector/gateways/create @@ -85,8 +85,5 @@ API REFERENCE API can be found at: https://cloud.google.com/ NOTES - This command is currently in beta and might change without notice. This - variant is also available: - - $ gcloud alpha beyondcorp client-connector gateways create + This command is currently in beta and might change without notice. diff --git a/gcloud/beta/beyondcorp/client-connector/gateways/delete b/gcloud/beta/beyondcorp/client-connector/gateways/delete index 61bc4de17..df6549d72 100644 --- a/gcloud/beta/beyondcorp/client-connector/gateways/delete +++ b/gcloud/beta/beyondcorp/client-connector/gateways/delete @@ -66,8 +66,5 @@ API REFERENCE API can be found at: https://cloud.google.com/ NOTES - This command is currently in beta and might change without notice. This - variant is also available: - - $ gcloud alpha beyondcorp client-connector gateways delete + This command is currently in beta and might change without notice. diff --git a/gcloud/beta/beyondcorp/client-connector/gateways/describe b/gcloud/beta/beyondcorp/client-connector/gateways/describe index 310911954..6fcd4cb58 100644 --- a/gcloud/beta/beyondcorp/client-connector/gateways/describe +++ b/gcloud/beta/beyondcorp/client-connector/gateways/describe @@ -61,8 +61,5 @@ API REFERENCE API can be found at: https://cloud.google.com/ NOTES - This command is currently in beta and might change without notice. This - variant is also available: - - $ gcloud alpha beyondcorp client-connector gateways describe + This command is currently in beta and might change without notice. diff --git a/gcloud/beta/beyondcorp/client-connector/gateways/get-iam-policy b/gcloud/beta/beyondcorp/client-connector/gateways/get-iam-policy index 9c03535ac..07949aa74 100644 --- a/gcloud/beta/beyondcorp/client-connector/gateways/get-iam-policy +++ b/gcloud/beta/beyondcorp/client-connector/gateways/get-iam-policy @@ -89,8 +89,5 @@ API REFERENCE API can be found at: https://cloud.google.com/ NOTES - This command is currently in beta and might change without notice. This - variant is also available: - - $ gcloud alpha beyondcorp client-connector gateways get-iam-policy + This command is currently in beta and might change without notice. diff --git a/gcloud/beta/beyondcorp/client-connector/gateways/help b/gcloud/beta/beyondcorp/client-connector/gateways/help index 06dfee098..0e5149c44 100644 --- a/gcloud/beta/beyondcorp/client-connector/gateways/help +++ b/gcloud/beta/beyondcorp/client-connector/gateways/help @@ -41,8 +41,5 @@ COMMANDS (BETA) Set the IAM policy for a BeyondCorp client gateway. NOTES - This command is currently in beta and might change without notice. This - variant is also available: - - $ gcloud alpha beyondcorp client-connector gateways + This command is currently in beta and might change without notice. diff --git a/gcloud/beta/beyondcorp/client-connector/gateways/list b/gcloud/beta/beyondcorp/client-connector/gateways/list index 290a42c3f..aa276a516 100644 --- a/gcloud/beta/beyondcorp/client-connector/gateways/list +++ b/gcloud/beta/beyondcorp/client-connector/gateways/list @@ -77,8 +77,5 @@ API REFERENCE API can be found at: https://cloud.google.com/ NOTES - This command is currently in beta and might change without notice. This - variant is also available: - - $ gcloud alpha beyondcorp client-connector gateways list + This command is currently in beta and might change without notice. diff --git a/gcloud/beta/beyondcorp/client-connector/gateways/set-iam-policy b/gcloud/beta/beyondcorp/client-connector/gateways/set-iam-policy index cc8a4f914..de264b109 100644 --- a/gcloud/beta/beyondcorp/client-connector/gateways/set-iam-policy +++ b/gcloud/beta/beyondcorp/client-connector/gateways/set-iam-policy @@ -69,8 +69,5 @@ API REFERENCE API can be found at: https://cloud.google.com/ NOTES - This command is currently in beta and might change without notice. This - variant is also available: - - $ gcloud alpha beyondcorp client-connector gateways set-iam-policy + This command is currently in beta and might change without notice. diff --git a/gcloud/beta/beyondcorp/client-connector/help b/gcloud/beta/beyondcorp/client-connector/help index 05e5aefbe..c0aa5929f 100644 --- a/gcloud/beta/beyondcorp/client-connector/help +++ b/gcloud/beta/beyondcorp/client-connector/help @@ -37,8 +37,5 @@ GROUPS (BETA) Create and manipulate BeyondCorp client connector services. NOTES - This command is currently in beta and might change without notice. This - variant is also available: - - $ gcloud alpha beyondcorp client-connector + This command is currently in beta and might change without notice. diff --git a/gcloud/beta/beyondcorp/client-connector/operations/describe b/gcloud/beta/beyondcorp/client-connector/operations/describe index cb6d31976..cacc4306a 100644 --- a/gcloud/beta/beyondcorp/client-connector/operations/describe +++ b/gcloud/beta/beyondcorp/client-connector/operations/describe @@ -62,8 +62,5 @@ API REFERENCE API can be found at: https://cloud.google.com/ NOTES - This command is currently in beta and might change without notice. This - variant is also available: - - $ gcloud alpha beyondcorp client-connector operations describe + This command is currently in beta and might change without notice. diff --git a/gcloud/beta/beyondcorp/client-connector/operations/help b/gcloud/beta/beyondcorp/client-connector/operations/help index 730e3d322..d974f321b 100644 --- a/gcloud/beta/beyondcorp/client-connector/operations/help +++ b/gcloud/beta/beyondcorp/client-connector/operations/help @@ -24,8 +24,5 @@ COMMANDS (BETA) List BeyondCorp client connector operations. NOTES - This command is currently in beta and might change without notice. This - variant is also available: - - $ gcloud alpha beyondcorp client-connector operations + This command is currently in beta and might change without notice. diff --git a/gcloud/beta/beyondcorp/client-connector/operations/list b/gcloud/beta/beyondcorp/client-connector/operations/list index 8928b0af8..4f576aa2e 100644 --- a/gcloud/beta/beyondcorp/client-connector/operations/list +++ b/gcloud/beta/beyondcorp/client-connector/operations/list @@ -78,8 +78,5 @@ API REFERENCE API can be found at: https://cloud.google.com/ NOTES - This command is currently in beta and might change without notice. This - variant is also available: - - $ gcloud alpha beyondcorp client-connector operations list + This command is currently in beta and might change without notice. diff --git a/gcloud/beta/beyondcorp/client-connector/services/create b/gcloud/beta/beyondcorp/client-connector/services/create index 80398fc2c..54b4b00dc 100644 --- a/gcloud/beta/beyondcorp/client-connector/services/create +++ b/gcloud/beta/beyondcorp/client-connector/services/create @@ -134,8 +134,5 @@ API REFERENCE API can be found at: https://cloud.google.com/ NOTES - This command is currently in beta and might change without notice. This - variant is also available: - - $ gcloud alpha beyondcorp client-connector services create + This command is currently in beta and might change without notice. diff --git a/gcloud/beta/beyondcorp/client-connector/services/delete b/gcloud/beta/beyondcorp/client-connector/services/delete index 9adff2ee6..cb8bce547 100644 --- a/gcloud/beta/beyondcorp/client-connector/services/delete +++ b/gcloud/beta/beyondcorp/client-connector/services/delete @@ -68,8 +68,5 @@ API REFERENCE API can be found at: https://cloud.google.com/ NOTES - This command is currently in beta and might change without notice. This - variant is also available: - - $ gcloud alpha beyondcorp client-connector services delete + This command is currently in beta and might change without notice. diff --git a/gcloud/beta/beyondcorp/client-connector/services/describe b/gcloud/beta/beyondcorp/client-connector/services/describe index 04251988b..52cb21ff5 100644 --- a/gcloud/beta/beyondcorp/client-connector/services/describe +++ b/gcloud/beta/beyondcorp/client-connector/services/describe @@ -62,8 +62,5 @@ API REFERENCE API can be found at: https://cloud.google.com/ NOTES - This command is currently in beta and might change without notice. This - variant is also available: - - $ gcloud alpha beyondcorp client-connector services describe + This command is currently in beta and might change without notice. diff --git a/gcloud/beta/beyondcorp/client-connector/services/get-iam-policy b/gcloud/beta/beyondcorp/client-connector/services/get-iam-policy index 28eb221c8..7425b8372 100644 --- a/gcloud/beta/beyondcorp/client-connector/services/get-iam-policy +++ b/gcloud/beta/beyondcorp/client-connector/services/get-iam-policy @@ -91,8 +91,5 @@ API REFERENCE API can be found at: https://cloud.google.com/ NOTES - This command is currently in beta and might change without notice. This - variant is also available: - - $ gcloud alpha beyondcorp client-connector services get-iam-policy + This command is currently in beta and might change without notice. diff --git a/gcloud/beta/beyondcorp/client-connector/services/help b/gcloud/beta/beyondcorp/client-connector/services/help index 46039288c..3b71ee820 100644 --- a/gcloud/beta/beyondcorp/client-connector/services/help +++ b/gcloud/beta/beyondcorp/client-connector/services/help @@ -46,8 +46,5 @@ COMMANDS (BETA) Update a BeyondCorp client connector service. NOTES - This command is currently in beta and might change without notice. This - variant is also available: - - $ gcloud alpha beyondcorp client-connector services + This command is currently in beta and might change without notice. diff --git a/gcloud/beta/beyondcorp/client-connector/services/list b/gcloud/beta/beyondcorp/client-connector/services/list index f406d8eb9..80673c98a 100644 --- a/gcloud/beta/beyondcorp/client-connector/services/list +++ b/gcloud/beta/beyondcorp/client-connector/services/list @@ -83,8 +83,5 @@ API REFERENCE API can be found at: https://cloud.google.com/ NOTES - This command is currently in beta and might change without notice. This - variant is also available: - - $ gcloud alpha beyondcorp client-connector services list + This command is currently in beta and might change without notice. diff --git a/gcloud/beta/beyondcorp/client-connector/services/set-iam-policy b/gcloud/beta/beyondcorp/client-connector/services/set-iam-policy index 81e3a4c1d..4243d50c6 100644 --- a/gcloud/beta/beyondcorp/client-connector/services/set-iam-policy +++ b/gcloud/beta/beyondcorp/client-connector/services/set-iam-policy @@ -72,8 +72,5 @@ API REFERENCE API can be found at: https://cloud.google.com/ NOTES - This command is currently in beta and might change without notice. This - variant is also available: - - $ gcloud alpha beyondcorp client-connector services set-iam-policy + This command is currently in beta and might change without notice. diff --git a/gcloud/beta/beyondcorp/client-connector/services/update b/gcloud/beta/beyondcorp/client-connector/services/update index 4b3bc898c..73a6b07b0 100644 --- a/gcloud/beta/beyondcorp/client-connector/services/update +++ b/gcloud/beta/beyondcorp/client-connector/services/update @@ -118,8 +118,5 @@ API REFERENCE API can be found at: https://cloud.google.com/ NOTES - This command is currently in beta and might change without notice. This - variant is also available: - - $ gcloud alpha beyondcorp client-connector services update + This command is currently in beta and might change without notice. diff --git a/gcloud/beta/compute/disks/bulk/create b/gcloud/beta/compute/disks/bulk/create index 67fd21b5d..4f8c437fe 100644 --- a/gcloud/beta/compute/disks/bulk/create +++ b/gcloud/beta/compute/disks/bulk/create @@ -81,8 +81,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud compute disks bulk create $ gcloud alpha compute disks bulk create diff --git a/gcloud/beta/compute/disks/bulk/help b/gcloud/beta/compute/disks/bulk/help index c58fffeb7..f4f5e2163 100644 --- a/gcloud/beta/compute/disks/bulk/help +++ b/gcloud/beta/compute/disks/bulk/help @@ -21,8 +21,10 @@ COMMANDS (BETA) Create multiple Compute Engine disks. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud compute disks bulk $ gcloud alpha compute disks bulk diff --git a/gcloud/beta/compute/disks/start-async-replication b/gcloud/beta/compute/disks/start-async-replication index 9fbddc70c..7807b9a4d 100644 --- a/gcloud/beta/compute/disks/start-async-replication +++ b/gcloud/beta/compute/disks/start-async-replication @@ -99,8 +99,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud compute disks start-async-replication $ gcloud alpha compute disks start-async-replication diff --git a/gcloud/beta/compute/disks/stop-async-replication b/gcloud/beta/compute/disks/stop-async-replication index 01c26999e..c090c3dd3 100644 --- a/gcloud/beta/compute/disks/stop-async-replication +++ b/gcloud/beta/compute/disks/stop-async-replication @@ -79,8 +79,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud compute disks stop-async-replication $ gcloud alpha compute disks stop-async-replication diff --git a/gcloud/beta/compute/disks/stop-group-async-replication b/gcloud/beta/compute/disks/stop-group-async-replication index 58dcddd22..97c9e3241 100644 --- a/gcloud/beta/compute/disks/stop-group-async-replication +++ b/gcloud/beta/compute/disks/stop-group-async-replication @@ -89,8 +89,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud compute disks stop-group-async-replication $ gcloud alpha compute disks stop-group-async-replication diff --git a/gcloud/beta/compute/instances/create b/gcloud/beta/compute/instances/create index 37cda3138..1dab67ad2 100644 --- a/gcloud/beta/compute/instances/create +++ b/gcloud/beta/compute/instances/create @@ -61,6 +61,10 @@ SYNOPSIS [--image-family-scope=IMAGE_FAMILY_SCOPE --image-project=IMAGE_PROJECT --image=IMAGE | --image-family=IMAGE_FAMILY | --source-snapshot=SOURCE_SNAPSHOT] + [--instance-kms-key=INSTANCE_KMS_KEY + : --instance-kms-keyring=INSTANCE_KMS_KEYRING + --instance-kms-location=INSTANCE_KMS_LOCATION + --instance-kms-project=INSTANCE_KMS_PROJECT] [--node=NODE | --node-affinity-file=NODE_AFFINITY_FILE | --node-group=NODE_GROUP] [--public-ptr | --no-public-ptr] [--public-ptr-domain=PUBLIC_PTR_DOMAIN | --no-public-ptr-domain] @@ -1059,6 +1063,44 @@ FLAGS ▸ https://compute.googleapis.com/compute/v1/projects/myproject/global/snapshots/snapshot ▸ snapshot + Key resource - The Cloud KMS (Key Management Service) cryptokey that will + be used to protect the instance. The arguments in this group can be used + to specify the attributes of this resource. + + --instance-kms-key=INSTANCE_KMS_KEY + ID of the key or fully qualified identifier for the key. + + To set the kms-key attribute: + ▸ provide the argument --instance-kms-key on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --instance-kms-keyring=INSTANCE_KMS_KEYRING + The KMS keyring of the key. + + To set the kms-keyring attribute: + ▸ provide the argument --instance-kms-key on the command line with + a fully specified name; + ▸ provide the argument --instance-kms-keyring on the command line. + + --instance-kms-location=INSTANCE_KMS_LOCATION + The Cloud location for the key. + + To set the kms-location attribute: + ▸ provide the argument --instance-kms-key on the command line with + a fully specified name; + ▸ provide the argument --instance-kms-location on the command line. + + --instance-kms-project=INSTANCE_KMS_PROJECT + The Cloud project for the key. + + To set the kms-project attribute: + ▸ provide the argument --instance-kms-key on the command line with + a fully specified name; + ▸ provide the argument --instance-kms-project on the command line; + ▸ set the property core/project. + Sole Tenancy. At most one of these can be specified: diff --git a/gcloud/beta/compute/resource-policies/create/disk-consistency-group b/gcloud/beta/compute/resource-policies/create/disk-consistency-group index e345420e2..5348dc4e3 100644 --- a/gcloud/beta/compute/resource-policies/create/disk-consistency-group +++ b/gcloud/beta/compute/resource-policies/create/disk-consistency-group @@ -52,8 +52,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud compute resource-policies create disk-consistency-group $ gcloud alpha compute resource-policies create \ disk-consistency-group diff --git a/gcloud/beta/compute/security-policies/rules/create b/gcloud/beta/compute/security-policies/rules/create index e4c95dfdc..a7120cfac 100644 --- a/gcloud/beta/compute/security-policies/rules/create +++ b/gcloud/beta/compute/security-policies/rules/create @@ -58,6 +58,8 @@ REQUIRED FLAGS allow Allows the request from HTTP(S) Load Balancing. + deny + Denies the request from TCP/SSL Proxy and Network Load Balancing. deny-403 Denies the request from HTTP(S) Load Balancing, with an HTTP response status code of 403. @@ -216,7 +218,7 @@ OPTIONAL FLAGS request is redirected, use the redirect options based on --exceed-redirect-type and --exceed-redirect-target below. EXCEED_ACTION must be one of: deny-403, deny-404, deny-429, deny-502, - redirect. + deny, redirect. --exceed-redirect-target=EXCEED_REDIRECT_TARGET URL target for the redirect action that is configured as the exceed diff --git a/gcloud/beta/compute/security-policies/rules/update b/gcloud/beta/compute/security-policies/rules/update index 859988578..3a6724565 100644 --- a/gcloud/beta/compute/security-policies/rules/update +++ b/gcloud/beta/compute/security-policies/rules/update @@ -58,6 +58,8 @@ FLAGS allow Allows the request from HTTP(S) Load Balancing. + deny + Denies the request from TCP/SSL Proxy and Network Load Balancing. deny-403 Denies the request from HTTP(S) Load Balancing, with an HTTP response status code of 403. @@ -167,7 +169,7 @@ FLAGS request is redirected, use the redirect options based on --exceed-redirect-type and --exceed-redirect-target below. EXCEED_ACTION must be one of: deny-403, deny-404, deny-429, deny-502, - redirect. + deny, redirect. --exceed-redirect-target=EXCEED_REDIRECT_TARGET URL target for the redirect action that is configured as the exceed diff --git a/gcloud/beta/compute/snapshots/create b/gcloud/beta/compute/snapshots/create index 83224f202..a56731a76 100644 --- a/gcloud/beta/compute/snapshots/create +++ b/gcloud/beta/compute/snapshots/create @@ -8,7 +8,7 @@ SYNOPSIS [--snapshot-type=SNAPSHOT_TYPE] [--source-disk=SOURCE_DISK] [--source-disk-key-file=FILE] [--source-instant-snapshot=SOURCE_INSTANT_SNAPSHOT] - [--storage-location=LOCATION] + [--source-instant-snapshot-key-file=FILE] [--storage-location=LOCATION] [--source-disk-region=SOURCE_DISK_REGION | --source-disk-zone=SOURCE_DISK_ZONE] [--source-instant-snapshot-region=SOURCE_INSTANT_SNAPSHOT_REGION @@ -92,6 +92,11 @@ FLAGS the full path to the source instant snapshot. For example: https://www.googleapis.com/compute/v1/projects/MY-PROJECT/zones/MY-ZONE/instantSnapshots/MY-INSTANT-SNAPSHOT + --source-instant-snapshot-key-file=FILE + Path to the customer-supplied encryption key of the source instant + snapshot. Required if the source instant snapshot is protected by a + customer-supplied encryption key. + --storage-location=LOCATION Google Cloud Storage location, either regional or multi-regional, where snapshot content is to be stored. If absent, a nearby regional or diff --git a/gcloud/beta/container/clusters/create b/gcloud/beta/container/clusters/create index 5b81f4149..d4b062a33 100644 --- a/gcloud/beta/container/clusters/create +++ b/gcloud/beta/container/clusters/create @@ -5,6 +5,7 @@ NAME SYNOPSIS gcloud beta container clusters create NAME [--accelerator=[type=TYPE,[count=COUNT, + gpu-driver-version=GPU_DRIVER_VERSION, gpu-partition-size=GPU_PARTITION_SIZE, gpu-sharing-strategy=GPU_SHARING_STRATEGY, max-shared-clients-per-gpu=MAX_SHARED_CLIENTS_PER_GPU],...]] @@ -57,12 +58,14 @@ SYNOPSIS [--private-endpoint-subnetwork=NAME] [--private-ipv6-google-access-type=PRIVATE_IPV6_GOOGLE_ACCESS_TYPE] [--release-channel=CHANNEL] [--security-group=SECURITY_GROUP] - [--services-ipv4-cidr=CIDR] [--services-secondary-range-name=NAME] + [--security-posture=SECURITY_POSTURE] [--services-ipv4-cidr=CIDR] + [--services-secondary-range-name=NAME] [--shielded-integrity-monitoring] [--shielded-secure-boot] [--spot] [--stack-type=STACK_TYPE] [--subnetwork=SUBNETWORK] [--system-config-from-file=SYSTEM_CONFIG_FROM_FILE] [--tags=TAG,[TAG,...]] [--threads-per-core=THREADS_PER_CORE] [--workload-metadata=WORKLOAD_METADATA] [--workload-pool=WORKLOAD_POOL] + [--workload-vulnerability-scanning=WORKLOAD_VULNERABILITY_SCANNING] [--additional-zones=ZONE,[ZONE,...] | --node-locations=ZONE,[ZONE,...]] [--binauthz-policy=BINAUTHZ_POLICY --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE @@ -130,7 +133,7 @@ POSITIONAL ARGUMENTS 40 characters. FLAGS - --accelerator=[type=TYPE,[count=COUNT,gpu-partition-size=GPU_PARTITION_SIZE,gpu-sharing-strategy=GPU_SHARING_STRATEGY,max-shared-clients-per-gpu=MAX_SHARED_CLIENTS_PER_GPU],...] + --accelerator=[type=TYPE,[count=COUNT,gpu-driver-version=GPU_DRIVER_VERSION,gpu-partition-size=GPU_PARTITION_SIZE,gpu-sharing-strategy=GPU_SHARING_STRATEGY,max-shared-clients-per-gpu=MAX_SHARED_CLIENTS_PER_GPU],...] Attaches accelerators (e.g. GPUs) to all nodes. type @@ -143,6 +146,20 @@ FLAGS (Optional) The number of accelerators to attach to the instances. The default value is 1. + gpu-driver-version + (Optional) The NVIDIA driver version to install. GPU_DRIVER_VERSION + must be one of: + + `default`: Install the default driver version. If you omit the flag `gpu-driver-version`, + this is the default option. + + `latest`: Install the latest available driver version. Available only for + nodes that use Container-Optimized OS. + + `disabled`: Skip automatic driver installation. You must [manually install a + driver](https://cloud.google.com/kubernetes-engine/docs/how-to/gpus#installing_drivers) + after you create the cluster. + gpu-partition-size (Optional) The GPU partition size used when running multi-instance GPUs. For information about multi-instance GPUs, refer to: @@ -963,6 +980,18 @@ FLAGS If unspecified, no groups will be returned for use with RBAC. + --security-posture=SECURITY_POSTURE + Sets the mode of the Kubernetes security posture API's off-cluster + features. + + To enable in standard mode explicitly set the flag to + --security-posture=standard + + To disable in an existing cluster, explicitly set the flag to + --security-posture=disabled. + + SECURITY_POSTURE must be one of: disabled, standard. + --services-ipv4-cidr=CIDR Set the IP range for the services IPs. @@ -1124,6 +1153,18 @@ FLAGS https://cloud.google.com/kubernetes-engine/docs/how-to/workload-identity + --workload-vulnerability-scanning=WORKLOAD_VULNERABILITY_SCANNING + Sets the mode of the Kubernetes security posture API's workload + vulnerability scanning. + + To enable in standard mode explicitly set the flag to + --workload-vulnerability-scanning=standard. + + To disable in an existing cluster, explicitly set the flag to + --workload-vulnerability-scanning=disabled. + + WORKLOAD_VULNERABILITY_SCANNING must be one of: disabled, standard. + At most one of these can be specified: --additional-zones=ZONE,[ZONE,...] diff --git a/gcloud/beta/container/clusters/create-auto b/gcloud/beta/container/clusters/create-auto index 6f926606e..5b739243a 100644 --- a/gcloud/beta/container/clusters/create-auto +++ b/gcloud/beta/container/clusters/create-auto @@ -17,8 +17,10 @@ SYNOPSIS [--logging=[COMPONENT,...]] [--monitoring=[COMPONENT,...]] [--network=NETWORK] [--private-endpoint-subnetwork=NAME] [--release-channel=CHANNEL] [--security-group=SECURITY_GROUP] - [--services-ipv4-cidr=CIDR] [--services-secondary-range-name=NAME] - [--subnetwork=SUBNETWORK] + [--security-posture=SECURITY_POSTURE] [--services-ipv4-cidr=CIDR] + [--services-secondary-range-name=NAME] [--subnetwork=SUBNETWORK] + [--workload-policies=WORKLOAD_POLICIES] + [--workload-vulnerability-scanning=WORKLOAD_VULNERABILITY_SCANNING] [--binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE --binauthz-policy=BINAUTHZ_POLICY] [--enable-master-authorized-networks @@ -269,6 +271,18 @@ FLAGS If unspecified, no groups will be returned for use with RBAC. + --security-posture=SECURITY_POSTURE + Sets the mode of the Kubernetes security posture API's off-cluster + features. + + To enable in standard mode explicitly set the flag to + --security-posture=standard + + To disable in an existing cluster, explicitly set the flag to + --security-posture=disabled. + + SECURITY_POSTURE must be one of: disabled, standard. + --services-ipv4-cidr=CIDR Set the IP range for the services IPs. @@ -297,6 +311,28 @@ FLAGS Cannot be used with the "--create-subnetwork" option. + --workload-policies=WORKLOAD_POLICIES + Add Autopilot workload policies to the cluster. + + Examples: + + $ gcloud beta container clusters create-auto example-cluster \ + --workload-policies=allow-net-admin + + The only supported workload policy is 'allow-net-admin'. + + --workload-vulnerability-scanning=WORKLOAD_VULNERABILITY_SCANNING + Sets the mode of the Kubernetes security posture API's workload + vulnerability scanning. + + To enable in standard mode explicitly set the flag to + --workload-vulnerability-scanning=standard. + + To disable in an existing cluster, explicitly set the flag to + --workload-vulnerability-scanning=disabled. + + WORKLOAD_VULNERABILITY_SCANNING must be one of: disabled, standard. + Flags for Binary Authorization: --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE diff --git a/gcloud/beta/container/clusters/update b/gcloud/beta/container/clusters/update index 138088cc1..e7bf186e3 100644 --- a/gcloud/beta/container/clusters/update +++ b/gcloud/beta/container/clusters/update @@ -29,10 +29,15 @@ SYNOPSIS pubsub-topic=TOPIC,...] | --private-ipv6-google-access-type=PRIVATE_IPV6_GOOGLE_ACCESS_TYPE | --release-channel=CHANNEL | --remove-labels=[KEY,...] - | --security-group=SECURITY_GROUP | --set-password + | --remove-workload-policies=REMOVE_WORKLOAD_POLICIES + | --security-group=SECURITY_GROUP + | --security-posture=SECURITY_POSTURE | --set-password | --stack-type=STACK_TYPE | --start-credential-rotation | --start-ip-rotation | --update-addons=[ADDON=ENABLED|DISABLED,...] - | --update-labels=[KEY=VALUE,...] | --workload-pool=WORKLOAD_POOL + | --update-labels=[KEY=VALUE,...] + | --workload-policies=WORKLOAD_POLICIES + | --workload-pool=WORKLOAD_POOL + | --workload-vulnerability-scanning=WORKLOAD_VULNERABILITY_SCANNING | --additional-pod-ipv4-ranges=NAME,[NAME,...] --remove-additional-pod-ipv4-ranges=NAME,[NAME,...] | --additional-zones=[ZONE,...] | --node-locations=ZONE,[ZONE,...] @@ -498,6 +503,16 @@ REQUIRED FLAGS $ gcloud beta container clusters update example-cluster \ --remove-labels=label_a,label_b + --remove-workload-policies=REMOVE_WORKLOAD_POLICIES + Remove Autopilot workload policies from the cluster. + + Examples: + + $ gcloud beta container clusters update example-cluster \ + --remove-workload-policies=allow-net-admin + + The only supported workload policy is 'allow-net-admin'. + --security-group=SECURITY_GROUP The name of the RBAC security group for use with Google security groups in Kubernetes RBAC @@ -509,6 +524,18 @@ REQUIRED FLAGS If unspecified, no groups will be returned for use with RBAC. + --security-posture=SECURITY_POSTURE + Sets the mode of the Kubernetes security posture API's off-cluster + features. + + To enable in standard mode explicitly set the flag to + --security-posture=standard + + To disable in an existing cluster, explicitly set the flag to + --security-posture=disabled. + + SECURITY_POSTURE must be one of: disabled, standard. + --set-password Set the basic auth password to the specified value, keeping the existing username. @@ -559,6 +586,16 @@ REQUIRED FLAGS $ gcloud beta container clusters update example-cluster \ --update-labels=label_a=value1,label_b=value2 + --workload-policies=WORKLOAD_POLICIES + Add Autopilot workload policies to the cluster. + + Examples: + + $ gcloud beta container clusters update example-cluster \ + --workload-policies=allow-net-admin + + The only supported workload policy is 'allow-net-admin'. + --workload-pool=WORKLOAD_POOL Enable Workload Identity on the cluster. @@ -572,6 +609,18 @@ REQUIRED FLAGS https://cloud.google.com/kubernetes-engine/docs/how-to/workload-identity + --workload-vulnerability-scanning=WORKLOAD_VULNERABILITY_SCANNING + Sets the mode of the Kubernetes security posture API's workload + vulnerability scanning. + + To enable in standard mode explicitly set the flag to + --workload-vulnerability-scanning=standard. + + To disable in an existing cluster, explicitly set the flag to + --workload-vulnerability-scanning=disabled. + + WORKLOAD_VULNERABILITY_SCANNING must be one of: disabled, standard. + --additional-pod-ipv4-ranges=NAME,[NAME,...] Additional IP address ranges(by name) for pods that need to be added to the cluster. diff --git a/gcloud/beta/container/node-pools/create b/gcloud/beta/container/node-pools/create index 65bfe2add..5fbaf7e1a 100644 --- a/gcloud/beta/container/node-pools/create +++ b/gcloud/beta/container/node-pools/create @@ -5,6 +5,7 @@ NAME SYNOPSIS gcloud beta container node-pools create NAME [--accelerator=[type=TYPE,[count=COUNT, + gpu-driver-version=GPU_DRIVER_VERSION, gpu-partition-size=GPU_PARTITION_SIZE, gpu-sharing-strategy=GPU_SHARING_STRATEGY, max-shared-clients-per-gpu=MAX_SHARED_CLIENTS_PER_GPU],...]] @@ -30,7 +31,9 @@ SYNOPSIS [--node-taints=[NODE_TAINT,...]] [--node-version=NODE_VERSION] [--num-nodes=NUM_NODES; default=3] [--placement-type=PLACEMENT_TYPE] [--preemptible] [--sandbox=[type=TYPE]] - [--shielded-integrity-monitoring] [--shielded-secure-boot] [--spot] + [--shielded-integrity-monitoring] [--shielded-secure-boot] + [--sole-tenant-node-affinity-file=SOLE_TENANT_NODE_AFFINITY_FILE] + [--spot] [--standard-rollout-policy=[batch-node-count=BATCH_NODE_COUNT, batch-percent=BATCH_NODE_PERCENTAGE, batch-soak-duration=BATCH_SOAK_DURATION,...]] @@ -79,7 +82,7 @@ POSITIONAL ARGUMENTS The name of the node pool to create. FLAGS - --accelerator=[type=TYPE,[count=COUNT,gpu-partition-size=GPU_PARTITION_SIZE,gpu-sharing-strategy=GPU_SHARING_STRATEGY,max-shared-clients-per-gpu=MAX_SHARED_CLIENTS_PER_GPU],...] + --accelerator=[type=TYPE,[count=COUNT,gpu-driver-version=GPU_DRIVER_VERSION,gpu-partition-size=GPU_PARTITION_SIZE,gpu-sharing-strategy=GPU_SHARING_STRATEGY,max-shared-clients-per-gpu=MAX_SHARED_CLIENTS_PER_GPU],...] Attaches accelerators (e.g. GPUs) to all nodes. type @@ -92,6 +95,20 @@ FLAGS (Optional) The number of accelerators to attach to the instances. The default value is 1. + gpu-driver-version + (Optional) The NVIDIA driver version to install. GPU_DRIVER_VERSION + must be one of: + + `default`: Install the default driver version. If you omit the flag `gpu-driver-version`, + this is the default option. + + `latest`: Install the latest available driver version. Available only for + nodes that use Container-Optimized OS. + + `disabled`: Skip automatic driver installation. You must [manually install a + driver](https://cloud.google.com/kubernetes-engine/docs/how-to/gpus#installing_drivers) + after you create the cluster. + gpu-partition-size (Optional) The GPU partition size used when running multi-instance GPUs. For information about multi-instance GPUs, refer to: @@ -471,6 +488,27 @@ FLAGS --shielded-secure-boot The instance will boot with secure boot enabled. + --sole-tenant-node-affinity-file=SOLE_TENANT_NODE_AFFINITY_FILE + JSON/YAML file containing the configuration of desired sole tenant + nodes onto which this node pool could be backed by. These rules filter + the nodes according to their node affinity labels. A node's affinity + labels come from the node template of the group the node is in. + + The file should contain a list of a JSON/YAML objects. For an example, + see + https://cloud.google.com/compute/docs/nodes/provisioning-sole-tenant-vms#configure_node_affinity_labels. + The following list describes the fields: + + key + Corresponds to the node affinity label keys of the Node resource. + operator + Specifies the node selection type. Must be one of: IN: Requires + Compute Engine to seek for matched nodes. NOT_IN: Requires Compute + Engine to avoid certain nodes. + values + Optional. A list of values which correspond to the node affinity + label values of the Node resource. + --spot Create nodes using spot VM instances in the new node pool. @@ -483,7 +521,7 @@ FLAGS --standard-rollout-policy=[batch-node-count=BATCH_NODE_COUNT,batch-percent=BATCH_NODE_PERCENTAGE,batch-soak-duration=BATCH_SOAK_DURATION,...] Standard rollout policy options for blue-green upgrade. - Batch sizes are specfied by one of, batch-node-count or batch-percent. + Batch sizes are specified by one of, batch-node-count or batch-percent. The duration between batches is specified by batch-soak-duration. $ gcloud beta container node-pools create example-cluster \ diff --git a/gcloud/beta/container/node-pools/update b/gcloud/beta/container/node-pools/update index 487e221a6..98229ae50 100644 --- a/gcloud/beta/container/node-pools/update +++ b/gcloud/beta/container/node-pools/update @@ -380,7 +380,7 @@ REQUIRED FLAGS --standard-rollout-policy=[batch-node-count=BATCH_NODE_COUNT,batch-percent=BATCH_NODE_PERCENTAGE,batch-soak-duration=BATCH_SOAK_DURATION,...] Standard rollout policy options for blue-green upgrade. - Batch sizes are specfied by one of, batch-node-count or + Batch sizes are specified by one of, batch-node-count or batch-percent. The duration between batches is specified by batch-soak-duration. diff --git a/gcloud/beta/dataflow/flex-template/build b/gcloud/beta/dataflow/flex-template/build index fdac6cb71..e528310a5 100644 --- a/gcloud/beta/dataflow/flex-template/build +++ b/gcloud/beta/dataflow/flex-template/build @@ -87,10 +87,10 @@ REQUIRED FLAGS --flex-template-base-image=FLEX_TEMPLATE_BASE_IMAGE Flex template base image to be used while building the container - image. Allowed choices are JAVA8, JAVA11 or gcr.io path of the - specific version of the base image. For JAVA8 and JAVA11 option, we - use the latest base image version to build the container. You can - also provide a specific version from this link + image. Allowed choices are JAVA8, JAVA11, JAVA17 or gcr.io path of + the specific version of the base image. For JAVA8, JAVA11 and JAVA17 + option, we use the latest base image version to build the container. + You can also provide a specific version from this link https://gcr.io/dataflow-templates-base/ This flag argument must be specified if any of the other arguments in diff --git a/gcloud/beta/dataproc/clusters/help b/gcloud/beta/dataproc/clusters/help index 0220cd580..583133ab6 100644 --- a/gcloud/beta/dataproc/clusters/help +++ b/gcloud/beta/dataproc/clusters/help @@ -16,7 +16,7 @@ EXAMPLES To resize a cluster, run: $ gcloud beta dataproc clusters update my-cluster \ - --region=us-central1 --num_workers 5 + --region=us-central1 --num-workers 5 To delete a cluster, run: diff --git a/gcloud/beta/deploy/job-runs/terminate b/gcloud/beta/deploy/job-runs/terminate index 07cec9baf..c6ed2e6f4 100644 --- a/gcloud/beta/deploy/job-runs/terminate +++ b/gcloud/beta/deploy/job-runs/terminate @@ -87,8 +87,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud deploy job-runs terminate $ gcloud alpha deploy job-runs terminate diff --git a/gcloud/beta/deploy/releases/create b/gcloud/beta/deploy/releases/create index 9cc94f1bd..ff0556df9 100644 --- a/gcloud/beta/deploy/releases/create +++ b/gcloud/beta/deploy/releases/create @@ -5,7 +5,8 @@ NAME SYNOPSIS gcloud beta deploy releases create (RELEASE : --delivery-pipeline=DELIVERY_PIPELINE --region=REGION) - [--annotations=[KEY=VALUE,...]] [--description=DESCRIPTION] + [--annotations=[KEY=VALUE,...]] [--deploy-parameters=[KEY=VALUE,...]] + [--description=DESCRIPTION] [--gcs-source-staging-dir=GCS_SOURCE_STAGING_DIR] [--ignore-file=IGNORE_FILE] [--labels=[KEY=VALUE,...]] [--skaffold-version=SKAFFOLD_VERSION] [--to-target=TO_TARGET] @@ -113,6 +114,17 @@ FLAGS $ gcloud beta deploy releases create \ --annotations="from_target=test,status=stable" + --deploy-parameters=[KEY=VALUE,...] + Deployment parameters to apply to the release. Deployment parameters + take the form of key/value string pairs. + + Examples: + + Add deployment parameters: + + $ gcloud beta deploy releases create \ + --deploy-parameters="key1=value1,key2=value2" + --description=DESCRIPTION Description of the release. diff --git a/gcloud/beta/deploy/rollouts/advance b/gcloud/beta/deploy/rollouts/advance index dbd505270..2638283f5 100644 --- a/gcloud/beta/deploy/rollouts/advance +++ b/gcloud/beta/deploy/rollouts/advance @@ -82,8 +82,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud deploy rollouts advance $ gcloud alpha deploy rollouts advance diff --git a/gcloud/beta/deploy/rollouts/cancel b/gcloud/beta/deploy/rollouts/cancel index dd466d2a0..8a061bb28 100644 --- a/gcloud/beta/deploy/rollouts/cancel +++ b/gcloud/beta/deploy/rollouts/cancel @@ -77,8 +77,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud deploy rollouts cancel $ gcloud alpha deploy rollouts cancel diff --git a/gcloud/beta/deploy/rollouts/ignore-job b/gcloud/beta/deploy/rollouts/ignore-job index 32f97b3f1..26f3bad12 100644 --- a/gcloud/beta/deploy/rollouts/ignore-job +++ b/gcloud/beta/deploy/rollouts/ignore-job @@ -88,8 +88,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud deploy rollouts ignore-job $ gcloud alpha deploy rollouts ignore-job diff --git a/gcloud/beta/netapp/volumes/replications/stop b/gcloud/beta/netapp/volumes/replications/stop index d85588812..250103918 100644 --- a/gcloud/beta/netapp/volumes/replications/stop +++ b/gcloud/beta/netapp/volumes/replications/stop @@ -4,8 +4,8 @@ NAME SYNOPSIS gcloud beta netapp volumes replications stop - (REPLICATION : --location=LOCATION) [--async] [--volume=VOLUME] - [GCLOUD_WIDE_FLAG ...] + (REPLICATION : --location=LOCATION) [--async] [--force] + [--volume=VOLUME] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Stop a Cloud NetApp Volume Replication @@ -66,6 +66,13 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + --force + Indicates whether to stop replication forcefully while data transfer is + in progress. Warning! if force is true, this will abort any current + transfers and can lead to data loss due to partial transfer. If force + is false, stop replication will fail while data transfer is in progress + and you will need to retry later. + Volume resource - The Volume that the Replication is based on This represents a Cloud resource. (NOTE) Some attributes are not given arguments in this group but can be set in other ways. diff --git a/gcloud/beta/services/identity/create b/gcloud/beta/services/identity/create index 37bc9eccc..97806be29 100644 --- a/gcloud/beta/services/identity/create +++ b/gcloud/beta/services/identity/create @@ -4,22 +4,54 @@ NAME SYNOPSIS gcloud beta services identity create --service=SERVICE + [--folder=FOLDER | --organization=ORGANIZATION | --project=PROJECT_ID] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) This command creates a service identity for a consumer. The - supported consumers are projects. + supported consumers are projects, folders, and organizations. EXAMPLES - To create a service identity for a project, run: + To create a service identity for a project, folder, or organization, run: $ gcloud beta services identity create \ --service=example.googleapis.com --project=helloworld + $ gcloud beta services identity create \ + --service=example.googleapis.com --project=1234567890 + $ gcloud beta services identity create \ + --service=example.googleapis.com --folder=1234567890 + $ gcloud beta services identity create \ + --service=example.googleapis.com --organization=1234567890 REQUIRED FLAGS --service=SERVICE The service to create a service identity for. +OPTIONAL FLAGS + Container resource where the service identity will be used. + + At most one of these can be specified: + + --folder=FOLDER + Folder where the service identity will be used. + + --organization=ORGANIZATION + Organization where the service identity will be used. + + --project=PROJECT_ID + Project where the service identity will be used. + + The Google Cloud project ID to use for this invocation. If omitted, + then the current project is assumed; the current project can be + listed using gcloud config list --format='text(core.project)' and can + be set using gcloud config set project PROJECTID. + + --project and its fallback core/project property play two roles in + the invocation. It specifies the project of the resource to operate + on. It also specifies the project for API enablement check, quota, + and billing. To specify a different project for quota and billing, + use --billing-project or billing/quota_project property. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/beta/spanner/databases/help b/gcloud/beta/spanner/databases/help index 0414c1908..dcc19894d 100644 --- a/gcloud/beta/spanner/databases/help +++ b/gcloud/beta/spanner/databases/help @@ -58,6 +58,9 @@ COMMANDS set-iam-policy (BETA) Set the IAM policy for a Cloud Spanner database. + update + (BETA) Update a Cloud Spanner database. + NOTES This command is currently in beta and might change without notice. These variants are also available: diff --git a/gcloud/beta/spanner/databases/update b/gcloud/beta/spanner/databases/update new file mode 100644 index 000000000..44ad035d6 --- /dev/null +++ b/gcloud/beta/spanner/databases/update @@ -0,0 +1,81 @@ +NAME + gcloud beta spanner databases update - update a Cloud Spanner database + +SYNOPSIS + gcloud beta spanner databases update (DATABASE : --instance=INSTANCE) + [--async] [--[no-]enable-drop-protection] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Update a Cloud Spanner database. + +EXAMPLES + To enable database deletion protection on a Cloud Spanner database + 'my-database', run: + + $ gcloud beta spanner databases update my-database \ + --enable-drop-protection + + To disable database deletion protection on a Cloud Spanner database + 'my-database', run: + + $ gcloud beta spanner databases update my-database \ + --no-enable-drop-protection + +POSITIONAL ARGUMENTS + Database resource - The Cloud Spanner database 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 database 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. + + DATABASE + ID of the database or fully qualified identifier for the database. + + To set the database attribute: + ▸ provide the argument database on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --instance=INSTANCE + The Cloud Spanner instance for the database. + + To set the instance attribute: + ▸ provide the argument database on the command line with a fully + specified name; + ▸ provide the argument --instance on the command line; + ▸ set the property spanner/instance. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --[no-]enable-drop-protection + Enable database deletion protection on this database. Use + --enable-drop-protection to enable and --no-enable-drop-protection to + disable. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud spanner databases update + + $ gcloud alpha spanner databases update + diff --git a/gcloud/beta/sql/instances/clone b/gcloud/beta/sql/instances/clone index 93ea2aed2..aa6c516a2 100644 --- a/gcloud/beta/sql/instances/clone +++ b/gcloud/beta/sql/instances/clone @@ -5,7 +5,8 @@ SYNOPSIS gcloud beta sql instances clone SOURCE DESTINATION [--async] [--bin-log-file-name=BIN_LOG_FILE_NAME --bin-log-position=BIN_LOG_POSITION | [--point-in-time=POINT_IN_TIME - : --restore-database-name=RESTORE_DATABASE_NAME]] + : --preferred-zone=PREFERRED_ZONE + --restore-database-name=RESTORE_DATABASE_NAME]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -105,6 +106,10 @@ FLAGS This flag argument must be specified if any of the other arguments in this group are specified. + --preferred-zone=PREFERRED_ZONE + The preferred zone for the cloned instance. If set, the destination + instance will be created in this zone. + --restore-database-name=RESTORE_DATABASE_NAME The name of the database to be restored for a point-in-time restore. If set, the destination instance will only restore the specified diff --git a/gcloud/beta/sql/instances/get-latest-recovery-time b/gcloud/beta/sql/instances/get-latest-recovery-time new file mode 100644 index 000000000..0f97bc76c --- /dev/null +++ b/gcloud/beta/sql/instances/get-latest-recovery-time @@ -0,0 +1,41 @@ +NAME + gcloud beta sql instances get-latest-recovery-time - displays the latest + recovery time to which a Cloud SQL instance can be restored to + +SYNOPSIS + gcloud beta sql instances get-latest-recovery-time INSTANCE + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) gcloud beta sql instances get-latest-recovery-time retrieves the + latest recovery time for a Cloud SQL instance. This is the latest time that + can be used to perform point in time recovery for the Cloud SQL instance. + + This is currently limited to PostgreSQL instances that are PITR enabled + with logs stored in cloud storage. + +EXAMPLES + To retrieve the latest recovery time for an instance: + + $ gcloud beta sql instances get-latest-recovery-time instance-foo + +POSITIONAL ARGUMENTS + INSTANCE + Cloud SQL instance ID. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud sql instances get-latest-recovery-time + + $ gcloud alpha sql instances get-latest-recovery-time + diff --git a/gcloud/beta/sql/instances/help b/gcloud/beta/sql/instances/help index 0d87220d9..c520cf873 100644 --- a/gcloud/beta/sql/instances/help +++ b/gcloud/beta/sql/instances/help @@ -35,6 +35,10 @@ COMMANDS failover (BETA) Causes a high-availability Cloud SQL instance to failover. + get-latest-recovery-time + (BETA) Displays the latest recovery time to which a Cloud SQL instance + can be restored to. + import (BETA) (DEPRECATED) Imports data into a Cloud SQL instance from Google Cloud Storage. diff --git a/gcloud/beta/workstations/clusters/create b/gcloud/beta/workstations/clusters/create index cdb844977..4e9abd1ba 100644 --- a/gcloud/beta/workstations/clusters/create +++ b/gcloud/beta/workstations/clusters/create @@ -89,8 +89,10 @@ API REFERENCE this API can be found at: https://cloud.google.com/workstations NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud workstations clusters create $ gcloud alpha workstations clusters create diff --git a/gcloud/beta/workstations/clusters/delete b/gcloud/beta/workstations/clusters/delete index f875ee9d4..fb8581fd3 100644 --- a/gcloud/beta/workstations/clusters/delete +++ b/gcloud/beta/workstations/clusters/delete @@ -62,8 +62,10 @@ API REFERENCE this API can be found at: https://cloud.google.com/workstations NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud workstations clusters delete $ gcloud alpha workstations clusters delete diff --git a/gcloud/beta/workstations/clusters/describe b/gcloud/beta/workstations/clusters/describe index b333c11da..183f38acd 100644 --- a/gcloud/beta/workstations/clusters/describe +++ b/gcloud/beta/workstations/clusters/describe @@ -57,8 +57,10 @@ API REFERENCE this API can be found at: https://cloud.google.com/workstations NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud workstations clusters describe $ gcloud alpha workstations clusters describe diff --git a/gcloud/beta/workstations/clusters/help b/gcloud/beta/workstations/clusters/help index 2a9bc411e..4fc5b1e11 100644 --- a/gcloud/beta/workstations/clusters/help +++ b/gcloud/beta/workstations/clusters/help @@ -29,8 +29,10 @@ COMMANDS (BETA) List workstation clusters. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud workstations clusters $ gcloud alpha workstations clusters diff --git a/gcloud/beta/workstations/clusters/list b/gcloud/beta/workstations/clusters/list index 7d7cd303d..e4de5a3f5 100644 --- a/gcloud/beta/workstations/clusters/list +++ b/gcloud/beta/workstations/clusters/list @@ -73,8 +73,10 @@ API REFERENCE this API can be found at: https://cloud.google.com/workstations NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud workstations clusters list $ gcloud alpha workstations clusters list diff --git a/gcloud/beta/workstations/configs/create b/gcloud/beta/workstations/configs/create index be6ba18a9..be661e001 100644 --- a/gcloud/beta/workstations/configs/create +++ b/gcloud/beta/workstations/configs/create @@ -281,8 +281,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud workstations configs create $ gcloud alpha workstations configs create diff --git a/gcloud/beta/workstations/configs/delete b/gcloud/beta/workstations/configs/delete index 5616138f9..77100caac 100644 --- a/gcloud/beta/workstations/configs/delete +++ b/gcloud/beta/workstations/configs/delete @@ -72,8 +72,10 @@ API REFERENCE this API can be found at: https://cloud.google.com/workstations NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud workstations configs delete $ gcloud alpha workstations configs delete diff --git a/gcloud/beta/workstations/configs/describe b/gcloud/beta/workstations/configs/describe index 6618dc29c..b27283a20 100644 --- a/gcloud/beta/workstations/configs/describe +++ b/gcloud/beta/workstations/configs/describe @@ -65,8 +65,10 @@ API REFERENCE this API can be found at: https://cloud.google.com/workstations NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud workstations configs describe $ gcloud alpha workstations configs describe diff --git a/gcloud/beta/workstations/configs/get-iam-policy b/gcloud/beta/workstations/configs/get-iam-policy index dbc56d219..eca0b5ca7 100644 --- a/gcloud/beta/workstations/configs/get-iam-policy +++ b/gcloud/beta/workstations/configs/get-iam-policy @@ -99,8 +99,10 @@ API REFERENCE this API can be found at: https://cloud.google.com/workstations NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud workstations configs get-iam-policy $ gcloud alpha workstations configs get-iam-policy diff --git a/gcloud/beta/workstations/configs/help b/gcloud/beta/workstations/configs/help index 8e16b0184..f827f7df3 100644 --- a/gcloud/beta/workstations/configs/help +++ b/gcloud/beta/workstations/configs/help @@ -38,8 +38,10 @@ COMMANDS (BETA) Updates a workstation configuration. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud workstations configs $ gcloud alpha workstations configs diff --git a/gcloud/beta/workstations/configs/list b/gcloud/beta/workstations/configs/list index 7dac157f0..8bc1c0780 100644 --- a/gcloud/beta/workstations/configs/list +++ b/gcloud/beta/workstations/configs/list @@ -84,8 +84,10 @@ API REFERENCE this API can be found at: https://cloud.google.com/workstations NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud workstations configs list $ gcloud alpha workstations configs list diff --git a/gcloud/beta/workstations/configs/set-iam-policy b/gcloud/beta/workstations/configs/set-iam-policy index 81d63a7e8..578108919 100644 --- a/gcloud/beta/workstations/configs/set-iam-policy +++ b/gcloud/beta/workstations/configs/set-iam-policy @@ -79,8 +79,10 @@ API REFERENCE this API can be found at: https://cloud.google.com/workstations NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud workstations configs set-iam-policy $ gcloud alpha workstations configs set-iam-policy diff --git a/gcloud/beta/workstations/configs/update b/gcloud/beta/workstations/configs/update index f71d5f0b2..48007711b 100644 --- a/gcloud/beta/workstations/configs/update +++ b/gcloud/beta/workstations/configs/update @@ -221,8 +221,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud workstations configs update $ gcloud alpha workstations configs update diff --git a/gcloud/beta/workstations/create b/gcloud/beta/workstations/create index 04c3a471d..aed15fde0 100644 --- a/gcloud/beta/workstations/create +++ b/gcloud/beta/workstations/create @@ -84,8 +84,10 @@ API REFERENCE this API can be found at: https://cloud.google.com/workstations NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud workstations create $ gcloud alpha workstations create diff --git a/gcloud/beta/workstations/delete b/gcloud/beta/workstations/delete index cedfe4f73..2ee8d6f28 100644 --- a/gcloud/beta/workstations/delete +++ b/gcloud/beta/workstations/delete @@ -80,8 +80,10 @@ API REFERENCE this API can be found at: https://cloud.google.com/workstations NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud workstations delete $ gcloud alpha workstations delete diff --git a/gcloud/beta/workstations/describe b/gcloud/beta/workstations/describe index 7e4bcf3ce..c9335c4ca 100644 --- a/gcloud/beta/workstations/describe +++ b/gcloud/beta/workstations/describe @@ -75,8 +75,10 @@ API REFERENCE this API can be found at: https://cloud.google.com/workstations NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud workstations describe $ gcloud alpha workstations describe diff --git a/gcloud/beta/workstations/get-iam-policy b/gcloud/beta/workstations/get-iam-policy index 24c570cec..ad2b1f31c 100644 --- a/gcloud/beta/workstations/get-iam-policy +++ b/gcloud/beta/workstations/get-iam-policy @@ -108,8 +108,10 @@ API REFERENCE this API can be found at: https://cloud.google.com/workstations NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud workstations get-iam-policy $ gcloud alpha workstations get-iam-policy diff --git a/gcloud/beta/workstations/help b/gcloud/beta/workstations/help index c7f03f656..f2e5e2350 100644 --- a/gcloud/beta/workstations/help +++ b/gcloud/beta/workstations/help @@ -59,8 +59,10 @@ COMMANDS (BETA) Stop a workstation. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud workstations $ gcloud alpha workstations diff --git a/gcloud/beta/workstations/list b/gcloud/beta/workstations/list index fbbe0fe08..5c129dcd4 100644 --- a/gcloud/beta/workstations/list +++ b/gcloud/beta/workstations/list @@ -93,8 +93,10 @@ API REFERENCE this API can be found at: https://cloud.google.com/workstations NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud workstations list $ gcloud alpha workstations list diff --git a/gcloud/beta/workstations/list-usable b/gcloud/beta/workstations/list-usable index d55442806..4e72a3ee6 100644 --- a/gcloud/beta/workstations/list-usable +++ b/gcloud/beta/workstations/list-usable @@ -89,8 +89,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud workstations list-usable $ gcloud alpha workstations list-usable diff --git a/gcloud/beta/workstations/set-iam-policy b/gcloud/beta/workstations/set-iam-policy index ad7818f38..784934a80 100644 --- a/gcloud/beta/workstations/set-iam-policy +++ b/gcloud/beta/workstations/set-iam-policy @@ -88,8 +88,10 @@ API REFERENCE this API can be found at: https://cloud.google.com/workstations NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud workstations set-iam-policy $ gcloud alpha workstations set-iam-policy diff --git a/gcloud/beta/workstations/ssh b/gcloud/beta/workstations/ssh index f02d8acb3..e2cb81aa2 100644 --- a/gcloud/beta/workstations/ssh +++ b/gcloud/beta/workstations/ssh @@ -101,8 +101,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud workstations ssh $ gcloud alpha workstations ssh diff --git a/gcloud/beta/workstations/start b/gcloud/beta/workstations/start index 6bea61233..f48c6b92e 100644 --- a/gcloud/beta/workstations/start +++ b/gcloud/beta/workstations/start @@ -76,8 +76,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud workstations start $ gcloud alpha workstations start diff --git a/gcloud/beta/workstations/start-tcp-tunnel b/gcloud/beta/workstations/start-tcp-tunnel index 88cd96d06..a13a94f49 100644 --- a/gcloud/beta/workstations/start-tcp-tunnel +++ b/gcloud/beta/workstations/start-tcp-tunnel @@ -91,8 +91,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud workstations start-tcp-tunnel $ gcloud alpha workstations start-tcp-tunnel diff --git a/gcloud/beta/workstations/stop b/gcloud/beta/workstations/stop index 3992d4105..07a4f5a74 100644 --- a/gcloud/beta/workstations/stop +++ b/gcloud/beta/workstations/stop @@ -76,8 +76,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud workstations stop $ gcloud alpha workstations stop diff --git a/gcloud/compute/disks/bulk/create b/gcloud/compute/disks/bulk/create new file mode 100644 index 000000000..a9d6f96b5 --- /dev/null +++ b/gcloud/compute/disks/bulk/create @@ -0,0 +1,88 @@ +NAME + gcloud compute disks bulk create - create multiple Compute Engine disks + +SYNOPSIS + gcloud compute disks bulk create + --source-consistency-group-policy=SOURCE_CONSISTENCY_GROUP_POLICY + (--region=REGION | --zone=ZONE) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + gcloud compute disks bulk create facilitates the creation of multiple + Compute Engine disks with a single command. This includes cloning a set of + Async PD secondary disks with the same consistency group policy. + +EXAMPLES + To consistently clone secondary disks with the same consistency group + policy + 'projects/example-project/regions/us-central1/resourcePolicies/example-group-policy' + to target zone 'us-central1-a', run: + + $ gcloud compute disks bulk create \ + --source-consistency-group-policy=projects/example-project/\ + regions/us-central1/resourcePolicies/example-group-policy \ + --zone=us-central1-a + +REQUIRED FLAGS + --source-consistency-group-policy=SOURCE_CONSISTENCY_GROUP_POLICY + URL of the source consistency group resource policy. The resource + policy is always the same region as the source disks. + + Exactly one of these must be specified: + + --region=REGION + Target region of the created disks, which currently must be the same + as the source region. If not specified, you might be prompted to + select a region (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/region property: + + $ gcloud config set compute/region REGION + + A list of regions can be fetched by running: + + $ gcloud compute regions list + + To unset the property, run: + + $ gcloud config unset compute/region + + Alternatively, the region can be stored in the environment variable + CLOUDSDK_COMPUTE_REGION. + + --zone=ZONE + Target zone of the created disks, which currently must be the same as + the source zone. If not specified and the compute/zone property isn't + set, you might be prompted to select a zone (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/zone property: + + $ gcloud config set compute/zone ZONE + + A list of zones can be fetched by running: + + $ gcloud compute zones list + + To unset the property, run: + + $ gcloud config unset compute/zone + + Alternatively, the zone can be stored in the environment variable + CLOUDSDK_COMPUTE_ZONE. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha compute disks bulk create + + $ gcloud beta compute disks bulk create + diff --git a/gcloud/compute/disks/bulk/help b/gcloud/compute/disks/bulk/help new file mode 100644 index 000000000..d39cda819 --- /dev/null +++ b/gcloud/compute/disks/bulk/help @@ -0,0 +1,28 @@ +NAME + gcloud compute disks bulk - manipulate multiple Compute Engine disks with + single command executions + +SYNOPSIS + gcloud compute disks bulk COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manipulate multiple Compute Engine disks with single command executions. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + Create multiple Compute Engine disks. + +NOTES + These variants are also available: + + $ gcloud alpha compute disks bulk + + $ gcloud beta compute disks bulk + diff --git a/gcloud/compute/disks/create b/gcloud/compute/disks/create index a56397b2d..31b102139 100644 --- a/gcloud/compute/disks/create +++ b/gcloud/compute/disks/create @@ -6,16 +6,20 @@ SYNOPSIS [--architecture=ARCHITECTURE] [--csek-key-file=FILE] [--description=DESCRIPTION] [--guest-os-features=[GUEST_OS_FEATURE,...]] [--labels=[KEY=VALUE,...]] - [--licenses=[LICENSE,...]] [--provisioned-iops=PROVISIONED_IOPS] + [--licenses=[LICENSE,...]] + [--primary-disk-project=PRIMARY_DISK_PROJECT] + [--provisioned-iops=PROVISIONED_IOPS] [--provisioned-throughput=PROVISIONED_THROUGHPUT] [--replica-zones=ZONE,ZONE] [--no-require-csek-key-create] [--resource-policies=[RESOURCE_POLICY,...]] [--size=SIZE] [--type=TYPE] [--image-family-scope=IMAGE_FAMILY_SCOPE --image-project=IMAGE_PROJECT --image=IMAGE - | --image-family=IMAGE_FAMILY | --source-disk=SOURCE_DISK - | --source-snapshot=SOURCE_SNAPSHOT] + | --image-family=IMAGE_FAMILY | --primary-disk=PRIMARY_DISK + | --source-disk=SOURCE_DISK | --source-snapshot=SOURCE_SNAPSHOT] [--kms-key=KMS_KEY : --kms-keyring=KMS_KEYRING --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT] + [--primary-disk-region=PRIMARY_DISK_REGION + | --primary-disk-zone=PRIMARY_DISK_ZONE] [--region=REGION | --zone=ZONE] [--source-disk-region=SOURCE_DISK_REGION | --source-disk-zone=SOURCE_DISK_ZONE] [GCLOUD_WIDE_FLAG ...] @@ -90,6 +94,9 @@ FLAGS added onto the created disks to indicate the licensing and billing policies. + --primary-disk-project=PRIMARY_DISK_PROJECT + Project of the primary disk for asynchronous replication. + --provisioned-iops=PROVISIONED_IOPS Provisioned IOPS of disk to create. Only for use with disks of type pd-extreme and hyperdisk-extreme. @@ -173,6 +180,10 @@ FLAGS practice to use --image-family when the latest version of an image is needed. + --primary-disk=PRIMARY_DISK + Primary disk for asynchronous replication. This flag is required when + creating a secondary disk. + --source-disk=SOURCE_DISK Source disk used to create the disk(s). It is safe to delete a source disk after a disk has been created from the source disk. To get a @@ -238,6 +249,18 @@ FLAGS ▸ provide the argument --kms-project on the command line; ▸ set the property core/project. + At most one of these can be specified: + + --primary-disk-region=PRIMARY_DISK_REGION + Region of the primary disk for asynchronous replication. The primary + and secondary disks must not be in the same region. Overrides the + default compute/region property value for this command invocation. + + --primary-disk-zone=PRIMARY_DISK_ZONE + Zone of the primary disk for asynchronous replication. The primary + and secondary disks must not be in the same region. Overrides the + default compute/zone property value for this command invocation. + At most one of these can be specified: --region=REGION diff --git a/gcloud/compute/disks/help b/gcloud/compute/disks/help index cfe32003f..31a4e8054 100644 --- a/gcloud/compute/disks/help +++ b/gcloud/compute/disks/help @@ -2,7 +2,7 @@ NAME gcloud compute disks - read and manipulate Compute Engine disks SYNOPSIS - gcloud compute disks COMMAND [GCLOUD_WIDE_FLAG ...] + gcloud compute disks GROUP | COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION Read and manipulate Compute Engine disks. @@ -18,6 +18,13 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. +GROUPS + GROUP is one of the following: + + bulk + Manipulate multiple Compute Engine disks with single command + executions. + COMMANDS COMMAND is one of the following: @@ -66,6 +73,15 @@ COMMANDS snapshot Create snapshots of Compute Engine persistent disks. + start-async-replication + Start asynchronous replication on a Compute Engine persistent disk. + + stop-async-replication + Stop async replication on a Compute Engine persistent disk. + + stop-group-async-replication + Consistently stops a group of asynchronously replicating disks. + update Update a Compute Engine persistent disk. diff --git a/gcloud/compute/disks/start-async-replication b/gcloud/compute/disks/start-async-replication new file mode 100644 index 000000000..60468e56b --- /dev/null +++ b/gcloud/compute/disks/start-async-replication @@ -0,0 +1,107 @@ +NAME + gcloud compute disks start-async-replication - start asynchronous + replication on a Compute Engine persistent disk + +SYNOPSIS + gcloud compute disks start-async-replication DISK_NAME + --secondary-disk=SECONDARY_DISK (--region=REGION | --zone=ZONE) + (--secondary-disk-region=SECONDARY_DISK_REGION + | --secondary-disk-zone=SECONDARY_DISK_ZONE) + [--secondary-disk-project=SECONDARY_DISK_PROJECT] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + gcloud compute disks start-async-replication starts async replication on a + Compute Engine persistent disk. This command must be invoked on the primary + disk and --secondary-disk must be provided. + +EXAMPLES + Start replication from the primary disk 'my-disk-1' in zone us-east1-a to + the secondary disk 'my-disk-2' in zone us-west1-a: + + $ gcloud compute disks start-async-replication my-disk-1 \ + --zone=us-east1-a --secondary-disk=my-disk-2 \ + --secondary-disk-zone=us-west1-a + +POSITIONAL ARGUMENTS + DISK_NAME + Name of the disk to operate on. + +REQUIRED FLAGS + --secondary-disk=SECONDARY_DISK + Secondary disk for asynchronous replication. This flag is required when + starting replication. + + Exactly one of these must be specified: + + --region=REGION + Region of the disk to operate on. If not specified, you might be + prompted to select a region (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/region property: + + $ gcloud config set compute/region REGION + + A list of regions can be fetched by running: + + $ gcloud compute regions list + + To unset the property, run: + + $ gcloud config unset compute/region + + Alternatively, the region can be stored in the environment variable + CLOUDSDK_COMPUTE_REGION. + + --zone=ZONE + Zone of the disk to operate on. If not specified and the compute/zone + property isn't set, you might be prompted to select a zone + (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/zone property: + + $ gcloud config set compute/zone ZONE + + A list of zones can be fetched by running: + + $ gcloud compute zones list + + To unset the property, run: + + $ gcloud config unset compute/zone + + Alternatively, the zone can be stored in the environment variable + CLOUDSDK_COMPUTE_ZONE. + + Exactly one of these must be specified: + + --secondary-disk-region=SECONDARY_DISK_REGION + Region of the secondary disk for asynchronous replication. Overrides + the default compute/region property value for this command + invocation. + + --secondary-disk-zone=SECONDARY_DISK_ZONE + Zone of the secondary disk for asynchronous replication. Overrides + the default compute/zone property value for this command invocation. + +SECONDARY DISK FLAGS + --secondary-disk-project=SECONDARY_DISK_PROJECT + Project of the secondary disk for asynchronous replication. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --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 compute disks start-async-replication + + $ gcloud beta compute disks start-async-replication + diff --git a/gcloud/compute/disks/stop-async-replication b/gcloud/compute/disks/stop-async-replication new file mode 100644 index 000000000..7f88a16a1 --- /dev/null +++ b/gcloud/compute/disks/stop-async-replication @@ -0,0 +1,87 @@ +NAME + gcloud compute disks stop-async-replication - stop async replication on a + Compute Engine persistent disk + +SYNOPSIS + gcloud compute disks stop-async-replication DISK_NAME + [--region=REGION | --zone=ZONE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + gcloud compute disks stop-async-replication stops async replication on a + Compute Engine persistent disk. This command can be invoked either on the + primary or on the secondary disk. + +EXAMPLES + Stop replication on the primary disk 'my-disk-1' in zone us-east1-a: + + $ gcloud compute disks stop-async-replication my-disk-1 \ + --zone=us-east1-a + + Stop replication on the secondary disk 'my-disk-2' in zone us-west1-a: + + $ gcloud compute disks stop-async-replication my-disk-2 \ + --zone=us-west1-a + +POSITIONAL ARGUMENTS + DISK_NAME + Name of the disk to stop async replication. + +FLAGS + At most one of these can be specified: + + --region=REGION + Region of the disk to stop async replication. If not specified, you + might be prompted to select a region (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/region property: + + $ gcloud config set compute/region REGION + + A list of regions can be fetched by running: + + $ gcloud compute regions list + + To unset the property, run: + + $ gcloud config unset compute/region + + Alternatively, the region can be stored in the environment variable + CLOUDSDK_COMPUTE_REGION. + + --zone=ZONE + Zone of the disk to stop async replication. If not specified and the + compute/zone property isn't set, you might be prompted to select a + zone (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/zone property: + + $ gcloud config set compute/zone ZONE + + A list of zones can be fetched by running: + + $ gcloud compute zones list + + To unset the property, run: + + $ gcloud config unset compute/zone + + Alternatively, the zone can be stored in the environment variable + CLOUDSDK_COMPUTE_ZONE. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha compute disks stop-async-replication + + $ gcloud beta compute disks stop-async-replication + diff --git a/gcloud/compute/disks/stop-group-async-replication b/gcloud/compute/disks/stop-group-async-replication new file mode 100644 index 000000000..35286b8a6 --- /dev/null +++ b/gcloud/compute/disks/stop-group-async-replication @@ -0,0 +1,96 @@ +NAME + gcloud compute disks stop-group-async-replication - consistently stops a + group of asynchronously replicating disks + +SYNOPSIS + gcloud compute disks stop-group-async-replication + DISK_CONSISTENCY_GROUP_POLICY [--region=REGION | --zone=ZONE] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + gcloud compute disks stop-group-async-replication consistently stops a + group of asynchronously replicating disks. This command can be invoked in + either in the primary or secondary scope of the replicating disks. + +EXAMPLES + To stop group replication in the primary scope, include the zone or region + of the primary disks. The URL of the disk consistency group resource policy + always uses the region of the primary disks: + + $ gcloud compute disks stop-group-async-replication \ + projects/my-project/regions/us-west1/resourcePolicies/\ + my-policy --zone=us-west1-a + + Alternatively, you can stop replication in the secondary scope. Include the + region or zone of the secondary disks. The URL of the disk consistency + group resource policy always uses the region of the primary disks: + + $ gcloud compute disks stop-group-async-replication \ + projects/my-project/regions/us-west1/resourcePolicies/\ + my-policy --zone=us-west2-a + +POSITIONAL ARGUMENTS + DISK_CONSISTENCY_GROUP_POLICY + URL of the disk consistency group resource policy. The resourcepolicy + is always in the region of the primary disks. + +FLAGS + At most one of these can be specified: + + --region=REGION + Region of the consistency group's primary or secondary disks. If not + specified, you might be prompted to select a region (interactive mode + only). + + To avoid prompting when this flag is omitted, you can set the + compute/region property: + + $ gcloud config set compute/region REGION + + A list of regions can be fetched by running: + + $ gcloud compute regions list + + To unset the property, run: + + $ gcloud config unset compute/region + + Alternatively, the region can be stored in the environment variable + CLOUDSDK_COMPUTE_REGION. + + --zone=ZONE + Zone of the consistency group's primary or secondary disks. If not + specified and the compute/zone property isn't set, you might be + prompted to select a zone (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/zone property: + + $ gcloud config set compute/zone ZONE + + A list of zones can be fetched by running: + + $ gcloud compute zones list + + To unset the property, run: + + $ gcloud config unset compute/zone + + Alternatively, the zone can be stored in the environment variable + CLOUDSDK_COMPUTE_ZONE. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha compute disks stop-group-async-replication + + $ gcloud beta compute disks stop-group-async-replication + diff --git a/gcloud/compute/instances/bulk/create b/gcloud/compute/instances/bulk/create index 362aaff03..c0e14f53c 100644 --- a/gcloud/compute/instances/bulk/create +++ b/gcloud/compute/instances/bulk/create @@ -22,6 +22,7 @@ SYNOPSIS [--local-ssd=[device-name=DEVICE-NAME], [interface=INTERFACE],[size=SIZE]] [--location-policy=[ZONE=POLICY,...]] [--machine-type=MACHINE_TYPE] + [--max-count-per-zone=[ZONE=MAX_COUNT_PER_ZONE,...]] [--metadata=KEY=VALUE,[KEY=VALUE,...]] [--metadata-from-file=KEY=LOCAL_FILE_PATH,[...]] [--min-count=MIN_COUNT] [--min-cpu-platform=PLATFORM] @@ -454,6 +455,17 @@ OPTIONAL FLAGS available machine types, run 'gcloud compute machine-types list'. If unspecified, the default type is n1-standard-1. + --max-count-per-zone=[ZONE=MAX_COUNT_PER_ZONE,...] + Maximum number of instances per zone specified as key-value pairs. The + zone name is the key and the max count per zone is the value in that + zone. + + Example: + + gcloud compute instances bulk create --name-pattern=example-### + --count=5 --region=us-east1 + --max-count-per-zone=us-east1-b=2,us-east-1-c=1 + --metadata=KEY=VALUE,[KEY=VALUE,...] Metadata to be made available to the guest operating system running on the instances. Each metadata entry is a key/value pair separated by an diff --git a/gcloud/compute/resource-policies/create/disk-consistency-group b/gcloud/compute/resource-policies/create/disk-consistency-group new file mode 100644 index 000000000..7ea9a39fa --- /dev/null +++ b/gcloud/compute/resource-policies/create/disk-consistency-group @@ -0,0 +1,61 @@ +NAME + gcloud compute resource-policies create disk-consistency-group - create a + Compute Engine Disk Consistency Group resource policy + +SYNOPSIS + gcloud compute resource-policies create disk-consistency-group NAME + [--description=DESCRIPTION] [--region=REGION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create a Compute Engine disk consistency group resource policy. + +EXAMPLES + Create a disk consistency group policy: + + $ gcloud compute resource-policies create disk-consistency-group \ + my-resource-policy --region=REGION + +POSITIONAL ARGUMENTS + NAME + Name of the resource policy to operate on. + +FLAGS + --description=DESCRIPTION + An optional, textual description for the backend. + + --region=REGION + Region of the resource policy to operate on. If not specified, you + might be prompted to select a region (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/region property: + + $ gcloud config set compute/region REGION + + A list of regions can be fetched by running: + + $ gcloud compute regions list + + To unset the property, run: + + $ gcloud config unset compute/region + + Alternatively, the region can be stored in the environment variable + CLOUDSDK_COMPUTE_REGION. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha compute resource-policies create \ + disk-consistency-group + + $ gcloud beta compute resource-policies create disk-consistency-group + diff --git a/gcloud/compute/resource-policies/create/help b/gcloud/compute/resource-policies/create/help index 36ec6a96f..792742196 100644 --- a/gcloud/compute/resource-policies/create/help +++ b/gcloud/compute/resource-policies/create/help @@ -16,6 +16,9 @@ GCLOUD WIDE FLAGS COMMANDS COMMAND is one of the following: + disk-consistency-group + Create a Compute Engine Disk Consistency Group resource policy. + group-placement Create a Compute Engine group placement resource policy. diff --git a/gcloud/compute/security-policies/rules/create b/gcloud/compute/security-policies/rules/create index efc090035..c8d6f3401 100644 --- a/gcloud/compute/security-policies/rules/create +++ b/gcloud/compute/security-policies/rules/create @@ -47,6 +47,8 @@ REQUIRED FLAGS allow Allows the request from HTTP(S) Load Balancing. + deny + Denies the request from TCP/SSL Proxy and Network Load Balancing. deny-403 Denies the request from HTTP(S) Load Balancing, with an HTTP response status code of 403. @@ -168,7 +170,7 @@ OPTIONAL FLAGS request is redirected, use the redirect options based on --exceed-redirect-type and --exceed-redirect-target below. EXCEED_ACTION must be one of: deny-403, deny-404, deny-429, deny-502, - redirect. + deny, redirect. --exceed-redirect-target=EXCEED_REDIRECT_TARGET URL target for the redirect action that is configured as the exceed diff --git a/gcloud/compute/security-policies/rules/update b/gcloud/compute/security-policies/rules/update index e4c1d8f5e..1cf399698 100644 --- a/gcloud/compute/security-policies/rules/update +++ b/gcloud/compute/security-policies/rules/update @@ -48,6 +48,8 @@ FLAGS allow Allows the request from HTTP(S) Load Balancing. + deny + Denies the request from TCP/SSL Proxy and Network Load Balancing. deny-403 Denies the request from HTTP(S) Load Balancing, with an HTTP response status code of 403. @@ -157,7 +159,7 @@ FLAGS request is redirected, use the redirect options based on --exceed-redirect-type and --exceed-redirect-target below. EXCEED_ACTION must be one of: deny-403, deny-404, deny-429, deny-502, - redirect. + deny, redirect. --exceed-redirect-target=EXCEED_REDIRECT_TARGET URL target for the redirect action that is configured as the exceed diff --git a/gcloud/container/clusters/create b/gcloud/container/clusters/create index c6909e381..16da5c20a 100644 --- a/gcloud/container/clusters/create +++ b/gcloud/container/clusters/create @@ -4,6 +4,7 @@ NAME SYNOPSIS gcloud container clusters create NAME [--accelerator=[type=TYPE,[count=COUNT, + gpu-driver-version=GPU_DRIVER_VERSION, gpu-partition-size=GPU_PARTITION_SIZE, gpu-sharing-strategy=GPU_SHARING_STRATEGY, max-shared-clients-per-gpu=MAX_SHARED_CLIENTS_PER_GPU],...]] @@ -53,12 +54,14 @@ SYNOPSIS [--private-endpoint-subnetwork=NAME] [--private-ipv6-google-access-type=PRIVATE_IPV6_GOOGLE_ACCESS_TYPE] [--release-channel=CHANNEL] [--security-group=SECURITY_GROUP] - [--services-ipv4-cidr=CIDR] [--services-secondary-range-name=NAME] + [--security-posture=SECURITY_POSTURE] [--services-ipv4-cidr=CIDR] + [--services-secondary-range-name=NAME] [--shielded-integrity-monitoring] [--shielded-secure-boot] [--spot] [--stack-type=STACK_TYPE] [--subnetwork=SUBNETWORK] [--system-config-from-file=SYSTEM_CONFIG_FROM_FILE] [--tags=TAG,[TAG,...]] [--threads-per-core=THREADS_PER_CORE] [--workload-metadata=WORKLOAD_METADATA] [--workload-pool=WORKLOAD_POOL] + [--workload-vulnerability-scanning=WORKLOAD_VULNERABILITY_SCANNING] [--binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE | --enable-binauthz] [--cluster-dns=CLUSTER_DNS --cluster-dns-domain=CLUSTER_DNS_DOMAIN @@ -123,7 +126,7 @@ POSITIONAL ARGUMENTS 40 characters. FLAGS - --accelerator=[type=TYPE,[count=COUNT,gpu-partition-size=GPU_PARTITION_SIZE,gpu-sharing-strategy=GPU_SHARING_STRATEGY,max-shared-clients-per-gpu=MAX_SHARED_CLIENTS_PER_GPU],...] + --accelerator=[type=TYPE,[count=COUNT,gpu-driver-version=GPU_DRIVER_VERSION,gpu-partition-size=GPU_PARTITION_SIZE,gpu-sharing-strategy=GPU_SHARING_STRATEGY,max-shared-clients-per-gpu=MAX_SHARED_CLIENTS_PER_GPU],...] Attaches accelerators (e.g. GPUs) to all nodes. type @@ -136,6 +139,20 @@ FLAGS (Optional) The number of accelerators to attach to the instances. The default value is 1. + gpu-driver-version + (Optional) The NVIDIA driver version to install. GPU_DRIVER_VERSION + must be one of: + + `default`: Install the default driver version. If you omit the flag `gpu-driver-version`, + this is the default option. + + `latest`: Install the latest available driver version. Available only for + nodes that use Container-Optimized OS. + + `disabled`: Skip automatic driver installation. You must [manually install a + driver](https://cloud.google.com/kubernetes-engine/docs/how-to/gpus#installing_drivers) + after you create the cluster. + gpu-partition-size (Optional) The GPU partition size used when running multi-instance GPUs. For information about multi-instance GPUs, refer to: @@ -907,6 +924,18 @@ FLAGS If unspecified, no groups will be returned for use with RBAC. + --security-posture=SECURITY_POSTURE + Sets the mode of the Kubernetes security posture API's off-cluster + features. + + To enable in standard mode explicitly set the flag to + --security-posture=standard + + To disable in an existing cluster, explicitly set the flag to + --security-posture=disabled. + + SECURITY_POSTURE must be one of: disabled, standard. + --services-ipv4-cidr=CIDR Set the IP range for the services IPs. @@ -1049,6 +1078,18 @@ FLAGS https://cloud.google.com/kubernetes-engine/docs/how-to/workload-identity + --workload-vulnerability-scanning=WORKLOAD_VULNERABILITY_SCANNING + Sets the mode of the Kubernetes security posture API's workload + vulnerability scanning. + + To enable in standard mode explicitly set the flag to + --workload-vulnerability-scanning=standard. + + To disable in an existing cluster, explicitly set the flag to + --workload-vulnerability-scanning=disabled. + + WORKLOAD_VULNERABILITY_SCANNING must be one of: disabled, standard. + Flags for Binary Authorization: At most one of these can be specified: diff --git a/gcloud/container/clusters/create-auto b/gcloud/container/clusters/create-auto index 287da5489..52161befe 100644 --- a/gcloud/container/clusters/create-auto +++ b/gcloud/container/clusters/create-auto @@ -17,8 +17,10 @@ SYNOPSIS [--enable-master-global-access] [--logging=[COMPONENT,...]] [--monitoring=[COMPONENT,...]] [--network=NETWORK] [--private-endpoint-subnetwork=NAME] [--release-channel=CHANNEL] - [--security-group=SECURITY_GROUP] [--services-ipv4-cidr=CIDR] - [--services-secondary-range-name=NAME] [--subnetwork=SUBNETWORK] + [--security-group=SECURITY_GROUP] [--security-posture=SECURITY_POSTURE] + [--services-ipv4-cidr=CIDR] [--services-secondary-range-name=NAME] + [--subnetwork=SUBNETWORK] [--workload-policies=WORKLOAD_POLICIES] + [--workload-vulnerability-scanning=WORKLOAD_VULNERABILITY_SCANNING] [--enable-master-authorized-networks --master-authorized-networks=NETWORK,[NETWORK,...]] [--enable-private-endpoint @@ -261,6 +263,18 @@ FLAGS If unspecified, no groups will be returned for use with RBAC. + --security-posture=SECURITY_POSTURE + Sets the mode of the Kubernetes security posture API's off-cluster + features. + + To enable in standard mode explicitly set the flag to + --security-posture=standard + + To disable in an existing cluster, explicitly set the flag to + --security-posture=disabled. + + SECURITY_POSTURE must be one of: disabled, standard. + --services-ipv4-cidr=CIDR Set the IP range for the services IPs. @@ -289,6 +303,28 @@ FLAGS Cannot be used with the "--create-subnetwork" option. + --workload-policies=WORKLOAD_POLICIES + Add Autopilot workload policies to the cluster. + + Examples: + + $ gcloud container clusters create-auto example-cluster \ + --workload-policies=allow-net-admin + + The only supported workload policy is 'allow-net-admin'. + + --workload-vulnerability-scanning=WORKLOAD_VULNERABILITY_SCANNING + Sets the mode of the Kubernetes security posture API's workload + vulnerability scanning. + + To enable in standard mode explicitly set the flag to + --workload-vulnerability-scanning=standard. + + To disable in an existing cluster, explicitly set the flag to + --workload-vulnerability-scanning=disabled. + + WORKLOAD_VULNERABILITY_SCANNING must be one of: disabled, standard. + Master Authorized Networks --enable-master-authorized-networks diff --git a/gcloud/container/clusters/update b/gcloud/container/clusters/update index 52d074fc8..9dadbe2b8 100644 --- a/gcloud/container/clusters/update +++ b/gcloud/container/clusters/update @@ -26,10 +26,15 @@ SYNOPSIS pubsub-topic=TOPIC,...] | --private-ipv6-google-access-type=PRIVATE_IPV6_GOOGLE_ACCESS_TYPE | --release-channel=CHANNEL | --remove-labels=[KEY,...] - | --security-group=SECURITY_GROUP | --set-password + | --remove-workload-policies=REMOVE_WORKLOAD_POLICIES + | --security-group=SECURITY_GROUP + | --security-posture=SECURITY_POSTURE | --set-password | --stack-type=STACK_TYPE | --start-credential-rotation | --start-ip-rotation | --update-addons=[ADDON=ENABLED|DISABLED,...] - | --update-labels=[KEY=VALUE,...] | --workload-pool=WORKLOAD_POOL + | --update-labels=[KEY=VALUE,...] + | --workload-policies=WORKLOAD_POLICIES + | --workload-pool=WORKLOAD_POOL + | --workload-vulnerability-scanning=WORKLOAD_VULNERABILITY_SCANNING | --additional-pod-ipv4-ranges=NAME,[NAME,...] --remove-additional-pod-ipv4-ranges=NAME,[NAME,...] | --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE @@ -455,6 +460,16 @@ REQUIRED FLAGS $ gcloud container clusters update example-cluster \ --remove-labels=label_a,label_b + --remove-workload-policies=REMOVE_WORKLOAD_POLICIES + Remove Autopilot workload policies from the cluster. + + Examples: + + $ gcloud container clusters update example-cluster \ + --remove-workload-policies=allow-net-admin + + The only supported workload policy is 'allow-net-admin'. + --security-group=SECURITY_GROUP The name of the RBAC security group for use with Google security groups in Kubernetes RBAC @@ -466,6 +481,18 @@ REQUIRED FLAGS If unspecified, no groups will be returned for use with RBAC. + --security-posture=SECURITY_POSTURE + Sets the mode of the Kubernetes security posture API's off-cluster + features. + + To enable in standard mode explicitly set the flag to + --security-posture=standard + + To disable in an existing cluster, explicitly set the flag to + --security-posture=disabled. + + SECURITY_POSTURE must be one of: disabled, standard. + --set-password Set the basic auth password to the specified value, keeping the existing username. @@ -514,6 +541,16 @@ REQUIRED FLAGS $ gcloud container clusters update example-cluster \ --update-labels=label_a=value1,label_b=value2 + --workload-policies=WORKLOAD_POLICIES + Add Autopilot workload policies to the cluster. + + Examples: + + $ gcloud container clusters update example-cluster \ + --workload-policies=allow-net-admin + + The only supported workload policy is 'allow-net-admin'. + --workload-pool=WORKLOAD_POOL Enable Workload Identity on the cluster. @@ -527,6 +564,18 @@ REQUIRED FLAGS https://cloud.google.com/kubernetes-engine/docs/how-to/workload-identity + --workload-vulnerability-scanning=WORKLOAD_VULNERABILITY_SCANNING + Sets the mode of the Kubernetes security posture API's workload + vulnerability scanning. + + To enable in standard mode explicitly set the flag to + --workload-vulnerability-scanning=standard. + + To disable in an existing cluster, explicitly set the flag to + --workload-vulnerability-scanning=disabled. + + WORKLOAD_VULNERABILITY_SCANNING must be one of: disabled, standard. + --additional-pod-ipv4-ranges=NAME,[NAME,...] Additional IP address ranges(by name) for pods that need to be added to the cluster. diff --git a/gcloud/container/node-pools/create b/gcloud/container/node-pools/create index 6c28ef812..18ab88591 100644 --- a/gcloud/container/node-pools/create +++ b/gcloud/container/node-pools/create @@ -5,6 +5,7 @@ NAME SYNOPSIS gcloud container node-pools create NAME [--accelerator=[type=TYPE,[count=COUNT, + gpu-driver-version=GPU_DRIVER_VERSION, gpu-partition-size=GPU_PARTITION_SIZE, gpu-sharing-strategy=GPU_SHARING_STRATEGY, max-shared-clients-per-gpu=MAX_SHARED_CLIENTS_PER_GPU],...]] @@ -30,7 +31,9 @@ SYNOPSIS [--node-taints=[NODE_TAINT,...]] [--node-version=NODE_VERSION] [--num-nodes=NUM_NODES; default=3] [--placement-type=PLACEMENT_TYPE] [--preemptible] [--sandbox=[type=TYPE]] - [--shielded-integrity-monitoring] [--shielded-secure-boot] [--spot] + [--shielded-integrity-monitoring] [--shielded-secure-boot] + [--sole-tenant-node-affinity-file=SOLE_TENANT_NODE_AFFINITY_FILE] + [--spot] [--standard-rollout-policy=[batch-node-count=BATCH_NODE_COUNT, batch-percent=BATCH_NODE_PERCENTAGE, batch-soak-duration=BATCH_SOAK_DURATION,...]] @@ -78,7 +81,7 @@ POSITIONAL ARGUMENTS The name of the node pool to create. FLAGS - --accelerator=[type=TYPE,[count=COUNT,gpu-partition-size=GPU_PARTITION_SIZE,gpu-sharing-strategy=GPU_SHARING_STRATEGY,max-shared-clients-per-gpu=MAX_SHARED_CLIENTS_PER_GPU],...] + --accelerator=[type=TYPE,[count=COUNT,gpu-driver-version=GPU_DRIVER_VERSION,gpu-partition-size=GPU_PARTITION_SIZE,gpu-sharing-strategy=GPU_SHARING_STRATEGY,max-shared-clients-per-gpu=MAX_SHARED_CLIENTS_PER_GPU],...] Attaches accelerators (e.g. GPUs) to all nodes. type @@ -91,6 +94,20 @@ FLAGS (Optional) The number of accelerators to attach to the instances. The default value is 1. + gpu-driver-version + (Optional) The NVIDIA driver version to install. GPU_DRIVER_VERSION + must be one of: + + `default`: Install the default driver version. If you omit the flag `gpu-driver-version`, + this is the default option. + + `latest`: Install the latest available driver version. Available only for + nodes that use Container-Optimized OS. + + `disabled`: Skip automatic driver installation. You must [manually install a + driver](https://cloud.google.com/kubernetes-engine/docs/how-to/gpus#installing_drivers) + after you create the cluster. + gpu-partition-size (Optional) The GPU partition size used when running multi-instance GPUs. For information about multi-instance GPUs, refer to: @@ -466,6 +483,27 @@ FLAGS --shielded-secure-boot The instance will boot with secure boot enabled. + --sole-tenant-node-affinity-file=SOLE_TENANT_NODE_AFFINITY_FILE + JSON/YAML file containing the configuration of desired sole tenant + nodes onto which this node pool could be backed by. These rules filter + the nodes according to their node affinity labels. A node's affinity + labels come from the node template of the group the node is in. + + The file should contain a list of a JSON/YAML objects. For an example, + see + https://cloud.google.com/compute/docs/nodes/provisioning-sole-tenant-vms#configure_node_affinity_labels. + The following list describes the fields: + + key + Corresponds to the node affinity label keys of the Node resource. + operator + Specifies the node selection type. Must be one of: IN: Requires + Compute Engine to seek for matched nodes. NOT_IN: Requires Compute + Engine to avoid certain nodes. + values + Optional. A list of values which correspond to the node affinity + label values of the Node resource. + --spot Create nodes using spot VM instances in the new node pool. @@ -478,7 +516,7 @@ FLAGS --standard-rollout-policy=[batch-node-count=BATCH_NODE_COUNT,batch-percent=BATCH_NODE_PERCENTAGE,batch-soak-duration=BATCH_SOAK_DURATION,...] Standard rollout policy options for blue-green upgrade. - Batch sizes are specfied by one of, batch-node-count or batch-percent. + Batch sizes are specified by one of, batch-node-count or batch-percent. The duration between batches is specified by batch-soak-duration. $ gcloud container node-pools create example-cluster \ diff --git a/gcloud/container/node-pools/update b/gcloud/container/node-pools/update index e8ffeec0b..ffcf378df 100644 --- a/gcloud/container/node-pools/update +++ b/gcloud/container/node-pools/update @@ -362,7 +362,7 @@ REQUIRED FLAGS --standard-rollout-policy=[batch-node-count=BATCH_NODE_COUNT,batch-percent=BATCH_NODE_PERCENTAGE,batch-soak-duration=BATCH_SOAK_DURATION,...] Standard rollout policy options for blue-green upgrade. - Batch sizes are specfied by one of, batch-node-count or + Batch sizes are specified by one of, batch-node-count or batch-percent. The duration between batches is specified by batch-soak-duration. diff --git a/gcloud/dataflow/flex-template/build b/gcloud/dataflow/flex-template/build index be2a629ea..7024026df 100644 --- a/gcloud/dataflow/flex-template/build +++ b/gcloud/dataflow/flex-template/build @@ -85,10 +85,10 @@ REQUIRED FLAGS --flex-template-base-image=FLEX_TEMPLATE_BASE_IMAGE Flex template base image to be used while building the container - image. Allowed choices are JAVA8, JAVA11 or gcr.io path of the - specific version of the base image. For JAVA8 and JAVA11 option, we - use the latest base image version to build the container. You can - also provide a specific version from this link + image. Allowed choices are JAVA8, JAVA11, JAVA17 or gcr.io path of + the specific version of the base image. For JAVA8, JAVA11 and JAVA17 + option, we use the latest base image version to build the container. + You can also provide a specific version from this link https://gcr.io/dataflow-templates-base/ This flag argument must be specified if any of the other arguments in diff --git a/gcloud/dataplex/tasks/help b/gcloud/dataplex/tasks/help index 1b8c7edd4..4666e745a 100644 --- a/gcloud/dataplex/tasks/help +++ b/gcloud/dataplex/tasks/help @@ -42,6 +42,9 @@ COMMANDS remove-iam-policy-binding Remove IAM policy binding from a Dataplex task resource. + run + Trigger one-time run of a Dataplex task. + set-iam-policy Set the IAM policy to a Dataplex task as defined in a JSON or YAML file. diff --git a/gcloud/dataplex/tasks/run b/gcloud/dataplex/tasks/run new file mode 100644 index 000000000..283d180be --- /dev/null +++ b/gcloud/dataplex/tasks/run @@ -0,0 +1,87 @@ +NAME + gcloud dataplex tasks run - trigger one-time run of a Dataplex task + +SYNOPSIS + gcloud dataplex tasks run (TASK : --lake=LAKE --location=LOCATION) + [--labels=[KEY=VALUE,...]] [GCLOUD_WIDE_FLAG ...] + [-- execution-spec-args ...] + +DESCRIPTION + Trigger one-time run of a Dataplex task. + +EXAMPLES + To trigger a one-time run of a Dataplex task test-task within lake + test-lake in location us-central1, run: + + $ gcloud dataplex tasks run test-task --location=us-central1 \ + --lake=test-lake + +POSITIONAL ARGUMENTS + Tasks resource - Arguments and flags that define the Dataplex task you + want to run. 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 task 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. + + TASK + ID of the tasks or fully qualified identifier for the tasks. + + To set the task attribute: + ▸ provide the argument task on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --lake=LAKE + The identifier of the Dataplex lake resource. + + To set the lake attribute: + ▸ provide the argument task on the command line with a fully + specified name; + ▸ provide the argument --lake on the command line. + + --location=LOCATION + The location of the Dataplex resource. + + To set the location attribute: + ▸ provide the argument task on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property dataplex/location. + + [-- execution-spec-args ...] + Execution spec arguments to pass to the driver. Follows the format + argKey=argValue. + + The '--' argument must be specified between gcloud specific args on the + left and execution-spec-args on the right. + +FLAGS + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud alpha dataplex tasks run + diff --git a/gcloud/dataproc/clusters/help b/gcloud/dataproc/clusters/help index da7e65a35..ec7d18c50 100644 --- a/gcloud/dataproc/clusters/help +++ b/gcloud/dataproc/clusters/help @@ -15,7 +15,7 @@ EXAMPLES To resize a cluster, run: $ gcloud dataproc clusters update my-cluster --region=us-central1 \ - --num_workers 5 + --num-workers 5 To delete a cluster, run: diff --git a/gcloud/deploy/job-runs/help b/gcloud/deploy/job-runs/help index 849f4f366..d2b17274a 100644 --- a/gcloud/deploy/job-runs/help +++ b/gcloud/deploy/job-runs/help @@ -21,6 +21,9 @@ COMMANDS list List the job runs. + terminate + Terminates a Cloud Deploy job run. + NOTES These variants are also available: diff --git a/gcloud/deploy/job-runs/terminate b/gcloud/deploy/job-runs/terminate new file mode 100644 index 000000000..7e6430929 --- /dev/null +++ b/gcloud/deploy/job-runs/terminate @@ -0,0 +1,95 @@ +NAME + gcloud deploy job-runs terminate - terminates a Cloud Deploy job run + +SYNOPSIS + gcloud deploy job-runs terminate + (JOB_RUN : --delivery-pipeline=DELIVERY_PIPELINE + --region=REGION --release=RELEASE --rollout=ROLLOUT) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Terminates a Cloud Deploy job run. + +EXAMPLES + To terminate a job run test-jobrun, for delivery pipeline 'test-pipeline', + release 'test-release', rollout 'test-rollout', in region 'us-central1', + run: + + $ gcloud deploy job-runs terminate test-jobrun \ + --delivery-pipeline=test-pipeline --release=test-release \ + --rollout=test-rollout --region=us-central1 + +POSITIONAL ARGUMENTS + Job run resource - The name of the Job Run. 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 job_run 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. + + JOB_RUN + ID of the job_run or fully qualified identifier for the job_run. + + To set the name attribute: + ▸ provide the argument job_run on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --delivery-pipeline=DELIVERY_PIPELINE + The delivery pipeline associated with the job_run. Alternatively, set + the property [deploy/delivery-pipeline]. + + To set the delivery-pipeline attribute: + ▸ provide the argument job_run on the command line with a fully + specified name; + ▸ provide the argument --delivery-pipeline on the command line; + ▸ set the property deploy/delivery_pipeline. + + --region=REGION + The Cloud region for the job_run. Alternatively, set the property + [deploy/region]. + + To set the region attribute: + ▸ provide the argument job_run on the command line with a fully + specified name; + ▸ provide the argument --region on the command line; + ▸ set the property deploy/region. + + --release=RELEASE + The release associated with the job_run. + + To set the release attribute: + ▸ provide the argument job_run on the command line with a fully + specified name; + ▸ provide the argument --release on the command line. + + --rollout=ROLLOUT + The rollout associated with the job_run. + + To set the rollout attribute: + ▸ provide the argument job_run on the command line with a fully + specified name; + ▸ provide the argument --rollout on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha deploy job-runs terminate + + $ gcloud beta deploy job-runs terminate + diff --git a/gcloud/deploy/releases/create b/gcloud/deploy/releases/create index 5f97fb7ef..6ef3fdd84 100644 --- a/gcloud/deploy/releases/create +++ b/gcloud/deploy/releases/create @@ -5,7 +5,8 @@ NAME SYNOPSIS gcloud deploy releases create (RELEASE : --delivery-pipeline=DELIVERY_PIPELINE --region=REGION) - [--annotations=[KEY=VALUE,...]] [--description=DESCRIPTION] + [--annotations=[KEY=VALUE,...]] [--deploy-parameters=[KEY=VALUE,...]] + [--description=DESCRIPTION] [--gcs-source-staging-dir=GCS_SOURCE_STAGING_DIR] [--ignore-file=IGNORE_FILE] [--labels=[KEY=VALUE,...]] [--skaffold-version=SKAFFOLD_VERSION] [--to-target=TO_TARGET] @@ -113,6 +114,17 @@ FLAGS $ gcloud deploy releases create \ --annotations="from_target=test,status=stable" + --deploy-parameters=[KEY=VALUE,...] + Deployment parameters to apply to the release. Deployment parameters + take the form of key/value string pairs. + + Examples: + + Add deployment parameters: + + $ gcloud deploy releases create \ + --deploy-parameters="key1=value1,key2=value2" + --description=DESCRIPTION Description of the release. diff --git a/gcloud/deploy/rollouts/advance b/gcloud/deploy/rollouts/advance new file mode 100644 index 000000000..bdbe1c207 --- /dev/null +++ b/gcloud/deploy/rollouts/advance @@ -0,0 +1,90 @@ +NAME + gcloud deploy rollouts advance - advances a rollout + +SYNOPSIS + gcloud deploy rollouts advance + (ROLLOUT : --delivery-pipeline=DELIVERY_PIPELINE + --region=REGION --release=RELEASE) [--phase-id=PHASE_ID] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Advances a rollout. + +EXAMPLES + To advance a rollout test-rollout to phase test-phase for delivery pipeline + test-pipeline, release test-release in region us-central1, run: + + $ gcloud deploy rollouts advance test-rollout \ + --phase-id=test-phase --delivery-pipeline=test-pipeline \ + --release=test-release --region=us-central1 + +POSITIONAL ARGUMENTS + Rollout resource - The name of the Rollout. 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 rollout 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. + + ROLLOUT + ID of the rollout or fully qualified identifier for the rollout. + + To set the rollout attribute: + ▸ provide the argument rollout on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --delivery-pipeline=DELIVERY_PIPELINE + The delivery pipeline associated with the rollout. Alternatively, set + the property [deploy/delivery-pipeline]. + + To set the delivery-pipeline attribute: + ▸ provide the argument rollout on the command line with a fully + specified name; + ▸ provide the argument --delivery-pipeline on the command line; + ▸ set the property deploy/delivery_pipeline. + + --region=REGION + The Cloud region for the rollout. Alternatively, set the property + [deploy/region]. + + To set the region attribute: + ▸ provide the argument rollout on the command line with a fully + specified name; + ▸ provide the argument --region on the command line; + ▸ set the property deploy/region. + + --release=RELEASE + The release associated with the rollout. + + To set the release attribute: + ▸ provide the argument rollout on the command line with a fully + specified name; + ▸ provide the argument --release on the command line. + +FLAGS + --phase-id=PHASE_ID + Phase ID on a rollout resource + +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 rollouts advance + + $ gcloud beta deploy rollouts advance + diff --git a/gcloud/deploy/rollouts/cancel b/gcloud/deploy/rollouts/cancel new file mode 100644 index 000000000..d972677bb --- /dev/null +++ b/gcloud/deploy/rollouts/cancel @@ -0,0 +1,85 @@ +NAME + gcloud deploy rollouts cancel - cancel a Rollout + +SYNOPSIS + gcloud deploy rollouts cancel + (ROLLOUT : --delivery-pipeline=DELIVERY_PIPELINE + --region=REGION --release=RELEASE) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Cancel a Rollout. + +EXAMPLES + To cancel a rollout test-rollout for delivery pipeline test-pipeline, + release test-release in region us-central1, run: + + $ gcloud deploy rollouts cancel test-rollout \ + --delivery-pipeline=test-pipeline --release=test-release \ + --region=us-central1 + +POSITIONAL ARGUMENTS + Rollout resource - The name of the Rollout. 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 rollout 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. + + ROLLOUT + ID of the rollout or fully qualified identifier for the rollout. + + To set the rollout attribute: + ▸ provide the argument rollout on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --delivery-pipeline=DELIVERY_PIPELINE + The delivery pipeline associated with the rollout. Alternatively, set + the property [deploy/delivery-pipeline]. + + To set the delivery-pipeline attribute: + ▸ provide the argument rollout on the command line with a fully + specified name; + ▸ provide the argument --delivery-pipeline on the command line; + ▸ set the property deploy/delivery_pipeline. + + --region=REGION + The Cloud region for the rollout. Alternatively, set the property + [deploy/region]. + + To set the region attribute: + ▸ provide the argument rollout on the command line with a fully + specified name; + ▸ provide the argument --region on the command line; + ▸ set the property deploy/region. + + --release=RELEASE + The release associated with the rollout. + + To set the release attribute: + ▸ provide the argument rollout on the command line with a fully + specified name; + ▸ provide the argument --release on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha deploy rollouts cancel + + $ gcloud beta deploy rollouts cancel + diff --git a/gcloud/deploy/rollouts/help b/gcloud/deploy/rollouts/help index d4081cb37..2d272a268 100644 --- a/gcloud/deploy/rollouts/help +++ b/gcloud/deploy/rollouts/help @@ -16,12 +16,21 @@ GCLOUD WIDE FLAGS COMMANDS COMMAND is one of the following: + advance + Advances a rollout. + approve Approves a rollout having an Approval state of "Required". + cancel + Cancel a Rollout. + describe Show details for a rollout. + ignore-job + Ignores a specified job and phase combination on a rollout. + list List the rollouts. diff --git a/gcloud/deploy/rollouts/ignore-job b/gcloud/deploy/rollouts/ignore-job new file mode 100644 index 000000000..8bf431c28 --- /dev/null +++ b/gcloud/deploy/rollouts/ignore-job @@ -0,0 +1,95 @@ +NAME + gcloud deploy rollouts ignore-job - ignores a specified job and phase + combination on a rollout + +SYNOPSIS + gcloud deploy rollouts ignore-job + (ROLLOUT : --delivery-pipeline=DELIVERY_PIPELINE + --region=REGION --release=RELEASE) --job-id=JOB_ID + --phase-id=PHASE_ID [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Ignores a specified job and phase combination on a rollout. + +EXAMPLES + To ignore a job test-job in phase test-phase on a rollout test-rollout for + delivery pipeline test-pipeline, release test-release in region + us-central1, run: + + $ gcloud deploy rollouts ignore-job test-rollout --job-id=test-job \ + --phase-id=test-phase --delivery-pipeline=test-pipeline \ + --release=test-release --region=us-central1 + +POSITIONAL ARGUMENTS + Rollout resource - The name of the Rollout. 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 rollout 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. + + ROLLOUT + ID of the rollout or fully qualified identifier for the rollout. + + To set the rollout attribute: + ▸ provide the argument rollout on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --delivery-pipeline=DELIVERY_PIPELINE + The delivery pipeline associated with the rollout. Alternatively, set + the property [deploy/delivery-pipeline]. + + To set the delivery-pipeline attribute: + ▸ provide the argument rollout on the command line with a fully + specified name; + ▸ provide the argument --delivery-pipeline on the command line; + ▸ set the property deploy/delivery_pipeline. + + --region=REGION + The Cloud region for the rollout. Alternatively, set the property + [deploy/region]. + + To set the region attribute: + ▸ provide the argument rollout on the command line with a fully + specified name; + ▸ provide the argument --region on the command line; + ▸ set the property deploy/region. + + --release=RELEASE + The release associated with the rollout. + + To set the release attribute: + ▸ provide the argument rollout on the command line with a fully + specified name; + ▸ provide the argument --release on the command line. + +REQUIRED FLAGS + --job-id=JOB_ID + Job ID on a rollout resource + + --phase-id=PHASE_ID + Phase ID on a rollout resource + +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 rollouts ignore-job + + $ gcloud beta deploy rollouts ignore-job + diff --git a/gcloud/spanner/databases/help b/gcloud/spanner/databases/help index 0e371370b..2dfa362f9 100644 --- a/gcloud/spanner/databases/help +++ b/gcloud/spanner/databases/help @@ -57,6 +57,9 @@ COMMANDS set-iam-policy Set the IAM policy for a Cloud Spanner database. + update + Update a Cloud Spanner database. + NOTES These variants are also available: diff --git a/gcloud/spanner/databases/update b/gcloud/spanner/databases/update new file mode 100644 index 000000000..c2e767046 --- /dev/null +++ b/gcloud/spanner/databases/update @@ -0,0 +1,80 @@ +NAME + gcloud spanner databases update - update a Cloud Spanner database + +SYNOPSIS + gcloud spanner databases update (DATABASE : --instance=INSTANCE) [--async] + [--[no-]enable-drop-protection] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Update a Cloud Spanner database. + +EXAMPLES + To enable database deletion protection on a Cloud Spanner database + 'my-database', run: + + $ gcloud spanner databases update my-database \ + --enable-drop-protection + + To disable database deletion protection on a Cloud Spanner database + 'my-database', run: + + $ gcloud spanner databases update my-database \ + --no-enable-drop-protection + +POSITIONAL ARGUMENTS + Database resource - The Cloud Spanner database 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 database 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. + + DATABASE + ID of the database or fully qualified identifier for the database. + + To set the database attribute: + ▸ provide the argument database on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --instance=INSTANCE + The Cloud Spanner instance for the database. + + To set the instance attribute: + ▸ provide the argument database on the command line with a fully + specified name; + ▸ provide the argument --instance on the command line; + ▸ set the property spanner/instance. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --[no-]enable-drop-protection + Enable database deletion protection on this database. Use + --enable-drop-protection to enable and --no-enable-drop-protection to + disable. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha spanner databases update + + $ gcloud beta spanner databases update + diff --git a/gcloud/sql/flags/list b/gcloud/sql/flags/list index c8c3e90f0..abcfca56d 100644 --- a/gcloud/sql/flags/list +++ b/gcloud/sql/flags/list @@ -22,7 +22,9 @@ FLAGS POSTGRES_12, POSTGRES_13, POSTGRES_14, POSTGRES_15, SQLSERVER_2017_EXPRESS, SQLSERVER_2017_WEB, SQLSERVER_2017_STANDARD, SQLSERVER_2017_ENTERPRISE, SQLSERVER_2019_EXPRESS, SQLSERVER_2019_WEB, - SQLSERVER_2019_STANDARD, SQLSERVER_2019_ENTERPRISE. + SQLSERVER_2019_STANDARD, SQLSERVER_2019_ENTERPRISE, + SQLSERVER_2022_EXPRESS, SQLSERVER_2022_WEB, SQLSERVER_2022_STANDARD, + SQLSERVER_2022_ENTERPRISE. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/sql/instances/clone b/gcloud/sql/instances/clone index 3593393a0..74891fe8a 100644 --- a/gcloud/sql/instances/clone +++ b/gcloud/sql/instances/clone @@ -5,7 +5,8 @@ SYNOPSIS gcloud sql instances clone SOURCE DESTINATION [--async] [--bin-log-file-name=BIN_LOG_FILE_NAME --bin-log-position=BIN_LOG_POSITION | [--point-in-time=POINT_IN_TIME - : --restore-database-name=RESTORE_DATABASE_NAME]] + : --preferred-zone=PREFERRED_ZONE + --restore-database-name=RESTORE_DATABASE_NAME]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -105,6 +106,10 @@ FLAGS This flag argument must be specified if any of the other arguments in this group are specified. + --preferred-zone=PREFERRED_ZONE + The preferred zone for the cloned instance. If set, the destination + instance will be created in this zone. + --restore-database-name=RESTORE_DATABASE_NAME The name of the database to be restored for a point-in-time restore. If set, the destination instance will only restore the specified diff --git a/gcloud/sql/instances/create b/gcloud/sql/instances/create index 1fcb07ea3..700d92219 100644 --- a/gcloud/sql/instances/create +++ b/gcloud/sql/instances/create @@ -188,7 +188,9 @@ FLAGS POSTGRES_12, POSTGRES_13, POSTGRES_14, POSTGRES_15, SQLSERVER_2017_EXPRESS, SQLSERVER_2017_WEB, SQLSERVER_2017_STANDARD, SQLSERVER_2017_ENTERPRISE, SQLSERVER_2019_EXPRESS, SQLSERVER_2019_WEB, - SQLSERVER_2019_STANDARD, SQLSERVER_2019_ENTERPRISE. + SQLSERVER_2019_STANDARD, SQLSERVER_2019_ENTERPRISE, + SQLSERVER_2022_EXPRESS, SQLSERVER_2022_WEB, SQLSERVER_2022_STANDARD, + SQLSERVER_2022_ENTERPRISE. --[no-]deletion-protection Enable deletion protection on a Cloud SQL instance. Use diff --git a/gcloud/sql/instances/get-latest-recovery-time b/gcloud/sql/instances/get-latest-recovery-time new file mode 100644 index 000000000..5f03983d1 --- /dev/null +++ b/gcloud/sql/instances/get-latest-recovery-time @@ -0,0 +1,40 @@ +NAME + gcloud sql instances get-latest-recovery-time - displays the latest + recovery time to which a Cloud SQL instance can be restored to + +SYNOPSIS + gcloud sql instances get-latest-recovery-time INSTANCE + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + gcloud sql instances get-latest-recovery-time retrieves the latest recovery + time for a Cloud SQL instance. This is the latest time that can be used to + perform point in time recovery for the Cloud SQL instance. + + This is currently limited to PostgreSQL instances that are PITR enabled + with logs stored in cloud storage. + +EXAMPLES + To retrieve the latest recovery time for an instance: + + $ gcloud sql instances get-latest-recovery-time instance-foo + +POSITIONAL ARGUMENTS + INSTANCE + Cloud SQL instance ID. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha sql instances get-latest-recovery-time + + $ gcloud beta sql instances get-latest-recovery-time + diff --git a/gcloud/sql/instances/help b/gcloud/sql/instances/help index 2e7c7bcfe..a069d9621 100644 --- a/gcloud/sql/instances/help +++ b/gcloud/sql/instances/help @@ -34,6 +34,10 @@ COMMANDS failover Causes a high-availability Cloud SQL instance to failover. + get-latest-recovery-time + Displays the latest recovery time to which a Cloud SQL instance can be + restored to. + import (DEPRECATED) Imports data into a Cloud SQL instance from Google Cloud Storage. diff --git a/gcloud/sql/instances/patch b/gcloud/sql/instances/patch index d25001679..d4b963ad4 100644 --- a/gcloud/sql/instances/patch +++ b/gcloud/sql/instances/patch @@ -134,7 +134,9 @@ FLAGS POSTGRES_12, POSTGRES_13, POSTGRES_14, POSTGRES_15, SQLSERVER_2017_EXPRESS, SQLSERVER_2017_WEB, SQLSERVER_2017_STANDARD, SQLSERVER_2017_ENTERPRISE, SQLSERVER_2019_EXPRESS, SQLSERVER_2019_WEB, - SQLSERVER_2019_STANDARD, SQLSERVER_2019_ENTERPRISE. + SQLSERVER_2019_STANDARD, SQLSERVER_2019_ENTERPRISE, + SQLSERVER_2022_EXPRESS, SQLSERVER_2022_WEB, SQLSERVER_2022_STANDARD, + SQLSERVER_2022_ENTERPRISE. --[no-]deletion-protection Enable deletion protection on a Cloud SQL instance. Use diff --git a/gcloud/workstations/clusters/create b/gcloud/workstations/clusters/create new file mode 100644 index 000000000..3b08a8926 --- /dev/null +++ b/gcloud/workstations/clusters/create @@ -0,0 +1,96 @@ +NAME + gcloud workstations clusters create - create a workstation cluster + +SYNOPSIS + gcloud workstations clusters create (CLUSTER : --region=REGION) [--async] + [--enable-private-endpoint] [--labels=[LABELS,...]] [--network=NETWORK] + [--subnetwork=SUBNETWORK] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create a workstation cluster. + +EXAMPLES + To create a public cluster my-cluster in region us-central1, run: + + $ gcloud workstations clusters create my-cluster --region=us-central1 + + To create a private cluster 'my-private-cluster' associated with network + 'my-network' and subnetwork 'my-subnetwork'. run: + + $ gcloud workstations clusters create my-private-cluster \ + --region=us-central1 --enable-private-endpoint \ + --network='my-network' --subnetwork='my-subnetwork' + +POSITIONAL ARGUMENTS + Cluster resource - Arguments and flags that specify the cluster to create. + The arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument cluster 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. + + CLUSTER + ID of the cluster or fully qualified identifier for the cluster. + + To set the cluster attribute: + ▸ provide the argument cluster on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + The name of the region of the cluster. + + To set the region attribute: + ▸ provide the argument cluster 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. + + --enable-private-endpoint + Default is false. If specified, the cluster will be assigned an + internal IP address to the Cluster Gateway. This isolates the cluster's + workstations from public networks, but requires additional + configuration. Learn more: https://cloud.google.com/workstations/docs. + + --labels=[LABELS,...] + Labels that are applied to the cluster and propagated to the underlying + Compute Engine resources. + + --network=NETWORK + The network that instances created under the cluster will be associated + with. + + --subnetwork=SUBNETWORK + The subnetwork that instances created under the cluster will be + associated with. + +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 workstations/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/workstations + +NOTES + These variants are also available: + + $ gcloud alpha workstations clusters create + + $ gcloud beta workstations clusters create + diff --git a/gcloud/workstations/clusters/delete b/gcloud/workstations/clusters/delete new file mode 100644 index 000000000..cd0b5180b --- /dev/null +++ b/gcloud/workstations/clusters/delete @@ -0,0 +1,70 @@ +NAME + gcloud workstations clusters delete - delete a workstation cluster + +SYNOPSIS + gcloud workstations clusters delete (CLUSTER : --region=REGION) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete a workstation cluster. + +EXAMPLES + To delete a cluster, run: + + $ gcloud workstations clusters delete WORKSTATION + +POSITIONAL ARGUMENTS + Cluster resource - The name of the cluster 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 cluster 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. + + CLUSTER + ID of the cluster or fully qualified identifier for the cluster. + + To set the cluster attribute: + ▸ provide the argument cluster on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + The name of the region of the cluster. + + To set the region attribute: + ▸ provide the argument cluster 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. + +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 workstations/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/workstations + +NOTES + These variants are also available: + + $ gcloud alpha workstations clusters delete + + $ gcloud beta workstations clusters delete + diff --git a/gcloud/workstations/clusters/describe b/gcloud/workstations/clusters/describe new file mode 100644 index 000000000..ec0b08778 --- /dev/null +++ b/gcloud/workstations/clusters/describe @@ -0,0 +1,65 @@ +NAME + gcloud workstations clusters describe - describe a cluster + +SYNOPSIS + gcloud workstations clusters describe (CLUSTER : --region=REGION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe a cluster. + +EXAMPLES + To describe a cluster, run: + + $ gcloud workstations clusters describe CLUSTER + +POSITIONAL ARGUMENTS + Cluster resource - The name of the cluster to display. 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 cluster 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. + + CLUSTER + ID of the cluster or fully qualified identifier for the cluster. + + To set the cluster attribute: + ▸ provide the argument cluster on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + The name of the region of the cluster. + + To set the region attribute: + ▸ provide the argument cluster 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 workstations/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/workstations + +NOTES + These variants are also available: + + $ gcloud alpha workstations clusters describe + + $ gcloud beta workstations clusters describe + diff --git a/gcloud/workstations/clusters/help b/gcloud/workstations/clusters/help new file mode 100644 index 000000000..49ca14d60 --- /dev/null +++ b/gcloud/workstations/clusters/help @@ -0,0 +1,36 @@ +NAME + gcloud workstations clusters - manage Cloud Workstations cluster resources + +SYNOPSIS + gcloud workstations clusters COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Cloud Workstations cluster resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + Create a workstation cluster. + + delete + Delete a workstation cluster. + + describe + Describe a cluster. + + list + List workstation clusters. + +NOTES + These variants are also available: + + $ gcloud alpha workstations clusters + + $ gcloud beta workstations clusters + diff --git a/gcloud/alpha/beyondcorp/client-connector/operations/list b/gcloud/workstations/clusters/list similarity index 51% rename from gcloud/alpha/beyondcorp/client-connector/operations/list rename to gcloud/workstations/clusters/list index 8ee733c87..5abc47bef 100644 --- a/gcloud/alpha/beyondcorp/client-connector/operations/list +++ b/gcloud/workstations/clusters/list @@ -1,43 +1,37 @@ NAME - gcloud alpha beyondcorp client-connector operations list - list BeyondCorp - client connector operations + gcloud workstations clusters list - list workstation clusters SYNOPSIS - gcloud alpha beyondcorp client-connector operations list - --location=LOCATION [--filter=EXPRESSION] [--limit=LIMIT] - [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + gcloud workstations clusters list --region=REGION [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) List all BeyondCorp client connector operations in the specified - project. - - You can specify the maximum number of operations to list using the --limit - flag. + List all workstation clusters under the specified project and region. EXAMPLES - The following command lists a maximum of five operations: + To list workstation clusters, run: - $ gcloud alpha beyondcorp client-connector operations list \ - --project=consumer-project-id --location=us-central1 --limit=5 + $ gcloud workstations clusters list REQUIRED FLAGS - Location resource - Location of the operations to display. This represents - a Cloud resource. (NOTE) Some attributes are not given arguments in this + Region resource - The region of the clusters to display. This represents a + Cloud resource. (NOTE) Some attributes are not given arguments in this group but can be set in other ways. To set the project attribute: - ◆ provide the argument --location on the command line with a fully + ◆ 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. + ◆ provide the argument --project on the command line; + ◆ set the property core/project. This must be specified. - --location=LOCATION - ID of the location or fully qualified identifier for the location. + --region=REGION + ID of the region or fully qualified identifier for the region. - To set the location attribute: - ▸ provide the argument --location on the command line. + To set the region attribute: + ▸ provide the argument --region on the command line. LIST COMMAND FLAGS --filter=EXPRESSION @@ -74,14 +68,13 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the beyondcorp/v1alpha API. The full documentation for - this API can be found at: https://cloud.google.com/ + This command uses the workstations/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/workstations 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: + These variants are also available: - $ gcloud beta beyondcorp client-connector operations list + $ gcloud alpha workstations clusters list + + $ gcloud beta workstations clusters list diff --git a/gcloud/workstations/configs/create b/gcloud/workstations/configs/create new file mode 100644 index 000000000..a3fbcec67 --- /dev/null +++ b/gcloud/workstations/configs/create @@ -0,0 +1,270 @@ +NAME + gcloud workstations configs create - create a workstation configuration + +SYNOPSIS + gcloud workstations configs create + (CONFIG : --cluster=CLUSTER --region=REGION) [--async] + [--boot-disk-size=BOOT_DISK_SIZE; default=50] + [--container-args=[CONTAINER_ARGS,...]] + [--container-command=[CONTAINER_COMMAND,...]] + [--container-env=[CONTAINER_ENV,...]] + [--container-run-as-user=CONTAINER_RUN_AS_USER] + [--container-working-dir=CONTAINER_WORKING_DIR] + [--disable-public-ip-addresses] [--enable-confidential-compute] + [--idle-timeout=IDLE_TIMEOUT; default=7200] [--labels=[LABELS,...]] + [--machine-type=MACHINE_TYPE; default="e2-standard-4"] + [--network-tags=[NETWORK_TAGS,...]] + [--pd-disk-size=PD_DISK_SIZE; default=200] + [--pd-disk-type=PD_DISK_TYPE; default="pd-standard"] + [--pd-reclaim-policy=PD_RECLAIM_POLICY; default="delete"] + [--pool-size=POOL_SIZE] + [--running-timeout=RUNNING_TIMEOUT; default=7200] + [--service-account=SERVICE_ACCOUNT] [--shielded-integrity-monitoring] + [--shielded-secure-boot] [--shielded-vtpm] + [--container-custom-image=CONTAINER_CUSTOM_IMAGE + | --container-predefined-image=CONTAINER_PREDEFINED_IMAGE; + default="codeoss"] + [--kms-key=KMS_KEY : --kms-key-service-account=KMS_KEY_SERVICE_ACCOUNT] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create a workstation configuration. + +EXAMPLES + To create a configuration with the 'e2-standard-8' machine type and a + IntelliJ image, run: + + $ gcloud workstations configs create CONFIG \ + --machine-type=e2-standard-8 \ + --container-predefined-image=intellij + + To create a configuration with a Shielded VM instance that enables Secure + Boot, virtual trusted platform module (vTPM) and integrity monitoring, run: + + $ gcloud workstations configs create CONFIG \ + --machine-type=e2-standard-4 --shielded-secure-boot \ + --shielded-vtpm --shielded-integrity-monitoring + + To create a configuration with a non-default persistent disk containing + 10GB of PD SSD storage, run: $ gcloud workstations configs create CONFIG \ + --machine-type=e2-standard-4 --pd-disk-type=pd-ssd \ + --pd-disk-size=10 + +POSITIONAL ARGUMENTS + Config resource - The group of arguments defining a config 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 config on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + CONFIG + ID of the config or fully qualified identifier for the config. + + To set the config attribute: + ▸ provide the argument config on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --cluster=CLUSTER + The cluster for the config. + + To set the cluster attribute: + ▸ provide the argument config on the command line with a fully + specified name; + ▸ provide the argument --cluster on the command line. + + --region=REGION + The location for the config. + + To set the region attribute: + ▸ provide the argument config 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. + + --boot-disk-size=BOOT_DISK_SIZE; default=50 + Size of the boot disk in GB. + + --container-args=[CONTAINER_ARGS,...] + Arguments passed to the entrypoint. + + Example: + + $ gcloud workstations configs create --container-args=arg_1,arg_2 + + --container-command=[CONTAINER_COMMAND,...] + If set, overrides the default ENTRYPOINT specified by the image. + + Example: + + $ gcloud workstations configs create \ + --container-command=executable,parameter_1,parameter_2 + + --container-env=[CONTAINER_ENV,...] + Environment variables passed to the container. + + Example: + + $ gcloud workstations configs create \ + --container-env=key1=value1,key2=value2 + + --container-run-as-user=CONTAINER_RUN_AS_USER + If set, overrides the USER specified in the image with the given uid. + + --container-working-dir=CONTAINER_WORKING_DIR + If set, overrides the default DIR specified by the image. + + --disable-public-ip-addresses + Default value is false. If set, instances will have no public IP + address. + + --enable-confidential-compute + Default value is false. If set, instances will have confidential + compute enabled. + + --idle-timeout=IDLE_TIMEOUT; default=7200 + How long (in seconds) to wait before automatically stopping an instance + that hasn't received any user traffic. A value of 0 indicates that this + instance should never time out due to idleness. + + --labels=[LABELS,...] + Labels that are applied to the configuration and propagated to the + underlying Compute Engine resources. + + Example: + + $ gcloud workstations configs create \ + --labels=label1=value1,label2=value2 + + --machine-type=MACHINE_TYPE; default="e2-standard-4" + Machine type determines the specifications of the Compute Engine + machines that the workstations created under this configuration will + run on. MACHINE_TYPE must be one of: e2-standard-2, e2-standard-4, + e2-standard-8, e2-standard-16, e2-standard-32, n2-standard-8, + n1-standard-4, t2d-standard-6, n2d-standard-2, n2d-standard-4, + n2d-standard-8, n2d-standard-16, n2d-standard-32. + + --network-tags=[NETWORK_TAGS,...] + Network tags to add to the Google Compute Engine machines backing the + Workstations. + + Example: + + $ gcloud workstations configs create --network-tags=tag_1,tag_2 + + --pd-disk-size=PD_DISK_SIZE; default=200 + Size of the persistent directory in GB. PD_DISK_SIZE must be one of: + 10, 50, 100, 200, 500, 1000. + + --pd-disk-type=PD_DISK_TYPE; default="pd-standard" + Type of the persistent directory. PD_DISK_TYPE must be one of: + pd-standard, pd-balanced, pd-ssd. + + --pd-reclaim-policy=PD_RECLAIM_POLICY; default="delete" + What should happen to the disk after the Workstation is deleted. + PD_RECLAIM_POLICY must be one of: + + delete + The persistent disk will be deleted with the Workstation. + retain + The persistent disk will be remain after the workstation is deleted + and the administrator must manually delete the disk. + + --pool-size=POOL_SIZE + Number of instances to pool for faster Workstation starup. + + --running-timeout=RUNNING_TIMEOUT; default=7200 + How long (in seconds) to wait before automatically stopping a + workstation after it started. A value of 0 indicates that workstations + using this config should never time out. + + --service-account=SERVICE_ACCOUNT + Email address of the service account that will be used on VM instances + used to support this config. This service account must have permission + to pull the specified container image. If not set, VMs will run without + a service account, in which case the image must be publicly accessible. + + --shielded-integrity-monitoring + Default value is false. If set, instances will have integrity + monitoring enabled. + + --shielded-secure-boot + Default value is false. If set, instances will have Secure Boot + enabled. + + --shielded-vtpm + Default value is false. If set, instances will have vTPM enabled. + + At most one of these can be specified: + + --container-custom-image=CONTAINER_CUSTOM_IMAGE + A docker image for the workstation. This image must be accessible by + the service account configured in this configuration + (--service-account). If no service account is defined, this image + must be public. + + --container-predefined-image=CONTAINER_PREDEFINED_IMAGE; default="codeoss" + Code editor on base images. CONTAINER_PREDEFINED_IMAGE must be one + of: + + base-image + Base image - no IDE + clion + CLion + codeoss + Code OSS + goland + GoLand + intellij + IntelliJ IDEA Ultimate + phpstorm + PhpStorm + pycharm + PyCharm Professional + rider + Rider + rubymine + RubyMine + webstorm + WebStorm + + Encryption key settings + + --kms-key=KMS_KEY + The customer-managed encryption key to use for this config. If not + specified, a Google-managed encryption key is used. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --kms-key-service-account=KMS_KEY_SERVICE_ACCOUNT + The service account associated with the provided customer-managed + encryption key. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha workstations configs create + + $ gcloud beta workstations configs create + diff --git a/gcloud/workstations/configs/delete b/gcloud/workstations/configs/delete new file mode 100644 index 000000000..792cce65c --- /dev/null +++ b/gcloud/workstations/configs/delete @@ -0,0 +1,79 @@ +NAME + gcloud workstations configs delete - delete a workstation configuration + +SYNOPSIS + gcloud workstations configs delete + (CONFIG : --cluster=CLUSTER --region=REGION) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete a workstation configuration. + +EXAMPLES + To delete a configuration, run: + + $ gcloud workstations configs delete WORKSTATION + +POSITIONAL ARGUMENTS + Config resource - The name of the configuration 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 config on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + CONFIG + ID of the config or fully qualified identifier for the config. + + To set the config attribute: + ▸ provide the argument config on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --cluster=CLUSTER + The name of the cluster containing the config. + + To set the cluster attribute: + ▸ provide the argument config on the command line with a fully + specified name; + ▸ provide the argument --cluster on the command line. + + --region=REGION + The name of the region of the config. + + To set the region attribute: + ▸ provide the argument config 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. + +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 workstations/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/workstations + +NOTES + These variants are also available: + + $ gcloud alpha workstations configs delete + + $ gcloud beta workstations configs delete + diff --git a/gcloud/workstations/configs/describe b/gcloud/workstations/configs/describe new file mode 100644 index 000000000..6dfbc04c5 --- /dev/null +++ b/gcloud/workstations/configs/describe @@ -0,0 +1,73 @@ +NAME + gcloud workstations configs describe - describe a config + +SYNOPSIS + gcloud workstations configs describe + (CONFIG : --cluster=CLUSTER --region=REGION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe a config. + +EXAMPLES + To describe a config, run: + + $ gcloud workstations configs describe CONFIG + +POSITIONAL ARGUMENTS + Config resource - The name of the config to display. 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 config on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + CONFIG + ID of the config or fully qualified identifier for the config. + + To set the config attribute: + ▸ provide the argument config on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --cluster=CLUSTER + The name of the cluster containing the config. + + To set the cluster attribute: + ▸ provide the argument config on the command line with a fully + specified name; + ▸ provide the argument --cluster on the command line. + + --region=REGION + The name of the region of the config. + + To set the region attribute: + ▸ provide the argument config 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 workstations/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/workstations + +NOTES + These variants are also available: + + $ gcloud alpha workstations configs describe + + $ gcloud beta workstations configs describe + diff --git a/gcloud/workstations/configs/get-iam-policy b/gcloud/workstations/configs/get-iam-policy new file mode 100644 index 000000000..24ced645f --- /dev/null +++ b/gcloud/workstations/configs/get-iam-policy @@ -0,0 +1,107 @@ +NAME + gcloud workstations configs get-iam-policy - get the IAM policy for a + configuration + +SYNOPSIS + gcloud workstations configs get-iam-policy + (CONFIG : --cluster=CLUSTER --region=REGION) [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + gcloud workstations configs get-iam-policy displays the IAM policy + associated with a given configuration. If formatted as JSON, the output can + be edited and used as a policy file for set-iam-policy. The output includes + an "etag" field identifying the version emitted and allowing detection of + concurrent policy updates; see $ {parent} set-iam-policy for additional + details. + +EXAMPLES + To get the IAM policy for a given configuration, run: + + $ gcloud workstations configs get-iam-policy CONFIG + +POSITIONAL ARGUMENTS + Config resource - The configuration for which to display the IAM 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 config on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + CONFIG + ID of the config or fully qualified identifier for the config. + + To set the config attribute: + ▸ provide the argument config on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --cluster=CLUSTER + The name of the cluster containing the config. + + To set the cluster attribute: + ▸ provide the argument config on the command line with a fully + specified name; + ▸ provide the argument --cluster on the command line. + + --region=REGION + The name of the region of the config. + + To set the region attribute: + ▸ provide the argument config on the command line with a fully + specified name; + ▸ 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 workstations/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/workstations + +NOTES + These variants are also available: + + $ gcloud alpha workstations configs get-iam-policy + + $ gcloud beta workstations configs get-iam-policy + diff --git a/gcloud/workstations/configs/help b/gcloud/workstations/configs/help new file mode 100644 index 000000000..b45c99048 --- /dev/null +++ b/gcloud/workstations/configs/help @@ -0,0 +1,46 @@ +NAME + gcloud workstations configs - manage Cloud Workstations configuration + resources + +SYNOPSIS + gcloud workstations configs COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Cloud Workstations configuration resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + Create a workstation configuration. + + delete + Delete a workstation configuration. + + describe + Describe a config. + + get-iam-policy + Get the IAM policy for a configuration.. + + list + List workstation configurations. + + set-iam-policy + Set the IAM policy for a configuration. + + update + Updates a workstation configuration. + +NOTES + These variants are also available: + + $ gcloud alpha workstations configs + + $ gcloud beta workstations configs + diff --git a/gcloud/alpha/beyondcorp/client-connector/gateways/list b/gcloud/workstations/configs/list similarity index 54% rename from gcloud/alpha/beyondcorp/client-connector/gateways/list rename to gcloud/workstations/configs/list index 28c31c742..bbe81cbeb 100644 --- a/gcloud/alpha/beyondcorp/client-connector/gateways/list +++ b/gcloud/workstations/configs/list @@ -1,42 +1,49 @@ NAME - gcloud alpha beyondcorp client-connector gateways list - list BeyondCorp - client gateway resources + gcloud workstations configs list - list workstation configurations SYNOPSIS - gcloud alpha beyondcorp client-connector gateways list --location=LOCATION + gcloud workstations configs list (--cluster=CLUSTER : --region=REGION) [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) List BeyondCorp client gateway resources based on project and - location. + List all workstation configurations under the specified cluster. EXAMPLES - To list all client gateways in a project for location us-central1 in table - form, run: + To list workstation configurations, run: - $ gcloud alpha beyondcorp client-connector gateways list \ - --project=consumer-project-id --location=us-central1 + $ gcloud workstations configs list REQUIRED FLAGS - Location resource - Arguments and flags that define the BeyondCorp client - gateways you want to list. This represents a Cloud resource. (NOTE) Some - attributes are not given arguments in this group but can be set in other - ways. + Cluster resource - The cluster of the configurations to display. 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 --location on the command line with a fully + ◆ provide the argument --cluster on the command line with a fully specified name; - ◆ set the property core/project; - ◆ provide the argument --project on the command line. + ◆ provide the argument --project on the command line; + ◆ set the property core/project. This must be specified. - --location=LOCATION - ID of the location or fully qualified identifier for the location. + --cluster=CLUSTER + ID of the cluster or fully qualified identifier for the cluster. - To set the location attribute: - ▸ provide the argument --location on the command line. + To set the cluster attribute: + ▸ provide the argument --cluster on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --region=REGION + The name of the region of the cluster. + + To set the region attribute: + ▸ provide the argument --cluster on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. LIST COMMAND FLAGS --filter=EXPRESSION @@ -73,14 +80,13 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the beyondcorp/v1alpha API. The full documentation for - this API can be found at: https://cloud.google.com/ + This command uses the workstations/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/workstations 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: + These variants are also available: - $ gcloud beta beyondcorp client-connector gateways list + $ gcloud alpha workstations configs list + + $ gcloud beta workstations configs list diff --git a/gcloud/workstations/configs/set-iam-policy b/gcloud/workstations/configs/set-iam-policy new file mode 100644 index 000000000..6852954dc --- /dev/null +++ b/gcloud/workstations/configs/set-iam-policy @@ -0,0 +1,87 @@ +NAME + gcloud workstations configs set-iam-policy - set the IAM policy for a + configuration + +SYNOPSIS + gcloud workstations configs set-iam-policy + (CONFIG : --cluster=CLUSTER --region=REGION) POLICY_FILE + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Sets the IAM policy for the given configuration as defined in a JSON or + YAML file. + +EXAMPLES + The following command will read an IAM policy defined in a JSON file + 'policy.json' and set it for the given configuration: + + $ gcloud workstations configs set-iam-policy CONFIG policy.json + + See https://cloud.google.com/iam/docs/managing-policies for details of the + policy file format and contents. + +POSITIONAL ARGUMENTS + Config resource - The configuration for which to display the IAM 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 config on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + CONFIG + ID of the config or fully qualified identifier for the config. + + To set the config attribute: + ▸ provide the argument config on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --cluster=CLUSTER + The name of the cluster containing the config. + + To set the cluster attribute: + ▸ provide the argument config on the command line with a fully + specified name; + ▸ provide the argument --cluster on the command line. + + --region=REGION + The name of the region of the config. + + To set the region attribute: + ▸ provide the argument config on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + + POLICY_FILE + Path to a local JSON or YAML formatted file containing a valid policy. + + The output of the get-iam-policy command is a valid file, as is any + JSON or YAML file conforming to the structure of a Policy + (https://cloud.google.com/iam/reference/rest/v1/Policy). + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the workstations/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/workstations + +NOTES + These variants are also available: + + $ gcloud alpha workstations configs set-iam-policy + + $ gcloud beta workstations configs set-iam-policy + diff --git a/gcloud/workstations/configs/update b/gcloud/workstations/configs/update new file mode 100644 index 000000000..2e54460bf --- /dev/null +++ b/gcloud/workstations/configs/update @@ -0,0 +1,227 @@ +NAME + gcloud workstations configs update - updates a workstation configuration + +SYNOPSIS + gcloud workstations configs update + (CONFIG : --cluster=CLUSTER --region=REGION) [--async] + [--boot-disk-size=BOOT_DISK_SIZE] + [--container-args=[CONTAINER_ARGS,...]] + [--container-command=[CONTAINER_COMMAND,...]] + [--container-env=[CONTAINER_ENV,...]] + [--container-run-as-user=CONTAINER_RUN_AS_USER] + [--container-working-dir=CONTAINER_WORKING_DIR] + [--disable-public-ip-addresses] [--enable-confidential-compute] + [--idle-timeout=IDLE_TIMEOUT] [--labels=[LABELS,...]] + [--machine-type=MACHINE_TYPE] [--network-tags=[NETWORK_TAGS,...]] + [--pool-size=POOL_SIZE] [--running-timeout=RUNNING_TIMEOUT] + [--service-account=SERVICE_ACCOUNT] [--shielded-integrity-monitoring] + [--shielded-secure-boot] [--shielded-vtpm] + [--container-custom-image=CONTAINER_CUSTOM_IMAGE + | --container-predefined-image=CONTAINER_PREDEFINED_IMAGE] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Updates a workstation configuration. + +EXAMPLES + To update a configuration with the 'e2-standard-8' machine type and a + IntelliJ image, run: + + $ gcloud workstations configs update CONFIG \ + --machine-type=e2-standard-8 \ + --container-predefined-image=intellij + + To update a configuration to disable Secure Boot, virtual trusted platform + module (vTPM) and integrity monitoring, run: + + $ gcloud workstations configs update CONFIG \ + --no-shielded-secure-boot --no-shielded-vtpm \ + --no-shielded-integrity-monitoring + +POSITIONAL ARGUMENTS + Config resource - The group of arguments defining a config 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 config on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + CONFIG + ID of the config or fully qualified identifier for the config. + + To set the config attribute: + ▸ provide the argument config on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --cluster=CLUSTER + The cluster for the config. + + To set the cluster attribute: + ▸ provide the argument config on the command line with a fully + specified name; + ▸ provide the argument --cluster on the command line. + + --region=REGION + The location for the config. + + To set the region attribute: + ▸ provide the argument config 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. + + --boot-disk-size=BOOT_DISK_SIZE + Size of the boot disk in GB. + + --container-args=[CONTAINER_ARGS,...] + Arguments passed to the entrypoint. + + Example: + + $ gcloud workstations configs update --container-args=arg_1,arg_2 + + --container-command=[CONTAINER_COMMAND,...] + If set, overrides the default ENTRYPOINT specified by the image. + + Example: + + $ gcloud workstations configs update \ + --container-command=executable,parameter_1,parameter_2 + + --container-env=[CONTAINER_ENV,...] + Environment variables passed to the container. + + Example: + + $ gcloud workstations configs update \ + --container-env=key1=value1,key2=value2 + + --container-run-as-user=CONTAINER_RUN_AS_USER + If set, overrides the USER specified in the image with the given uid. + + --container-working-dir=CONTAINER_WORKING_DIR + If set, overrides the default DIR specified by the image. + + --disable-public-ip-addresses + Default value is false. If set, instances will have no public IP + address. + + --enable-confidential-compute + Default value is false. If set, instances will have confidential + compute enabled. + + --idle-timeout=IDLE_TIMEOUT + How long (in seconds) to wait before automatically stopping an instance + that hasn't received any user traffic. A value of 0 indicates that this + instance should never time out due to idleness. + + --labels=[LABELS,...] + Labels that are applied to the configuration and propagated to the + underlying Compute Engine resources. + + Example: + + $ gcloud workstations configs update \ + --labels=label1=value1,label2=value2 + + --machine-type=MACHINE_TYPE + Machine type determines the specifications of the Compute Engine + machines that the workstations created under this configuration will + run on. MACHINE_TYPE must be one of: e2-standard-2, e2-standard-4, + e2-standard-8, e2-standard-16, e2-standard-32, n2-standard-8, + n1-standard-4, t2d-standard-6, n2d-standard-2, n2d-standard-4, + n2d-standard-8, n2d-standard-16, n2d-standard-32. + + --network-tags=[NETWORK_TAGS,...] + Network tags to add to the Google Compute Engine machines backing the + Workstations. + + Example: + + $ gcloud workstations configs update --network-tags=tag_1,tag_2 + + --pool-size=POOL_SIZE + Number of instances to pool for faster Workstation starup. + + --running-timeout=RUNNING_TIMEOUT + How long (in seconds) to wait before automatically stopping a + workstation after it started. A value of 0 indicates that workstations + using this config should never time out. + + --service-account=SERVICE_ACCOUNT + Email address of the service account that will be used on VM instances + used to support this config. This service account must have permission + to pull the specified container image. If not set, VMs will run without + a service account, in which case the image must be publicly accessible. + + --shielded-integrity-monitoring + Default value is false. If set, instances will have integrity + monitoring enabled. + + --shielded-secure-boot + Default value is false. If set, instances will have Secure Boot + enabled. + + --shielded-vtpm + Default value is false. If set, instances will have vTPM enabled. + + At most one of these can be specified: + + --container-custom-image=CONTAINER_CUSTOM_IMAGE + A docker image for the workstation. This image must be accessible by + the service account configured in this configuration + (--service-account). If no service account is defined, this image + must be public. + + --container-predefined-image=CONTAINER_PREDEFINED_IMAGE + Code editor on base images. CONTAINER_PREDEFINED_IMAGE must be one + of: + + base-image + Base image - no IDE + clion + CLion + codeoss + Code OSS + goland + GoLand + intellij + IntelliJ IDEA Ultimate + phpstorm + PhpStorm + pycharm + PyCharm Professional + rider + Rider + rubymine + RubyMine + webstorm + WebStorm + +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 workstations configs update + + $ gcloud beta workstations configs update + diff --git a/gcloud/workstations/create b/gcloud/workstations/create new file mode 100644 index 000000000..5e4182480 --- /dev/null +++ b/gcloud/workstations/create @@ -0,0 +1,92 @@ +NAME + gcloud workstations create - create a workstation + +SYNOPSIS + gcloud workstations create + (WORKSTATION : --cluster=CLUSTER --config=CONFIG --region=REGION) + [--async] [--labels=[LABELS,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create a workstation. + +EXAMPLES + To create a workstation, run: + + $ gcloud workstations create WORKSTATION + +POSITIONAL ARGUMENTS + Workstation resource - Arguments and flags that specify the workstation to + create. The arguments in this group can be used to specify the attributes + of this resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument workstation 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. + + WORKSTATION + ID of the workstation or fully qualified identifier for the + workstation. + + To set the workstation attribute: + ▸ provide the argument workstation on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --cluster=CLUSTER + The name of the cluster containing the workstation. + + To set the cluster attribute: + ▸ provide the argument workstation on the command line with a fully + specified name; + ▸ provide the argument --cluster on the command line. + + --config=CONFIG + The name of the config containing the workstation. + + To set the config attribute: + ▸ provide the argument workstation on the command line with a fully + specified name; + ▸ provide the argument --config on the command line. + + --region=REGION + The name of the region of the workstation. + + To set the region attribute: + ▸ provide the argument workstation 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. + + --labels=[LABELS,...] + Labels that are applied to the workstation and propagated to the + underlying Compute Engine resources. + +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 workstations/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/workstations + +NOTES + These variants are also available: + + $ gcloud alpha workstations create + + $ gcloud beta workstations create + diff --git a/gcloud/workstations/delete b/gcloud/workstations/delete new file mode 100644 index 000000000..43035628f --- /dev/null +++ b/gcloud/workstations/delete @@ -0,0 +1,88 @@ +NAME + gcloud workstations delete - delete a workstation + +SYNOPSIS + gcloud workstations delete + (WORKSTATION : --cluster=CLUSTER --config=CONFIG --region=REGION) + [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete a workstation. + +EXAMPLES + To delete a workstation, run: + + $ gcloud workstations delete WORKSTATION + +POSITIONAL ARGUMENTS + Workstation resource - The name of the workstation 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 workstation 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. + + WORKSTATION + ID of the workstation or fully qualified identifier for the + workstation. + + To set the workstation attribute: + ▸ provide the argument workstation on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --cluster=CLUSTER + The name of the cluster containing the workstation. + + To set the cluster attribute: + ▸ provide the argument workstation on the command line with a fully + specified name; + ▸ provide the argument --cluster on the command line. + + --config=CONFIG + The name of the config containing the workstation. + + To set the config attribute: + ▸ provide the argument workstation on the command line with a fully + specified name; + ▸ provide the argument --config on the command line. + + --region=REGION + The name of the region of the workstation. + + To set the region attribute: + ▸ provide the argument workstation 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. + +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 workstations/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/workstations + +NOTES + These variants are also available: + + $ gcloud alpha workstations delete + + $ gcloud beta workstations delete + diff --git a/gcloud/workstations/describe b/gcloud/workstations/describe new file mode 100644 index 000000000..99aadf471 --- /dev/null +++ b/gcloud/workstations/describe @@ -0,0 +1,83 @@ +NAME + gcloud workstations describe - describe a workstation + +SYNOPSIS + gcloud workstations describe + (WORKSTATION : --cluster=CLUSTER --config=CONFIG --region=REGION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe a workstation. + +EXAMPLES + To describe a workstation, run: + + $ gcloud workstations describe WORKSTATION + +POSITIONAL ARGUMENTS + Workstation resource - The name of the workstation to display. 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 workstation 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. + + WORKSTATION + ID of the workstation or fully qualified identifier for the + workstation. + + To set the workstation attribute: + ▸ provide the argument workstation on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --cluster=CLUSTER + The name of the cluster containing the workstation. + + To set the cluster attribute: + ▸ provide the argument workstation on the command line with a fully + specified name; + ▸ provide the argument --cluster on the command line. + + --config=CONFIG + The name of the config containing the workstation. + + To set the config attribute: + ▸ provide the argument workstation on the command line with a fully + specified name; + ▸ provide the argument --config on the command line. + + --region=REGION + The name of the region of the workstation. + + To set the region attribute: + ▸ provide the argument workstation 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 workstations/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/workstations + +NOTES + These variants are also available: + + $ gcloud alpha workstations describe + + $ gcloud beta workstations describe + diff --git a/gcloud/workstations/get-iam-policy b/gcloud/workstations/get-iam-policy new file mode 100644 index 000000000..5bd18dd2e --- /dev/null +++ b/gcloud/workstations/get-iam-policy @@ -0,0 +1,114 @@ +NAME + gcloud workstations get-iam-policy - get the IAM policy for a workstation + +SYNOPSIS + gcloud workstations get-iam-policy + (WORKSTATION : --cluster=CLUSTER --config=CONFIG --region=REGION) + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + gcloud workstations get-iam-policy displays the IAM policy associated with + a given workstation. If formatted as JSON, the output can be edited and + used as a policy file for set-iam-policy. The output includes an "etag" + field identifying the version emitted and allowing detection of concurrent + policy updates; see $ {parent} set-iam-policy for additional details. + +EXAMPLES + To get the IAM policy for a given workstation, run: + + $ gcloud workstations get-iam-policy WORKSTATION + +POSITIONAL ARGUMENTS + Workstation resource - The workstation for which to display the IAM + 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 workstation 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. + + WORKSTATION + ID of the workstation or fully qualified identifier for the + workstation. + + To set the workstation attribute: + ▸ provide the argument workstation on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --cluster=CLUSTER + The name of the cluster containing the workstation. + + To set the cluster attribute: + ▸ provide the argument workstation on the command line with a fully + specified name; + ▸ provide the argument --cluster on the command line. + + --config=CONFIG + The name of the config containing the workstation. + + To set the config attribute: + ▸ provide the argument workstation on the command line with a fully + specified name; + ▸ provide the argument --config on the command line. + + --region=REGION + The name of the region of the workstation. + + To set the region attribute: + ▸ provide the argument workstation on the command line with a fully + specified name; + ▸ 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 workstations/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/workstations + +NOTES + These variants are also available: + + $ gcloud alpha workstations get-iam-policy + + $ gcloud beta workstations get-iam-policy + diff --git a/gcloud/workstations/help b/gcloud/workstations/help new file mode 100644 index 000000000..787b30689 --- /dev/null +++ b/gcloud/workstations/help @@ -0,0 +1,67 @@ +NAME + gcloud workstations - manage Cloud Workstations resources + +SYNOPSIS + gcloud workstations GROUP | COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Cloud Workstations resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + clusters + Manage Cloud Workstations cluster resources. + + configs + Manage Cloud Workstations configuration resources. + +COMMANDS + COMMAND is one of the following: + + create + Create a workstation. + + delete + Delete a workstation. + + describe + Describe a workstation. + + get-iam-policy + Get the IAM policy for a workstation. + + list + List workstations. + + list-usable + List usable workstations. + + set-iam-policy + Set the IAM policy for a workstation. + + ssh + SSH into a running workstation. + + start + Start a workstation. + + start-tcp-tunnel + Start a tunnel through which a local process can forward TCP traffic to + the workstation. + + stop + Stop a workstation. + +NOTES + These variants are also available: + + $ gcloud alpha workstations + + $ gcloud beta workstations + diff --git a/gcloud/workstations/list b/gcloud/workstations/list new file mode 100644 index 000000000..a06f06177 --- /dev/null +++ b/gcloud/workstations/list @@ -0,0 +1,101 @@ +NAME + gcloud workstations list - list workstations + +SYNOPSIS + gcloud workstations list + (--config=CONFIG : --cluster=CLUSTER --region=REGION) + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List all workstations under the specified configuration. + +EXAMPLES + To list workstations, run: + + $ gcloud workstations list + +REQUIRED FLAGS + Config resource - The configuration of the workstations to display. 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 --config on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --config=CONFIG + ID of the config or fully qualified identifier for the config. + + To set the config attribute: + ▸ provide the argument --config on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --cluster=CLUSTER + The name of the cluster containing the config. + + To set the cluster attribute: + ▸ provide the argument --config on the command line with a fully + specified name; + ▸ provide the argument --cluster on the command line. + + --region=REGION + The name of the region of the config. + + To set the region attribute: + ▸ provide the argument --config on the command line with a fully + specified name; + ▸ 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 workstations/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/workstations + +NOTES + These variants are also available: + + $ gcloud alpha workstations list + + $ gcloud beta workstations list + diff --git a/gcloud/alpha/beyondcorp/client-connector/services/list b/gcloud/workstations/list-usable similarity index 52% rename from gcloud/alpha/beyondcorp/client-connector/services/list rename to gcloud/workstations/list-usable index b71dc57fa..e240119ab 100644 --- a/gcloud/alpha/beyondcorp/client-connector/services/list +++ b/gcloud/workstations/list-usable @@ -1,48 +1,58 @@ NAME - gcloud alpha beyondcorp client-connector services list - list BeyondCorp - client connector service resources + gcloud workstations list-usable - list usable workstations SYNOPSIS - gcloud alpha beyondcorp client-connector services list --location=LOCATION + gcloud workstations list-usable + (--config=CONFIG : --cluster=CLUSTER --region=REGION) [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) List BeyondCorp client connector service resources based on project - and location. + List all usable workstations under the specified configuration. EXAMPLES - To list all client connector services in a project for location us-central1 - in table form, run: + To list usable workstations, run - $ gcloud alpha beyondcorp client-connector services list \ - --project=consumer-project-id --location=us-central1 - - To list all client connector service in a project for location us-central1 - with limit=1, run: - - $ gcloud alpha beyondcorp client-connector services list \ - --project=consumer-project-id --location=us-central1 --limit=1 + $ gcloud workstations list-usable REQUIRED FLAGS - Location resource - Arguments and flags that define the BeyondCorp client - connector services you want to list. This represents a Cloud resource. + Config resource - The group of arguments defining a config 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 --location on the command line with a fully + ◆ provide the argument --config on the command line with a fully specified name; - ◆ set the property core/project; - ◆ provide the argument --project on the command line. + ◆ provide the argument --project on the command line; + ◆ set the property core/project. This must be specified. - --location=LOCATION - ID of the location or fully qualified identifier for the location. + --config=CONFIG + ID of the config or fully qualified identifier for the config. - To set the location attribute: - ▸ provide the argument --location on the command line. + To set the config attribute: + ▸ provide the argument --config on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --cluster=CLUSTER + The cluster for the config. + + To set the cluster attribute: + ▸ provide the argument --config on the command line with a fully + specified name; + ▸ provide the argument --cluster on the command line. + + --region=REGION + The location for the config. + + To set the region attribute: + ▸ provide the argument --config on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. LIST COMMAND FLAGS --filter=EXPRESSION @@ -78,15 +88,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. -API REFERENCE - This command uses the beyondcorp/v1alpha API. The full documentation for - this API can be found at: https://cloud.google.com/ - NOTES - This command is currently in alpha and might change without notice. If this - command fails with API permission errors despite specifying the correct - project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + These variants are also available: - $ gcloud beta beyondcorp client-connector services list + $ gcloud alpha workstations list-usable + + $ gcloud beta workstations list-usable diff --git a/gcloud/workstations/set-iam-policy b/gcloud/workstations/set-iam-policy new file mode 100644 index 000000000..e0373437a --- /dev/null +++ b/gcloud/workstations/set-iam-policy @@ -0,0 +1,95 @@ +NAME + gcloud workstations set-iam-policy - set the IAM policy for a workstation + +SYNOPSIS + gcloud workstations set-iam-policy + (WORKSTATION : --cluster=CLUSTER --config=CONFIG --region=REGION) + POLICY_FILE [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Sets the IAM policy for the given workstation as defined in a JSON or YAML + file. + +EXAMPLES + The following command will read an IAM policy defined in a JSON file + 'policy.json' and set it for the given workstation: + + $ gcloud workstations set-iam-policy WORKSTATION policy.json + + See https://cloud.google.com/iam/docs/managing-policies for details of the + policy file format and contents. + +POSITIONAL ARGUMENTS + Workstation resource - The workstation for which to display the IAM + 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 workstation 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. + + WORKSTATION + ID of the workstation or fully qualified identifier for the + workstation. + + To set the workstation attribute: + ▸ provide the argument workstation on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --cluster=CLUSTER + The name of the cluster containing the workstation. + + To set the cluster attribute: + ▸ provide the argument workstation on the command line with a fully + specified name; + ▸ provide the argument --cluster on the command line. + + --config=CONFIG + The name of the config containing the workstation. + + To set the config attribute: + ▸ provide the argument workstation on the command line with a fully + specified name; + ▸ provide the argument --config on the command line. + + --region=REGION + The name of the region of the workstation. + + To set the region attribute: + ▸ provide the argument workstation on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + + POLICY_FILE + Path to a local JSON or YAML formatted file containing a valid policy. + + The output of the get-iam-policy command is a valid file, as is any + JSON or YAML file conforming to the structure of a Policy + (https://cloud.google.com/iam/reference/rest/v1/Policy). + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the workstations/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/workstations + +NOTES + These variants are also available: + + $ gcloud alpha workstations set-iam-policy + + $ gcloud beta workstations set-iam-policy + diff --git a/gcloud/workstations/ssh b/gcloud/workstations/ssh new file mode 100644 index 000000000..83198768c --- /dev/null +++ b/gcloud/workstations/ssh @@ -0,0 +1,109 @@ +NAME + gcloud workstations ssh - SSH into a running workstation + +SYNOPSIS + gcloud workstations ssh + (WORKSTATION : --cluster=CLUSTER --config=CONFIG --region=REGION) + [--command=COMMAND] [--port=PORT; default=22] + [--user=USER; default="user"] [GCLOUD_WIDE_FLAG ...] [-- SSH_ARGS ...] + +DESCRIPTION + SSH into a running workstation. + +EXAMPLES + To ssh into a running workstation, run: + + $ gcloud workstations ssh WORKSTATION + + To specify the workstation port, run: + + $ gcloud workstations ssh WORKSTATION --port=22 + + To ssh into a running workstation with a username, run: + + $ gcloud workstations ssh WORKSTATION --user=my-user + + To run a command on the workstation, such as getting a snapshot of the + guest's process tree, run: $ gcloud workstations ssh WORKSTATION --command="ps -ejH" + +POSITIONAL ARGUMENTS + Workstation resource - The group of arguments defining a workstation 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 workstation 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. + + WORKSTATION + ID of the workstation or fully qualified identifier for the + workstation. + + To set the workstation attribute: + ▸ provide the argument workstation on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --cluster=CLUSTER + The cluster for the workstation. + + To set the cluster attribute: + ▸ provide the argument workstation on the command line with a fully + specified name; + ▸ provide the argument --cluster on the command line. + + --config=CONFIG + The config for the workstation. + + To set the config attribute: + ▸ provide the argument workstation on the command line with a fully + specified name; + ▸ provide the argument --config on the command line. + + --region=REGION + The location for the workstation. + + To set the region attribute: + ▸ provide the argument workstation on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + + [-- SSH_ARGS ...] + Flags and positionals passed to the underlying ssh implementation. + + The '--' argument must be specified between gcloud specific args on the + left and SSH_ARGS on the right. + +FLAGS + --command=COMMAND + A command to run on the workstation. + + Runs the command on the target workstation and then exits. + + --port=PORT; default=22 + The port on the workstation to which traffic should be sent. + + --user=USER; default="user" + The username with which to SSH. + +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 workstations ssh + + $ gcloud beta workstations ssh + diff --git a/gcloud/workstations/start b/gcloud/workstations/start new file mode 100644 index 000000000..7823a5dbf --- /dev/null +++ b/gcloud/workstations/start @@ -0,0 +1,84 @@ +NAME + gcloud workstations start - start a workstation + +SYNOPSIS + gcloud workstations start + (WORKSTATION : --cluster=CLUSTER --config=CONFIG --region=REGION) + [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Start a workstation. + +EXAMPLES + To start a workstation, run + + $ gcloud workstations start WORKSTATION + +POSITIONAL ARGUMENTS + Workstation resource - The group of arguments defining a workstation 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 workstation 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. + + WORKSTATION + ID of the workstation or fully qualified identifier for the + workstation. + + To set the workstation attribute: + ▸ provide the argument workstation on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --cluster=CLUSTER + The cluster for the workstation. + + To set the cluster attribute: + ▸ provide the argument workstation on the command line with a fully + specified name; + ▸ provide the argument --cluster on the command line. + + --config=CONFIG + The config for the workstation. + + To set the config attribute: + ▸ provide the argument workstation on the command line with a fully + specified name; + ▸ provide the argument --config on the command line. + + --region=REGION + The location for the workstation. + + To set the region attribute: + ▸ provide the argument workstation 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. + +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 workstations start + + $ gcloud beta workstations start + diff --git a/gcloud/workstations/start-tcp-tunnel b/gcloud/workstations/start-tcp-tunnel new file mode 100644 index 000000000..1d7818af2 --- /dev/null +++ b/gcloud/workstations/start-tcp-tunnel @@ -0,0 +1,99 @@ +NAME + gcloud workstations start-tcp-tunnel - start a tunnel through which a local + process can forward TCP traffic to the workstation + +SYNOPSIS + gcloud workstations start-tcp-tunnel + (WORKSTATION : --cluster=CLUSTER --config=CONFIG --region=REGION) + WORKSTATION_PORT + [--local-host-port=LOCAL_HOST_PORT; default="localhost:0"] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Start a tunnel through which a local process can forward TCP traffic to the + workstation. + +EXAMPLES + To start a tunnel to port 22 on a workstation, run: + + $ gcloud workstations start-tcp-tunnel --project=my-project \ + --region=us-central1 --cluster=my-cluster --config=my-config \ + my-workstation 22 + +POSITIONAL ARGUMENTS + Workstation resource - The group of arguments defining a workstation 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 workstation 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. + + WORKSTATION + ID of the workstation or fully qualified identifier for the + workstation. + + To set the workstation attribute: + ▸ provide the argument workstation on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --cluster=CLUSTER + The cluster for the workstation. + + To set the cluster attribute: + ▸ provide the argument workstation on the command line with a fully + specified name; + ▸ provide the argument --cluster on the command line. + + --config=CONFIG + The config for the workstation. + + To set the config attribute: + ▸ provide the argument workstation on the command line with a fully + specified name; + ▸ provide the argument --config on the command line. + + --region=REGION + The location for the workstation. + + To set the region attribute: + ▸ provide the argument workstation on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + + WORKSTATION_PORT + The port on the workstation to which traffic should be sent. + +FLAGS + --local-host-port=LOCAL_HOST_PORT; default="localhost:0" + LOCAL_HOST:LOCAL_PORT on which gcloud should bind and listen for + connections that should be tunneled. + + LOCAL_PORT may be omitted, in which case it is treated as 0 and an + arbitrary unused local port is chosen. The colon also may be omitted in + that case. + + If LOCAL_PORT is 0, an arbitrary unused local port is chosen. + +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 workstations start-tcp-tunnel + + $ gcloud beta workstations start-tcp-tunnel + diff --git a/gcloud/workstations/stop b/gcloud/workstations/stop new file mode 100644 index 000000000..78c3886c6 --- /dev/null +++ b/gcloud/workstations/stop @@ -0,0 +1,84 @@ +NAME + gcloud workstations stop - stop a workstation + +SYNOPSIS + gcloud workstations stop + (WORKSTATION : --cluster=CLUSTER --config=CONFIG --region=REGION) + [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Stop a workstation. + +EXAMPLES + To stop a workstation, run + + $ gcloud workstations stop WORKSTATION + +POSITIONAL ARGUMENTS + Workstation resource - The group of arguments defining a workstation 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 workstation 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. + + WORKSTATION + ID of the workstation or fully qualified identifier for the + workstation. + + To set the workstation attribute: + ▸ provide the argument workstation on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --cluster=CLUSTER + The cluster for the workstation. + + To set the cluster attribute: + ▸ provide the argument workstation on the command line with a fully + specified name; + ▸ provide the argument --cluster on the command line. + + --config=CONFIG + The config for the workstation. + + To set the config attribute: + ▸ provide the argument workstation on the command line with a fully + specified name; + ▸ provide the argument --config on the command line. + + --region=REGION + The location for the workstation. + + To set the region attribute: + ▸ provide the argument workstation 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. + +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 workstations stop + + $ gcloud beta workstations stop +