From 8ebed5b0f1fb08f393e57f6fa957b08fcae861ba Mon Sep 17 00:00:00 2001 From: Automated Date: Wed, 18 Sep 2024 09:49:45 +0000 Subject: [PATCH] gcloud: Wed Sep 18 09:49:45 UTC 2024 --- gcloud/_version | 8 +- gcloud/alloydb/instances/restart | 6 +- gcloud/alpha/assured/workloads/create | 6 +- gcloud/alpha/compute/commitments/create | 16 +- gcloud/alpha/compute/disks/create | 2 +- gcloud/alpha/compute/disks/update | 2 +- .../compute/firewall-policies/rules/create | 2 +- .../compute/firewall-policies/rules/update | 2 +- .../alpha/compute/future-reservations/cancel | 4 +- .../alpha/compute/future-reservations/create | 12 +- .../alpha/compute/future-reservations/delete | 4 +- .../compute/future-reservations/describe | 4 +- gcloud/alpha/compute/future-reservations/help | 4 +- gcloud/alpha/compute/future-reservations/list | 4 +- .../alpha/compute/future-reservations/update | 12 +- gcloud/alpha/compute/images/list | 8 +- .../managed/resize-requests/create | 40 ++-- gcloud/alpha/compute/instances/attach-disk | 7 +- .../network-firewall-policies/rules/create | 2 +- .../network-firewall-policies/rules/update | 2 +- .../compute/reservations/blocks/describe | 62 +++++ gcloud/alpha/compute/reservations/blocks/help | 29 +++ gcloud/alpha/compute/reservations/blocks/list | 98 ++++++++ gcloud/alpha/compute/reservations/help | 8 +- gcloud/alpha/compute/snapshots/add-labels | 13 +- gcloud/alpha/compute/snapshots/delete | 15 +- .../container/attached/clusters/register | 27 +-- .../alpha/container/attached/clusters/update | 27 +-- .../database-migration/migration-jobs/promote | 16 +- .../dataplex/data-attribute-bindings/update | 2 +- .../data-taxonomies/attributes/update | 2 +- .../git-repository-links/fetch-read-token | 81 +++++++ .../fetch-read-write-token | 82 +++++++ .../connections/git-repository-links/help | 6 + gcloud/alpha/looker/instances/create | 22 +- gcloud/alpha/looker/instances/update | 29 +++ gcloud/alpha/managed-flink/deployments/create | 22 +- gcloud/alpha/managed-flink/deployments/delete | 9 +- .../alpha/managed-flink/deployments/describe | 9 +- gcloud/alpha/managed-flink/deployments/help | 11 +- gcloud/alpha/managed-flink/deployments/list | 10 +- gcloud/alpha/managed-flink/deployments/update | 9 +- gcloud/alpha/managed-flink/jobs/create | 14 +- gcloud/alpha/managed-flink/jobs/delete | 8 +- gcloud/alpha/managed-flink/jobs/describe | 8 +- gcloud/alpha/managed-flink/jobs/help | 7 +- gcloud/alpha/managed-flink/jobs/list | 8 +- gcloud/alpha/migration/help | 4 +- gcloud/alpha/migration/vms/help | 4 +- .../alpha/migration/vms/image-imports/create | 4 +- .../alpha/migration/vms/image-imports/delete | 4 +- .../migration/vms/image-imports/describe | 4 +- gcloud/alpha/migration/vms/image-imports/help | 4 +- gcloud/alpha/migration/vms/image-imports/list | 4 +- .../security-profile-groups/create | 146 ++++++++---- .../security-profile-groups/update | 17 +- gcloud/alpha/recaptcha/keys/create | 58 +++-- gcloud/alpha/recaptcha/keys/update | 7 +- .../recommender/recommendations/mark-active | 2 +- gcloud/alpha/scc/sources/describe | 24 +- gcloud/alpha/spanner/instance-configs/create | 14 +- gcloud/alpha/spanner/instance-configs/delete | 4 +- gcloud/alpha/spanner/instances/create | 18 +- gcloud/alpha/spanner/instances/update | 13 +- gcloud/alpha/sql/backups/restore | 7 +- gcloud/alpha/sql/instances/create | 7 +- gcloud/alpha/sql/instances/patch | 7 +- gcloud/alpha/workstations/configs/create | 2 +- gcloud/alpha/workstations/configs/update | 2 +- gcloud/assured/workloads/create | 6 +- gcloud/beta/assured/workloads/create | 6 +- gcloud/beta/colab-enterprise/help | 3 + .../colab-enterprise/runtime-templates/create | 2 +- .../colab-enterprise/runtime-templates/delete | 4 +- .../runtime-templates/describe | 4 +- .../runtime-templates/get-iam-policy | 2 +- .../colab-enterprise/runtime-templates/help | 8 +- .../colab-enterprise/runtime-templates/list | 2 +- gcloud/beta/colab-enterprise/runtimes/assign | 109 +++++++++ gcloud/beta/colab-enterprise/runtimes/help | 25 ++ gcloud/beta/compute/commitments/create | 16 +- gcloud/beta/compute/disks/create | 2 +- gcloud/beta/compute/disks/update | 2 +- .../compute/firewall-policies/rules/create | 21 ++ .../compute/firewall-policies/rules/update | 21 ++ .../beta/compute/future-reservations/cancel | 6 +- .../beta/compute/future-reservations/create | 6 +- .../beta/compute/future-reservations/delete | 6 +- .../beta/compute/future-reservations/describe | 6 +- gcloud/beta/compute/future-reservations/help | 6 +- gcloud/beta/compute/future-reservations/list | 6 +- .../beta/compute/future-reservations/update | 6 +- gcloud/beta/compute/images/list | 8 +- gcloud/beta/compute/instances/attach-disk | 7 +- .../network-firewall-policies/rules/create | 21 ++ .../network-firewall-policies/rules/update | 21 ++ .../beta/container/fleet/memberships/update | 2 +- gcloud/beta/container/hub/memberships/update | 2 +- .../beta/data-fusion/add-iam-policy-binding | 14 +- gcloud/beta/data-fusion/get-iam-policy | 4 +- gcloud/beta/data-fusion/instances/create | 8 +- gcloud/beta/data-fusion/instances/delete | 8 +- gcloud/beta/data-fusion/instances/describe | 8 +- gcloud/beta/data-fusion/instances/list | 2 +- gcloud/beta/data-fusion/instances/restart | 8 +- gcloud/beta/data-fusion/operations/delete | 8 +- gcloud/beta/data-fusion/operations/list | 2 +- gcloud/beta/data-fusion/operations/wait | 8 +- .../data-fusion/remove-iam-policy-binding | 14 +- gcloud/beta/data-fusion/set-iam-policy | 4 +- gcloud/beta/iap/settings/get | 2 +- gcloud/beta/iap/settings/set | 2 +- gcloud/beta/iap/web/add-iam-policy-binding | 2 +- gcloud/beta/iap/web/get-iam-policy | 2 +- gcloud/beta/iap/web/remove-iam-policy-binding | 2 +- gcloud/beta/iap/web/set-iam-policy | 2 +- .../security-profile-groups/create | 102 ++++---- .../security-profile-groups/update | 17 +- gcloud/beta/scc/sources/describe | 24 +- gcloud/beta/secrets/delete | 11 +- gcloud/beta/secrets/update | 9 +- gcloud/beta/secrets/versions/destroy | 12 +- gcloud/beta/secrets/versions/disable | 12 +- gcloud/beta/secrets/versions/enable | 12 +- gcloud/beta/spanner/instance-configs/create | 14 +- gcloud/beta/spanner/instance-configs/delete | 4 +- gcloud/beta/spanner/instances/create | 18 +- gcloud/beta/spanner/instances/update | 13 +- gcloud/beta/sql/backups/restore | 7 +- gcloud/beta/sql/instances/create | 7 +- gcloud/beta/sql/instances/patch | 7 +- gcloud/beta/workstations/configs/create | 2 +- gcloud/beta/workstations/configs/update | 2 +- gcloud/compute/disks/create | 5 +- gcloud/compute/disks/update | 2 +- gcloud/compute/future-reservations/cancel | 74 ------ gcloud/compute/future-reservations/create | 205 ---------------- gcloud/compute/future-reservations/delete | 74 ------ gcloud/compute/future-reservations/describe | 69 ------ gcloud/compute/future-reservations/help | 43 ---- gcloud/compute/future-reservations/update | 222 ------------------ gcloud/compute/help | 3 - gcloud/compute/images/create | 3 +- gcloud/compute/images/list | 8 +- gcloud/compute/instance-templates/create | 10 +- gcloud/compute/instances/attach-disk | 7 +- gcloud/compute/instances/bulk/create | 10 +- gcloud/compute/instances/create | 10 +- gcloud/container/attached/clusters/register | 27 +-- gcloud/container/attached/clusters/update | 27 +-- .../database-migration/migration-jobs/promote | 16 +- gcloud/looker/instances/update | 13 +- gcloud/migration/help | 26 ++ gcloud/migration/vms/help | 30 +++ gcloud/migration/vms/image-imports/create | 140 +++++++++++ gcloud/migration/vms/image-imports/delete | 68 ++++++ gcloud/migration/vms/image-imports/describe | 68 ++++++ gcloud/migration/vms/image-imports/help | 60 +++++ .../vms/image-imports}/list | 48 +++- gcloud/netapp/storage-pools/create | 7 +- gcloud/netapp/storage-pools/update | 14 +- gcloud/netapp/volumes/create | 13 + gcloud/netapp/volumes/update | 13 + .../security-profile-groups/create | 102 ++++---- .../security-profile-groups/update | 17 +- gcloud/recaptcha/keys/create | 58 +++-- gcloud/recaptcha/keys/update | 7 +- gcloud/scc/sources/describe | 24 +- gcloud/secrets/delete | 11 +- gcloud/secrets/update | 10 +- gcloud/secrets/versions/destroy | 13 +- gcloud/secrets/versions/disable | 13 +- gcloud/secrets/versions/enable | 13 +- gcloud/spanner/instance-configs/create | 14 +- gcloud/spanner/instance-configs/delete | 4 +- gcloud/spanner/instances/create | 18 +- gcloud/spanner/instances/update | 13 +- gcloud/sql/backups/restore | 7 +- gcloud/sql/instances/create | 7 +- gcloud/sql/instances/patch | 7 +- gcloud/workstations/configs/create | 2 +- gcloud/workstations/configs/update | 2 +- 182 files changed, 2067 insertions(+), 1436 deletions(-) create mode 100644 gcloud/alpha/compute/reservations/blocks/describe create mode 100644 gcloud/alpha/compute/reservations/blocks/help create mode 100644 gcloud/alpha/compute/reservations/blocks/list create mode 100644 gcloud/alpha/developer-connect/connections/git-repository-links/fetch-read-token create mode 100644 gcloud/alpha/developer-connect/connections/git-repository-links/fetch-read-write-token create mode 100644 gcloud/beta/colab-enterprise/runtimes/assign create mode 100644 gcloud/beta/colab-enterprise/runtimes/help delete mode 100644 gcloud/compute/future-reservations/cancel delete mode 100644 gcloud/compute/future-reservations/create delete mode 100644 gcloud/compute/future-reservations/delete delete mode 100644 gcloud/compute/future-reservations/describe delete mode 100644 gcloud/compute/future-reservations/help delete mode 100644 gcloud/compute/future-reservations/update create mode 100644 gcloud/migration/help create mode 100644 gcloud/migration/vms/help create mode 100644 gcloud/migration/vms/image-imports/create create mode 100644 gcloud/migration/vms/image-imports/delete create mode 100644 gcloud/migration/vms/image-imports/describe create mode 100644 gcloud/migration/vms/image-imports/help rename gcloud/{compute/future-reservations => migration/vms/image-imports}/list (52%) diff --git a/gcloud/_version b/gcloud/_version index d66dd0a9d..eaf323266 100644 --- a/gcloud/_version +++ b/gcloud/_version @@ -1,8 +1,8 @@ -Google Cloud SDK 492.0.0 -alpha 2024.09.06 -beta 2024.09.06 +Google Cloud SDK 493.0.0 +alpha 2024.09.13 +beta 2024.09.13 bq 2.1.8 bundled-python3-unix 3.11.9 -core 2024.09.06 +core 2024.09.13 gcloud-crc32c 1.0.0 gsutil 5.30 diff --git a/gcloud/alloydb/instances/restart b/gcloud/alloydb/instances/restart index 790a0768d..dcf2c93cd 100644 --- a/gcloud/alloydb/instances/restart +++ b/gcloud/alloydb/instances/restart @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud alloydb instances restart INSTANCE --cluster=CLUSTER --region=REGION - [--async] [GCLOUD_WIDE_FLAG ...] + [--async] [--node-ids=[NODE_IDS,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION Restarts an AlloyDB instance within a given cluster. @@ -32,6 +32,10 @@ OPTIONAL FLAGS Return immediately, without waiting for the operation in progress to complete. + --node-ids=[NODE_IDS,...] + Comma-separated list of node IDs. Only supported for read pool + instances. (e.g., --node-ids=node-1,node-2,node-3) + 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/assured/workloads/create b/gcloud/alpha/assured/workloads/create index 04bcab9f9..2476fb9d3 100644 --- a/gcloud/alpha/assured/workloads/create +++ b/gcloud/alpha/assured/workloads/create @@ -87,8 +87,10 @@ REQUIRED FLAGS The compliance regime of the new Assured Workloads environment. COMPLIANCE_REGIME must be one of: assured-workloads-for-partners, au-regions-and-us-support, ca-protected-b, ca-regions-and-support, - cjis, eu-regions-and-support, fedramp-high, fedramp-moderate, hipaa, - hitrust, il2, il4, il5, isr-regions, isr-regions-and-support, itar, + cjis, eu-regions-and-support, fedramp-high, fedramp-moderate, + healthcare-and-life-sciences-controls, + healthcare-and-life-sciences-controls-us-support, hipaa, hitrust, il2, + il4, il5, isr-regions, isr-regions-and-support, itar, jp-regions-and-support, ksa-regions-and-support-with-sovereignty-controls, regional-controls, us-regional-access. diff --git a/gcloud/alpha/compute/commitments/create b/gcloud/alpha/compute/commitments/create index fd9452525..62a385807 100644 --- a/gcloud/alpha/compute/commitments/create +++ b/gcloud/alpha/compute/commitments/create @@ -11,7 +11,8 @@ SYNOPSIS [--type=TYPE; default="general-purpose"] [--existing-reservation=[name=NAME],[zone=ZONE] | --reservations-from-file=PATH_TO_FILE | [--reservation=RESERVATION - : --reservation-zone=RESERVATION_ZONE + : --reservation-sharing-policy=RESERVATION_SHARING_POLICY + --reservation-zone=RESERVATION_ZONE --accelerator=[count=COUNT],[type=TYPE] --local-ssd=[interface=INTERFACE],[size=SIZE] --machine-type=MACHINE_TYPE @@ -144,6 +145,19 @@ OPTIONAL FLAGS This flag argument must be specified if any of the other arguments in this group are specified. + Manage the properties of a reservation sharing policy to create + + --reservation-sharing-policy=RESERVATION_SHARING_POLICY + The reservation sharing policy to use for this reservation. + RESERVATION_SHARING_POLICY must be one of: + + ALLOW_ALL + The reservation can be shared with Google Cloud services. + DISALLOW_ALL + The reservation won't be shared with Google Cloud services. + If you omit this flag during creation, the default value is + DISALLOW_ALL. + --reservation-zone=RESERVATION_ZONE Zone of the reservation to operate on. If not specified and the compute/zone property isn't set, you might be prompted to select a diff --git a/gcloud/alpha/compute/disks/create b/gcloud/alpha/compute/disks/create index 9457ce129..d2b44a308 100644 --- a/gcloud/alpha/compute/disks/create +++ b/gcloud/alpha/compute/disks/create @@ -63,7 +63,7 @@ POSITIONAL ARGUMENTS FLAGS --access-mode=ACCESS_MODE - Specifie how VMs attached to the disk can access the data on the disk. + Specifies how VMs attached to the disk can access the data on the disk. To grant read-only access to multiple VMs attached to the disk, set access-mode to READ_ONLY_MANY. To grant read-write access to only one VM attached to the disk, use READ_WRITE_SINGLE. READ_WRITE_SINGLE is diff --git a/gcloud/alpha/compute/disks/update b/gcloud/alpha/compute/disks/update index a0b4a9e89..8a3313403 100644 --- a/gcloud/alpha/compute/disks/update +++ b/gcloud/alpha/compute/disks/update @@ -41,7 +41,7 @@ POSITIONAL ARGUMENTS FLAGS --access-mode=ACCESS_MODE - Specifie how VMs attached to the disk can access the data on the disk. + Specifies how VMs attached to the disk can access the data on the disk. To grant read-only access to multiple VMs attached to the disk, set access-mode to READ_ONLY_MANY. To grant read-write access to only one VM attached to the disk, use READ_WRITE_SINGLE. READ_WRITE_SINGLE is diff --git a/gcloud/alpha/compute/firewall-policies/rules/create b/gcloud/alpha/compute/firewall-policies/rules/create index 0afeb9c6f..3081609cf 100644 --- a/gcloud/alpha/compute/firewall-policies/rules/create +++ b/gcloud/alpha/compute/firewall-policies/rules/create @@ -134,7 +134,7 @@ OPTIONAL FLAGS --src-networks=[SRC_NETWORKS,...] The source VPC networks to match for this rule. It can only be specified when --src-network-scope is VPC_NETWORKS. It applies to - ingress rules .It accepts full or partial URLs. + ingress rules. It accepts full or partial URLs. --src-region-codes=[SOURCE_REGION_CODES,...] Source Region Code to match for this rule. Can only be specified if diff --git a/gcloud/alpha/compute/firewall-policies/rules/update b/gcloud/alpha/compute/firewall-policies/rules/update index c28a9c4f1..1a2110a9c 100644 --- a/gcloud/alpha/compute/firewall-policies/rules/update +++ b/gcloud/alpha/compute/firewall-policies/rules/update @@ -139,7 +139,7 @@ OPTIONAL FLAGS --src-networks=[SRC_NETWORKS,...] The source VPC networks to match for this rule. It can only be specified when --src-network-scope is VPC_NETWORKS. It applies to - ingress rules .It accepts full or partial URLs. + ingress rules. It accepts full or partial URLs. --src-region-codes=[SOURCE_REGION_CODES,...] Source Region Code to match for this rule. Can only be specified if diff --git a/gcloud/alpha/compute/future-reservations/cancel b/gcloud/alpha/compute/future-reservations/cancel index a85766ada..c631008db 100644 --- a/gcloud/alpha/compute/future-reservations/cancel +++ b/gcloud/alpha/compute/future-reservations/cancel @@ -69,9 +69,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. These variants are also available: - - $ gcloud compute future-reservations cancel + access allowlist. This variant is also available: $ gcloud beta compute future-reservations cancel diff --git a/gcloud/alpha/compute/future-reservations/create b/gcloud/alpha/compute/future-reservations/create index 1286627bd..97d02220a 100644 --- a/gcloud/alpha/compute/future-reservations/create +++ b/gcloud/alpha/compute/future-reservations/create @@ -14,7 +14,7 @@ SYNOPSIS --min-cpu-platform=MIN_CPU_PLATFORM]) (--start-time=START_TIME (--duration=DURATION | --end-time=END_TIME)) [--deployment-type=DEPLOYMENT_TYPE] [--description=DESCRIPTION] - [--enable-opportunistic-maintenance=ENABLE_OPPORTUNISTIC_MAINTENANCE] + [--[no-]enable-opportunistic-maintenance] [--instance-termination-action=INSTANCE_TERMINATION_ACTION] [--name-prefix=NAME_PREFIX] [--planning-status=PLANNING_STATUS] [--[no-]require-specific-reservation] @@ -179,9 +179,11 @@ OPTIONAL FLAGS --description=DESCRIPTION An optional description of the future reservation to create. - --enable-opportunistic-maintenance=ENABLE_OPPORTUNISTIC_MAINTENANCE + --[no-]enable-opportunistic-maintenance Indicates if this group of VMs have opportunistic maintenance enabled. - Applicable only to dense coordinated maintenance. + Applicable only to dense coordinated maintenance. Use + --enable-opportunistic-maintenance to enable and + --no-enable-opportunistic-maintenance to disable. --instance-termination-action=INSTANCE_TERMINATION_ACTION Specific termination action for running instances at the end of @@ -313,9 +315,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. These variants are also available: - - $ gcloud compute future-reservations create + access allowlist. This variant is also available: $ gcloud beta compute future-reservations create diff --git a/gcloud/alpha/compute/future-reservations/delete b/gcloud/alpha/compute/future-reservations/delete index 7ec81eb1f..3487cf6cd 100644 --- a/gcloud/alpha/compute/future-reservations/delete +++ b/gcloud/alpha/compute/future-reservations/delete @@ -69,9 +69,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. These variants are also available: - - $ gcloud compute future-reservations delete + access allowlist. This variant is also available: $ gcloud beta compute future-reservations delete diff --git a/gcloud/alpha/compute/future-reservations/describe b/gcloud/alpha/compute/future-reservations/describe index beb281217..c0a965348 100644 --- a/gcloud/alpha/compute/future-reservations/describe +++ b/gcloud/alpha/compute/future-reservations/describe @@ -64,9 +64,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. These variants are also available: - - $ gcloud compute future-reservations describe + access allowlist. This variant is also available: $ gcloud beta compute future-reservations describe diff --git a/gcloud/alpha/compute/future-reservations/help b/gcloud/alpha/compute/future-reservations/help index 63bb74f9e..072f719be 100644 --- a/gcloud/alpha/compute/future-reservations/help +++ b/gcloud/alpha/compute/future-reservations/help @@ -38,9 +38,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. These variants are also available: - - $ gcloud compute future-reservations + access allowlist. This variant is also available: $ gcloud beta compute future-reservations diff --git a/gcloud/alpha/compute/future-reservations/list b/gcloud/alpha/compute/future-reservations/list index 9afc0b715..53e4cf08e 100644 --- a/gcloud/alpha/compute/future-reservations/list +++ b/gcloud/alpha/compute/future-reservations/list @@ -59,9 +59,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. These variants are also available: - - $ gcloud compute future-reservations list + access allowlist. This variant is also available: $ gcloud beta compute future-reservations list diff --git a/gcloud/alpha/compute/future-reservations/update b/gcloud/alpha/compute/future-reservations/update index 2eb952084..cac69ac87 100644 --- a/gcloud/alpha/compute/future-reservations/update +++ b/gcloud/alpha/compute/future-reservations/update @@ -6,7 +6,7 @@ SYNOPSIS gcloud alpha compute future-reservations update FUTURE_RESERVATION [--[no-]auto-delete-auto-created-reservations] [--deployment-type=DEPLOYMENT_TYPE] [--description=DESCRIPTION] - [--enable-opportunistic-maintenance=ENABLE_OPPORTUNISTIC_MAINTENANCE] + [--[no-]enable-opportunistic-maintenance] [--instance-termination-action=INSTANCE_TERMINATION_ACTION] [--planning-status=PLANNING_STATUS] [--[no-]require-specific-reservation] @@ -61,9 +61,11 @@ FLAGS --description=DESCRIPTION An optional description of the future reservation to create. - --enable-opportunistic-maintenance=ENABLE_OPPORTUNISTIC_MAINTENANCE + --[no-]enable-opportunistic-maintenance Indicates if this group of VMs have opportunistic maintenance enabled. - Applicable only to dense coordinated maintenance. + Applicable only to dense coordinated maintenance. Use + --enable-opportunistic-maintenance to enable and + --no-enable-opportunistic-maintenance to disable. --instance-termination-action=INSTANCE_TERMINATION_ACTION Specific termination action for running instances at the end of @@ -305,9 +307,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. These variants are also available: - - $ gcloud compute future-reservations update + access allowlist. This variant is also available: $ gcloud beta compute future-reservations update diff --git a/gcloud/alpha/compute/images/list b/gcloud/alpha/compute/images/list index 802af3d57..3fd3a8cd3 100644 --- a/gcloud/alpha/compute/images/list +++ b/gcloud/alpha/compute/images/list @@ -58,10 +58,10 @@ FLAGS --standard-images List images from public image projects. The public image projects that are available include the following: cos-cloud, debian-cloud, - rocky-linux-cloud, centos-cloud, fedora-coreos-cloud, opensuse-cloud, - rhel-cloud, rhel-sap-cloud, suse-cloud, suse-sap-cloud, - ubuntu-os-cloud, ubuntu-os-pro-cloud, windows-cloud, windows-sql-cloud. - Enabled by default, use --no-standard-images to disable. + rocky-linux-cloud, ubuntu-os-cloud, centos-cloud, fedora-coreos-cloud, + opensuse-cloud, rhel-cloud, rhel-sap-cloud, suse-cloud, suse-sap-cloud, + ubuntu-os-pro-cloud, windows-cloud, windows-sql-cloud. Enabled by + default, use --no-standard-images to disable. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/alpha/compute/instance-groups/managed/resize-requests/create b/gcloud/alpha/compute/instance-groups/managed/resize-requests/create index 659050d51..eeccbfdf3 100644 --- a/gcloud/alpha/compute/instance-groups/managed/resize-requests/create +++ b/gcloud/alpha/compute/instance-groups/managed/resize-requests/create @@ -3,11 +3,10 @@ NAME create a Compute Engine managed instance group resize request SYNOPSIS - gcloud alpha compute instance-groups managed resize-requests create - INSTANCE_GROUP_MANAGER --resize-by=RESIZE_BY - --resize-request=RESIZE_REQUEST_NAME - [--requested-run-duration=REQUESTED_RUN_DURATION] [--zone=ZONE] - [GCLOUD_WIDE_FLAG ...] + gcloud alpha compute instance-groups managed resize-requests create NAME + --resize-by=RESIZE_BY --resize-request=RESIZE_REQUEST_NAME + [--requested-run-duration=REQUESTED_RUN_DURATION] + [--region=REGION | --zone=ZONE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Create a Compute Engine managed instance group resize request. @@ -21,7 +20,7 @@ EXAMPLES --requested-run-duration=3d1h30s POSITIONAL ARGUMENTS - INSTANCE_GROUP_MANAGER + NAME Name of the managed instance group to operate on. REQUIRED FLAGS @@ -40,26 +39,29 @@ OPTIONAL FLAGS day, 2 hours, 3 minutes, and 4 seconds. The value must be between 10m (10 minutes) and 7d (7 days). - --zone=ZONE - Zone of the managed instance group 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). + At most one of these can be specified: - To avoid prompting when this flag is omitted, you can set the - compute/zone property: + --region=REGION + Region of the managed instance group to operate on. If not specified, + you might be prompted to select a region (interactive mode only). - $ gcloud config set compute/zone ZONE + A list of regions can be fetched by running: - A list of zones can be fetched by running: + $ gcloud compute regions list - $ gcloud compute zones list + Overrides the default compute/region property value for this command + invocation. - To unset the property, run: + --zone=ZONE + Zone of the managed instance group to operate on. If not specified, + you might be prompted to select a zone (interactive mode only). - $ gcloud config unset compute/zone + A list of zones can be fetched by running: - Alternatively, the zone can be stored in the environment variable - CLOUDSDK_COMPUTE_ZONE. + $ gcloud compute zones list + + Overrides the default compute/zone property value for this command + invocation. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/compute/instances/attach-disk b/gcloud/alpha/compute/instances/attach-disk index a4400465f..533a05d8d 100644 --- a/gcloud/alpha/compute/instances/attach-disk +++ b/gcloud/alpha/compute/instances/attach-disk @@ -22,6 +22,8 @@ DESCRIPTION mount (https://cloud.google.com/compute/docs/disks/add-persistent-disk#formatting) the disk so that the operating system can use the available storage space. + You can attach an existing non-boot disk to more than one instance. For + more information, see Share a disk between VMs. EXAMPLES To attach a disk named 'my-disk' as a boot disk to an instance named @@ -97,10 +99,7 @@ OPTIONAL FLAGS ro Read-only. rw - Read-write. It is an error to attach a disk in read-write mode to - more than one instance. For details on how to share persistent - disks between multiple instances, refer to - https://cloud.google.com/compute/docs/disks/add-persistent-disk#use_multi_instances + Read-write. --zone=ZONE Zone of the instance to operate on. If not specified, you might be diff --git a/gcloud/alpha/compute/network-firewall-policies/rules/create b/gcloud/alpha/compute/network-firewall-policies/rules/create index 5d761b835..ae42bdb15 100644 --- a/gcloud/alpha/compute/network-firewall-policies/rules/create +++ b/gcloud/alpha/compute/network-firewall-policies/rules/create @@ -141,7 +141,7 @@ OPTIONAL FLAGS --src-networks=[SRC_NETWORKS,...] The source VPC networks to match for this rule. It can only be specified when --src-network-scope is VPC_NETWORKS. It applies to - ingress rules .It accepts full or partial URLs. + ingress rules. It accepts full or partial URLs. --src-region-codes=[SOURCE_REGION_CODES,...] Source Region Code to match for this rule. Can only be specified if diff --git a/gcloud/alpha/compute/network-firewall-policies/rules/update b/gcloud/alpha/compute/network-firewall-policies/rules/update index 4d59ed215..d35a7fce7 100644 --- a/gcloud/alpha/compute/network-firewall-policies/rules/update +++ b/gcloud/alpha/compute/network-firewall-policies/rules/update @@ -137,7 +137,7 @@ OPTIONAL FLAGS --src-networks=[SRC_NETWORKS,...] The source VPC networks to match for this rule. It can only be specified when --src-network-scope is VPC_NETWORKS. It applies to - ingress rules .It accepts full or partial URLs. + ingress rules. It accepts full or partial URLs. --src-region-codes=[SOURCE_REGION_CODES,...] Source Region Code to match for this rule. Can only be specified if diff --git a/gcloud/alpha/compute/reservations/blocks/describe b/gcloud/alpha/compute/reservations/blocks/describe new file mode 100644 index 000000000..a8ef8e7fb --- /dev/null +++ b/gcloud/alpha/compute/reservations/blocks/describe @@ -0,0 +1,62 @@ +NAME + gcloud alpha compute reservations blocks describe - describe a Compute + Engine image + +SYNOPSIS + gcloud alpha compute reservations blocks describe RESERVATION + --block-name=BLOCK_NAME [--zone=ZONE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe a Compute Engine image. + +EXAMPLES + To describe a reservation block in reservation exr1 in my-zone with block + name block1, run: + + $ gcloud alpha compute reservations blocks describe exr1 \ + --zone=my-zone --block-name=block1 + +POSITIONAL ARGUMENTS + RESERVATION + Name of the reservation to describe. + +REQUIRED FLAGS + --block-name=BLOCK_NAME + The name of the reservation block. + +OPTIONAL FLAGS + --zone=ZONE + Zone of the reservation to describe. If not specified and the + compute/zone property isn't set, you might be prompted to select a zone + (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/zone property: + + $ gcloud config set compute/zone ZONE + + A list of zones can be fetched by running: + + $ gcloud compute zones list + + To unset the property, run: + + $ gcloud config unset compute/zone + + Alternatively, the zone can be stored in the environment variable + CLOUDSDK_COMPUTE_ZONE. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/compute/reservations/blocks/help b/gcloud/alpha/compute/reservations/blocks/help new file mode 100644 index 000000000..63bd4ccce --- /dev/null +++ b/gcloud/alpha/compute/reservations/blocks/help @@ -0,0 +1,29 @@ +NAME + gcloud alpha compute reservations blocks - + +SYNOPSIS + gcloud alpha compute reservations blocks COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Compute Engine reservation blocks. + +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 Compute Engine image. + + list + (ALPHA) List Compute Engine reservation blocks. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/compute/reservations/blocks/list b/gcloud/alpha/compute/reservations/blocks/list new file mode 100644 index 000000000..f70754c36 --- /dev/null +++ b/gcloud/alpha/compute/reservations/blocks/list @@ -0,0 +1,98 @@ +NAME + gcloud alpha compute reservations blocks list - list Compute Engine + reservation blocks + +SYNOPSIS + gcloud alpha compute reservations blocks list RESERVATION [--zone=ZONE] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) gcloud alpha compute reservations blocks list displays all Compute + Engine reservation blocks in an extended reservation. + +EXAMPLES + To list all reservation blocks in an extended reservation in table form, + run: + + $ gcloud alpha compute reservations blocks list \ + extended-reservation --zone=us-central1-a --project=my-project + + To list the URIs of all reservation blocks in an extended reservation, run: + + $ gcloud alpha compute reservations blocks list \ + extended-reservation --zone=us-central1-a --project=my-project \ + --uri + +POSITIONAL ARGUMENTS + RESERVATION + Name of the reservation to operate on. + +FLAGS + --zone=ZONE + Zone of the reservation 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. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/compute/reservations/help b/gcloud/alpha/compute/reservations/help index ade393b9f..de4918e44 100644 --- a/gcloud/alpha/compute/reservations/help +++ b/gcloud/alpha/compute/reservations/help @@ -2,7 +2,7 @@ NAME gcloud alpha compute reservations - manage Compute Engine reservations SYNOPSIS - gcloud alpha compute reservations COMMAND [GCLOUD_WIDE_FLAG ...] + gcloud alpha compute reservations GROUP | COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Manage Compute Engine reservations. @@ -18,6 +18,12 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. +GROUPS + GROUP is one of the following: + + blocks + (ALPHA) + COMMANDS COMMAND is one of the following: diff --git a/gcloud/alpha/compute/snapshots/add-labels b/gcloud/alpha/compute/snapshots/add-labels index 4cd4fb12a..e4dc3146c 100644 --- a/gcloud/alpha/compute/snapshots/add-labels +++ b/gcloud/alpha/compute/snapshots/add-labels @@ -4,7 +4,8 @@ NAME SYNOPSIS gcloud alpha compute snapshots add-labels SNAPSHOT_NAME - --labels=[KEY=VALUE,...] [GCLOUD_WIDE_FLAG ...] + --labels=[KEY=VALUE,...] [--global | --region=REGION] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) gcloud alpha compute snapshots add-labels adds labels to a Google @@ -34,6 +35,16 @@ REQUIRED FLAGS --labels=[KEY=VALUE,...] A list of labels to add. +OPTIONAL FLAGS + At most one of these can be specified: + + --global + If set, the snapshot is global. + + --region=REGION + Region of the snapshot to operate on. Overrides the default + compute/region property value for this command invocation. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/compute/snapshots/delete b/gcloud/alpha/compute/snapshots/delete index eb23dddf5..67ee3a286 100644 --- a/gcloud/alpha/compute/snapshots/delete +++ b/gcloud/alpha/compute/snapshots/delete @@ -3,11 +3,10 @@ NAME SYNOPSIS gcloud alpha compute snapshots delete SNAPSHOT_NAME [SNAPSHOT_NAME ...] - [GCLOUD_WIDE_FLAG ...] + [--global | --region=REGION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) gcloud alpha compute snapshots delete deletes one or more Compute - Engine snapshots. + (ALPHA) Delete Compute Engine snapshots. EXAMPLES To delete Compute Engine snapshots with the names 'snapshot-1' and @@ -28,6 +27,16 @@ POSITIONAL ARGUMENTS SNAPSHOT_NAME [SNAPSHOT_NAME ...] Names of the snapshots to delete. +FLAGS + At most one of these can be specified: + + --global + If set, the snapshots are global. + + --region=REGION + Region of the snapshots to delete. Overrides the default + compute/region property value for this command invocation. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/container/attached/clusters/register b/gcloud/alpha/container/attached/clusters/register index edeb3dda1..a081da4e2 100644 --- a/gcloud/alpha/container/attached/clusters/register +++ b/gcloud/alpha/container/attached/clusters/register @@ -12,8 +12,8 @@ SYNOPSIS [--annotations=ANNOTATION,[ANNOTATION,...]] [--binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE] [--description=DESCRIPTION] [--enable-managed-prometheus] - [--logging=COMPONENT,[COMPONENT,...]] - [--security-posture=SECURITY_POSTURE] [--validate-only] + [--logging=COMPONENT,[COMPONENT,...]] [--validate-only] + [--workload-vulnerability-scanning=WORKLOAD_VULNERABILITY_SCANNING] [--proxy-secret-name=PROXY_SECRET_NAME --proxy-secret-namespace=PROXY_SECRET_NAMESPACE] [GCLOUD_WIDE_FLAG ...] @@ -181,21 +181,20 @@ OPTIONAL FLAGS COMPONENT must be one of: NONE, SYSTEM, WORKLOAD. - --security-posture=SECURITY_POSTURE - Sets the mode of the Kubernetes security posture API's off-cluster - features. - - To enable advanced mode explicitly set the flag to - --security-posture=enterprise. - - To disable in an existing cluster, explicitly set the flag to - --security-posture=disabled. - - SECURITY_POSTURE must be one of: disabled, enterprise. - --validate-only Validate the cluster to create, but don't actually perform it. + --workload-vulnerability-scanning=WORKLOAD_VULNERABILITY_SCANNING + Sets the mode of the Kubernetes security posture API's workload + vulnerability scanning. To enable Advanced vulnerability insights mode + explicitly set the flag to + --workload-vulnerability-scanning=enterprise. + + To disable in an existing cluster, explicitly set the flag to + --workload-vulnerability-scanning=disabled. + + WORKLOAD_VULNERABILITY_SCANNING must be one of: disabled, enterprise. + Proxy config --proxy-secret-name=PROXY_SECRET_NAME diff --git a/gcloud/alpha/container/attached/clusters/update b/gcloud/alpha/container/attached/clusters/update index 3627ecf35..d6ce6a7a9 100644 --- a/gcloud/alpha/container/attached/clusters/update +++ b/gcloud/alpha/container/attached/clusters/update @@ -9,8 +9,8 @@ SYNOPSIS [--binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE] [--clear-description] [--description=DESCRIPTION] [--logging=COMPONENT,[COMPONENT,...]] - [--platform-version=PLATFORM_VERSION] - [--security-posture=SECURITY_POSTURE] [--validate-only] + [--platform-version=PLATFORM_VERSION] [--validate-only] + [--workload-vulnerability-scanning=WORKLOAD_VULNERABILITY_SCANNING] [--admin-groups=[GROUP,...] | --clear-admin-groups] [--admin-users=[USER,...] | --clear-admin-users] [--disable-managed-prometheus | --enable-managed-prometheus] @@ -99,21 +99,20 @@ FLAGS Replace LOCATION with the target Google Cloud location for the cluster. - --security-posture=SECURITY_POSTURE - Sets the mode of the Kubernetes security posture API's off-cluster - features. - - To enable advanced mode explicitly set the flag to - --security-posture=enterprise. - - To disable in an existing cluster, explicitly set the flag to - --security-posture=disabled. - - SECURITY_POSTURE must be one of: disabled, enterprise. - --validate-only Validate the update of the cluster, but don't actually perform it. + --workload-vulnerability-scanning=WORKLOAD_VULNERABILITY_SCANNING + Sets the mode of the Kubernetes security posture API's workload + vulnerability scanning. To enable Advanced vulnerability insights mode + explicitly set the flag to + --workload-vulnerability-scanning=enterprise. + + To disable in an existing cluster, explicitly set the flag to + --workload-vulnerability-scanning=disabled. + + WORKLOAD_VULNERABILITY_SCANNING must be one of: disabled, enterprise. + Admin groups At most one of these can be specified: diff --git a/gcloud/alpha/database-migration/migration-jobs/promote b/gcloud/alpha/database-migration/migration-jobs/promote index fb67dfd1e..405bf3a8c 100644 --- a/gcloud/alpha/database-migration/migration-jobs/promote +++ b/gcloud/alpha/database-migration/migration-jobs/promote @@ -13,13 +13,13 @@ EXAMPLES To promote a migration job: $ gcloud alpha database-migration migration-jobs promote \ - MIGRATION_JOB --region=us-central1 + MIGRATION_JOB --region=us-central1 POSITIONAL ARGUMENTS - Migration job resource - Migration job resource - Cloud Database Migration - Service migration job to promote. The arguments in this group can be used - to specify the attributes of this resource. (NOTE) Some attributes are not - given arguments in this group but can be set in other ways. + Migration job resource - The migration job to promote. The arguments in + this group can be used to specify the attributes of this resource. (NOTE) + Some attributes are not given arguments in this group but can be set in + other ways. To set the project attribute: ◆ provide the argument migration_job on the command line with a fully @@ -40,7 +40,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --region=REGION - The name of the region. + The Cloud region for the migration_job. To set the region attribute: ▸ provide the argument migration_job on the command line with a @@ -55,10 +55,6 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. -API REFERENCE - This command uses the datamigration/v1alpha2 API. The full documentation - for this API can be found at: https://cloud.google.com/database-migration/ - 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/dataplex/data-attribute-bindings/update b/gcloud/alpha/dataplex/data-attribute-bindings/update index cf282dbfa..46d5285ae 100644 --- a/gcloud/alpha/dataplex/data-attribute-bindings/update +++ b/gcloud/alpha/dataplex/data-attribute-bindings/update @@ -62,7 +62,7 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS --etag=ETAG - etag value for particulat Data Attribute Binding resource. + etag value of the Data Attribute Binding resource. OPTIONAL FLAGS --description=DESCRIPTION diff --git a/gcloud/alpha/dataplex/data-taxonomies/attributes/update b/gcloud/alpha/dataplex/data-taxonomies/attributes/update index 10e2d1bd9..924634b0b 100644 --- a/gcloud/alpha/dataplex/data-taxonomies/attributes/update +++ b/gcloud/alpha/dataplex/data-taxonomies/attributes/update @@ -87,7 +87,7 @@ FLAGS Display Name of the Data Attribute. --etag=ETAG - etag value for particular Data Attribute resource. + etag value of the Data Attribute resource. --labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to add. diff --git a/gcloud/alpha/developer-connect/connections/git-repository-links/fetch-read-token b/gcloud/alpha/developer-connect/connections/git-repository-links/fetch-read-token new file mode 100644 index 000000000..b7eb6a2fb --- /dev/null +++ b/gcloud/alpha/developer-connect/connections/git-repository-links/fetch-read-token @@ -0,0 +1,81 @@ +NAME + gcloud alpha developer-connect connections git-repository-links + fetch-read-token - fetch the read token of a given gitRepositoryLink + +SYNOPSIS + gcloud alpha developer-connect connections git-repository-links + fetch-read-token + (GIT_REPOSITORY_LINK : --connection=CONNECTION --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Fetch the read token of a given gitRepositoryLink. + +EXAMPLES + To get the read token of a GitRepositoryLink named "my-git-repository-link" + in a Connection named "my-connection" in location "us-central1": + + $ gcloud alpha developer-connect connections git-repository-links \ + fetch-read-token fetch-read-token my-git-repository-link \ + --connection=my-connection --location=us-central1 \ + --project=my-project + +POSITIONAL ARGUMENTS + GitRepositoryLink resource - Developer Connect GitRepositoryLink from + which to fetch the read token. 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 git_repository_link 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. + + GIT_REPOSITORY_LINK + ID of the gitRepositoryLink or fully qualified identifier for the + gitRepositoryLink. + + To set the git_repository_link attribute: + ▸ provide the argument git_repository_link on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --connection=CONNECTION + The connection id of the gitRepositoryLink resource. + + To set the connection attribute: + ▸ provide the argument git_repository_link on the command line with + a fully specified name; + ▸ provide the argument --connection on the command line. + + --location=LOCATION + The location id of the gitRepositoryLink resource. + + To set the location attribute: + ▸ provide the argument git_repository_link 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 developerconnect/v1 API. The full documentation for + this API can be found at: + http://cloud.google.com/developer-connect/docs/overview + +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/developer-connect/connections/git-repository-links/fetch-read-write-token b/gcloud/alpha/developer-connect/connections/git-repository-links/fetch-read-write-token new file mode 100644 index 000000000..14d14bc55 --- /dev/null +++ b/gcloud/alpha/developer-connect/connections/git-repository-links/fetch-read-write-token @@ -0,0 +1,82 @@ +NAME + gcloud alpha developer-connect connections git-repository-links + fetch-read-write-token - fetch the read/write token of a given + gitRepositoryLink + +SYNOPSIS + gcloud alpha developer-connect connections git-repository-links + fetch-read-write-token + (GIT_REPOSITORY_LINK : --connection=CONNECTION --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Fetch the read/write token of a given gitRepositoryLink. + +EXAMPLES + To get the read/write token of a GitRepositoryLink named + "my-git-repository-link" in a Connection named "my-connection": + + $ gcloud alpha developer-connect connections git-repository-links \ + fetch-read-write-token fetch-read-write-token \ + my-git-repository-link --connection=my-connection \ + --location=us-central1 --project=my-project + +POSITIONAL ARGUMENTS + GitRepositoryLink resource - Developer Connect GitRepositoryLink from + which to fetch the read/write token. 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 git_repository_link 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. + + GIT_REPOSITORY_LINK + ID of the gitRepositoryLink or fully qualified identifier for the + gitRepositoryLink. + + To set the git_repository_link attribute: + ▸ provide the argument git_repository_link on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --connection=CONNECTION + The connection id of the gitRepositoryLink resource. + + To set the connection attribute: + ▸ provide the argument git_repository_link on the command line with + a fully specified name; + ▸ provide the argument --connection on the command line. + + --location=LOCATION + The location id of the gitRepositoryLink resource. + + To set the location attribute: + ▸ provide the argument git_repository_link 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 developerconnect/v1 API. The full documentation for + this API can be found at: + http://cloud.google.com/developer-connect/docs/overview + +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/developer-connect/connections/git-repository-links/help b/gcloud/alpha/developer-connect/connections/git-repository-links/help index a288f0595..6e40f003e 100644 --- a/gcloud/alpha/developer-connect/connections/git-repository-links/help +++ b/gcloud/alpha/developer-connect/connections/git-repository-links/help @@ -26,6 +26,12 @@ COMMANDS describe (ALPHA) Describe gitRepositoryLinks. + fetch-read-token + (ALPHA) Fetch the read token of a given gitRepositoryLink. + + fetch-read-write-token + (ALPHA) Fetch the read/write token of a given gitRepositoryLink. + list (ALPHA) List gitRepositoryLinks. diff --git a/gcloud/alpha/looker/instances/create b/gcloud/alpha/looker/instances/create index 89d7599d1..ea19f05dd 100644 --- a/gcloud/alpha/looker/instances/create +++ b/gcloud/alpha/looker/instances/create @@ -4,14 +4,15 @@ NAME SYNOPSIS gcloud alpha looker instances create (INSTANCE : --region=REGION) --edition=EDITION --oauth-client-id=OAUTH_CLIENT_ID - --oauth-client-secret=OAUTH_CLIENT_SECRET [--async] [--kms-key=KMS_KEY] - [--no-public-ip-enabled] + --oauth-client-secret=OAUTH_CLIENT_SECRET [--async] [--fips-enabled] + [--kms-key=KMS_KEY] [--no-public-ip-enabled] [--consumer-network=CONSUMER_NETWORK --private-ip-enabled : --reserved-range=RESERVED_RANGE] [--deny-maintenance-period-end-date=DENY_MAINTENANCE_PERIOD_END_DATE --deny-maintenance-period-start-date=DENY_MAINTENANCE_PERIOD_START_DATE --deny-maintenance-period-time=DENY_MAINTENANCE_PERIOD_TIME] [--maintenance-window-day=MAINTENANCE_WINDOW_DAY --maintenance-window-time=MAINTENANCE_WINDOW_TIME] + [--psc-enabled : --psc-allowed-vpcs=[PSC_ALLOWED_VPCS,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -115,6 +116,9 @@ OPTIONAL FLAGS Return immediately, without waiting for the operation in progress to complete. + --fips-enabled + This specifies whether FIPS is enabled on the Looker instance. + Key resource - The Cloud KMS (Key Management Service) cryptokey that will be used to protect the Looker instance and backups. The 'Looker Service Agent' service account must hold permission 'Cloud KMS CryptoKey @@ -203,6 +207,20 @@ OPTIONAL FLAGS This flag argument must be specified if any of the other arguments in this group are specified. + Private Service Connect - Private Service Connect allows private + consumption of services across VPC networks that belong to different + groups, teams, projects, or organizations. + + --psc-enabled + This specifies whether Private Service Connect (PSC) is enabled on + the Looker instance. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --psc-allowed-vpcs=[PSC_ALLOWED_VPCS,...] + List of VPCs that are allowed ingress into the Looker instance. + 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/looker/instances/update b/gcloud/alpha/looker/instances/update index 51d9ce50e..e333f2135 100644 --- a/gcloud/alpha/looker/instances/update +++ b/gcloud/alpha/looker/instances/update @@ -10,6 +10,9 @@ SYNOPSIS [--add-developer-users=ADD_DEVELOPER_USERS --add-standard-users=ADD_STANDARD_USERS --add-viewer-users=ADD_VIEWER_USERS] + [--clear-psc-allowed-vpcs | --psc-allowed-vpcs=[PSC_ALLOWED_VPCS,...] + --clear-psc-service-attachments + | --psc-service-attachment=[attachment=ATTACHMENT],[domain=DOMAIN]] [--deny-maintenance-period-end-date=DENY_MAINTENANCE_PERIOD_END_DATE --deny-maintenance-period-start-date=DENY_MAINTENANCE_PERIOD_START_DATE --deny-maintenance-period-time=DENY_MAINTENANCE_PERIOD_TIME] [--maintenance-window-day=MAINTENANCE_WINDOW_DAY @@ -115,6 +118,32 @@ FLAGS --add-viewer-users=ADD_VIEWER_USERS Number of additional Viewer Users to allocate to the Looker Instance. + Private Service Connect - Private Service Connect allows the Looker + Instance to be reached via a private connection from inside a VPC network, + and for the Looker Instance to connect to managed services via private + connections. + + At most one of these can be specified: + + --clear-psc-allowed-vpcs + Remove all service attachments from the PSC config of the instance. + + --psc-allowed-vpcs=[PSC_ALLOWED_VPCS,...] + List of VPCs that are allowed ingress into the Looker instance. + + At most one of these can be specified: + + --clear-psc-service-attachments + Remove all allowed VPCs from the PSC config of the instance. + + --psc-service-attachment=[attachment=ATTACHMENT],[domain=DOMAIN] + Service attachments representing egress connections for the Looker + instance. This flag can be repeated. (Example: + --psc-service-attachment + domain="mydomain.com",attachment="projects/my-project/regions/us-east1/serviceAttachments/sa" + --psc-service-attachments + domain="mydomain.com",attachment="projects/my-project/regions/us-east1/serviceAttachments/sa") + Deny Maintanence Period - You must allow at least 48 hours of maintenance availability in a 60-day rolling window. Only contiguous availability windows of at least two hours are considered. When setting a maintenance diff --git a/gcloud/alpha/managed-flink/deployments/create b/gcloud/alpha/managed-flink/deployments/create index 00c45a009..3ea1d5875 100644 --- a/gcloud/alpha/managed-flink/deployments/create +++ b/gcloud/alpha/managed-flink/deployments/create @@ -1,30 +1,30 @@ NAME - gcloud alpha managed-flink deployments create - create a Managed Flink - deployment + gcloud alpha managed-flink deployments create - create a BigQuery Engine + for Apache Flink deployment SYNOPSIS gcloud alpha managed-flink deployments create (DEPLOYMENT : --location=LOCATION) --max-slots=MAX_SLOTS [--async] - [--display-name=DISPLAY_NAME] [--secrets-path=SECRETS_PATH] + [--display-name=DISPLAY_NAME] [--network-config-subnetwork=NETWORK_CONFIG_SUBNETWORK --network-config-vpc=NETWORK_CONFIG_VPC] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Create a Managed Flink deployment. + (ALPHA) Create a BigQuery Engine for Apache Flink deployment. EXAMPLES - To create a Managed Flink deployment, run: + To create a BigQuery Engine for Apache Flink deployment, run: $ gcloud alpha managed-flink deployments create my-deployment \ --location=us-central1 - To create a Managed Flink deployment with all optional parameters set, run: + To create a BigQuery Engine for Apache Flink deployment with all optional + parameters set, run: $ gcloud alpha managed-flink deployments create my-deployment \ --location=us-central1 --max-slots=100 \ - --secrets-path=projects/my-project/secrets/my-secret/versions/\ - 1 --network-config-vpc=my-vpc \ - --network-config-subnetwork=my-subnetwork + --network-config-vpc=my-vpc \ + --network-config-subnetwork=my-subnetwork POSITIONAL ARGUMENTS Deployment resource - Identifies the deployment for which the command @@ -72,10 +72,6 @@ OPTIONAL FLAGS --display-name=DISPLAY_NAME display name of the Flink deployment. - --secrets-path=SECRETS_PATH - path to the secrets manager for the Flink deployment. (ie. - projects/{my-project}/secrets/{my-secret}/versions/{1}) - --network-config-subnetwork=NETWORK_CONFIG_SUBNETWORK subnetwork for the Flink deployment network config. diff --git a/gcloud/alpha/managed-flink/deployments/delete b/gcloud/alpha/managed-flink/deployments/delete index 4302238cd..d433d8776 100644 --- a/gcloud/alpha/managed-flink/deployments/delete +++ b/gcloud/alpha/managed-flink/deployments/delete @@ -1,16 +1,17 @@ NAME - gcloud alpha managed-flink deployments delete - delete a Managed Flink - deployment + gcloud alpha managed-flink deployments delete - delete a BigQuery Engine + for Apache Flink deployment SYNOPSIS gcloud alpha managed-flink deployments delete (DEPLOYMENT : --location=LOCATION) [--async] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Delete a Managed Flink deployment. + (ALPHA) Delete a BigQuery Engine for Apache Flink deployment. EXAMPLES - To delete a Managed Flink whose ID is mydeployment, run the following: + To delete a BigQuery Engine for Apache Flink whose ID is mydeployment, run + the following: $ gcloud alpha managed-flink deployments delete mydeployment \ --location=us-central1 diff --git a/gcloud/alpha/managed-flink/deployments/describe b/gcloud/alpha/managed-flink/deployments/describe index 3504cb1fc..49ba1b741 100644 --- a/gcloud/alpha/managed-flink/deployments/describe +++ b/gcloud/alpha/managed-flink/deployments/describe @@ -1,16 +1,17 @@ NAME - gcloud alpha managed-flink deployments describe - describe a Managed Flink - deployment + gcloud alpha managed-flink deployments describe - describe a BigQuery + Engine for Apache Flink deployment SYNOPSIS gcloud alpha managed-flink deployments describe (DEPLOYMENT : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Describe a Managed Flink deployment. + (ALPHA) Describe a BigQuery Engine for Apache Flink deployment. EXAMPLES - To describe a Managed Flink whose ID is mydeployment, run the following: + To describe a BigQuery Engine for Apache Flink whose ID is mydeployment, + run the following: $ gcloud alpha managed-flink deployments describe mydeployment \ --location=us-central1 diff --git a/gcloud/alpha/managed-flink/deployments/help b/gcloud/alpha/managed-flink/deployments/help index 25eb86528..f3929c824 100644 --- a/gcloud/alpha/managed-flink/deployments/help +++ b/gcloud/alpha/managed-flink/deployments/help @@ -16,19 +16,20 @@ COMMANDS COMMAND is one of the following: create - (ALPHA) Create a Managed Flink deployment. + (ALPHA) Create a BigQuery Engine for Apache Flink deployment. delete - (ALPHA) Delete a Managed Flink deployment. + (ALPHA) Delete a BigQuery Engine for Apache Flink deployment. describe - (ALPHA) Describe a Managed Flink deployment. + (ALPHA) Describe a BigQuery Engine for Apache Flink deployment. list - (ALPHA) List all Managed Flink deployments in a given location. + (ALPHA) List all BigQuery Engine for Apache Flink deployments in a + given location. update - (ALPHA) Update a Managed Flink deployment. + (ALPHA) Update a BigQuery Engine for Apache Flink deployment. NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/managed-flink/deployments/list b/gcloud/alpha/managed-flink/deployments/list index 7d91daa48..3e2a6f6e0 100644 --- a/gcloud/alpha/managed-flink/deployments/list +++ b/gcloud/alpha/managed-flink/deployments/list @@ -1,6 +1,6 @@ NAME - gcloud alpha managed-flink deployments list - list all Managed Flink - deployments in a given location + gcloud alpha managed-flink deployments list - list all BigQuery Engine for + Apache Flink deployments in a given location SYNOPSIS gcloud alpha managed-flink deployments list LOCATION [--filter=EXPRESSION] @@ -8,10 +8,12 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) List all Managed Flink deployments in a given location. + (ALPHA) List all BigQuery Engine for Apache Flink deployments in a given + location. EXAMPLES - To list all Managed Flink deployments in a given location, run: + To list all BigQuery Engine for Apache Flink deployments in a given + location, run: $ gcloud alpha managed-flink deployments list us-central1 diff --git a/gcloud/alpha/managed-flink/deployments/update b/gcloud/alpha/managed-flink/deployments/update index be7a9b25a..2796b7320 100644 --- a/gcloud/alpha/managed-flink/deployments/update +++ b/gcloud/alpha/managed-flink/deployments/update @@ -1,6 +1,6 @@ NAME - gcloud alpha managed-flink deployments update - update a Managed Flink - deployment + gcloud alpha managed-flink deployments update - update a BigQuery Engine + for Apache Flink deployment SYNOPSIS gcloud alpha managed-flink deployments update @@ -8,10 +8,11 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Update a Managed Flink deployment. + (ALPHA) Update a BigQuery Engine for Apache Flink deployment. EXAMPLES - To update a Managed Flink whose ID is mydeployment, run the following: + To update a BigQuery Engine for Apache Flink whose ID is mydeployment, run + the following: $ gcloud alpha managed-flink deployments update mydeployment \ --location=us-central1 --max-slots=100 diff --git a/gcloud/alpha/managed-flink/jobs/create b/gcloud/alpha/managed-flink/jobs/create index 63ba8665e..a9461e79d 100644 --- a/gcloud/alpha/managed-flink/jobs/create +++ b/gcloud/alpha/managed-flink/jobs/create @@ -3,14 +3,15 @@ NAME SYNOPSIS gcloud alpha managed-flink jobs create JAR|PY|SQL --location=LOCATION - --staging-location=STAGING_LOCATION [--project=PROJECT_ID] [--async] + --staging-location=STAGING_LOCATION [--project=PROJECT_ID] + [--archives=[ZIP,...]] [--async] [--autotuning-mode=AUTOTUNING_MODE; default="elastic"] [--class=CLASS] [--deployment=DEPLOYMENT_NAME] [--dry-run] [--enable-output] [--jars=[JAR,...]] [--job-type=JOB_TYPE; default="auto"] [--max-parallelism=MAX_PARALLELISM] [--min-parallelism=MIN_PARALLELISM] [--name=NAME] [--network-config-subnetwork=SUBNETWORK] [--network-config-vpc=NETWORK] [--parallelism=PARALLELISM] - [GCLOUD_WIDE_FLAG ...] [-- JOB_ARGS ...] + [--python-venv=ZIP] [GCLOUD_WIDE_FLAG ...] [-- JOB_ARGS ...] DESCRIPTION (ALPHA) Create a Flink job from a Java jar. @@ -46,6 +47,10 @@ COMMONLY USED FLAGS value for this command invocation. OTHER FLAGS + --archives=[ZIP,...] + The extra archives to pass to the job. Can be a zip file containing + resource files for the job. + --async Return immediately after job submission. @@ -98,6 +103,11 @@ OTHER FLAGS --parallelism=PARALLELISM The parallelism of the job when in "fixed" autotuning mode. + --python-venv=ZIP + The path to the zip file to manage the virtualenv for Python + dependencies. Required if the job type is python. Must start with + gs://. + 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/managed-flink/jobs/delete b/gcloud/alpha/managed-flink/jobs/delete index 5f7bbf5ff..583e7a517 100644 --- a/gcloud/alpha/managed-flink/jobs/delete +++ b/gcloud/alpha/managed-flink/jobs/delete @@ -1,15 +1,17 @@ NAME - gcloud alpha managed-flink jobs delete - delete a Managed Flink job + gcloud alpha managed-flink jobs delete - delete a BigQuery Engine for + Apache Flink job SYNOPSIS gcloud alpha managed-flink jobs delete (JOB : --location=LOCATION) [--async] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Delete a Managed Flink job. + (ALPHA) Delete a BigQuery Engine for Apache Flink job. EXAMPLES - To delete a Managed Flink whose ID is myjob, run the following: + To delete a BigQuery Engine for Apache Flink whose ID is myjob, run the + following: $ gcloud alpha managed-flink jobs delete myjob --location=us-central1 diff --git a/gcloud/alpha/managed-flink/jobs/describe b/gcloud/alpha/managed-flink/jobs/describe index 0c2488646..48011a64a 100644 --- a/gcloud/alpha/managed-flink/jobs/describe +++ b/gcloud/alpha/managed-flink/jobs/describe @@ -1,15 +1,17 @@ NAME - gcloud alpha managed-flink jobs describe - describe a Managed Flink job + gcloud alpha managed-flink jobs describe - describe a BigQuery Engine for + Apache Flink job SYNOPSIS gcloud alpha managed-flink jobs describe (JOB : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Describe a Managed Flink job. + (ALPHA) Describe a BigQuery Engine for Apache Flink job. EXAMPLES - To describe a Managed Flink whose ID is myjob, run the following: + To describe a BigQuery Engine for Apache Flink whose ID is myjob, run the + following: $ gcloud alpha managed-flink jobs describe myjob \ --location=us-central1 diff --git a/gcloud/alpha/managed-flink/jobs/help b/gcloud/alpha/managed-flink/jobs/help index 52586177a..f60d4d1b8 100644 --- a/gcloud/alpha/managed-flink/jobs/help +++ b/gcloud/alpha/managed-flink/jobs/help @@ -19,13 +19,14 @@ COMMANDS (ALPHA) Create a Flink job from a Java jar. delete - (ALPHA) Delete a Managed Flink job. + (ALPHA) Delete a BigQuery Engine for Apache Flink job. describe - (ALPHA) Describe a Managed Flink job. + (ALPHA) Describe a BigQuery Engine for Apache Flink job. list - (ALPHA) List all Managed Flink jobs in a given location. + (ALPHA) List all BigQuery Engine for Apache Flink jobs in a given + location. update (ALPHA) Update the parallelism of a Flink job. diff --git a/gcloud/alpha/managed-flink/jobs/list b/gcloud/alpha/managed-flink/jobs/list index 57ce9654e..fefb2a616 100644 --- a/gcloud/alpha/managed-flink/jobs/list +++ b/gcloud/alpha/managed-flink/jobs/list @@ -1,6 +1,6 @@ NAME - gcloud alpha managed-flink jobs list - list all Managed Flink jobs in a - given location + gcloud alpha managed-flink jobs list - list all BigQuery Engine for Apache + Flink jobs in a given location SYNOPSIS gcloud alpha managed-flink jobs list LOCATION [--filter=EXPRESSION] @@ -8,10 +8,10 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) List all Managed Flink jobs in a given location. + (ALPHA) List all BigQuery Engine for Apache Flink jobs in a given location. EXAMPLES - To list all Managed Flink jobs in a given location, run: + To list all BigQuery Engine for Apache Flink jobs in a given location, run: $ gcloud alpha managed-flink jobs list us-central1 diff --git a/gcloud/alpha/migration/help b/gcloud/alpha/migration/help index c621da999..e8156836e 100644 --- a/gcloud/alpha/migration/help +++ b/gcloud/alpha/migration/help @@ -23,5 +23,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud migration diff --git a/gcloud/alpha/migration/vms/help b/gcloud/alpha/migration/vms/help index 827130986..1b644114f 100644 --- a/gcloud/alpha/migration/vms/help +++ b/gcloud/alpha/migration/vms/help @@ -35,5 +35,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud migration vms diff --git a/gcloud/alpha/migration/vms/image-imports/create b/gcloud/alpha/migration/vms/image-imports/create index 6e4c52c7f..0a77d080d 100644 --- a/gcloud/alpha/migration/vms/image-imports/create +++ b/gcloud/alpha/migration/vms/image-imports/create @@ -137,5 +137,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud migration vms image-imports create diff --git a/gcloud/alpha/migration/vms/image-imports/delete b/gcloud/alpha/migration/vms/image-imports/delete index d5b67b611..33c822a1f 100644 --- a/gcloud/alpha/migration/vms/image-imports/delete +++ b/gcloud/alpha/migration/vms/image-imports/delete @@ -67,5 +67,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud migration vms image-imports delete diff --git a/gcloud/alpha/migration/vms/image-imports/describe b/gcloud/alpha/migration/vms/image-imports/describe index 3b3a51fd3..1410e0df9 100644 --- a/gcloud/alpha/migration/vms/image-imports/describe +++ b/gcloud/alpha/migration/vms/image-imports/describe @@ -66,5 +66,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud migration vms image-imports describe diff --git a/gcloud/alpha/migration/vms/image-imports/help b/gcloud/alpha/migration/vms/image-imports/help index 2b898724f..23742ba47 100644 --- a/gcloud/alpha/migration/vms/image-imports/help +++ b/gcloud/alpha/migration/vms/image-imports/help @@ -57,5 +57,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud migration vms image-imports diff --git a/gcloud/alpha/migration/vms/image-imports/list b/gcloud/alpha/migration/vms/image-imports/list index 31664c3d5..93732831c 100644 --- a/gcloud/alpha/migration/vms/image-imports/list +++ b/gcloud/alpha/migration/vms/image-imports/list @@ -86,5 +86,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud migration vms image-imports list diff --git a/gcloud/alpha/network-security/security-profile-groups/create b/gcloud/alpha/network-security/security-profile-groups/create index f330f56ef..575a162a2 100644 --- a/gcloud/alpha/network-security/security-profile-groups/create +++ b/gcloud/alpha/network-security/security-profile-groups/create @@ -5,11 +5,12 @@ NAME SYNOPSIS gcloud alpha network-security security-profile-groups create (SECURITY_PROFILE_GROUP - : --location=LOCATION --organization=ORGANIZATION) - (--threat-prevention-profile=THREAT_PREVENTION_PROFILE - : --security-profile-location=SECURITY_PROFILE_LOCATION - --security-profile-organization=SECURITY_PROFILE_ORGANIZATION) - [--async] [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] + : --location=LOCATION --organization=ORGANIZATION) [--async] + [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] + [--custom-mirroring-profile=CUSTOM_MIRRORING_PROFILE + : --custom-mirroring-profile-location=CUSTOM_MIRRORING_PROFILE_LOCATION --custom-mirroring-profile-organization=CUSTOM_MIRRORING_PROFILE_ORGANIZATION] + [--threat-prevention-profile=THREAT_PREVENTION_PROFILE + : --threat-prevention-profile-location=THREAT_PREVENTION_PROFILE_LOCATION --threat-prevention-profile-organization=THREAT_PREVENTION_PROFILE_ORGANIZATION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -60,52 +61,7 @@ POSITIONAL ARGUMENTS with a fully specified name; ▸ provide the argument --organization on the command line. -REQUIRED FLAGS - Security Profile resource - Path to Security Profile resource. The - arguments in this group can be used to specify the attributes of this - resource. - - This must be specified. - - --threat-prevention-profile=THREAT_PREVENTION_PROFILE - ID of the Security Profile or fully qualified identifier for the - Security Profile. - - To set the security_profile attribute: - ▸ provide the argument --threat-prevention-profile on the command - line. - - This flag argument must be specified if any of the other arguments in - this group are specified. - - --security-profile-location=SECURITY_PROFILE_LOCATION - Location of the Security Profile. NOTE: Only global security profiles - are supported. - - To set the security-profile-location attribute: - ▸ provide the argument --threat-prevention-profile on the command - line with a fully specified name; - ▸ provide the argument --security-profile-location on the command - line; - ▸ provide the argument --location on the command line; - ▸ provide the argument - networksecurity.organizations.locations.securityProfileGroups on - the command line with a fully specified name. - - --security-profile-organization=SECURITY_PROFILE_ORGANIZATION - Organization ID of the Security Profile. - - To set the security-profile-organization attribute: - ▸ provide the argument --threat-prevention-profile on the command - line with a fully specified name; - ▸ provide the argument --security-profile-organization on the - command line; - ▸ provide the argument --organization on the command line; - ▸ provide the argument - networksecurity.organizations.locations.securityProfileGroups on - the command line with a fully specified name. - -OPTIONAL FLAGS +FLAGS --async Return immediately, without waiting for the operation in progress to complete. The default is False. @@ -121,6 +77,94 @@ OPTIONAL FLAGS contain only hyphens (-), underscores (_), lowercase characters, and numbers. + Security Profile resource - Path to Security Profile resource. The + arguments in this group can be used to specify the attributes of this + resource. + + --custom-mirroring-profile=CUSTOM_MIRRORING_PROFILE + ID of the Security Profile or fully qualified identifier for the + Security Profile. + + To set the custom-mirroring-profile-profile attribute: + ▸ provide the argument --custom-mirroring-profile on the command + line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --custom-mirroring-profile-location=CUSTOM_MIRRORING_PROFILE_LOCATION + Location of the Security Profile. NOTE: Only global security profiles + are supported. + + To set the custom-mirroring-profile-location attribute: + ▸ provide the argument --custom-mirroring-profile on the command + line with a fully specified name; + ▸ provide the argument --custom-mirroring-profile-location on the + command line; + ▸ provide the argument --location on the command line; + ▸ provide the argument + networksecurity.organizations.locations.securityProfileGroups on + the command line with a fully specified name. + + --custom-mirroring-profile-organization=CUSTOM_MIRRORING_PROFILE_ORGANIZATION + Organization ID of the Security Profile. + + To set the custom-mirroring-profile-organization attribute: + ▸ provide the argument --custom-mirroring-profile on the command + line with a fully specified name; + ▸ provide the argument --custom-mirroring-profile-organization on + the command line; + ▸ provide the argument --organization on the command line; + ▸ provide the argument + networksecurity.organizations.locations.securityProfileGroups on + the command line with a fully specified name. + + Security Profile resource - Path to Security Profile resource. The + arguments in this group can be used to specify the attributes of this + resource. + + --threat-prevention-profile=THREAT_PREVENTION_PROFILE + ID of the Security Profile or fully qualified identifier for the + Security Profile. + + To set the threat-prevention-profile-profile attribute: + ▸ provide the argument --threat-prevention-profile on the command + line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --threat-prevention-profile-location=THREAT_PREVENTION_PROFILE_LOCATION + Location of the Security Profile. NOTE: Only global security profiles + are supported. + + To set the threat-prevention-profile-location attribute: + ▸ provide the argument --threat-prevention-profile on the command + line with a fully specified name; + ▸ provide the argument --threat-prevention-profile-location on the + command line; + ▸ provide the argument --security-profile-location on the command + line; + ▸ provide the argument --location on the command line; + ▸ provide the argument + networksecurity.organizations.locations.securityProfileGroups on + the command line with a fully specified name. + + --threat-prevention-profile-organization=THREAT_PREVENTION_PROFILE_ORGANIZATION + Organization ID of the Security Profile. + + To set the threat-prevention-profile-organization attribute: + ▸ provide the argument --threat-prevention-profile on the command + line with a fully specified name; + ▸ provide the argument --threat-prevention-profile-organization on + the command line; + ▸ provide the argument --security-profile-organization on the + command line; + ▸ provide the argument --organization on the command line; + ▸ provide the argument + networksecurity.organizations.locations.securityProfileGroups on + the command line with a fully specified name. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/network-security/security-profile-groups/update b/gcloud/alpha/network-security/security-profile-groups/update index 60d2c0778..876a2ee0a 100644 --- a/gcloud/alpha/network-security/security-profile-groups/update +++ b/gcloud/alpha/network-security/security-profile-groups/update @@ -9,8 +9,7 @@ SYNOPSIS [--description=DESCRIPTION] [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] [--threat-prevention-profile=THREAT_PREVENTION_PROFILE - : --security-profile-location=SECURITY_PROFILE_LOCATION - --security-profile-organization=SECURITY_PROFILE_ORGANIZATION] + : --threat-prevention-profile-location=THREAT_PREVENTION_PROFILE_LOCATION --threat-prevention-profile-organization=THREAT_PREVENTION_PROFILE_ORGANIZATION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -106,20 +105,22 @@ FLAGS ID of the Security Profile or fully qualified identifier for the Security Profile. - To set the security_profile attribute: + To set the threat-prevention-profile-profile attribute: ▸ provide the argument --threat-prevention-profile on the command line. This flag argument must be specified if any of the other arguments in this group are specified. - --security-profile-location=SECURITY_PROFILE_LOCATION + --threat-prevention-profile-location=THREAT_PREVENTION_PROFILE_LOCATION Location of the Security Profile. NOTE: Only global security profiles are supported. - To set the security-profile-location attribute: + To set the threat-prevention-profile-location attribute: ▸ provide the argument --threat-prevention-profile on the command line with a fully specified name; + ▸ provide the argument --threat-prevention-profile-location on the + command line; ▸ provide the argument --security-profile-location on the command line; ▸ provide the argument --location on the command line; @@ -127,12 +128,14 @@ FLAGS networksecurity.organizations.locations.securityProfileGroups on the command line with a fully specified name. - --security-profile-organization=SECURITY_PROFILE_ORGANIZATION + --threat-prevention-profile-organization=THREAT_PREVENTION_PROFILE_ORGANIZATION Organization ID of the Security Profile. - To set the security-profile-organization attribute: + To set the threat-prevention-profile-organization attribute: ▸ provide the argument --threat-prevention-profile on the command line with a fully specified name; + ▸ provide the argument --threat-prevention-profile-organization on + the command line; ▸ provide the argument --security-profile-organization on the command line; ▸ provide the argument --organization on the command line; diff --git a/gcloud/alpha/recaptcha/keys/create b/gcloud/alpha/recaptcha/keys/create index 25f00af83..d8236e90d 100644 --- a/gcloud/alpha/recaptcha/keys/create +++ b/gcloud/alpha/recaptcha/keys/create @@ -3,7 +3,7 @@ NAME SYNOPSIS gcloud alpha recaptcha keys create --display-name=DISPLAY_NAME - ([--android (--allow-all-package-names + (--express | [--android (--allow-all-package-names | --package-names=[PACKAGE_NAMES,...]) : --support-non-google-app-store-distribution] | [--ios (--allow-all-bundle-ids | --bundle-ids=[BUNDLE_IDS,...]) @@ -13,7 +13,7 @@ SYNOPSIS --security-preference=SECURITY_PREFERENCE --testing-challenge=TESTING_CHALLENGE]) [--labels=[KEY=VALUE,...]] [--testing-score=TESTING_SCORE] - [--waf-feature=WAF_FEATURE : --waf-service=WAF_SERVICE] + [--waf-service=WAF_SERVICE : --waf-feature=WAF_FEATURE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -32,6 +32,11 @@ REQUIRED FLAGS Exactly one of these must be specified: + Options for the creation of a site key for Express. + + --express + Creates a Key configured for Express assessments. + Options for the creation of a site key for Android. --android @@ -130,6 +135,11 @@ REQUIRED FLAGS score Shows no CAPTCHA challenge on the page + score-and-challenge + Conditionally displays a challenge based on the score. This is + in private preview. If you want to onboard, contact your Google + Cloud sales representative. + --security-preference=SECURITY_PREFERENCE Represents the possible challenge frequency and difficulty configurations for a web key. usability: show fewer and easier @@ -181,27 +191,6 @@ OPTIONAL FLAGS please refer to https://cloud.google.com/recaptcha-enterprise/docs/integration-overview. - --waf-feature=WAF_FEATURE - The WAF feature to use. For more information, see - https://cloud.google.com/recaptcha-enterprise/docs/usecase#comparison_of_features. - WAF_FEATURE must be one of: - - action-token - Use reCAPTCHA action-tokens to protect user actions. - - challenge-page - Redirects suspicious traffic to reCAPTCHA challenge page. - - express - Assesses requests without tokens or frontend integration. - - session-token - Use reCAPTCHA session-tokens to protect the whole user session on - the site's domain. - - This flag argument must be specified if any of the other arguments in - this group are specified. - --waf-service=WAF_SERVICE The WAF service provider to use. WAF_SERVICE must be one of: @@ -217,8 +206,27 @@ OPTIONAL FLAGS fastly Fastly - unspecified - No specified WAF service + This flag argument must be specified if any of the other arguments in + this group are specified. + + --waf-feature=WAF_FEATURE + The WAF feature to use. For more information, see + https://cloud.google.com/recaptcha-enterprise/docs/usecase#comparison_of_features. + WAF_FEATURE must be one of: + + action-token + Use reCAPTCHA action-tokens to protect user actions. + + challenge-page + Redirects suspicious traffic to reCAPTCHA challenge page. + + express + Assesses requests without tokens or frontend integration. This + option is deprecated, use --express instead. + + session-token + Use reCAPTCHA session-tokens to protect the whole user session on + the site's domain. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/recaptcha/keys/update b/gcloud/alpha/recaptcha/keys/update index 74bf433e4..50e4fa9a8 100644 --- a/gcloud/alpha/recaptcha/keys/update +++ b/gcloud/alpha/recaptcha/keys/update @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud alpha recaptcha keys update KEY [--display-name=DISPLAY_NAME] [--labels=[KEY=VALUE,...]] - [--android (--allow-all-package-names + [--express | --android (--allow-all-package-names | --package-names=[PACKAGE_NAMES,...]) | [--ios : --allow-all-bundle-ids | --bundle-ids=[BUNDLE_IDS,...] --key-id=KEY_ID --private-key-file=PATH_TO_FILE --team-id=TEAM_ID] @@ -49,6 +49,11 @@ FLAGS At most one of these can be specified: + Options for the creation of a site key for Express. + + --express + Creates a Key configured for Express assessments. + Options for the creation of a site key for Android. --android diff --git a/gcloud/alpha/recommender/recommendations/mark-active b/gcloud/alpha/recommender/recommendations/mark-active index 1be4faf8f..1df321891 100644 --- a/gcloud/alpha/recommender/recommendations/mark-active +++ b/gcloud/alpha/recommender/recommendations/mark-active @@ -27,7 +27,7 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS --etag=ETAG - Etag of a recommendation + Etag of the recommendation --location=LOCATION Location diff --git a/gcloud/alpha/scc/sources/describe b/gcloud/alpha/scc/sources/describe index c0fe3db01..c52cd01f5 100644 --- a/gcloud/alpha/scc/sources/describe +++ b/gcloud/alpha/scc/sources/describe @@ -3,7 +3,7 @@ NAME name or source id SYNOPSIS - gcloud alpha scc sources describe [ORGANIZATION] + gcloud alpha scc sources describe [PARENT] (--source=SOURCE | --source-display-name=SOURCE_DISPLAY_NAME) [GCLOUD_WIDE_FLAG ...] @@ -11,7 +11,7 @@ DESCRIPTION (ALPHA) Describe a source given its display name or source id. EXAMPLES - Describe source with display name 'Security Scanner': + Describe source with display name Security Scanner: $ gcloud alpha scc sources describe 123456 \ --source-display-name="Security Scanner" @@ -21,18 +21,18 @@ EXAMPLES $ gcloud alpha scc sources describe 123456 --source=5678 POSITIONAL ARGUMENTS - Organization resource - The organization to be used for the SCC (Security - Command Center) command. This represents a Cloud resource. + Parent resource - parent organization, folder, or project in the Google + Cloud resource hierarchy to be used for the gcloud scc command. Specify + the argument as either [RESOURCE_TYPE/RESOURCE_ID] or [RESOURCE_ID], as + shown in the preceding examples. This represents a Cloud resource. - [ORGANIZATION] - ID of the organization or fully qualified identifier for the - organization. + [PARENT] + ID of the parent or fully qualified identifier for the parent. - To set the organization attribute: - ▸ provide the argument organization on the command line; - ▸ Set the organization property in configuration using gcloud - config set scc/organization if it is not specified in command - line.. + To set the parent attribute: + ▸ provide the argument parent on the command line; + ▸ Set the parent property in configuration using gcloud config set + scc/parent if it is not specified in command line. REQUIRED FLAGS Exactly one of these must be specified: diff --git a/gcloud/alpha/spanner/instance-configs/create b/gcloud/alpha/spanner/instance-configs/create index a615a4980..bddb11e41 100644 --- a/gcloud/alpha/spanner/instance-configs/create +++ b/gcloud/alpha/spanner/instance-configs/create @@ -16,17 +16,17 @@ DESCRIPTION EXAMPLES To create a custom Cloud Spanner instance configuration based on an - existing Google-managed configuration (nam3) by adding a 'READ_ONLY' type - replica in location 'us-east4', run: + existing Google-managed configuration (nam3) by adding a READ_ONLY type + replica in location us-east4, run: $ gcloud alpha spanner instance-configs create \ custom-instance-config --clone-config=nam3 \ --add-replicas=location=us-east4,type=READ_ONLY To create a custom Cloud Spanner instance configuration based on another - custom configuration (custom-instance-config) by adding a 'READ_ONLY' type - replica in location 'us-east1' and removing a 'READ_ONLY' type replica in - location 'us-east4', run: + custom configuration (custom-instance-config) by adding a READ_ONLY type + replica in location us-east1 and removing a READ_ONLY type replica in + location us-east4, run: $ gcloud alpha spanner instance-configs create \ custom-instance-config1 --clone-config=custom-instance-config \ @@ -144,8 +144,8 @@ OPTIONAL FLAGS numbers. --validate-only - Use this flag to validate that the request will succeed before - executing it. + If specified, validate that the creation will succeed without creating + the instance configuration. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/spanner/instance-configs/delete b/gcloud/alpha/spanner/instance-configs/delete index f34d3be74..480e8bf26 100644 --- a/gcloud/alpha/spanner/instance-configs/delete +++ b/gcloud/alpha/spanner/instance-configs/delete @@ -24,8 +24,8 @@ FLAGS simultaneous deletes of an instance config from overwriting each other. --validate-only - Use this flag to validate that the request will succeed before - executing it. + If specified, validate that the deletion will succeed without deleting + the instance config. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/spanner/instances/create b/gcloud/alpha/spanner/instances/create index 0ba98d86d..1b4c1250f 100644 --- a/gcloud/alpha/spanner/instances/create +++ b/gcloud/alpha/spanner/instances/create @@ -3,8 +3,8 @@ NAME SYNOPSIS gcloud alpha spanner instances create INSTANCE --config=CONFIG - --description=DESCRIPTION [--async] [--expire-behavior=EXPIRE_BEHAVIOR] - [--instance-type=INSTANCE_TYPE] + --description=DESCRIPTION [--async] [--edition=EDITION] + [--expire-behavior=EXPIRE_BEHAVIOR] [--instance-type=INSTANCE_TYPE] [--nodes=NODES | --processing-units=PROCESSING_UNITS | --autoscaling-high-priority-cpu-target=AUTOSCALING_HIGH_PRIORITY_CPU_TARGET --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET (--autoscaling-max-nodes=AUTOSCALING_MAX_NODES --autoscaling-min-nodes=AUTOSCALING_MIN_NODES | --autoscaling-max-processing-units=AUTOSCALING_MAX_PROCESSING_UNITS --autoscaling-min-processing-units=AUTOSCALING_MIN_PROCESSING_UNITS)] [GCLOUD_WIDE_FLAG ...] @@ -37,6 +37,20 @@ OPTIONAL FLAGS Return immediately, without waiting for the operation in progress to complete. + --edition=EDITION + Cloud Spanner edition. EDITION must be one of: + + EDITION_UNSPECIFIED + Spanner's legacy pricing model. For more information, see the + Spanner editions overview + (https://cloud.google.com/spanner/docs/editions-overview) + ENTERPRISE + Enterprise edition + ENTERPRISE_PLUS + Enterprise Plus edition + STANDARD + Standard edition + --expire-behavior=EXPIRE_BEHAVIOR The expire behavior of a free trial instance. EXPIRE_BEHAVIOR must be one of: diff --git a/gcloud/alpha/spanner/instances/update b/gcloud/alpha/spanner/instances/update index 32082bd01..aebfcf4d7 100644 --- a/gcloud/alpha/spanner/instances/update +++ b/gcloud/alpha/spanner/instances/update @@ -3,8 +3,8 @@ NAME SYNOPSIS gcloud alpha spanner instances update INSTANCE [--async] - [--description=DESCRIPTION] [--expire-behavior=EXPIRE_BEHAVIOR] - [--instance-type=INSTANCE_TYPE] + [--description=DESCRIPTION] [--edition=EDITION] + [--expire-behavior=EXPIRE_BEHAVIOR] [--instance-type=INSTANCE_TYPE] [--nodes=NODES | --processing-units=PROCESSING_UNITS | --autoscaling-high-priority-cpu-target=AUTOSCALING_HIGH_PRIORITY_CPU_TARGET --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET --autoscaling-max-nodes=AUTOSCALING_MAX_NODES --autoscaling-min-nodes=AUTOSCALING_MIN_NODES | --autoscaling-max-processing-units=AUTOSCALING_MAX_PROCESSING_UNITS --autoscaling-min-processing-units=AUTOSCALING_MIN_PROCESSING_UNITS] [GCLOUD_WIDE_FLAG ...] @@ -34,6 +34,15 @@ FLAGS --description=DESCRIPTION Description of the instance. + --edition=EDITION + Cloud Spanner edition. You can upgrade your Standard edition instance + to the ENTERPRISE edition or ENTERPRISE_PLUS edition. You can also + upgrade your Enterprise edition instance to the ENTERPRISE_PLUS + edition. Self-service downgrade isn't available. To downgrade the + edition of your instance, file a support ticket. For more information, + see the Spanner editions overview + (https://cloud.google.com/spanner/docs/editions-overview) + --expire-behavior=EXPIRE_BEHAVIOR The expire behavior of a free trial instance. EXPIRE_BEHAVIOR must be one of: diff --git a/gcloud/alpha/sql/backups/restore b/gcloud/alpha/sql/backups/restore index 39f075d51..98ff00505 100644 --- a/gcloud/alpha/sql/backups/restore +++ b/gcloud/alpha/sql/backups/restore @@ -4,7 +4,8 @@ NAME SYNOPSIS gcloud alpha sql backups restore ID --restore-instance=RESTORE_INSTANCE - [--async] [--backup-instance=BACKUP_INSTANCE] [GCLOUD_WIDE_FLAG ...] + [--async] [--backup-instance=BACKUP_INSTANCE] + [--backup-project=BACKUP_PROJECT] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Restores a backup of a Cloud SQL instance. @@ -28,6 +29,10 @@ OPTIONAL FLAGS restore instance. If it is not specified, the backup instance is considered the same as the restore instance. + --backup-project=BACKUP_PROJECT + The project of the instance to which the backup belongs. If it isn't + specified, backup and restore instances are in the same project. + 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/sql/instances/create b/gcloud/alpha/sql/instances/create index f2f85da77..e12c408a4 100644 --- a/gcloud/alpha/sql/instances/create +++ b/gcloud/alpha/sql/instances/create @@ -20,7 +20,7 @@ SYNOPSIS [--deny-maintenance-period-end-date=DENY_MAINTENANCE_PERIOD_END_DATE] [--deny-maintenance-period-start-date=DENY_MAINTENANCE_PERIOD_START_DATE] [--deny-maintenance-period-time=DENY_MAINTENANCE_PERIOD_TIME] - [--edition=EDITION] [--enable-bin-log] [--enable-data-cache] + [--edition=EDITION] [--enable-bin-log] [--[no-]enable-data-cache] [--[no-]enable-dataplex-integration] [--[no-]enable-google-ml-integration] [--enable-google-private-path] [--enable-password-policy] [--enable-point-in-time-recovery] @@ -236,9 +236,10 @@ FLAGS fraction of a second. Must have automatic backups enabled to use. Make sure storage can support at least 7 days of logs. - --enable-data-cache + --[no-]enable-data-cache Enable use of data cache for accelerated read performance. This flag is - only available for Enterprise_Plus edition instances. + only available for Enterprise_Plus edition instances. Use + --enable-data-cache to enable and --no-enable-data-cache to disable. --[no-]enable-dataplex-integration Enable Dataplex integration for Google Cloud SQL. Use diff --git a/gcloud/alpha/sql/instances/patch b/gcloud/alpha/sql/instances/patch index 776d21c88..ebf5b0f98 100644 --- a/gcloud/alpha/sql/instances/patch +++ b/gcloud/alpha/sql/instances/patch @@ -17,7 +17,7 @@ SYNOPSIS [--deny-maintenance-period-end-date=DENY_MAINTENANCE_PERIOD_END_DATE] [--deny-maintenance-period-start-date=DENY_MAINTENANCE_PERIOD_START_DATE] [--deny-maintenance-period-time=DENY_MAINTENANCE_PERIOD_TIME] [--diff] - [--edition=EDITION] [--[no-]enable-bin-log] [--enable-data-cache] + [--edition=EDITION] [--[no-]enable-bin-log] [--[no-]enable-data-cache] [--[no-]enable-database-replication] [--[no-]enable-dataplex-integration] [--[no-]enable-google-ml-integration] @@ -183,9 +183,10 @@ FLAGS sure storage can support at least 7 days of logs. Use --enable-bin-log to enable and --no-enable-bin-log to disable. - --enable-data-cache + --[no-]enable-data-cache Enable use of data cache for accelerated read performance. This flag is - only available for Enterprise_Plus edition instances. + only available for Enterprise_Plus edition instances. Use + --enable-data-cache to enable and --no-enable-data-cache to disable. --[no-]enable-database-replication Enable database replication. Applicable only for read replica diff --git a/gcloud/alpha/workstations/configs/create b/gcloud/alpha/workstations/configs/create index 16dd22e7f..02cfbecfc 100644 --- a/gcloud/alpha/workstations/configs/create +++ b/gcloud/alpha/workstations/configs/create @@ -310,7 +310,7 @@ FLAGS and the administrator must manually delete the disk. --pool-size=POOL_SIZE - Number of instances to pool for faster Workstation starup. + Number of instances to pool for faster Workstation startup. --replica-zones=[REPLICA_ZONES,...] Specifies the zones the VM and disk resources will be replicated within diff --git a/gcloud/alpha/workstations/configs/update b/gcloud/alpha/workstations/configs/update index 54cc877b3..130676ee6 100644 --- a/gcloud/alpha/workstations/configs/update +++ b/gcloud/alpha/workstations/configs/update @@ -253,7 +253,7 @@ FLAGS $ gcloud alpha workstations configs update --network-tags=tag_1,tag_2 --pool-size=POOL_SIZE - Number of instances to pool for faster Workstation starup. + Number of instances to pool for faster Workstation startup. --running-timeout=RUNNING_TIMEOUT How long (in seconds) to wait before automatically stopping a diff --git a/gcloud/assured/workloads/create b/gcloud/assured/workloads/create index 3bcc95659..27fcf38d0 100644 --- a/gcloud/assured/workloads/create +++ b/gcloud/assured/workloads/create @@ -87,8 +87,10 @@ REQUIRED FLAGS The compliance regime of the new Assured Workloads environment. COMPLIANCE_REGIME must be one of: assured-workloads-for-partners, au-regions-and-us-support, ca-protected-b, ca-regions-and-support, - cjis, eu-regions-and-support, fedramp-high, fedramp-moderate, hipaa, - hitrust, il2, il4, il5, isr-regions, isr-regions-and-support, itar, + cjis, eu-regions-and-support, fedramp-high, fedramp-moderate, + healthcare-and-life-sciences-controls, + healthcare-and-life-sciences-controls-us-support, hipaa, hitrust, il2, + il4, il5, isr-regions, isr-regions-and-support, itar, jp-regions-and-support, ksa-regions-and-support-with-sovereignty-controls, regional-controls, us-regional-access. diff --git a/gcloud/beta/assured/workloads/create b/gcloud/beta/assured/workloads/create index 35b0b223c..a4e5f1a0f 100644 --- a/gcloud/beta/assured/workloads/create +++ b/gcloud/beta/assured/workloads/create @@ -87,8 +87,10 @@ REQUIRED FLAGS The compliance regime of the new Assured Workloads environment. COMPLIANCE_REGIME must be one of: assured-workloads-for-partners, au-regions-and-us-support, ca-protected-b, ca-regions-and-support, - cjis, eu-regions-and-support, fedramp-high, fedramp-moderate, hipaa, - hitrust, il2, il4, il5, isr-regions, isr-regions-and-support, itar, + cjis, eu-regions-and-support, fedramp-high, fedramp-moderate, + healthcare-and-life-sciences-controls, + healthcare-and-life-sciences-controls-us-support, hipaa, hitrust, il2, + il4, il5, isr-regions, isr-regions-and-support, itar, jp-regions-and-support, ksa-regions-and-support-with-sovereignty-controls, regional-controls, us-regional-access. diff --git a/gcloud/beta/colab-enterprise/help b/gcloud/beta/colab-enterprise/help index d5fa45886..89c0ee3ff 100644 --- a/gcloud/beta/colab-enterprise/help +++ b/gcloud/beta/colab-enterprise/help @@ -18,6 +18,9 @@ GROUPS runtime-templates (BETA) Colab Enterprise Runtime Templates command group. + runtimes + (BETA) Colab Enterprise Runtimes command group. + NOTES This command is currently in beta and might change without notice. diff --git a/gcloud/beta/colab-enterprise/runtime-templates/create b/gcloud/beta/colab-enterprise/runtime-templates/create index f485c6d7f..2945fffb2 100644 --- a/gcloud/beta/colab-enterprise/runtime-templates/create +++ b/gcloud/beta/colab-enterprise/runtime-templates/create @@ -1,5 +1,5 @@ NAME - gcloud beta colab-enterprise runtime-templates create - creates a runtime + gcloud beta colab-enterprise runtime-templates create - create a runtime template SYNOPSIS diff --git a/gcloud/beta/colab-enterprise/runtime-templates/delete b/gcloud/beta/colab-enterprise/runtime-templates/delete index 15c0bb718..87b25d78e 100644 --- a/gcloud/beta/colab-enterprise/runtime-templates/delete +++ b/gcloud/beta/colab-enterprise/runtime-templates/delete @@ -1,5 +1,5 @@ NAME - gcloud beta colab-enterprise runtime-templates delete - deletes a runtime + gcloud beta colab-enterprise runtime-templates delete - delete a runtime template SYNOPSIS @@ -14,7 +14,7 @@ EXAMPLES 'us-central1', run: $ gcloud beta colab-enterprise runtime-templates delete \ - --my-runtime-template --region=us-central1 + my-runtime-template --region=us-central1 POSITIONAL ARGUMENTS Runtime template resource - Unique name of the runtime template to delete. diff --git a/gcloud/beta/colab-enterprise/runtime-templates/describe b/gcloud/beta/colab-enterprise/runtime-templates/describe index 1c474557f..9a6dffd2f 100644 --- a/gcloud/beta/colab-enterprise/runtime-templates/describe +++ b/gcloud/beta/colab-enterprise/runtime-templates/describe @@ -1,5 +1,5 @@ NAME - gcloud beta colab-enterprise runtime-templates describe - describes a + gcloud beta colab-enterprise runtime-templates describe - describe a runtime template SYNOPSIS @@ -14,7 +14,7 @@ EXAMPLES 'us-central1', run: $ gcloud beta colab-enterprise runtime-templates describe \ - --my-runtime-template --region=us-central1 + my-runtime-template --region=us-central1 POSITIONAL ARGUMENTS Runtime template resource - Unique name of the runtime template to diff --git a/gcloud/beta/colab-enterprise/runtime-templates/get-iam-policy b/gcloud/beta/colab-enterprise/runtime-templates/get-iam-policy index 963d68dea..29411e1d3 100644 --- a/gcloud/beta/colab-enterprise/runtime-templates/get-iam-policy +++ b/gcloud/beta/colab-enterprise/runtime-templates/get-iam-policy @@ -16,7 +16,7 @@ EXAMPLES region us-central1, run: $ gcloud beta colab-enterprise runtime-templates get-iam-policy \ - get-iam-policy my-runtime-template --location=us-central1 \ + my-runtime-template --location=us-central1 \ --member=user:someone@example.com \ --role=roles/aiplatform.notebookRuntimeUser diff --git a/gcloud/beta/colab-enterprise/runtime-templates/help b/gcloud/beta/colab-enterprise/runtime-templates/help index 330839b97..4b885cb4a 100644 --- a/gcloud/beta/colab-enterprise/runtime-templates/help +++ b/gcloud/beta/colab-enterprise/runtime-templates/help @@ -23,19 +23,19 @@ COMMANDS template. create - (BETA) Creates a runtime template. + (BETA) Create a runtime template. delete - (BETA) Deletes a runtime template. + (BETA) Delete a runtime template. describe - (BETA) Describes a runtime template. + (BETA) Describe a runtime template. get-iam-policy (BETA) Get IAM policy for a Colab Enterprise runtime template. list - (BETA) Lists your runtime templates. + (BETA) List your runtime templates. remove-iam-policy-binding (BETA) Remove an IAM policy binding from a Colab Enterprise runtime diff --git a/gcloud/beta/colab-enterprise/runtime-templates/list b/gcloud/beta/colab-enterprise/runtime-templates/list index 2d1ccd3fd..8372d220c 100644 --- a/gcloud/beta/colab-enterprise/runtime-templates/list +++ b/gcloud/beta/colab-enterprise/runtime-templates/list @@ -1,5 +1,5 @@ NAME - gcloud beta colab-enterprise runtime-templates list - lists your runtime + gcloud beta colab-enterprise runtime-templates list - list your runtime templates SYNOPSIS diff --git a/gcloud/beta/colab-enterprise/runtimes/assign b/gcloud/beta/colab-enterprise/runtimes/assign new file mode 100644 index 000000000..315db44be --- /dev/null +++ b/gcloud/beta/colab-enterprise/runtimes/assign @@ -0,0 +1,109 @@ +NAME + gcloud beta colab-enterprise runtimes assign - assign a notebook runtime + +SYNOPSIS + gcloud beta colab-enterprise runtimes assign --display-name=DISPLAY_NAME + --region=REGION --runtime-template=RUNTIME_TEMPLATE [--async] + [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] + [--runtime-id=RUNTIME_ID] [--runtime-user=RUNTIME_USER] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Assign a notebook runtime to run code from your notebook (IPYNB + file). + +EXAMPLES + To create a runtime in region 'us-central1' with the display name + 'my-runtime' and template with id 'my-template', run: + + $ gcloud beta colab-enterprise runtimes assign \ + --region=us-central1 --display-name=my-runtime \ + --runtime-template=my-template + + To create a runtime for user 'USER@DOMAIN.COM', run: + + $ gcloud beta colab-enterprise runtimes assign \ + --runtime-user=USER@DOMAIN.COM --region=us-central1 \ + --display-name=my-runtime --runtime-template=my-template + +REQUIRED FLAGS + --display-name=DISPLAY_NAME + The display name of the runtime to assign. + + Region resource - Cloud region to assign runtime. Please see + https://cloud.google.com/colab/docs/locations for a list of supported + regions. This represents a Cloud resource. (NOTE) Some attributes are not + given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --region on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --region=REGION + ID of the region or fully qualified identifier for the region. + + To set the region attribute: + ▸ provide the argument --region on the command line. + + Runtime template resource - Unique name of the runtime template to + configure the runtime with. This was optionally provided by setting + --runtime-template-id in the create runtime-template command, or was + system-generated if unspecified. 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 --runtime-template on the command line with a + fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the region attribute: + ◆ provide the argument --runtime-template on the command line with a + fully specified name; + ◆ provide the argument --region on the command line. + + This must be specified. + + --runtime-template=RUNTIME_TEMPLATE + ID of the runtime template or fully qualified identifier for the + runtime template. + + To set the name attribute: + ▸ provide the argument --runtime-template on the command line. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + The description + + --labels=[KEY=VALUE,...] + Add labels to identify and group the runtime template. + + --runtime-id=RUNTIME_ID + The id of the runtime to assign. If not specified, a random id will be + generated. + + --runtime-user=RUNTIME_USER + User email for the runtime owner. Runtimes can only be used by the + owner. If a user is not provided, the gcloud user will be assumed to be + the owner. The user cannot be a service account. + +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. + diff --git a/gcloud/beta/colab-enterprise/runtimes/help b/gcloud/beta/colab-enterprise/runtimes/help new file mode 100644 index 000000000..afd4c39cc --- /dev/null +++ b/gcloud/beta/colab-enterprise/runtimes/help @@ -0,0 +1,25 @@ +NAME + gcloud beta colab-enterprise runtimes - colab Enterprise Runtimes command + group + +SYNOPSIS + gcloud beta colab-enterprise runtimes COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) For more information about runtimes, see + https://cloud.google.com/colab/docs/runtimes#runtimes + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + assign + (BETA) Assign a notebook runtime. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/compute/commitments/create b/gcloud/beta/compute/commitments/create index a28739a0f..df28c0538 100644 --- a/gcloud/beta/compute/commitments/create +++ b/gcloud/beta/compute/commitments/create @@ -10,7 +10,8 @@ SYNOPSIS [--type=TYPE; default="general-purpose"] [--existing-reservation=[name=NAME],[zone=ZONE] | --reservations-from-file=PATH_TO_FILE | [--reservation=RESERVATION - : --reservation-zone=RESERVATION_ZONE + : --reservation-sharing-policy=RESERVATION_SHARING_POLICY + --reservation-zone=RESERVATION_ZONE --accelerator=[count=COUNT],[type=TYPE] --local-ssd=[interface=INTERFACE],[size=SIZE] --machine-type=MACHINE_TYPE @@ -139,6 +140,19 @@ OPTIONAL FLAGS This flag argument must be specified if any of the other arguments in this group are specified. + Manage the properties of a reservation sharing policy to create + + --reservation-sharing-policy=RESERVATION_SHARING_POLICY + The reservation sharing policy to use for this reservation. + RESERVATION_SHARING_POLICY must be one of: + + ALLOW_ALL + The reservation can be shared with Google Cloud services. + DISALLOW_ALL + The reservation won't be shared with Google Cloud services. + If you omit this flag during creation, the default value is + DISALLOW_ALL. + --reservation-zone=RESERVATION_ZONE Zone of the reservation to operate on. If not specified and the compute/zone property isn't set, you might be prompted to select a diff --git a/gcloud/beta/compute/disks/create b/gcloud/beta/compute/disks/create index 67b56212d..0f5cd2044 100644 --- a/gcloud/beta/compute/disks/create +++ b/gcloud/beta/compute/disks/create @@ -62,7 +62,7 @@ POSITIONAL ARGUMENTS FLAGS --access-mode=ACCESS_MODE - Specifie how VMs attached to the disk can access the data on the disk. + Specifies how VMs attached to the disk can access the data on the disk. To grant read-only access to multiple VMs attached to the disk, set access-mode to READ_ONLY_MANY. To grant read-write access to only one VM attached to the disk, use READ_WRITE_SINGLE. READ_WRITE_SINGLE is diff --git a/gcloud/beta/compute/disks/update b/gcloud/beta/compute/disks/update index a17a448d4..9de04acdc 100644 --- a/gcloud/beta/compute/disks/update +++ b/gcloud/beta/compute/disks/update @@ -41,7 +41,7 @@ POSITIONAL ARGUMENTS FLAGS --access-mode=ACCESS_MODE - Specifie how VMs attached to the disk can access the data on the disk. + Specifies how VMs attached to the disk can access the data on the disk. To grant read-only access to multiple VMs attached to the disk, set access-mode to READ_ONLY_MANY. To grant read-write access to only one VM attached to the disk, use READ_WRITE_SINGLE. READ_WRITE_SINGLE is diff --git a/gcloud/beta/compute/firewall-policies/rules/create b/gcloud/beta/compute/firewall-policies/rules/create index 18cc3ae80..93b7b47ad 100644 --- a/gcloud/beta/compute/firewall-policies/rules/create +++ b/gcloud/beta/compute/firewall-policies/rules/create @@ -7,6 +7,7 @@ SYNOPSIS --firewall-policy=FIREWALL_POLICY [--description=DESCRIPTION] [--dest-address-groups=[DEST_ADDRESS_GROUPS,...]] [--dest-fqdns=[DEST_FQDNS,...]] [--dest-ip-ranges=[DEST_IP_RANGE,...]] + [--dest-network-scope=DEST_NETWORK_SCOPE] [--dest-region-codes=[DEST_REGION_CODES,...]] [--dest-threat-intelligence=[DEST_THREAT_INTELLIGENCE_LISTS,...]] [--direction=DIRECTION] [--[no-]disabled] [--[no-]enable-logging] @@ -14,6 +15,8 @@ SYNOPSIS [--security-profile-group=SECURITY_PROFILE_GROUP] [--src-address-groups=[SOURCE_ADDRESS_GROUPS,...]] [--src-fqdns=[SOURCE_FQDNS,...]] [--src-ip-ranges=[SRC_IP_RANGE,...]] + [--src-network-scope=SRC_NETWORK_SCOPE] + [--src-networks=[SRC_NETWORKS,...]] [--src-region-codes=[SOURCE_REGION_CODES,...]] [--src-threat-intelligence=[SOURCE_THREAT_INTELLIGENCE_LISTS,...]] [--target-resources=[TARGET_RESOURCES,...]] @@ -60,6 +63,12 @@ OPTIONAL FLAGS --dest-ip-ranges=[DEST_IP_RANGE,...] Destination IP ranges to match for this rule. + --dest-network-scope=DEST_NETWORK_SCOPE + Use this flag to indicate that the rule should match internet or + non-internet traffic. It applies to destination traffic for egress + rules. Valid values are INTERNET, NON_INTERNET and INTRA_VPC. Use empty + string to clear the field. + --dest-region-codes=[DEST_REGION_CODES,...] Destination Region Code to match for this rule. Can only be specified if DIRECTION is egress. @@ -114,6 +123,18 @@ OPTIONAL FLAGS --src-ip-ranges=[SRC_IP_RANGE,...] Source IP ranges to match for this rule. + --src-network-scope=SRC_NETWORK_SCOPE + Use this flag to indicate that the rule should match internet, + non-internet traffic or traffic coming from the network specified by + --src-network. It applies to ingress rules. Valid values are INTERNET, + NON_INTERNET, VPC_NETWORKS and INTRA_VPC. Use empty string to clear the + field. + + --src-networks=[SRC_NETWORKS,...] + The source VPC networks to match for this rule. It can only be + specified when --src-network-scope is VPC_NETWORKS. It applies to + ingress rules. It accepts full or partial URLs. + --src-region-codes=[SOURCE_REGION_CODES,...] Source Region Code to match for this rule. Can only be specified if DIRECTION is ingress. diff --git a/gcloud/beta/compute/firewall-policies/rules/update b/gcloud/beta/compute/firewall-policies/rules/update index ccd04f68d..7cd822cb9 100644 --- a/gcloud/beta/compute/firewall-policies/rules/update +++ b/gcloud/beta/compute/firewall-policies/rules/update @@ -8,6 +8,7 @@ SYNOPSIS [--description=DESCRIPTION] [--dest-address-groups=[DEST_ADDRESS_GROUPS,...]] [--dest-fqdns=[DEST_FQDNS,...]] [--dest-ip-ranges=[DEST_IP_RANGE,...]] + [--dest-network-scope=DEST_NETWORK_SCOPE] [--dest-region-codes=[DEST_REGION_CODES,...]] [--dest-threat-intelligence=[DEST_THREAT_INTELLIGENCE_LISTS,...]] [--direction=DIRECTION] [--[no-]disabled] [--[no-]enable-logging] @@ -16,6 +17,8 @@ SYNOPSIS [--security-profile-group=SECURITY_PROFILE_GROUP] [--src-address-groups=[SOURCE_ADDRESS_GROUPS,...]] [--src-fqdns=[SOURCE_FQDNS,...]] [--src-ip-ranges=[SRC_IP_RANGE,...]] + [--src-network-scope=SRC_NETWORK_SCOPE] + [--src-networks=[SRC_NETWORKS,...]] [--src-region-codes=[SOURCE_REGION_CODES,...]] [--src-threat-intelligence=[SOURCE_THREAT_INTELLIGENCE_LISTS,...]] [--target-resources=[TARGET_RESOURCES,...]] @@ -63,6 +66,12 @@ OPTIONAL FLAGS --dest-ip-ranges=[DEST_IP_RANGE,...] Destination IP ranges to match for this rule. + --dest-network-scope=DEST_NETWORK_SCOPE + Use this flag to indicate that the rule should match internet or + non-internet traffic. It applies to destination traffic for egress + rules. Valid values are INTERNET, NON_INTERNET and INTRA_VPC. Use empty + string to clear the field. + --dest-region-codes=[DEST_REGION_CODES,...] Destination Region Code to match for this rule. Can only be specified if DIRECTION is egress. @@ -120,6 +129,18 @@ OPTIONAL FLAGS --src-ip-ranges=[SRC_IP_RANGE,...] Source IP ranges to match for this rule. + --src-network-scope=SRC_NETWORK_SCOPE + Use this flag to indicate that the rule should match internet, + non-internet traffic or traffic coming from the network specified by + --src-network. It applies to ingress rules. Valid values are INTERNET, + NON_INTERNET, VPC_NETWORKS and INTRA_VPC. Use empty string to clear the + field. + + --src-networks=[SRC_NETWORKS,...] + The source VPC networks to match for this rule. It can only be + specified when --src-network-scope is VPC_NETWORKS. It applies to + ingress rules. It accepts full or partial URLs. + --src-region-codes=[SOURCE_REGION_CODES,...] Source Region Code to match for this rule. Can only be specified if DIRECTION is ingress. diff --git a/gcloud/beta/compute/future-reservations/cancel b/gcloud/beta/compute/future-reservations/cancel index 8cc8563e1..948353155 100644 --- a/gcloud/beta/compute/future-reservations/cancel +++ b/gcloud/beta/compute/future-reservations/cancel @@ -66,10 +66,8 @@ API REFERENCE can be found at: https://cloud.google.com/compute/ NOTES - This command is currently in beta and might change without notice. These - variants are also available: - - $ gcloud compute future-reservations cancel + This command is currently in beta and might change without notice. This + variant is also available: $ gcloud alpha compute future-reservations cancel diff --git a/gcloud/beta/compute/future-reservations/create b/gcloud/beta/compute/future-reservations/create index a1cb57605..c8c070956 100644 --- a/gcloud/beta/compute/future-reservations/create +++ b/gcloud/beta/compute/future-reservations/create @@ -219,10 +219,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. These - variants are also available: - - $ gcloud compute future-reservations create + This command is currently in beta and might change without notice. This + variant is also available: $ gcloud alpha compute future-reservations create diff --git a/gcloud/beta/compute/future-reservations/delete b/gcloud/beta/compute/future-reservations/delete index c625dd8e8..4cf68954f 100644 --- a/gcloud/beta/compute/future-reservations/delete +++ b/gcloud/beta/compute/future-reservations/delete @@ -66,10 +66,8 @@ API REFERENCE can be found at: https://cloud.google.com/compute/ NOTES - This command is currently in beta and might change without notice. These - variants are also available: - - $ gcloud compute future-reservations delete + This command is currently in beta and might change without notice. This + variant is also available: $ gcloud alpha compute future-reservations delete diff --git a/gcloud/beta/compute/future-reservations/describe b/gcloud/beta/compute/future-reservations/describe index 70adbcbfa..5aea44bd0 100644 --- a/gcloud/beta/compute/future-reservations/describe +++ b/gcloud/beta/compute/future-reservations/describe @@ -61,10 +61,8 @@ API REFERENCE can be found at: https://cloud.google.com/compute/ NOTES - This command is currently in beta and might change without notice. These - variants are also available: - - $ gcloud compute future-reservations describe + This command is currently in beta and might change without notice. This + variant is also available: $ gcloud alpha compute future-reservations describe diff --git a/gcloud/beta/compute/future-reservations/help b/gcloud/beta/compute/future-reservations/help index 1166c0ee6..3a482a508 100644 --- a/gcloud/beta/compute/future-reservations/help +++ b/gcloud/beta/compute/future-reservations/help @@ -35,10 +35,8 @@ COMMANDS (BETA) Update Compute Engine future reservations. NOTES - This command is currently in beta and might change without notice. These - variants are also available: - - $ gcloud compute future-reservations + This command is currently in beta and might change without notice. This + variant is also available: $ gcloud alpha compute future-reservations diff --git a/gcloud/beta/compute/future-reservations/list b/gcloud/beta/compute/future-reservations/list index 67e6f2e20..5f547d72a 100644 --- a/gcloud/beta/compute/future-reservations/list +++ b/gcloud/beta/compute/future-reservations/list @@ -56,10 +56,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. These - variants are also available: - - $ gcloud compute future-reservations list + This command is currently in beta and might change without notice. This + variant is also available: $ gcloud alpha compute future-reservations list diff --git a/gcloud/beta/compute/future-reservations/update b/gcloud/beta/compute/future-reservations/update index 74d592bc4..eb353b820 100644 --- a/gcloud/beta/compute/future-reservations/update +++ b/gcloud/beta/compute/future-reservations/update @@ -215,10 +215,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. These - variants are also available: - - $ gcloud compute future-reservations update + This command is currently in beta and might change without notice. This + variant is also available: $ gcloud alpha compute future-reservations update diff --git a/gcloud/beta/compute/images/list b/gcloud/beta/compute/images/list index 808a16459..3b0355823 100644 --- a/gcloud/beta/compute/images/list +++ b/gcloud/beta/compute/images/list @@ -58,10 +58,10 @@ FLAGS --standard-images List images from public image projects. The public image projects that are available include the following: cos-cloud, debian-cloud, - rocky-linux-cloud, centos-cloud, fedora-coreos-cloud, opensuse-cloud, - rhel-cloud, rhel-sap-cloud, suse-cloud, suse-sap-cloud, - ubuntu-os-cloud, ubuntu-os-pro-cloud, windows-cloud, windows-sql-cloud. - Enabled by default, use --no-standard-images to disable. + rocky-linux-cloud, ubuntu-os-cloud, centos-cloud, fedora-coreos-cloud, + opensuse-cloud, rhel-cloud, rhel-sap-cloud, suse-cloud, suse-sap-cloud, + ubuntu-os-pro-cloud, windows-cloud, windows-sql-cloud. Enabled by + default, use --no-standard-images to disable. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/beta/compute/instances/attach-disk b/gcloud/beta/compute/instances/attach-disk index 0ac3028f4..acb21598d 100644 --- a/gcloud/beta/compute/instances/attach-disk +++ b/gcloud/beta/compute/instances/attach-disk @@ -22,6 +22,8 @@ DESCRIPTION mount (https://cloud.google.com/compute/docs/disks/add-persistent-disk#formatting) the disk so that the operating system can use the available storage space. + You can attach an existing non-boot disk to more than one instance. For + more information, see Share a disk between VMs. EXAMPLES To attach a disk named 'my-disk' as a boot disk to an instance named @@ -97,10 +99,7 @@ OPTIONAL FLAGS ro Read-only. rw - Read-write. It is an error to attach a disk in read-write mode to - more than one instance. For details on how to share persistent - disks between multiple instances, refer to - https://cloud.google.com/compute/docs/disks/add-persistent-disk#use_multi_instances + Read-write. --zone=ZONE Zone of the instance to operate on. If not specified, you might be diff --git a/gcloud/beta/compute/network-firewall-policies/rules/create b/gcloud/beta/compute/network-firewall-policies/rules/create index d3f06d174..0b4fc3c46 100644 --- a/gcloud/beta/compute/network-firewall-policies/rules/create +++ b/gcloud/beta/compute/network-firewall-policies/rules/create @@ -8,6 +8,7 @@ SYNOPSIS [--description=DESCRIPTION] [--dest-address-groups=[DEST_ADDRESS_GROUPS,...]] [--dest-fqdns=[DEST_FQDNS,...]] [--dest-ip-ranges=[DEST_IP_RANGE,...]] + [--dest-network-scope=DEST_NETWORK_SCOPE] [--dest-region-codes=[DEST_REGION_CODES,...]] [--dest-threat-intelligence=[DEST_THREAT_INTELLIGENCE_LISTS,...]] [--direction=DIRECTION] [--[no-]disabled] [--[no-]enable-logging] @@ -15,6 +16,8 @@ SYNOPSIS [--security-profile-group=SECURITY_PROFILE_GROUP] [--src-address-groups=[SOURCE_ADDRESS_GROUPS,...]] [--src-fqdns=[SOURCE_FQDNS,...]] [--src-ip-ranges=[SRC_IP_RANGE,...]] + [--src-network-scope=SRC_NETWORK_SCOPE] + [--src-networks=[SRC_NETWORKS,...]] [--src-region-codes=[SOURCE_REGION_CODES,...]] [--src-secure-tags=[SOURCE_SECURE_TAGS,...]] [--src-threat-intelligence=[SOURCE_THREAT_INTELLIGENCE_LISTS,...]] @@ -71,6 +74,12 @@ OPTIONAL FLAGS --dest-ip-ranges=[DEST_IP_RANGE,...] Destination IP ranges to match for this rule. + --dest-network-scope=DEST_NETWORK_SCOPE + Use this flag to indicate that the rule should match internet or + non-internet traffic. It applies to destination traffic for egress + rules. Valid values are INTERNET, NON_INTERNET and INTRA_VPC. Use empty + string to clear the field. + --dest-region-codes=[DEST_REGION_CODES,...] Destination Region Code to match for this rule. Can only be specified if DIRECTION is egress. @@ -122,6 +131,18 @@ OPTIONAL FLAGS --src-secure-tags.Multiple IP address blocks can be specified if they are separated by commas. + --src-network-scope=SRC_NETWORK_SCOPE + Use this flag to indicate that the rule should match internet, + non-internet traffic or traffic coming from the network specified by + --src-network. It applies to ingress rules. Valid values are INTERNET, + NON_INTERNET, VPC_NETWORKS and INTRA_VPC. Use empty string to clear the + field. + + --src-networks=[SRC_NETWORKS,...] + The source VPC networks to match for this rule. It can only be + specified when --src-network-scope is VPC_NETWORKS. It applies to + ingress rules. It accepts full or partial URLs. + --src-region-codes=[SOURCE_REGION_CODES,...] Source Region Code to match for this rule. Can only be specified if DIRECTION is ingress. diff --git a/gcloud/beta/compute/network-firewall-policies/rules/update b/gcloud/beta/compute/network-firewall-policies/rules/update index 0c9bd5178..b938b4248 100644 --- a/gcloud/beta/compute/network-firewall-policies/rules/update +++ b/gcloud/beta/compute/network-firewall-policies/rules/update @@ -8,6 +8,7 @@ SYNOPSIS [--description=DESCRIPTION] [--dest-address-groups=[DEST_ADDRESS_GROUPS,...]] [--dest-fqdns=[DEST_FQDNS,...]] [--dest-ip-ranges=[DEST_IP_RANGE,...]] + [--dest-network-scope=DEST_NETWORK_SCOPE] [--dest-region-codes=[DEST_REGION_CODES,...]] [--dest-threat-intelligence=[DEST_THREAT_INTELLIGENCE_LISTS,...]] [--direction=DIRECTION] [--[no-]disabled] [--[no-]enable-logging] @@ -15,6 +16,8 @@ SYNOPSIS [--security-profile-group=SECURITY_PROFILE_GROUP] [--src-address-groups=[SOURCE_ADDRESS_GROUPS,...]] [--src-fqdns=[SOURCE_FQDNS,...]] [--src-ip-ranges=[SRC_IP_RANGE,...]] + [--src-network-scope=SRC_NETWORK_SCOPE] + [--src-networks=[SRC_NETWORKS,...]] [--src-region-codes=[SOURCE_REGION_CODES,...]] [--src-secure-tags=[SOURCE_SECURE_TAGS,...]] [--src-threat-intelligence=[SOURCE_THREAT_INTELLIGENCE_LISTS,...]] @@ -64,6 +67,12 @@ OPTIONAL FLAGS --dest-ip-ranges=[DEST_IP_RANGE,...] Destination IP ranges to match for this rule. + --dest-network-scope=DEST_NETWORK_SCOPE + Use this flag to indicate that the rule should match internet or + non-internet traffic. It applies to destination traffic for egress + rules. Valid values are INTERNET, NON_INTERNET and INTRA_VPC. Use empty + string to clear the field. + --dest-region-codes=[DEST_REGION_CODES,...] Destination Region Code to match for this rule. Can only be specified if DIRECTION is egress. @@ -118,6 +127,18 @@ OPTIONAL FLAGS --src-secure-tags.Multiple IP address blocks can be specified if they are separated by commas. + --src-network-scope=SRC_NETWORK_SCOPE + Use this flag to indicate that the rule should match internet, + non-internet traffic or traffic coming from the network specified by + --src-network. It applies to ingress rules. Valid values are INTERNET, + NON_INTERNET, VPC_NETWORKS and INTRA_VPC. Use empty string to clear the + field. + + --src-networks=[SRC_NETWORKS,...] + The source VPC networks to match for this rule. It can only be + specified when --src-network-scope is VPC_NETWORKS. It applies to + ingress rules. It accepts full or partial URLs. + --src-region-codes=[SOURCE_REGION_CODES,...] Source Region Code to match for this rule. Can only be specified if DIRECTION is ingress. diff --git a/gcloud/beta/container/fleet/memberships/update b/gcloud/beta/container/fleet/memberships/update index 4f3295633..431f48116 100644 --- a/gcloud/beta/container/fleet/memberships/update +++ b/gcloud/beta/container/fleet/memberships/update @@ -97,7 +97,7 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the gkehub/v1beta1 API. The full documentation for this + This command uses the gkehub/v1beta API. The full documentation for this API can be found at: https://cloud.google.com/anthos/multicluster-management/connect/registering-a-cluster diff --git a/gcloud/beta/container/hub/memberships/update b/gcloud/beta/container/hub/memberships/update index 80281a899..1d01b5bc2 100644 --- a/gcloud/beta/container/hub/memberships/update +++ b/gcloud/beta/container/hub/memberships/update @@ -97,7 +97,7 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the gkehub/v1beta1 API. The full documentation for this + This command uses the gkehub/v1beta API. The full documentation for this API can be found at: https://cloud.google.com/anthos/multicluster-management/connect/registering-a-cluster diff --git a/gcloud/beta/data-fusion/add-iam-policy-binding b/gcloud/beta/data-fusion/add-iam-policy-binding index b596c8376..827bb43cd 100644 --- a/gcloud/beta/data-fusion/add-iam-policy-binding +++ b/gcloud/beta/data-fusion/add-iam-policy-binding @@ -9,18 +9,16 @@ SYNOPSIS EXAMPLES To set someone@example.com to have roles/datafusion.admin permission for - instance 'my-instance', in project 'my-project', location in 'my-location', - run: + instance my-instance, in project my-project, location in my-location, run: - $ gcloud beta data-fusion add-iam-policy-binding \ - add-iam-policy-binding my-instance --location=my-location \ - --member=user:someone@example.com --role=roles/datafusion.admin + $ gcloud beta data-fusion add-iam-policy-binding my-instance \ + --location=my-location --member=user:someone@example.com \ + --role=roles/datafusion.admin To run the same command for a specific namespace on the instance, run: - $ gcloud beta data-fusion add-iam-policy-binding \ - add-iam-policy-binding my-instance --location=my-location \ - --member=user:someone@example.com \ + $ gcloud beta data-fusion add-iam-policy-binding my-instance \ + --location=my-location --member=user:someone@example.com \ --role=roles/datafusion.admin --namespace=my-namespace POSITIONAL ARGUMENTS diff --git a/gcloud/beta/data-fusion/get-iam-policy b/gcloud/beta/data-fusion/get-iam-policy index 22cc76d7c..2989ea973 100644 --- a/gcloud/beta/data-fusion/get-iam-policy +++ b/gcloud/beta/data-fusion/get-iam-policy @@ -8,8 +8,8 @@ SYNOPSIS [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] EXAMPLES - To get IAM policy for instance 'my-instance' in project 'my-project' and - location 'my-location', run: + To get IAM policy for instance my-instance in project my-project and + location my-location, run: $ gcloud beta data-fusion get-iam-policy my-instance \ --project=my-project --location=my-location diff --git a/gcloud/beta/data-fusion/instances/create b/gcloud/beta/data-fusion/instances/create index de86df3f8..926e2d1e5 100644 --- a/gcloud/beta/data-fusion/instances/create +++ b/gcloud/beta/data-fusion/instances/create @@ -21,11 +21,11 @@ DESCRIPTION gcloud beta data-fusion instances create operations list EXAMPLES - To create instance 'my-instance' in project 'my-project', location in - 'my-location', and zone in 'my-zone' run: + To create instance my-instance in project my-project, location in + my-location, and zone in my-zone run: - $ gcloud beta data-fusion instances create --project=my-project \ - --location=my-location my-instance --zone=my-zone + $ gcloud beta data-fusion instances create my-instance \ + --project=my-project --location=my-location --zone=my-zone POSITIONAL ARGUMENTS Instance resource - Instance to create. The arguments in this group can be diff --git a/gcloud/beta/data-fusion/instances/delete b/gcloud/beta/data-fusion/instances/delete index 82346429a..279fb7642 100644 --- a/gcloud/beta/data-fusion/instances/delete +++ b/gcloud/beta/data-fusion/instances/delete @@ -14,11 +14,11 @@ DESCRIPTION gcloud beta data-fusion instances delete operations list EXAMPLES - To delete instance 'my-instance' in project 'my-project' and location - 'my-location', run: + To delete instance my-instance in project my-project and location + my-location, run: - $ gcloud beta data-fusion instances delete --project=my-project \ - --location=my-location my-instance + $ gcloud beta data-fusion instances delete my-instance \ + --project=my-project --location=my-location POSITIONAL ARGUMENTS Instance resource - Instance to delete. The arguments in this group can be diff --git a/gcloud/beta/data-fusion/instances/describe b/gcloud/beta/data-fusion/instances/describe index c6d722158..8a4f1955f 100644 --- a/gcloud/beta/data-fusion/instances/describe +++ b/gcloud/beta/data-fusion/instances/describe @@ -7,11 +7,11 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] EXAMPLES - To describe instance 'my-instance' in project 'my-project' and location - 'my-location', run: + To describe instance my-instance in project my-project and location + my-location, run: - $ gcloud beta data-fusion instances describe --project=my-project \ - --location=my-location my-instance + $ gcloud beta data-fusion instances describe my-instance \ + --project=my-project --location=my-location POSITIONAL ARGUMENTS Instance resource - Instance to describe. The arguments in this group can diff --git a/gcloud/beta/data-fusion/instances/list b/gcloud/beta/data-fusion/instances/list index b0f683266..123359e29 100644 --- a/gcloud/beta/data-fusion/instances/list +++ b/gcloud/beta/data-fusion/instances/list @@ -8,7 +8,7 @@ SYNOPSIS [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] EXAMPLES - To list instances in project 'my-project' and location 'my-location', run: + To list instances in project my-project and location my-location, run: $ gcloud beta data-fusion instances list --project=my-project \ --location=my-location diff --git a/gcloud/beta/data-fusion/instances/restart b/gcloud/beta/data-fusion/instances/restart index 2314c17cd..50f5864f0 100644 --- a/gcloud/beta/data-fusion/instances/restart +++ b/gcloud/beta/data-fusion/instances/restart @@ -14,11 +14,11 @@ DESCRIPTION gcloud beta data-fusion instances restart operations list EXAMPLES - To restart instance 'my-instance' in project 'my-project' and location - 'my-location', run: + To restart instance my-instance in project my-project and location + my-location, run: - $ gcloud beta data-fusion instances restart --project=my-project \ - --location=my-location my-instance + $ gcloud beta data-fusion instances restart my-instance \ + --project=my-project --location=my-location POSITIONAL ARGUMENTS Instance resource - Instance to restart. The arguments in this group can diff --git a/gcloud/beta/data-fusion/operations/delete b/gcloud/beta/data-fusion/operations/delete index 0240bb8b7..9f8f445ac 100644 --- a/gcloud/beta/data-fusion/operations/delete +++ b/gcloud/beta/data-fusion/operations/delete @@ -7,11 +7,11 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] EXAMPLES - To delete operation 'my-operation' in project 'my-project' and location - 'my-location', run: + To delete operation my-operation in project my-project and location + my-location, run: - $ gcloud beta data-fusion operations delete --project=my-project \ - --location=my-location my-operation + $ gcloud beta data-fusion operations delete my-operation \ + --project=my-project --location=my-location POSITIONAL ARGUMENTS Operation resource - The operation to delete. The arguments in this group diff --git a/gcloud/beta/data-fusion/operations/list b/gcloud/beta/data-fusion/operations/list index c5be541d0..3d18714a1 100644 --- a/gcloud/beta/data-fusion/operations/list +++ b/gcloud/beta/data-fusion/operations/list @@ -7,7 +7,7 @@ SYNOPSIS [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] EXAMPLES - To list operations in project 'my-project' and location 'my-location', run: + To list operations in project my-project and location my-location, run: $ gcloud beta data-fusion operations list --project=my-project \ --location=my-location diff --git a/gcloud/beta/data-fusion/operations/wait b/gcloud/beta/data-fusion/operations/wait index f4c91efdd..5df297680 100644 --- a/gcloud/beta/data-fusion/operations/wait +++ b/gcloud/beta/data-fusion/operations/wait @@ -7,11 +7,11 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] EXAMPLES - To wait for operation 'my-operation' in project 'my-project' and location - 'my-location', run: + To wait for operation my-operation in project my-project and location + my-location, run: - $ gcloud beta data-fusion operations wait --project=my-project \ - --location=my-location my-operation + $ gcloud beta data-fusion operations wait my-operation \ + --project=my-project --location=my-location POSITIONAL ARGUMENTS Operation resource - The operation to wait for. The arguments in this diff --git a/gcloud/beta/data-fusion/remove-iam-policy-binding b/gcloud/beta/data-fusion/remove-iam-policy-binding index 5f1b15909..28019e5aa 100644 --- a/gcloud/beta/data-fusion/remove-iam-policy-binding +++ b/gcloud/beta/data-fusion/remove-iam-policy-binding @@ -9,18 +9,16 @@ SYNOPSIS EXAMPLES To set someone@example.com to have roles/datafusion.admin permission for - instance 'my-instance' in project 'my-project', location in 'my-location', - run: + instance my-instance in project my-project, location in my-location, run: - $ gcloud beta data-fusion remove-iam-policy-binding \ - remove-iam-policy-binding my-instance --location=my-location \ - --member=user:someone@example.com --role=roles/datafusion.admin + $ gcloud beta data-fusion remove-iam-policy-binding my-instance \ + --location=my-location --member=user:someone@example.com \ + --role=roles/datafusion.admin To run the same command for a specific namespace on the instance, run: - $ gcloud beta data-fusion remove-iam-policy-binding \ - remove-iam-policy-binding my-instance --location=my-location \ - --member=user:someone@example.com \ + $ gcloud beta data-fusion remove-iam-policy-binding my-instance \ + --location=my-location --member=user:someone@example.com \ --role=roles/datafusion.admin --namespace=my-namespace POSITIONAL ARGUMENTS diff --git a/gcloud/beta/data-fusion/set-iam-policy b/gcloud/beta/data-fusion/set-iam-policy index c3968297c..b8cfbf73a 100644 --- a/gcloud/beta/data-fusion/set-iam-policy +++ b/gcloud/beta/data-fusion/set-iam-policy @@ -7,8 +7,8 @@ SYNOPSIS POLICY_FILE [--namespace=NAMESPACE] [GCLOUD_WIDE_FLAG ...] EXAMPLES - To set the policy for instance 'my-instance' in project 'my-project', - location in 'my-location', and zone in 'my-zone' run: + To set the policy for instance my-instance in project my-project, location + in my-location, and zone in my-zone run: $ gcloud beta data-fusion set-iam-policy my-instance \ policy-file.yaml --project=my-project --location=my-location diff --git a/gcloud/beta/iap/settings/get b/gcloud/beta/iap/settings/get index 4311170e5..93f710284 100644 --- a/gcloud/beta/iap/settings/get +++ b/gcloud/beta/iap/settings/get @@ -79,7 +79,7 @@ FLAGS --resource-type=RESOURCE_TYPE Resource type of the IAP resource. RESOURCE_TYPE must be one of: - app-engine, iap_web, compute, organization, folder. + app-engine, iap_web, compute, organization, folder, forwarding-rule. --service=SERVICE Service name. Optional when resource-type is compute or app-engine. diff --git a/gcloud/beta/iap/settings/set b/gcloud/beta/iap/settings/set index d7b281f6e..33722fb4f 100644 --- a/gcloud/beta/iap/settings/set +++ b/gcloud/beta/iap/settings/set @@ -130,7 +130,7 @@ FLAGS --resource-type=RESOURCE_TYPE Resource type of the IAP resource. RESOURCE_TYPE must be one of: - app-engine, iap_web, compute, organization, folder. + app-engine, iap_web, compute, organization, folder, forwarding-rule. --service=SERVICE Service name. Optional when resource-type is compute or app-engine. diff --git a/gcloud/beta/iap/web/add-iam-policy-binding b/gcloud/beta/iap/web/add-iam-policy-binding index 248aa8fa9..65b9e8045 100644 --- a/gcloud/beta/iap/web/add-iam-policy-binding +++ b/gcloud/beta/iap/web/add-iam-policy-binding @@ -122,7 +122,7 @@ OPTIONAL FLAGS --resource-type=RESOURCE_TYPE Resource type of the IAP resource. RESOURCE_TYPE must be one of: - app-engine, backend-services. + app-engine, backend-services, forwarding-rule. --service=SERVICE Service name. diff --git a/gcloud/beta/iap/web/get-iam-policy b/gcloud/beta/iap/web/get-iam-policy index 907d1ae37..490d877c6 100644 --- a/gcloud/beta/iap/web/get-iam-policy +++ b/gcloud/beta/iap/web/get-iam-policy @@ -70,7 +70,7 @@ FLAGS --resource-type=RESOURCE_TYPE Resource type of the IAP resource. RESOURCE_TYPE must be one of: - app-engine, backend-services. + app-engine, backend-services, forwarding-rule. --service=SERVICE Service name. diff --git a/gcloud/beta/iap/web/remove-iam-policy-binding b/gcloud/beta/iap/web/remove-iam-policy-binding index 7524d922f..2bf4f309e 100644 --- a/gcloud/beta/iap/web/remove-iam-policy-binding +++ b/gcloud/beta/iap/web/remove-iam-policy-binding @@ -139,7 +139,7 @@ OPTIONAL FLAGS --resource-type=RESOURCE_TYPE Resource type of the IAP resource. RESOURCE_TYPE must be one of: - app-engine, backend-services. + app-engine, backend-services, forwarding-rule. --service=SERVICE Service name. diff --git a/gcloud/beta/iap/web/set-iam-policy b/gcloud/beta/iap/web/set-iam-policy index 9b22d82ba..ed5e89e97 100644 --- a/gcloud/beta/iap/web/set-iam-policy +++ b/gcloud/beta/iap/web/set-iam-policy @@ -79,7 +79,7 @@ FLAGS --resource-type=RESOURCE_TYPE Resource type of the IAP resource. RESOURCE_TYPE must be one of: - app-engine, backend-services. + app-engine, backend-services, forwarding-rule. --service=SERVICE Service name. diff --git a/gcloud/beta/network-security/security-profile-groups/create b/gcloud/beta/network-security/security-profile-groups/create index ca008e056..c4c35b274 100644 --- a/gcloud/beta/network-security/security-profile-groups/create +++ b/gcloud/beta/network-security/security-profile-groups/create @@ -5,11 +5,10 @@ NAME SYNOPSIS gcloud beta network-security security-profile-groups create (SECURITY_PROFILE_GROUP - : --location=LOCATION --organization=ORGANIZATION) - (--threat-prevention-profile=THREAT_PREVENTION_PROFILE - : --security-profile-location=SECURITY_PROFILE_LOCATION - --security-profile-organization=SECURITY_PROFILE_ORGANIZATION) - [--async] [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] + : --location=LOCATION --organization=ORGANIZATION) [--async] + [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] + [--threat-prevention-profile=THREAT_PREVENTION_PROFILE + : --threat-prevention-profile-location=THREAT_PREVENTION_PROFILE_LOCATION --threat-prevention-profile-organization=THREAT_PREVENTION_PROFILE_ORGANIZATION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -60,52 +59,7 @@ POSITIONAL ARGUMENTS with a fully specified name; ▸ provide the argument --organization on the command line. -REQUIRED FLAGS - Security Profile resource - Path to Security Profile resource. The - arguments in this group can be used to specify the attributes of this - resource. - - This must be specified. - - --threat-prevention-profile=THREAT_PREVENTION_PROFILE - ID of the Security Profile or fully qualified identifier for the - Security Profile. - - To set the security_profile attribute: - ▸ provide the argument --threat-prevention-profile on the command - line. - - This flag argument must be specified if any of the other arguments in - this group are specified. - - --security-profile-location=SECURITY_PROFILE_LOCATION - Location of the Security Profile. NOTE: Only global security profiles - are supported. - - To set the security-profile-location attribute: - ▸ provide the argument --threat-prevention-profile on the command - line with a fully specified name; - ▸ provide the argument --security-profile-location on the command - line; - ▸ provide the argument --location on the command line; - ▸ provide the argument - networksecurity.organizations.locations.securityProfileGroups on - the command line with a fully specified name. - - --security-profile-organization=SECURITY_PROFILE_ORGANIZATION - Organization ID of the Security Profile. - - To set the security-profile-organization attribute: - ▸ provide the argument --threat-prevention-profile on the command - line with a fully specified name; - ▸ provide the argument --security-profile-organization on the - command line; - ▸ provide the argument --organization on the command line; - ▸ provide the argument - networksecurity.organizations.locations.securityProfileGroups on - the command line with a fully specified name. - -OPTIONAL FLAGS +FLAGS --async Return immediately, without waiting for the operation in progress to complete. The default is False. @@ -121,6 +75,52 @@ OPTIONAL FLAGS contain only hyphens (-), underscores (_), lowercase characters, and numbers. + Security Profile resource - Path to Security Profile resource. The + arguments in this group can be used to specify the attributes of this + resource. + + --threat-prevention-profile=THREAT_PREVENTION_PROFILE + ID of the Security Profile or fully qualified identifier for the + Security Profile. + + To set the threat-prevention-profile-profile attribute: + ▸ provide the argument --threat-prevention-profile on the command + line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --threat-prevention-profile-location=THREAT_PREVENTION_PROFILE_LOCATION + Location of the Security Profile. NOTE: Only global security profiles + are supported. + + To set the threat-prevention-profile-location attribute: + ▸ provide the argument --threat-prevention-profile on the command + line with a fully specified name; + ▸ provide the argument --threat-prevention-profile-location on the + command line; + ▸ provide the argument --security-profile-location on the command + line; + ▸ provide the argument --location on the command line; + ▸ provide the argument + networksecurity.organizations.locations.securityProfileGroups on + the command line with a fully specified name. + + --threat-prevention-profile-organization=THREAT_PREVENTION_PROFILE_ORGANIZATION + Organization ID of the Security Profile. + + To set the threat-prevention-profile-organization attribute: + ▸ provide the argument --threat-prevention-profile on the command + line with a fully specified name; + ▸ provide the argument --threat-prevention-profile-organization on + the command line; + ▸ provide the argument --security-profile-organization on the + command line; + ▸ provide the argument --organization on the command line; + ▸ provide the argument + networksecurity.organizations.locations.securityProfileGroups on + the command line with a fully specified name. + 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/network-security/security-profile-groups/update b/gcloud/beta/network-security/security-profile-groups/update index f1536f0ba..6f7866a7b 100644 --- a/gcloud/beta/network-security/security-profile-groups/update +++ b/gcloud/beta/network-security/security-profile-groups/update @@ -9,8 +9,7 @@ SYNOPSIS [--description=DESCRIPTION] [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] [--threat-prevention-profile=THREAT_PREVENTION_PROFILE - : --security-profile-location=SECURITY_PROFILE_LOCATION - --security-profile-organization=SECURITY_PROFILE_ORGANIZATION] + : --threat-prevention-profile-location=THREAT_PREVENTION_PROFILE_LOCATION --threat-prevention-profile-organization=THREAT_PREVENTION_PROFILE_ORGANIZATION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -106,20 +105,22 @@ FLAGS ID of the Security Profile or fully qualified identifier for the Security Profile. - To set the security_profile attribute: + To set the threat-prevention-profile-profile attribute: ▸ provide the argument --threat-prevention-profile on the command line. This flag argument must be specified if any of the other arguments in this group are specified. - --security-profile-location=SECURITY_PROFILE_LOCATION + --threat-prevention-profile-location=THREAT_PREVENTION_PROFILE_LOCATION Location of the Security Profile. NOTE: Only global security profiles are supported. - To set the security-profile-location attribute: + To set the threat-prevention-profile-location attribute: ▸ provide the argument --threat-prevention-profile on the command line with a fully specified name; + ▸ provide the argument --threat-prevention-profile-location on the + command line; ▸ provide the argument --security-profile-location on the command line; ▸ provide the argument --location on the command line; @@ -127,12 +128,14 @@ FLAGS networksecurity.organizations.locations.securityProfileGroups on the command line with a fully specified name. - --security-profile-organization=SECURITY_PROFILE_ORGANIZATION + --threat-prevention-profile-organization=THREAT_PREVENTION_PROFILE_ORGANIZATION Organization ID of the Security Profile. - To set the security-profile-organization attribute: + To set the threat-prevention-profile-organization attribute: ▸ provide the argument --threat-prevention-profile on the command line with a fully specified name; + ▸ provide the argument --threat-prevention-profile-organization on + the command line; ▸ provide the argument --security-profile-organization on the command line; ▸ provide the argument --organization on the command line; diff --git a/gcloud/beta/scc/sources/describe b/gcloud/beta/scc/sources/describe index 697691ab6..d29686d20 100644 --- a/gcloud/beta/scc/sources/describe +++ b/gcloud/beta/scc/sources/describe @@ -3,7 +3,7 @@ NAME or source id SYNOPSIS - gcloud beta scc sources describe [ORGANIZATION] + gcloud beta scc sources describe [PARENT] (--source=SOURCE | --source-display-name=SOURCE_DISPLAY_NAME) [GCLOUD_WIDE_FLAG ...] @@ -11,7 +11,7 @@ DESCRIPTION (BETA) Describe a source given its display name or source id. EXAMPLES - Describe source with display name 'Security Scanner': + Describe source with display name Security Scanner: $ gcloud beta scc sources describe 123456 \ --source-display-name="Security Scanner" @@ -21,18 +21,18 @@ EXAMPLES $ gcloud beta scc sources describe 123456 --source=5678 POSITIONAL ARGUMENTS - Organization resource - The organization to be used for the SCC (Security - Command Center) command. This represents a Cloud resource. + Parent resource - parent organization, folder, or project in the Google + Cloud resource hierarchy to be used for the gcloud scc command. Specify + the argument as either [RESOURCE_TYPE/RESOURCE_ID] or [RESOURCE_ID], as + shown in the preceding examples. This represents a Cloud resource. - [ORGANIZATION] - ID of the organization or fully qualified identifier for the - organization. + [PARENT] + ID of the parent or fully qualified identifier for the parent. - To set the organization attribute: - ▸ provide the argument organization on the command line; - ▸ Set the organization property in configuration using gcloud - config set scc/organization if it is not specified in command - line.. + To set the parent attribute: + ▸ provide the argument parent on the command line; + ▸ Set the parent property in configuration using gcloud config set + scc/parent if it is not specified in command line. REQUIRED FLAGS Exactly one of these must be specified: diff --git a/gcloud/beta/secrets/delete b/gcloud/beta/secrets/delete index b53f4ddc7..92fdc250d 100644 --- a/gcloud/beta/secrets/delete +++ b/gcloud/beta/secrets/delete @@ -11,13 +11,13 @@ DESCRIPTION succeed, but the operation will be a no-op. EXAMPLES - Delete a secret 'my-secret': + Delete a secret my-secret: $ gcloud beta secrets delete my-secret - Delete a secret 'my-secret' using etag: + Delete a secret my-secret using etag: - $ gcloud beta secrets delete my-secret --etag=\"123\" + $ gcloud beta secrets delete my-secret --etag=123 POSITIONAL ARGUMENTS Secret resource - The secret to delete. This represents a Cloud resource. @@ -40,9 +40,8 @@ POSITIONAL ARGUMENTS FLAGS --etag=ETAG - Current entity tag (ETag) of the secret. If this flag is defined, the - secret is updated only if the ETag provided matched the current - secret's ETag. + Current entity tag (ETag) of the secret. If specified, the secret is + deleted only if the ETag provided matches the current secret's ETag. Location resource - The location to delete secret. This represents a Cloud resource. (NOTE) Some attributes are not given arguments in this group but diff --git a/gcloud/beta/secrets/update b/gcloud/beta/secrets/update index d2c6faefa..3890c20b2 100644 --- a/gcloud/beta/secrets/update +++ b/gcloud/beta/secrets/update @@ -25,14 +25,14 @@ DESCRIPTION an error if given a secret that does not exist. EXAMPLES - Update the label of a secret named 'my-secret'. + Update the label of a secret named my-secret. $ gcloud beta secrets update my-secret --update-labels=foo=bar Update the label of a secret using etag. $ gcloud beta secrets update my-secret --update-labels=foo=bar \ - --etag=\"123\" + --etag=123 Update the expiration of a secret named 'my-secret' using a ttl. @@ -95,9 +95,8 @@ POSITIONAL ARGUMENTS FLAGS --etag=ETAG - Current entity tag (ETag) of the secret. If this flag is defined, the - secret is updated only if the ETag provided matched the current - secret's ETag. + Current entity tag (ETag) of the secret. If specified, the secret is + updated only if the ETag provided matches the current secret's ETag. Location resource - The location to update secret. This represents a Cloud resource. (NOTE) Some attributes are not given arguments in this group but diff --git a/gcloud/beta/secrets/versions/destroy b/gcloud/beta/secrets/versions/destroy index f16d4f952..374e7ad9b 100644 --- a/gcloud/beta/secrets/versions/destroy +++ b/gcloud/beta/secrets/versions/destroy @@ -11,14 +11,14 @@ DESCRIPTION irreversible. EXAMPLES - Destroy version '123' of the secret named 'my-secret': + Destroy version 123 of the secret named my-secret: $ gcloud beta secrets versions destroy 123 --secret=my-secret - Destroy version '123' of the secret named 'my-secret' using an etag: + Destroy version 123 of the secret named my-secret using an etag: $ gcloud beta secrets versions destroy 123 --secret=my-secret \ - --etag=\"123\" + --etag=123 POSITIONAL ARGUMENTS Version resource - Numeric secret version to destroy. The arguments in @@ -53,9 +53,9 @@ POSITIONAL ARGUMENTS FLAGS --etag=ETAG - Current entity tag (ETag) of the secret version. If this flag is - defined, the version is updated only if the ETag provided matched the - current version's ETag. + Current entity tag (ETag) of the secret version. If specified, the + version is destroyed only if the ETag provided matches the current + version's ETag. Location resource - The location to destroy . This represents a Cloud resource. (NOTE) Some attributes are not given arguments in this group but diff --git a/gcloud/beta/secrets/versions/disable b/gcloud/beta/secrets/versions/disable index 8419e2ce8..ecb6afe9e 100644 --- a/gcloud/beta/secrets/versions/disable +++ b/gcloud/beta/secrets/versions/disable @@ -11,14 +11,14 @@ DESCRIPTION with gcloud beta secrets versions enable. EXAMPLES - Disable version '123' of the secret named 'my-secret': + Disable version 123 of the secret named my-secret: $ gcloud beta secrets versions disable 123 --secret=my-secret - Disable version '123' of the secret named 'my-secret' using an etag: + Disable version 123 of the secret named my-secret using an etag: $ gcloud beta secrets versions disable 123 --secret=my-secret \ - --etag=\"123\" + --etag=123 POSITIONAL ARGUMENTS Version resource - Numeric secret version to disable. The arguments in @@ -53,9 +53,9 @@ POSITIONAL ARGUMENTS FLAGS --etag=ETAG - Current entity tag (ETag) of the secret version. If this flag is - defined, the version is updated only if the ETag provided matched the - current version's ETag. + Current entity tag (ETag) of the secret version. If specified, the + version is disabled only if the ETag provided matches the current + version's ETag. Location resource - The location to disable. This represents a Cloud resource. (NOTE) Some attributes are not given arguments in this group but diff --git a/gcloud/beta/secrets/versions/enable b/gcloud/beta/secrets/versions/enable index b9316f10c..f99b3aaf5 100644 --- a/gcloud/beta/secrets/versions/enable +++ b/gcloud/beta/secrets/versions/enable @@ -11,14 +11,14 @@ DESCRIPTION gcloud beta secrets versions disable. EXAMPLES - Enable version '123' of the secret named 'my-secret': + Enable version 123 of the secret named my-secret: $ gcloud beta secrets versions enable 123 --secret=my-secret - Enable version '123' of the secret named 'my-secret' using an etag: + Enable version 123 of the secret named my-secret using an etag: $ gcloud beta secrets versions enable 123 --secret=my-secret \ - --etag=\"123\" + --etag=123 POSITIONAL ARGUMENTS Version resource - Numeric secret version to enable. The arguments in this @@ -53,9 +53,9 @@ POSITIONAL ARGUMENTS FLAGS --etag=ETAG - Current entity tag (ETag) of the secret version. If this flag is - defined, the version is updated only if the ETag provided matched the - current version's ETag. + Current entity tag (ETag) of the secret version. If specified, the + version is enabled only if the ETag provided matches the current + version's ETag. Location resource - The location to enable. This represents a Cloud resource. (NOTE) Some attributes are not given arguments in this group but diff --git a/gcloud/beta/spanner/instance-configs/create b/gcloud/beta/spanner/instance-configs/create index c57959508..fa91d4261 100644 --- a/gcloud/beta/spanner/instance-configs/create +++ b/gcloud/beta/spanner/instance-configs/create @@ -16,17 +16,17 @@ DESCRIPTION EXAMPLES To create a custom Cloud Spanner instance configuration based on an - existing Google-managed configuration (nam3) by adding a 'READ_ONLY' type - replica in location 'us-east4', run: + existing Google-managed configuration (nam3) by adding a READ_ONLY type + replica in location us-east4, run: $ gcloud beta spanner instance-configs create \ custom-instance-config --clone-config=nam3 \ --add-replicas=location=us-east4,type=READ_ONLY To create a custom Cloud Spanner instance configuration based on another - custom configuration (custom-instance-config) by adding a 'READ_ONLY' type - replica in location 'us-east1' and removing a 'READ_ONLY' type replica in - location 'us-east4', run: + custom configuration (custom-instance-config) by adding a READ_ONLY type + replica in location us-east1 and removing a READ_ONLY type replica in + location us-east4, run: $ gcloud beta spanner instance-configs create \ custom-instance-config1 --clone-config=custom-instance-config \ @@ -144,8 +144,8 @@ OPTIONAL FLAGS numbers. --validate-only - Use this flag to validate that the request will succeed before - executing it. + If specified, validate that the creation will succeed without creating + the instance configuration. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/spanner/instance-configs/delete b/gcloud/beta/spanner/instance-configs/delete index f293a6af9..4000abd13 100644 --- a/gcloud/beta/spanner/instance-configs/delete +++ b/gcloud/beta/spanner/instance-configs/delete @@ -24,8 +24,8 @@ FLAGS simultaneous deletes of an instance config from overwriting each other. --validate-only - Use this flag to validate that the request will succeed before - executing it. + If specified, validate that the deletion will succeed without deleting + the instance config. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/spanner/instances/create b/gcloud/beta/spanner/instances/create index 010514b06..78a7b4646 100644 --- a/gcloud/beta/spanner/instances/create +++ b/gcloud/beta/spanner/instances/create @@ -3,8 +3,8 @@ NAME SYNOPSIS gcloud beta spanner instances create INSTANCE --config=CONFIG - --description=DESCRIPTION [--async] [--expire-behavior=EXPIRE_BEHAVIOR] - [--instance-type=INSTANCE_TYPE] + --description=DESCRIPTION [--async] [--edition=EDITION] + [--expire-behavior=EXPIRE_BEHAVIOR] [--instance-type=INSTANCE_TYPE] [--nodes=NODES | --processing-units=PROCESSING_UNITS | --autoscaling-high-priority-cpu-target=AUTOSCALING_HIGH_PRIORITY_CPU_TARGET --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET (--autoscaling-max-nodes=AUTOSCALING_MAX_NODES --autoscaling-min-nodes=AUTOSCALING_MIN_NODES | --autoscaling-max-processing-units=AUTOSCALING_MAX_PROCESSING_UNITS --autoscaling-min-processing-units=AUTOSCALING_MIN_PROCESSING_UNITS)] [GCLOUD_WIDE_FLAG ...] @@ -37,6 +37,20 @@ OPTIONAL FLAGS Return immediately, without waiting for the operation in progress to complete. + --edition=EDITION + Cloud Spanner edition. EDITION must be one of: + + EDITION_UNSPECIFIED + Spanner's legacy pricing model. For more information, see the + Spanner editions overview + (https://cloud.google.com/spanner/docs/editions-overview) + ENTERPRISE + Enterprise edition + ENTERPRISE_PLUS + Enterprise Plus edition + STANDARD + Standard edition + --expire-behavior=EXPIRE_BEHAVIOR The expire behavior of a free trial instance. EXPIRE_BEHAVIOR must be one of: diff --git a/gcloud/beta/spanner/instances/update b/gcloud/beta/spanner/instances/update index 11464e532..9ba6f16bb 100644 --- a/gcloud/beta/spanner/instances/update +++ b/gcloud/beta/spanner/instances/update @@ -3,8 +3,8 @@ NAME SYNOPSIS gcloud beta spanner instances update INSTANCE [--async] - [--description=DESCRIPTION] [--expire-behavior=EXPIRE_BEHAVIOR] - [--instance-type=INSTANCE_TYPE] + [--description=DESCRIPTION] [--edition=EDITION] + [--expire-behavior=EXPIRE_BEHAVIOR] [--instance-type=INSTANCE_TYPE] [--nodes=NODES | --processing-units=PROCESSING_UNITS | --autoscaling-high-priority-cpu-target=AUTOSCALING_HIGH_PRIORITY_CPU_TARGET --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET --autoscaling-max-nodes=AUTOSCALING_MAX_NODES --autoscaling-min-nodes=AUTOSCALING_MIN_NODES | --autoscaling-max-processing-units=AUTOSCALING_MAX_PROCESSING_UNITS --autoscaling-min-processing-units=AUTOSCALING_MIN_PROCESSING_UNITS] [GCLOUD_WIDE_FLAG ...] @@ -34,6 +34,15 @@ FLAGS --description=DESCRIPTION Description of the instance. + --edition=EDITION + Cloud Spanner edition. You can upgrade your Standard edition instance + to the ENTERPRISE edition or ENTERPRISE_PLUS edition. You can also + upgrade your Enterprise edition instance to the ENTERPRISE_PLUS + edition. Self-service downgrade isn't available. To downgrade the + edition of your instance, file a support ticket. For more information, + see the Spanner editions overview + (https://cloud.google.com/spanner/docs/editions-overview) + --expire-behavior=EXPIRE_BEHAVIOR The expire behavior of a free trial instance. EXPIRE_BEHAVIOR must be one of: diff --git a/gcloud/beta/sql/backups/restore b/gcloud/beta/sql/backups/restore index 84c278994..2665f4b3a 100644 --- a/gcloud/beta/sql/backups/restore +++ b/gcloud/beta/sql/backups/restore @@ -3,7 +3,8 @@ NAME SYNOPSIS gcloud beta sql backups restore ID --restore-instance=RESTORE_INSTANCE - [--async] [--backup-instance=BACKUP_INSTANCE] [GCLOUD_WIDE_FLAG ...] + [--async] [--backup-instance=BACKUP_INSTANCE] + [--backup-project=BACKUP_PROJECT] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Restores a backup of a Cloud SQL instance. @@ -27,6 +28,10 @@ OPTIONAL FLAGS restore instance. If it is not specified, the backup instance is considered the same as the restore instance. + --backup-project=BACKUP_PROJECT + The project of the instance to which the backup belongs. If it isn't + specified, backup and restore instances are in the same project. + 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/sql/instances/create b/gcloud/beta/sql/instances/create index a7bc1c8dd..80d48fd29 100644 --- a/gcloud/beta/sql/instances/create +++ b/gcloud/beta/sql/instances/create @@ -20,7 +20,7 @@ SYNOPSIS [--deny-maintenance-period-end-date=DENY_MAINTENANCE_PERIOD_END_DATE] [--deny-maintenance-period-start-date=DENY_MAINTENANCE_PERIOD_START_DATE] [--deny-maintenance-period-time=DENY_MAINTENANCE_PERIOD_TIME] - [--edition=EDITION] [--enable-bin-log] [--enable-data-cache] + [--edition=EDITION] [--enable-bin-log] [--[no-]enable-data-cache] [--[no-]enable-dataplex-integration] [--[no-]enable-google-ml-integration] [--enable-google-private-path] [--enable-password-policy] [--enable-point-in-time-recovery] @@ -236,9 +236,10 @@ FLAGS fraction of a second. Must have automatic backups enabled to use. Make sure storage can support at least 7 days of logs. - --enable-data-cache + --[no-]enable-data-cache Enable use of data cache for accelerated read performance. This flag is - only available for Enterprise_Plus edition instances. + only available for Enterprise_Plus edition instances. Use + --enable-data-cache to enable and --no-enable-data-cache to disable. --[no-]enable-dataplex-integration Enable Dataplex integration for Google Cloud SQL. Use diff --git a/gcloud/beta/sql/instances/patch b/gcloud/beta/sql/instances/patch index d166662ce..b775a736c 100644 --- a/gcloud/beta/sql/instances/patch +++ b/gcloud/beta/sql/instances/patch @@ -17,7 +17,7 @@ SYNOPSIS [--deny-maintenance-period-end-date=DENY_MAINTENANCE_PERIOD_END_DATE] [--deny-maintenance-period-start-date=DENY_MAINTENANCE_PERIOD_START_DATE] [--deny-maintenance-period-time=DENY_MAINTENANCE_PERIOD_TIME] [--diff] - [--edition=EDITION] [--[no-]enable-bin-log] [--enable-data-cache] + [--edition=EDITION] [--[no-]enable-bin-log] [--[no-]enable-data-cache] [--[no-]enable-database-replication] [--[no-]enable-dataplex-integration] [--[no-]enable-google-ml-integration] @@ -183,9 +183,10 @@ FLAGS sure storage can support at least 7 days of logs. Use --enable-bin-log to enable and --no-enable-bin-log to disable. - --enable-data-cache + --[no-]enable-data-cache Enable use of data cache for accelerated read performance. This flag is - only available for Enterprise_Plus edition instances. + only available for Enterprise_Plus edition instances. Use + --enable-data-cache to enable and --no-enable-data-cache to disable. --[no-]enable-database-replication Enable database replication. Applicable only for read replica diff --git a/gcloud/beta/workstations/configs/create b/gcloud/beta/workstations/configs/create index 3688a9c8d..bc832a315 100644 --- a/gcloud/beta/workstations/configs/create +++ b/gcloud/beta/workstations/configs/create @@ -310,7 +310,7 @@ FLAGS and the administrator must manually delete the disk. --pool-size=POOL_SIZE - Number of instances to pool for faster Workstation starup. + Number of instances to pool for faster Workstation startup. --replica-zones=[REPLICA_ZONES,...] Specifies the zones the VM and disk resources will be replicated within diff --git a/gcloud/beta/workstations/configs/update b/gcloud/beta/workstations/configs/update index eeddb9db9..4e90bff49 100644 --- a/gcloud/beta/workstations/configs/update +++ b/gcloud/beta/workstations/configs/update @@ -253,7 +253,7 @@ FLAGS $ gcloud beta workstations configs update --network-tags=tag_1,tag_2 --pool-size=POOL_SIZE - Number of instances to pool for faster Workstation starup. + Number of instances to pool for faster Workstation startup. --running-timeout=RUNNING_TIMEOUT How long (in seconds) to wait before automatically stopping a diff --git a/gcloud/compute/disks/create b/gcloud/compute/disks/create index 99c54db16..e2247794b 100644 --- a/gcloud/compute/disks/create +++ b/gcloud/compute/disks/create @@ -60,7 +60,7 @@ POSITIONAL ARGUMENTS FLAGS --access-mode=ACCESS_MODE - Specifie how VMs attached to the disk can access the data on the disk. + Specifies how VMs attached to the disk can access the data on the disk. To grant read-only access to multiple VMs attached to the disk, set access-mode to READ_ONLY_MANY. To grant read-write access to only one VM attached to the disk, use READ_WRITE_SINGLE. READ_WRITE_SINGLE is @@ -95,7 +95,8 @@ FLAGS https://cloud.google.com/compute/docs/images/create-delete-deprecate-private-images#guest-os-features. GUEST_OS_FEATURE must be one of: GVNIC, IDPF, MULTI_IP_SUBNET, SEV_CAPABLE, SEV_LIVE_MIGRATABLE, SEV_LIVE_MIGRATABLE_V2, - SEV_SNP_CAPABLE, UEFI_COMPATIBLE, VIRTIO_SCSI_MULTIQUEUE, WINDOWS. + SEV_SNP_CAPABLE, TDX_CAPABLE, UEFI_COMPATIBLE, VIRTIO_SCSI_MULTIQUEUE, + WINDOWS. --labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to add. diff --git a/gcloud/compute/disks/update b/gcloud/compute/disks/update index 5cc1b5b5b..e8a05edea 100644 --- a/gcloud/compute/disks/update +++ b/gcloud/compute/disks/update @@ -38,7 +38,7 @@ POSITIONAL ARGUMENTS FLAGS --access-mode=ACCESS_MODE - Specifie how VMs attached to the disk can access the data on the disk. + Specifies how VMs attached to the disk can access the data on the disk. To grant read-only access to multiple VMs attached to the disk, set access-mode to READ_ONLY_MANY. To grant read-write access to only one VM attached to the disk, use READ_WRITE_SINGLE. READ_WRITE_SINGLE is diff --git a/gcloud/compute/future-reservations/cancel b/gcloud/compute/future-reservations/cancel deleted file mode 100644 index d8e753ce8..000000000 --- a/gcloud/compute/future-reservations/cancel +++ /dev/null @@ -1,74 +0,0 @@ -NAME - gcloud compute future-reservations cancel - cancel a Compute Engine future - reservation - -SYNOPSIS - gcloud compute future-reservations cancel - (FUTURE_RESERVATION : --zone=ZONE) [--async] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Cancel a Compute Engine future reservation. - -EXAMPLES - To cancel a given Compute Engine future reservation, run: - - $ gcloud compute future-reservations cancel my-reservation \ - --zone=ZONE - -POSITIONAL ARGUMENTS - Future reservation resource - The name of the future reservation to - cancel. 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 future_reservation 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. - - FUTURE_RESERVATION - ID of the future reservation or fully qualified identifier for the - future reservation. - - To set the future_reservation attribute: - ▸ provide the argument future_reservation on the command line. - - This positional argument must be specified if any of the other - arguments in this group are specified. - - --zone=ZONE - The name of the Google Compute Engine zone. - - To set the zone attribute: - ▸ provide the argument future_reservation on the command line with - a fully specified name; - ▸ provide the argument --zone on the command line; - ▸ set the property compute/zone. - -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 compute/v1 API. The full documentation for this API - can be found at: https://cloud.google.com/compute/ - -NOTES - These variants are also available: - - $ gcloud alpha compute future-reservations cancel - - $ gcloud beta compute future-reservations cancel - diff --git a/gcloud/compute/future-reservations/create b/gcloud/compute/future-reservations/create deleted file mode 100644 index a567d0aac..000000000 --- a/gcloud/compute/future-reservations/create +++ /dev/null @@ -1,205 +0,0 @@ -NAME - gcloud compute future-reservations create - create a Compute Engine - reservation - -SYNOPSIS - gcloud compute future-reservations create FUTURE_RESERVATION - --[no-]auto-delete-auto-created-reservations --total-count=TOTAL_COUNT - (--source-instance-template=SOURCE_INSTANCE_TEMPLATE - | [--machine-type=MACHINE_TYPE - : --accelerator=[count=COUNT],[type=TYPE] - --local-ssd=[count=COUNT],[interface=INTERFACE],[size=SIZE] - --min-cpu-platform=MIN_CPU_PLATFORM]) - (--start-time=START_TIME (--duration=DURATION | --end-time=END_TIME)) - [--description=DESCRIPTION] [--name-prefix=NAME_PREFIX] - [--planning-status=PLANNING_STATUS] [--zone=ZONE] - [--auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME | --auto-created-reservations-duration=AUTO_CREATED_RESERVATIONS_DURATION] - [--share-setting=SHARE_SETTING --share-with=PROJECT,[PROJECT,...]] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Create a Compute Engine reservation. - -POSITIONAL ARGUMENTS - FUTURE_RESERVATION - Name of the future reservation to create. - -REQUIRED FLAGS - --[no-]auto-delete-auto-created-reservations - If specified, the auto-created reservations for a future reservation - are deleted at the end time (default) or at a specified delete time. - Use --auto-delete-auto-created-reservations to enable and - --no-auto-delete-auto-created-reservations to disable. - - --total-count=TOTAL_COUNT - The total number of instances for which capacity assurance is requested - at a future time period. - - Manage the instance properties for the auto-created reservations. You must - either provide a source instance template or define the instance - properties. - - Exactly one of these must be specified: - - --source-instance-template=SOURCE_INSTANCE_TEMPLATE - The url of the instance template that will be used to populate the - fields of the reservation. Instance properties can not be defined in - addition to source instance template. - - Define individual instance properties for the specific SKU reservation. - - --machine-type=MACHINE_TYPE - The type of machine (name only) that has a fixed number of vCPUs - and a fixed amount of memory. You can also specify a custom machine - type by using the pattern - custom-number_of_CPUs-amount_of_memory-for example, - custom-32-29440. - - This flag argument must be specified if any of the other arguments - in this group are specified. - - --accelerator=[count=COUNT],[type=TYPE] - Manage the configuration of the type and number of accelerator - cards attached. - count - The number of accelerators to attach to each instance in the - reservation. - type - The specific type (e.g. nvidia-tesla-k80 for nVidia Tesla K80) - of accelerator to attach to instances in the reservation. Use - gcloud compute accelerator-types list to learn about all - available accelerator types. - - --local-ssd=[count=COUNT],[interface=INTERFACE],[size=SIZE] - Manage the size and the interface of local SSD to use. See - https://cloud.google.com/compute/docs/disks/local-ssd for more - information. - interface - The kind of disk interface exposed to the VM for this SSD. - Valid values are scsi and nvme. SCSI is the default and is - supported by more guest operating systems. NVME may provide - higher performance. - size - The size of the local SSD in base-2 GB. - count - The number of local SSD to use per VM. Default value is 1. - - --min-cpu-platform=MIN_CPU_PLATFORM - Optional minimum CPU platform of the reservation to create. - - Manage the time specific properties for requesting future capacity - - This must be specified. - - --start-time=START_TIME - Start time of the Future Reservation. The start time must be an - RFC3339 valid string formatted by date, time, and timezone or - "YYYY-MM-DDTHH:MM:SSZ"; where YYYY = year, MM = month, DD = day, HH = - hours, MM = minutes, SS = seconds, and Z = timezone (i.e. - 2021-11-20T07:00:00Z). - - This flag argument must be specified if any of the other arguments in - this group are specified. - - Exactly one of these must be specified: - - --duration=DURATION - Alternate way of specifying time in the number of seconds to - terminate capacity request relative to the start time of a request. - - --end-time=END_TIME - End time of the Future Reservation. The end time must be an RFC3339 - valid string formatted by date, time, and timezone or - "YYYY-MM-DDTHH:MM:SSZ"; where YYYY = year, MM = month, DD = day, HH - = hours, MM = minutes, SS = seconds, and Z = timezone (i.e. - 2021-11-20T07:00:00Z). - -OPTIONAL FLAGS - --description=DESCRIPTION - An optional description of the future reservation to create. - - --name-prefix=NAME_PREFIX - A name prefix for the auto-created reservations when capacity is - delivered at the start time. Each auto-created reservation name starts - with the name prefix. - - --planning-status=PLANNING_STATUS - The planning status of the future reservation. The default value is - DRAFT. While in DRAFT, any changes to the future reservation's - properties will be allowed. If set to SUBMITTED, the future reservation - will submit and its procurementStatus will change to PENDING_APPROVAL. - Once the future reservation is pending approval, changes to the future - reservation's properties will not be allowed. PLANNING_STATUS must be - one of: - - DRAFT - Default planning status value. - SUBMITTED - Planning status value to immediately submit the future reservation. - - --zone=ZONE - Zone of the future reservation to create. 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. - - Manage the auto-delete time properties. - - At most one of these can be specified: - - --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME - Automatically deletes an auto-created reservations at a specific - time. The specified time must be an RFC3339 timestamp, which must be - formatted as "YYYY-MM-DDTHH:MM:SSZ" where YYYY = year, MM = month, DD - = day, HH = hours, MM = minutes, SS = seconds, and Z = time zone in - Coordinated Universal Time (UTC). For example, specify - 2021-11-20T07:00:00Z. - - --auto-created-reservations-duration=AUTO_CREATED_RESERVATIONS_DURATION - Automatically deletes an auto-created reservations after a specified - number of days, hours, minutes, or seconds. For example, specify 30m - for 30 minutes, or 1d2h3m4s for 1 day, 2 hours, 3 minutes, and 4 - seconds. For more information, see $ gcloud topic datetimes. - - Manage the properties of a shared reservation. - - --share-setting=SHARE_SETTING - Specify if this future reservation is shared, and if so, the type of - sharing. If you omit this flag, this value is local by default. - SHARE_SETTING must be one of: local, projects. - - --share-with=PROJECT,[PROJECT,...] - If this future reservation is shared, provide a comma-separated list - of projects that this future reservation is shared with. The list - must contain project IDs or project 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 - These variants are also available: - - $ gcloud alpha compute future-reservations create - - $ gcloud beta compute future-reservations create - diff --git a/gcloud/compute/future-reservations/delete b/gcloud/compute/future-reservations/delete deleted file mode 100644 index 83bd407a0..000000000 --- a/gcloud/compute/future-reservations/delete +++ /dev/null @@ -1,74 +0,0 @@ -NAME - gcloud compute future-reservations delete - delete a Compute Engine future - reservation - -SYNOPSIS - gcloud compute future-reservations delete - (FUTURE_RESERVATION : --zone=ZONE) [--async] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Delete a Compute Engine future reservation. - -EXAMPLES - To delete a given Compute Engine future reservation, run: - - $ gcloud compute future-reservations delete my-reservation \ - --zone=ZONE - -POSITIONAL ARGUMENTS - Future reservation resource - The name of the future reservation 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 future_reservation 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. - - FUTURE_RESERVATION - ID of the future reservation or fully qualified identifier for the - future reservation. - - To set the future_reservation attribute: - ▸ provide the argument future_reservation on the command line. - - This positional argument must be specified if any of the other - arguments in this group are specified. - - --zone=ZONE - The name of the Google Compute Engine zone. - - To set the zone attribute: - ▸ provide the argument future_reservation on the command line with - a fully specified name; - ▸ provide the argument --zone on the command line; - ▸ set the property compute/zone. - -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 compute/v1 API. The full documentation for this API - can be found at: https://cloud.google.com/compute/ - -NOTES - These variants are also available: - - $ gcloud alpha compute future-reservations delete - - $ gcloud beta compute future-reservations delete - diff --git a/gcloud/compute/future-reservations/describe b/gcloud/compute/future-reservations/describe deleted file mode 100644 index 5a9903eee..000000000 --- a/gcloud/compute/future-reservations/describe +++ /dev/null @@ -1,69 +0,0 @@ -NAME - gcloud compute future-reservations describe - show details about a Compute - Engine future reservation - -SYNOPSIS - gcloud compute future-reservations describe - (FUTURE_RESERVATION : --zone=ZONE) [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Show details about a Compute Engine future reservation. - -EXAMPLES - To describe a given Compute Engine future reservation, run: - - $ gcloud compute future-reservations describe my-reservation \ - --zone=ZONE - -POSITIONAL ARGUMENTS - Future reservation resource - The name of the future reservation 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 future_reservation 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. - - FUTURE_RESERVATION - ID of the future reservation or fully qualified identifier for the - future reservation. - - To set the future_reservation attribute: - ▸ provide the argument future_reservation on the command line. - - This positional argument must be specified if any of the other - arguments in this group are specified. - - --zone=ZONE - The name of the Google Compute Engine zone. - - To set the zone attribute: - ▸ provide the argument future_reservation on the command line with - a fully specified name; - ▸ provide the argument --zone on the command line; - ▸ set the property 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. - -API REFERENCE - This command uses the compute/v1 API. The full documentation for this API - can be found at: https://cloud.google.com/compute/ - -NOTES - These variants are also available: - - $ gcloud alpha compute future-reservations describe - - $ gcloud beta compute future-reservations describe - diff --git a/gcloud/compute/future-reservations/help b/gcloud/compute/future-reservations/help deleted file mode 100644 index 00539551b..000000000 --- a/gcloud/compute/future-reservations/help +++ /dev/null @@ -1,43 +0,0 @@ -NAME - gcloud compute future-reservations - manage Compute Engine future - reservations - -SYNOPSIS - gcloud compute future-reservations COMMAND [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Manage Compute Engine future reservations. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -COMMANDS - COMMAND is one of the following: - - cancel - Cancel a Compute Engine future reservation. - - create - Create a Compute Engine reservation. - - delete - Delete a Compute Engine future reservation. - - describe - Show details about a Compute Engine future reservation. - - list - List Compute Engine future reservations. - - update - Update Compute Engine future reservations. - -NOTES - These variants are also available: - - $ gcloud alpha compute future-reservations - - $ gcloud beta compute future-reservations - diff --git a/gcloud/compute/future-reservations/update b/gcloud/compute/future-reservations/update deleted file mode 100644 index c6749dbb6..000000000 --- a/gcloud/compute/future-reservations/update +++ /dev/null @@ -1,222 +0,0 @@ -NAME - gcloud compute future-reservations update - update Compute Engine future - reservations - -SYNOPSIS - gcloud compute future-reservations update FUTURE_RESERVATION - [--[no-]auto-delete-auto-created-reservations] - [--description=DESCRIPTION] [--planning-status=PLANNING_STATUS] - [--total-count=TOTAL_COUNT] [--zone=ZONE] - [--auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME | --auto-created-reservations-duration=AUTO_CREATED_RESERVATIONS_DURATION] - [--clear-name-prefix | --name-prefix=NAME_PREFIX] - [--clear-share-settings - | --share-setting=SHARE_SETTING --share-with=PROJECT,[PROJECT,...]] - [--machine-type=MACHINE_TYPE --min-cpu-platform=MIN_CPU_PLATFORM - --accelerator=[count=COUNT],[type=TYPE] - | --clear-accelerator --clear-local-ssd - | --local-ssd=[count=COUNT],[interface=INTERFACE],[size=SIZE]] - [--start-time=START_TIME --duration=DURATION | --end-time=END_TIME] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - Update Compute Engine future reservations. - -EXAMPLES - To update total count, start and end time of a Compute Engine future - reservation in us-central1-a, run: - - $ gcloud compute future-reservations update my-future-reservation \ - --total-count=1000 --start-time=2021-11-10T07:00:00Z \ - --end-time=2021-12-10T07:00:00Z --zone=us-central1-a - -POSITIONAL ARGUMENTS - FUTURE_RESERVATION - Name of the future reservation to update. - -FLAGS - --[no-]auto-delete-auto-created-reservations - If specified, the auto-created reservations for a future reservation - are deleted at the end time (default) or at a specified delete time. - Use --auto-delete-auto-created-reservations to enable and - --no-auto-delete-auto-created-reservations to disable. - - --description=DESCRIPTION - An optional description of the future reservation to create. - - --planning-status=PLANNING_STATUS - The planning status of the future reservation. The default value is - DRAFT. While in DRAFT, any changes to the future reservation's - properties will be allowed. If set to SUBMITTED, the future reservation - will submit and its procurementStatus will change to PENDING_APPROVAL. - Once the future reservation is pending approval, changes to the future - reservation's properties will not be allowed. PLANNING_STATUS must be - one of: - - DRAFT - Default planning status value. - SUBMITTED - Planning status value to immediately submit the future reservation. - - --total-count=TOTAL_COUNT - The total number of instances for which capacity assurance is requested - at a future time period. - - --zone=ZONE - Zone of the future reservation to update. 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. - - Manage the auto-delete time properties. - - At most one of these can be specified: - - --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME - Automatically deletes an auto-created reservations at a specific - time. The specified time must be an RFC3339 timestamp, which must be - formatted as "YYYY-MM-DDTHH:MM:SSZ" where YYYY = year, MM = month, DD - = day, HH = hours, MM = minutes, SS = seconds, and Z = time zone in - Coordinated Universal Time (UTC). For example, specify - 2021-11-20T07:00:00Z. - - --auto-created-reservations-duration=AUTO_CREATED_RESERVATIONS_DURATION - Automatically deletes an auto-created reservations after a specified - number of days, hours, minutes, or seconds. For example, specify 30m - for 30 minutes, or 1d2h3m4s for 1 day, 2 hours, 3 minutes, and 4 - seconds. For more information, see $ gcloud topic datetimes. - - Manage the name-prefix of a future reservation. - - At most one of these can be specified: - - --clear-name-prefix - Clears the name prefix for the system generated reservations. - - --name-prefix=NAME_PREFIX - A name prefix for the auto-created reservations when capacity is - delivered at the start time. Each auto-created reservation name - starts with the name prefix. - - Manage the properties of a shared future reservation. - - At most one of these can be specified: - - --clear-share-settings - Clear share settings on future reservation. This will result in - non-shared future reservation. - - Manage the share settings of a future reservation. - - --share-setting=SHARE_SETTING - Specify if this future reservation is shared, and if so, the type - of sharing. If you omit this flag, this value is local by default. - SHARE_SETTING must be one of: local, projects. - - --share-with=PROJECT,[PROJECT,...] - If this future reservation is shared, provide a comma-separated - list of projects that this future reservation is shared with. The - list must contain project IDs or project numbers. - - Manage the specific SKU reservation properties. - - --machine-type=MACHINE_TYPE - The type of machine (name only) that has a fixed number of vCPUs and - a fixed amount of memory. You can also specify a custom machine type - by using the pattern custom-number_of_CPUs-amount_of_memory-for - example, custom-32-29440. - - --min-cpu-platform=MIN_CPU_PLATFORM - Optional minimum CPU platform of the reservation to create. - - Manage the accelerators of a future reservation. - - At most one of these can be specified: - - --accelerator=[count=COUNT],[type=TYPE] - Manage the configuration of the type and number of accelerator - cards attached. - count - The number of accelerators to attach to each instance in the - reservation. - type - The specific type (e.g. nvidia-tesla-k80 for nVidia Tesla K80) - of accelerator to attach to instances in the reservation. Use - gcloud compute accelerator-types list to learn about all - available accelerator types. - - --clear-accelerator - Remove all accelerators from the future reservation. - - Manage the local ssd of a future reservation. - - At most one of these can be specified: - - --clear-local-ssd - Remove all local ssd information on the future reservation. - - --local-ssd=[count=COUNT],[interface=INTERFACE],[size=SIZE] - Manage the size and the interface of local SSD to use. See - https://cloud.google.com/compute/docs/disks/local-ssd for more - information. - interface - The kind of disk interface exposed to the VM for this SSD. - Valid values are scsi and nvme. SCSI is the default and is - supported by more guest operating systems. NVME may provide - higher performance. - size - The size of the local SSD in base-2 GB. - count - The number of local SSD to use per VM. Default value is 1. - - Manage the time specific properties for requesting future capacity - - --start-time=START_TIME - Start time of the Future Reservation. The start time must be an - RFC3339 valid string formatted by date, time, and timezone or - "YYYY-MM-DDTHH:MM:SSZ"; where YYYY = year, MM = month, DD = day, HH = - hours, MM = minutes, SS = seconds, and Z = timezone (i.e. - 2021-11-20T07:00:00Z). - - At most one of these can be specified: - - --duration=DURATION - Alternate way of specifying time in the number of seconds to - terminate capacity request relative to the start time of a request. - - --end-time=END_TIME - End time of the Future Reservation. The end time must be an RFC3339 - valid string formatted by date, time, and timezone or - "YYYY-MM-DDTHH:MM:SSZ"; where YYYY = year, MM = month, DD = day, HH - = hours, MM = minutes, SS = seconds, and Z = timezone (i.e. - 2021-11-20T07:00:00Z). - -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 future-reservations update - - $ gcloud beta compute future-reservations update - diff --git a/gcloud/compute/help b/gcloud/compute/help index 9366f4c47..9c88a608d 100644 --- a/gcloud/compute/help +++ b/gcloud/compute/help @@ -60,9 +60,6 @@ GROUPS forwarding-rules Read and manipulate traffic forwarding rules to network load balancers. - future-reservations - Manage Compute Engine future reservations. - health-checks Read and manipulate health checks for load balanced instances. diff --git a/gcloud/compute/images/create b/gcloud/compute/images/create index 9325f5db3..60f5cb410 100644 --- a/gcloud/compute/images/create +++ b/gcloud/compute/images/create @@ -145,7 +145,8 @@ OPTIONAL FLAGS https://cloud.google.com/compute/docs/images/create-delete-deprecate-private-images#guest-os-features. GUEST_OS_FEATURE must be one of: GVNIC, IDPF, MULTI_IP_SUBNET, SEV_CAPABLE, SEV_LIVE_MIGRATABLE, SEV_LIVE_MIGRATABLE_V2, - SEV_SNP_CAPABLE, UEFI_COMPATIBLE, VIRTIO_SCSI_MULTIQUEUE, WINDOWS. + SEV_SNP_CAPABLE, TDX_CAPABLE, UEFI_COMPATIBLE, VIRTIO_SCSI_MULTIQUEUE, + WINDOWS. --key-exchange-key-file=[KEK_VALUE,...] Comma-separated list of file paths that point to X.509 certificates in diff --git a/gcloud/compute/images/list b/gcloud/compute/images/list index 8448a4672..754b662b7 100644 --- a/gcloud/compute/images/list +++ b/gcloud/compute/images/list @@ -52,10 +52,10 @@ FLAGS --standard-images List images from public image projects. The public image projects that are available include the following: cos-cloud, debian-cloud, - rocky-linux-cloud, centos-cloud, fedora-coreos-cloud, opensuse-cloud, - rhel-cloud, rhel-sap-cloud, suse-cloud, suse-sap-cloud, - ubuntu-os-cloud, ubuntu-os-pro-cloud, windows-cloud, windows-sql-cloud. - Enabled by default, use --no-standard-images to disable. + rocky-linux-cloud, ubuntu-os-cloud, centos-cloud, fedora-coreos-cloud, + opensuse-cloud, rhel-cloud, rhel-sap-cloud, suse-cloud, suse-sap-cloud, + ubuntu-os-pro-cloud, windows-cloud, windows-sql-cloud. Enabled by + default, use --no-standard-images to disable. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/compute/instance-templates/create b/gcloud/compute/instance-templates/create index 0fbda04cc..aed02148f 100644 --- a/gcloud/compute/instance-templates/create +++ b/gcloud/compute/instance-templates/create @@ -47,7 +47,7 @@ SYNOPSIS [--source-instance-zone=SOURCE_INSTANCE_ZONE] [--stack-type=STACK_TYPE] [--subnet=SUBNET] [--tags=TAG,[TAG,...]] [--termination-time=TERMINATION_TIME] - [--threads-per-core=THREADS_PER_CORE] + [--threads-per-core=THREADS_PER_CORE] [--turbo-mode=TURBO_MODE] [--visible-core-count=VISIBLE_CORE_COUNT] [--address=ADDRESS | --no-address] [--boot-disk-kms-key=BOOT_DISK_KMS_KEY @@ -883,6 +883,14 @@ FLAGS For more information about configuring SMT, see: https://cloud.google.com/compute/docs/instances/configuring-simultaneous-multithreading. + --turbo-mode=TURBO_MODE + Turbo mode to use for the instance. Supported modes include: + ◆ ALL_CORE_MAX + + To achieve all-core-turbo frequency for more consistent CPU + performance, set the field to ALL_CORE_MAX. The field is unset by + default, which results in maximum performance single-core boosting. + --visible-core-count=VISIBLE_CORE_COUNT The number of physical cores to expose to the instance's guest operating system. The number of virtual CPUs visible to the instance's diff --git a/gcloud/compute/instances/attach-disk b/gcloud/compute/instances/attach-disk index 98ddab3e1..83a25f120 100644 --- a/gcloud/compute/instances/attach-disk +++ b/gcloud/compute/instances/attach-disk @@ -22,6 +22,8 @@ DESCRIPTION mount (https://cloud.google.com/compute/docs/disks/add-persistent-disk#formatting) the disk so that the operating system can use the available storage space. + You can attach an existing non-boot disk to more than one instance. For + more information, see Share a disk between VMs. EXAMPLES To attach a disk named 'my-disk' as a boot disk to an instance named @@ -97,10 +99,7 @@ OPTIONAL FLAGS ro Read-only. rw - Read-write. It is an error to attach a disk in read-write mode to - more than one instance. For details on how to share persistent - disks between multiple instances, refer to - https://cloud.google.com/compute/docs/disks/add-persistent-disk#use_multi_instances + Read-write. --zone=ZONE Zone of the instance to operate on. If not specified, you might be diff --git a/gcloud/compute/instances/bulk/create b/gcloud/compute/instances/bulk/create index fd1777ee2..a6b444a58 100644 --- a/gcloud/compute/instances/bulk/create +++ b/gcloud/compute/instances/bulk/create @@ -45,7 +45,7 @@ SYNOPSIS [--stack-type=STACK_TYPE] [--subnet=SUBNET] [--tags=TAG,[TAG,...]] [--target-distribution-shape=SHAPE] [--termination-time=TERMINATION_TIME] - [--threads-per-core=THREADS_PER_CORE] + [--threads-per-core=THREADS_PER_CORE] [--turbo-mode=TURBO_MODE] [--visible-core-count=VISIBLE_CORE_COUNT] [--boot-disk-kms-key=BOOT_DISK_KMS_KEY : --boot-disk-kms-keyring=BOOT_DISK_KMS_KEYRING @@ -822,6 +822,14 @@ OPTIONAL FLAGS For more information about configuring SMT, see: https://cloud.google.com/compute/docs/instances/configuring-simultaneous-multithreading. + --turbo-mode=TURBO_MODE + Turbo mode to use for the instance. Supported modes include: + ◆ ALL_CORE_MAX + + To achieve all-core-turbo frequency for more consistent CPU + performance, set the field to ALL_CORE_MAX. The field is unset by + default, which results in maximum performance single-core boosting. + --visible-core-count=VISIBLE_CORE_COUNT The number of physical cores to expose to the instance's guest operating system. The number of virtual CPUs visible to the instance's diff --git a/gcloud/compute/instances/create b/gcloud/compute/instances/create index 72739c9ad..161743c10 100644 --- a/gcloud/compute/instances/create +++ b/gcloud/compute/instances/create @@ -55,7 +55,7 @@ SYNOPSIS [--source-machine-image-csek-key-file=FILE] [--stack-type=STACK_TYPE] [--subnet=SUBNET] [--tags=TAG,[TAG,...]] [--termination-time=TERMINATION_TIME] - [--threads-per-core=THREADS_PER_CORE] + [--threads-per-core=THREADS_PER_CORE] [--turbo-mode=TURBO_MODE] [--visible-core-count=VISIBLE_CORE_COUNT] [--zone=ZONE] [--address=ADDRESS | --no-address] [--boot-disk-kms-key=BOOT_DISK_KMS_KEY @@ -979,6 +979,14 @@ FLAGS For more information about configuring SMT, see: https://cloud.google.com/compute/docs/instances/configuring-simultaneous-multithreading. + --turbo-mode=TURBO_MODE + Turbo mode to use for the instance. Supported modes include: + ◆ ALL_CORE_MAX + + To achieve all-core-turbo frequency for more consistent CPU + performance, set the field to ALL_CORE_MAX. The field is unset by + default, which results in maximum performance single-core boosting. + --visible-core-count=VISIBLE_CORE_COUNT The number of physical cores to expose to the instance's guest operating system. The number of virtual CPUs visible to the instance's diff --git a/gcloud/container/attached/clusters/register b/gcloud/container/attached/clusters/register index 496afc549..fa3972995 100644 --- a/gcloud/container/attached/clusters/register +++ b/gcloud/container/attached/clusters/register @@ -11,8 +11,8 @@ SYNOPSIS [--annotations=ANNOTATION,[ANNOTATION,...]] [--binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE] [--description=DESCRIPTION] [--enable-managed-prometheus] - [--logging=COMPONENT,[COMPONENT,...]] - [--security-posture=SECURITY_POSTURE] [--validate-only] + [--logging=COMPONENT,[COMPONENT,...]] [--validate-only] + [--workload-vulnerability-scanning=WORKLOAD_VULNERABILITY_SCANNING] [--proxy-secret-name=PROXY_SECRET_NAME --proxy-secret-namespace=PROXY_SECRET_NAMESPACE] [GCLOUD_WIDE_FLAG ...] @@ -177,21 +177,20 @@ OPTIONAL FLAGS COMPONENT must be one of: NONE, SYSTEM, WORKLOAD. - --security-posture=SECURITY_POSTURE - Sets the mode of the Kubernetes security posture API's off-cluster - features. - - To enable advanced mode explicitly set the flag to - --security-posture=enterprise. - - To disable in an existing cluster, explicitly set the flag to - --security-posture=disabled. - - SECURITY_POSTURE must be one of: disabled, enterprise. - --validate-only Validate the cluster to create, but don't actually perform it. + --workload-vulnerability-scanning=WORKLOAD_VULNERABILITY_SCANNING + Sets the mode of the Kubernetes security posture API's workload + vulnerability scanning. To enable Advanced vulnerability insights mode + explicitly set the flag to + --workload-vulnerability-scanning=enterprise. + + To disable in an existing cluster, explicitly set the flag to + --workload-vulnerability-scanning=disabled. + + WORKLOAD_VULNERABILITY_SCANNING must be one of: disabled, enterprise. + Proxy config --proxy-secret-name=PROXY_SECRET_NAME diff --git a/gcloud/container/attached/clusters/update b/gcloud/container/attached/clusters/update index 09e81a455..ead04313d 100644 --- a/gcloud/container/attached/clusters/update +++ b/gcloud/container/attached/clusters/update @@ -7,8 +7,8 @@ SYNOPSIS [--binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE] [--clear-description] [--description=DESCRIPTION] [--logging=COMPONENT,[COMPONENT,...]] - [--platform-version=PLATFORM_VERSION] - [--security-posture=SECURITY_POSTURE] [--validate-only] + [--platform-version=PLATFORM_VERSION] [--validate-only] + [--workload-vulnerability-scanning=WORKLOAD_VULNERABILITY_SCANNING] [--admin-groups=[GROUP,...] | --clear-admin-groups] [--admin-users=[USER,...] | --clear-admin-users] [--disable-managed-prometheus | --enable-managed-prometheus] @@ -96,21 +96,20 @@ FLAGS Replace LOCATION with the target Google Cloud location for the cluster. - --security-posture=SECURITY_POSTURE - Sets the mode of the Kubernetes security posture API's off-cluster - features. - - To enable advanced mode explicitly set the flag to - --security-posture=enterprise. - - To disable in an existing cluster, explicitly set the flag to - --security-posture=disabled. - - SECURITY_POSTURE must be one of: disabled, enterprise. - --validate-only Validate the update of the cluster, but don't actually perform it. + --workload-vulnerability-scanning=WORKLOAD_VULNERABILITY_SCANNING + Sets the mode of the Kubernetes security posture API's workload + vulnerability scanning. To enable Advanced vulnerability insights mode + explicitly set the flag to + --workload-vulnerability-scanning=enterprise. + + To disable in an existing cluster, explicitly set the flag to + --workload-vulnerability-scanning=disabled. + + WORKLOAD_VULNERABILITY_SCANNING must be one of: disabled, enterprise. + Admin groups At most one of these can be specified: diff --git a/gcloud/database-migration/migration-jobs/promote b/gcloud/database-migration/migration-jobs/promote index c3cc49132..2280e0f57 100644 --- a/gcloud/database-migration/migration-jobs/promote +++ b/gcloud/database-migration/migration-jobs/promote @@ -13,13 +13,13 @@ EXAMPLES To promote a migration job: $ gcloud database-migration migration-jobs promote MIGRATION_JOB \ - --region=us-central1 + --region=us-central1 POSITIONAL ARGUMENTS - Migration job resource - Migration job resource - Cloud Database Migration - Service migration job to promote. The arguments in this group can be used - to specify the attributes of this resource. (NOTE) Some attributes are not - given arguments in this group but can be set in other ways. + Migration job resource - The migration job to promote. The arguments in + this group can be used to specify the attributes of this resource. (NOTE) + Some attributes are not given arguments in this group but can be set in + other ways. To set the project attribute: ◆ provide the argument migration_job on the command line with a fully @@ -40,7 +40,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --region=REGION - The name of the region. + The Cloud region for the migration_job. To set the region attribute: ▸ provide the argument migration_job on the command line with a @@ -55,10 +55,6 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. -API REFERENCE - This command uses the datamigration/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/database-migration/ - NOTES This variant is also available: diff --git a/gcloud/looker/instances/update b/gcloud/looker/instances/update index 6dbb8b364..3e7871728 100644 --- a/gcloud/looker/instances/update +++ b/gcloud/looker/instances/update @@ -117,9 +117,10 @@ FLAGS --add-viewer-users=ADD_VIEWER_USERS Number of additional Viewer Users to allocate to the Looker Instance. - Private Service Connect - Private Service Connect allows private - consumption of services across VPC networks that belong to different - groups, teams, projects, or organizations. + Private Service Connect - Private Service Connect allows the Looker + Instance to be reached via a private connection from inside a VPC network, + and for the Looker Instance to connect to managed services via private + connections. At most one of these can be specified: @@ -132,11 +133,11 @@ FLAGS At most one of these can be specified: --clear-psc-service-attachments - Remove all service attachments from the PSC config of the instance. + Remove all allowed VPCs from the PSC config of the instance. --psc-service-attachment=[attachment=ATTACHMENT],[domain=DOMAIN] - The service attachments asigned to the Private Service Connect - (PSC) config. This flag can be repeated. (Example: + Service attachments representing egress connections for the Looker + instance. This flag can be repeated. (Example: --psc-service-attachment domain="mydomain.com",attachment="projects/my-project/regions/us-east1/serviceAttachments/sa" --psc-service-attachments diff --git a/gcloud/migration/help b/gcloud/migration/help new file mode 100644 index 000000000..80496799a --- /dev/null +++ b/gcloud/migration/help @@ -0,0 +1,26 @@ +NAME + gcloud migration - the root group for various Cloud Migration teams + +SYNOPSIS + gcloud migration GROUP [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Each team must have its own sub-group. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + vms + Provides Migrate to Virtual Machines (VM migration) service + functionality. + +NOTES + This variant is also available: + + $ gcloud alpha migration + diff --git a/gcloud/migration/vms/help b/gcloud/migration/vms/help new file mode 100644 index 000000000..aa0193650 --- /dev/null +++ b/gcloud/migration/vms/help @@ -0,0 +1,30 @@ +NAME + gcloud migration vms - provides Migrate to Virtual Machines (VM migration) + service functionality + +SYNOPSIS + gcloud migration vms GROUP [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + The gcloud alpha migration vms command group provides the CLI for the + Migrate to Virtual Machines API. Google Cloud Migrate to Virtual Machines + migrates VMs from on-premises data center and other cloud providers to + Google Compute Engine virtual machine (VM) instances. VM Migration API must + be enabled in your project. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + image-imports + Imports images to Google Compute Engine from Google Cloud Storage. + +NOTES + This variant is also available: + + $ gcloud alpha migration vms + diff --git a/gcloud/migration/vms/image-imports/create b/gcloud/migration/vms/image-imports/create new file mode 100644 index 000000000..7b22cdbe8 --- /dev/null +++ b/gcloud/migration/vms/image-imports/create @@ -0,0 +1,140 @@ +NAME + gcloud migration vms image-imports create - import Virtual Disk images to + Google Compute Engine + +SYNOPSIS + gcloud migration vms image-imports create + (IMAGE_IMPORT_NAME : --location=LOCATION) --source-file=SOURCE_FILE + [--additional-licenses=[ADDITIONAL_LICENSES,...]] + [--description=DESCRIPTION] [--family-name=FAMILY_NAME] + [--image-name=IMAGE_NAME] [--kms-key=KMS_KEY] + [--labels=[KEY=VALUE,...]] [--single-region-storage] + [--target-project=TARGET_PROJECT] + [--skip-os-adaptation | --generalize --license-type=LICENSE_TYPE] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + gcloud migration vms image-imports create imports images such as VMWare + VMDK files and VHD files, from a Google Cloud Storage file (gs://...) to + Google Compute Engine, using the Migrate to Virtual Machines service API. + This command creates an Image Import resource with a nested Image Import + Job resource. The Image Import Job resource tracks the image import + progress. To use this command, you must enable VM Migration API in your + project. + +EXAMPLES + To import my-ubuntu22.04.vmdk from my-images-bucket to my-target-project in + us-central1, create my-image-import resource in my-project in us-central1. + Run: $ gcloud migration vms image-imports create my-image-import \ + --source-file=gs://my-images-bucket/my-ubuntu22.04.vmdk \ + --image-name=my-ubuntu-image --location=us-central1 \ + --target-project=projects/my-project/locations/global/\ + targetProjects/my-target-project --project=my-project + +POSITIONAL ARGUMENTS + Image import resource - The Image Import resource you want to create. This + would be the image name if --image-name is not given. The arguments in + this group can be used to specify the attributes of this resource. (NOTE) + Some attributes are not given arguments in this group but can be set in + other ways. + + To set the project attribute: + ◆ provide the argument image_import_name on the command line with a + fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + IMAGE_IMPORT_NAME + ID of the image_import or fully qualified identifier for the + image_import. + + To set the image_import_name attribute: + ▸ provide the argument image_import_name on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Resource location. + + To set the location attribute: + ▸ provide the argument image_import_name on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property compute/region. + +REQUIRED FLAGS + --source-file=SOURCE_FILE + The path to the Google Cloud Storage file from which the image should + be imported. + +OPTIONAL FLAGS + --additional-licenses=[ADDITIONAL_LICENSES,...] + Comma-separated list of the additional licenses to assign to the image. + + --description=DESCRIPTION + A description of the image. + + --family-name=FAMILY_NAME + The name of the image family to which the new image belongs. + + --image-name=IMAGE_NAME + The name of the image that will be imported to Google Compute Engine. + Default is the Image Import name. + + --kms-key=KMS_KEY + Fully qualified identifier for the Cloud KMS (Key Management Service) + cryptokey that will be used to protect the image. + + --labels=[KEY=VALUE,...] + A map of labels to associate with the image. + + --single-region-storage + If true, the location of the imported image will be the region of the + import job. Otherwise the closest multi-region is selected. Default is + false. + + --target-project=TARGET_PROJECT + The target project resource path to which the image will be imported. + Default is the customer project. To get a list of the target projects + run the gcloud alpha migration vms target-projects list command. + + OS adaptation parameters + + At most one of these can be specified: + + --skip-os-adaptation + If true, skip OS adaptation. Default false. + + --generalize + If true, generalize the imported image. Default false. The + generalization process enables co-existence of multiple VMs created + from the same image. For Windows, generalizing the image removes + computer-specific information such as installed drivers and the + computer security identifier (SID). + + --license-type=LICENSE_TYPE + The license to use post migration. LICENSE_TYPE must be one of: + compute-engine-license-type-byol, + compute-engine-license-type-default, + compute-engine-license-type-payg. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the vmmigration/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/migrate/virtual-machines + +NOTES + This variant is also available: + + $ gcloud alpha migration vms image-imports create + diff --git a/gcloud/migration/vms/image-imports/delete b/gcloud/migration/vms/image-imports/delete new file mode 100644 index 000000000..27db893ff --- /dev/null +++ b/gcloud/migration/vms/image-imports/delete @@ -0,0 +1,68 @@ +NAME + gcloud migration vms image-imports delete - delete an Image Import resource + +SYNOPSIS + gcloud migration vms image-imports delete + (IMAGE_IMPORT_NAME : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + gcloud migration vms image-imports delete deletes an Image Import resource. + To use this command, you must enable VM Migration API in your project. + + This command does not delete any images imported to Google Compute Engine. + +EXAMPLES + To delete my-image-import resource in us-central1 in the default project, + run: $ gcloud migration vms image-imports delete my-image-import \ + --location=us-central1 + +POSITIONAL ARGUMENTS + Image import resource - The Image Import resource you want to delete. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument image_import_name on the command line with a + fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + IMAGE_IMPORT_NAME + ID of the image_import or fully qualified identifier for the + image_import. + + To set the image_import_name attribute: + ▸ provide the argument image_import_name on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Resource location. + + To set the location attribute: + ▸ provide the argument image_import_name on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property compute/region. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the vmmigration/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/migrate/virtual-machines + +NOTES + This variant is also available: + + $ gcloud alpha migration vms image-imports delete + diff --git a/gcloud/migration/vms/image-imports/describe b/gcloud/migration/vms/image-imports/describe new file mode 100644 index 000000000..089bb3b72 --- /dev/null +++ b/gcloud/migration/vms/image-imports/describe @@ -0,0 +1,68 @@ +NAME + gcloud migration vms image-imports describe - describe an Image Import + +SYNOPSIS + gcloud migration vms image-imports describe + (IMAGE_IMPORT_NAME : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + gcloud migration vms image-imports describe describes an Image Import + resource with a nested Image Import Job. The Image Import Job resource + tracks the image import progress. To use this command, you must enable VM + Migration API in your project. + +EXAMPLES + To describe my-image-import resource in us-central1 in the default project, + run: $ gcloud migration vms image-imports describe my-image-import \ + --location=us-central1 + +POSITIONAL ARGUMENTS + Image import resource - The Image Import you want to describe. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument image_import_name on the command line with a + fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + IMAGE_IMPORT_NAME + ID of the image_import or fully qualified identifier for the + image_import. + + To set the image_import_name attribute: + ▸ provide the argument image_import_name on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Resource location. + + To set the location attribute: + ▸ provide the argument image_import_name on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property compute/region. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the vmmigration/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/migrate/virtual-machines + +NOTES + This variant is also available: + + $ gcloud alpha migration vms image-imports describe + diff --git a/gcloud/migration/vms/image-imports/help b/gcloud/migration/vms/image-imports/help new file mode 100644 index 000000000..84bf6ae42 --- /dev/null +++ b/gcloud/migration/vms/image-imports/help @@ -0,0 +1,60 @@ +NAME + gcloud migration vms image-imports - imports images to Google Compute + Engine from Google Cloud Storage + +SYNOPSIS + gcloud migration vms image-imports COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + gcloud alpha migration vms image-imports provides a more robust and better + supported method for importing images to Google Compute Engine. Other + image-related operations (for example, list) can be done using gcloud + compute images, as usual. + + The commands use VM Migartion API which supports importing of an image from + a Google Cloud Storage file (gs://...) to a target project. VM Migration + API must be enabled in your project. + + gcloud alpha migration vms image-imports create creates an Image Import + resource with a nested Image Import Job resource. The Image Import Job + resource tracks the image import progress. After the Image Import Job + completes, successfully or otherwise, there's no further use for the Image + Import resource. + + The image is imported to a Google Cloud Project, desginated by the Target + Project resource. To get a list of Target Projects, run the gcloud alpha + migration vms target-projects list command. Use the Google Cloud console to + add target project resources. For information on adding target projects, + see + https://cloud.google.com/migrate/virtual-machines/docs/5.0/how-to/target-project. + + A project can support a maximum of 1000 Image Import resources per project. + Hence it's recommended to delete an Image Import resource after the Image + Import Job is complete to avoid reaching the Image Import resources limit. + Deletion of Image Import resource does not affect the imported image. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + import Virtual Disk images to Google Compute Engine. + + delete + delete an Image Import resource. + + describe + describe an Image Import. + + list + list Image Imports. + +NOTES + This variant is also available: + + $ gcloud alpha migration vms image-imports + diff --git a/gcloud/compute/future-reservations/list b/gcloud/migration/vms/image-imports/list similarity index 52% rename from gcloud/compute/future-reservations/list rename to gcloud/migration/vms/image-imports/list index b6b5af6a1..90532d098 100644 --- a/gcloud/compute/future-reservations/list +++ b/gcloud/migration/vms/image-imports/list @@ -1,19 +1,41 @@ NAME - gcloud compute future-reservations list - list Compute Engine future - reservations + gcloud migration vms image-imports list - list Image Imports SYNOPSIS - gcloud compute future-reservations list [--filter=EXPRESSION] - [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] - [GCLOUD_WIDE_FLAG ...] + gcloud migration vms image-imports list [--location=LOCATION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - List Compute Engine future reservations. + gcloud migration vms image-imports list prints a detailed list of Image + Import resources. To use this command, you must enable VM Migration API in + your project. EXAMPLES - To list all Compute Engine future reservations, run: + To list the Image Import resources in us-central1 in the default project, + run: $ gcloud migration vms image-imports list --location=us-central1 - $ gcloud compute future-reservations list my-future-reservation +FLAGS + Location resource - The compute/region of the Image Import. To get a list + of the available regions, run gcloud compute regions list command. If not + specified, the value of the [compute/zone] property in the current gcloud + configuration is used. This represents a Cloud resource. (NOTE) Some + attributes are not given arguments in this group but can be set in other + ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ set the property compute/region with a fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line; + ▸ set the property compute/region. LIST COMMAND FLAGS --filter=EXPRESSION @@ -55,10 +77,12 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. +API REFERENCE + This command uses the vmmigration/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/migrate/virtual-machines + NOTES - These variants are also available: + This variant is also available: - $ gcloud alpha compute future-reservations list - - $ gcloud beta compute future-reservations list + $ gcloud alpha migration vms image-imports list diff --git a/gcloud/netapp/storage-pools/create b/gcloud/netapp/storage-pools/create index 1c139edb0..2bc0fa25b 100644 --- a/gcloud/netapp/storage-pools/create +++ b/gcloud/netapp/storage-pools/create @@ -5,7 +5,8 @@ SYNOPSIS gcloud netapp storage-pools create (STORAGE_POOL : --location=LOCATION) --capacity=CAPACITY --network=[name=NAME],[psa-range=PSA-RANGE] --service-level=SERVICE_LEVEL [--active-directory=ACTIVE_DIRECTORY] - [--async] [--description=DESCRIPTION] [--enable-ldap=ENABLE_LDAP] + [--allow-auto-tiering=ALLOW_AUTO_TIERING] [--async] + [--description=DESCRIPTION] [--enable-ldap=ENABLE_LDAP] [--kms-config=KMS_CONFIG] [--labels=[KEY=VALUE,...]] [--replica-zone=REPLICA_ZONE] [--zone=ZONE] [GCLOUD_WIDE_FLAG ...] @@ -133,6 +134,10 @@ OPTIONAL FLAGS To set the active_directory attribute: ▸ provide the argument --active-directory on the command line. + --allow-auto-tiering=ALLOW_AUTO_TIERING + Boolean flag indicating whether Storage Pool is allowed to use + auto-tiering + --async Return immediately, without waiting for the operation in progress to complete. diff --git a/gcloud/netapp/storage-pools/update b/gcloud/netapp/storage-pools/update index fd42a3d2c..fedfa6118 100644 --- a/gcloud/netapp/storage-pools/update +++ b/gcloud/netapp/storage-pools/update @@ -3,10 +3,12 @@ NAME SYNOPSIS gcloud netapp storage-pools update (STORAGE_POOL : --location=LOCATION) - [--active-directory=ACTIVE_DIRECTORY] [--async] [--capacity=CAPACITY] - [--description=DESCRIPTION] [--replica-zone=REPLICA_ZONE] - [--update-labels=[KEY=VALUE,...]] [--zone=ZONE] - [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] + [--active-directory=ACTIVE_DIRECTORY] + [--allow-auto-tiering=ALLOW_AUTO_TIERING] [--async] + [--capacity=CAPACITY] [--description=DESCRIPTION] + [--replica-zone=REPLICA_ZONE] [--update-labels=[KEY=VALUE,...]] + [--zone=ZONE] [--clear-labels | --remove-labels=[KEY,...]] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION Updates a Storage Pool with given arguments @@ -76,6 +78,10 @@ FLAGS To set the active_directory attribute: ▸ provide the argument --active-directory on the command line. + --allow-auto-tiering=ALLOW_AUTO_TIERING + Boolean flag indicating whether Storage Pool is allowed to use + auto-tiering + --async Return immediately, without waiting for the operation in progress to complete. diff --git a/gcloud/netapp/volumes/create b/gcloud/netapp/volumes/create index 0579d0f7e..a9714cad6 100644 --- a/gcloud/netapp/volumes/create +++ b/gcloud/netapp/volumes/create @@ -39,6 +39,7 @@ SYNOPSIS [--snapshot-weekly=[day=DAY], [hour=HOUR],[minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP]] [--source-snapshot=SOURCE_SNAPSHOT] + [--tiering-policy=[tier-action=ENABLED|PAUSED,...]] [--unix-permissions=UNIX_PERMISSIONS] [--source-backup=SOURCE_BACKUP : --backup_vault=BACKUP_VAULT] [GCLOUD_WIDE_FLAG ...] @@ -278,6 +279,18 @@ OPTIONAL FLAGS To set the snapshot attribute: ▸ provide the argument --source-snapshot on the command line. + --tiering-policy=[tier-action=ENABLED|PAUSED,...] + Tiering Policy contains auto tiering policy on a volume. + + Tiering Policy will have the following format + --tiering-policy=tier-action=TIER_ACTION, + cooling-threshold-days=COOLING_THRESHOLD_DAYS + + tier-action is an enum, supported values are ENABLED or PAUSED, + cooling-threshold-days is an integer represents time in days to mark + the volume's data block as cold and make it eligible for tiering, can + be range from 7-183. Default is 31. + --unix-permissions=UNIX_PERMISSIONS Unix permissions the mount point will be created with. Unix permissions are only applicable with NFS protocol only diff --git a/gcloud/netapp/volumes/update b/gcloud/netapp/volumes/update index 4a4ca30f8..1a4891c8c 100644 --- a/gcloud/netapp/volumes/update +++ b/gcloud/netapp/volumes/update @@ -32,6 +32,7 @@ SYNOPSIS [--snapshot-weekly=[day=DAY], [hour=HOUR],[minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP]] [--source-snapshot=SOURCE_SNAPSHOT] [--storage-pool=STORAGE_POOL] + [--tiering-policy=[tier-action=ENABLED|PAUSED,...]] [--unix-permissions=UNIX_PERMISSIONS] [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] [--source-backup=SOURCE_BACKUP : --backup_vault=BACKUP_VAULT] @@ -220,6 +221,18 @@ FLAGS To set the storage_pool attribute: ▸ provide the argument --storage-pool on the command line. + --tiering-policy=[tier-action=ENABLED|PAUSED,...] + Tiering Policy contains auto tiering policy on a volume. + + Tiering Policy will have the following format + --tiering-policy=tier-action=TIER_ACTION, + cooling-threshold-days=COOLING_THRESHOLD_DAYS + + tier-action is an enum, supported values are ENABLED or PAUSED, + cooling-threshold-days is an integer represents time in days to mark + the volume's data block as cold and make it eligible for tiering, can + be range from 7-183. Default is 31. + --unix-permissions=UNIX_PERMISSIONS Unix permissions the mount point will be created with. Unix permissions are only applicable with NFS protocol only diff --git a/gcloud/network-security/security-profile-groups/create b/gcloud/network-security/security-profile-groups/create index 278bb067d..8d2c3f4e3 100644 --- a/gcloud/network-security/security-profile-groups/create +++ b/gcloud/network-security/security-profile-groups/create @@ -5,11 +5,10 @@ NAME SYNOPSIS gcloud network-security security-profile-groups create (SECURITY_PROFILE_GROUP - : --location=LOCATION --organization=ORGANIZATION) - (--threat-prevention-profile=THREAT_PREVENTION_PROFILE - : --security-profile-location=SECURITY_PROFILE_LOCATION - --security-profile-organization=SECURITY_PROFILE_ORGANIZATION) - [--async] [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] + : --location=LOCATION --organization=ORGANIZATION) [--async] + [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] + [--threat-prevention-profile=THREAT_PREVENTION_PROFILE + : --threat-prevention-profile-location=THREAT_PREVENTION_PROFILE_LOCATION --threat-prevention-profile-organization=THREAT_PREVENTION_PROFILE_ORGANIZATION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -60,52 +59,7 @@ POSITIONAL ARGUMENTS with a fully specified name; ▸ provide the argument --organization on the command line. -REQUIRED FLAGS - Security Profile resource - Path to Security Profile resource. The - arguments in this group can be used to specify the attributes of this - resource. - - This must be specified. - - --threat-prevention-profile=THREAT_PREVENTION_PROFILE - ID of the Security Profile or fully qualified identifier for the - Security Profile. - - To set the security_profile attribute: - ▸ provide the argument --threat-prevention-profile on the command - line. - - This flag argument must be specified if any of the other arguments in - this group are specified. - - --security-profile-location=SECURITY_PROFILE_LOCATION - Location of the Security Profile. NOTE: Only global security profiles - are supported. - - To set the security-profile-location attribute: - ▸ provide the argument --threat-prevention-profile on the command - line with a fully specified name; - ▸ provide the argument --security-profile-location on the command - line; - ▸ provide the argument --location on the command line; - ▸ provide the argument - networksecurity.organizations.locations.securityProfileGroups on - the command line with a fully specified name. - - --security-profile-organization=SECURITY_PROFILE_ORGANIZATION - Organization ID of the Security Profile. - - To set the security-profile-organization attribute: - ▸ provide the argument --threat-prevention-profile on the command - line with a fully specified name; - ▸ provide the argument --security-profile-organization on the - command line; - ▸ provide the argument --organization on the command line; - ▸ provide the argument - networksecurity.organizations.locations.securityProfileGroups on - the command line with a fully specified name. - -OPTIONAL FLAGS +FLAGS --async Return immediately, without waiting for the operation in progress to complete. The default is False. @@ -121,6 +75,52 @@ OPTIONAL FLAGS contain only hyphens (-), underscores (_), lowercase characters, and numbers. + Security Profile resource - Path to Security Profile resource. The + arguments in this group can be used to specify the attributes of this + resource. + + --threat-prevention-profile=THREAT_PREVENTION_PROFILE + ID of the Security Profile or fully qualified identifier for the + Security Profile. + + To set the threat-prevention-profile-profile attribute: + ▸ provide the argument --threat-prevention-profile on the command + line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --threat-prevention-profile-location=THREAT_PREVENTION_PROFILE_LOCATION + Location of the Security Profile. NOTE: Only global security profiles + are supported. + + To set the threat-prevention-profile-location attribute: + ▸ provide the argument --threat-prevention-profile on the command + line with a fully specified name; + ▸ provide the argument --threat-prevention-profile-location on the + command line; + ▸ provide the argument --security-profile-location on the command + line; + ▸ provide the argument --location on the command line; + ▸ provide the argument + networksecurity.organizations.locations.securityProfileGroups on + the command line with a fully specified name. + + --threat-prevention-profile-organization=THREAT_PREVENTION_PROFILE_ORGANIZATION + Organization ID of the Security Profile. + + To set the threat-prevention-profile-organization attribute: + ▸ provide the argument --threat-prevention-profile on the command + line with a fully specified name; + ▸ provide the argument --threat-prevention-profile-organization on + the command line; + ▸ provide the argument --security-profile-organization on the + command line; + ▸ provide the argument --organization on the command line; + ▸ provide the argument + networksecurity.organizations.locations.securityProfileGroups on + the command line with a fully specified name. + 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/network-security/security-profile-groups/update b/gcloud/network-security/security-profile-groups/update index 44d5b7a9e..4aad4ae37 100644 --- a/gcloud/network-security/security-profile-groups/update +++ b/gcloud/network-security/security-profile-groups/update @@ -9,8 +9,7 @@ SYNOPSIS [--description=DESCRIPTION] [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] [--threat-prevention-profile=THREAT_PREVENTION_PROFILE - : --security-profile-location=SECURITY_PROFILE_LOCATION - --security-profile-organization=SECURITY_PROFILE_ORGANIZATION] + : --threat-prevention-profile-location=THREAT_PREVENTION_PROFILE_LOCATION --threat-prevention-profile-organization=THREAT_PREVENTION_PROFILE_ORGANIZATION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -106,20 +105,22 @@ FLAGS ID of the Security Profile or fully qualified identifier for the Security Profile. - To set the security_profile attribute: + To set the threat-prevention-profile-profile attribute: ▸ provide the argument --threat-prevention-profile on the command line. This flag argument must be specified if any of the other arguments in this group are specified. - --security-profile-location=SECURITY_PROFILE_LOCATION + --threat-prevention-profile-location=THREAT_PREVENTION_PROFILE_LOCATION Location of the Security Profile. NOTE: Only global security profiles are supported. - To set the security-profile-location attribute: + To set the threat-prevention-profile-location attribute: ▸ provide the argument --threat-prevention-profile on the command line with a fully specified name; + ▸ provide the argument --threat-prevention-profile-location on the + command line; ▸ provide the argument --security-profile-location on the command line; ▸ provide the argument --location on the command line; @@ -127,12 +128,14 @@ FLAGS networksecurity.organizations.locations.securityProfileGroups on the command line with a fully specified name. - --security-profile-organization=SECURITY_PROFILE_ORGANIZATION + --threat-prevention-profile-organization=THREAT_PREVENTION_PROFILE_ORGANIZATION Organization ID of the Security Profile. - To set the security-profile-organization attribute: + To set the threat-prevention-profile-organization attribute: ▸ provide the argument --threat-prevention-profile on the command line with a fully specified name; + ▸ provide the argument --threat-prevention-profile-organization on + the command line; ▸ provide the argument --security-profile-organization on the command line; ▸ provide the argument --organization on the command line; diff --git a/gcloud/recaptcha/keys/create b/gcloud/recaptcha/keys/create index b588d82ba..305355f42 100644 --- a/gcloud/recaptcha/keys/create +++ b/gcloud/recaptcha/keys/create @@ -3,7 +3,7 @@ NAME SYNOPSIS gcloud recaptcha keys create --display-name=DISPLAY_NAME - ([--android (--allow-all-package-names + (--express | [--android (--allow-all-package-names | --package-names=[PACKAGE_NAMES,...]) : --support-non-google-app-store-distribution] | [--ios (--allow-all-bundle-ids | --bundle-ids=[BUNDLE_IDS,...]) @@ -13,7 +13,7 @@ SYNOPSIS --security-preference=SECURITY_PREFERENCE --testing-challenge=TESTING_CHALLENGE]) [--labels=[KEY=VALUE,...]] [--testing-score=TESTING_SCORE] - [--waf-feature=WAF_FEATURE : --waf-service=WAF_SERVICE] + [--waf-service=WAF_SERVICE : --waf-feature=WAF_FEATURE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -32,6 +32,11 @@ REQUIRED FLAGS Exactly one of these must be specified: + Options for the creation of a site key for Express. + + --express + Creates a Key configured for Express assessments. + Options for the creation of a site key for Android. --android @@ -130,6 +135,11 @@ REQUIRED FLAGS score Shows no CAPTCHA challenge on the page + score-and-challenge + Conditionally displays a challenge based on the score. This is + in private preview. If you want to onboard, contact your Google + Cloud sales representative. + --security-preference=SECURITY_PREFERENCE Represents the possible challenge frequency and difficulty configurations for a web key. usability: show fewer and easier @@ -181,27 +191,6 @@ OPTIONAL FLAGS please refer to https://cloud.google.com/recaptcha-enterprise/docs/integration-overview. - --waf-feature=WAF_FEATURE - The WAF feature to use. For more information, see - https://cloud.google.com/recaptcha-enterprise/docs/usecase#comparison_of_features. - WAF_FEATURE must be one of: - - action-token - Use reCAPTCHA action-tokens to protect user actions. - - challenge-page - Redirects suspicious traffic to reCAPTCHA challenge page. - - express - Assesses requests without tokens or frontend integration. - - session-token - Use reCAPTCHA session-tokens to protect the whole user session on - the site's domain. - - This flag argument must be specified if any of the other arguments in - this group are specified. - --waf-service=WAF_SERVICE The WAF service provider to use. WAF_SERVICE must be one of: @@ -217,8 +206,27 @@ OPTIONAL FLAGS fastly Fastly - unspecified - No specified WAF service + This flag argument must be specified if any of the other arguments in + this group are specified. + + --waf-feature=WAF_FEATURE + The WAF feature to use. For more information, see + https://cloud.google.com/recaptcha-enterprise/docs/usecase#comparison_of_features. + WAF_FEATURE must be one of: + + action-token + Use reCAPTCHA action-tokens to protect user actions. + + challenge-page + Redirects suspicious traffic to reCAPTCHA challenge page. + + express + Assesses requests without tokens or frontend integration. This + option is deprecated, use --express instead. + + session-token + Use reCAPTCHA session-tokens to protect the whole user session on + the site's domain. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/recaptcha/keys/update b/gcloud/recaptcha/keys/update index 18ed4ff9b..ef8b1b6a7 100644 --- a/gcloud/recaptcha/keys/update +++ b/gcloud/recaptcha/keys/update @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud recaptcha keys update KEY [--display-name=DISPLAY_NAME] [--labels=[KEY=VALUE,...]] - [--android (--allow-all-package-names + [--express | --android (--allow-all-package-names | --package-names=[PACKAGE_NAMES,...]) | [--ios : --allow-all-bundle-ids | --bundle-ids=[BUNDLE_IDS,...] --key-id=KEY_ID --private-key-file=PATH_TO_FILE --team-id=TEAM_ID] @@ -49,6 +49,11 @@ FLAGS At most one of these can be specified: + Options for the creation of a site key for Express. + + --express + Creates a Key configured for Express assessments. + Options for the creation of a site key for Android. --android diff --git a/gcloud/scc/sources/describe b/gcloud/scc/sources/describe index d0a8665fe..e0a6d0920 100644 --- a/gcloud/scc/sources/describe +++ b/gcloud/scc/sources/describe @@ -3,7 +3,7 @@ NAME source id SYNOPSIS - gcloud scc sources describe [ORGANIZATION] + gcloud scc sources describe [PARENT] (--source=SOURCE | --source-display-name=SOURCE_DISPLAY_NAME) [GCLOUD_WIDE_FLAG ...] @@ -11,7 +11,7 @@ DESCRIPTION Describe a source given its display name or source id. EXAMPLES - Describe source with display name 'Security Scanner': + Describe source with display name Security Scanner: $ gcloud scc sources describe 123456 \ --source-display-name="Security Scanner" @@ -21,18 +21,18 @@ EXAMPLES $ gcloud scc sources describe 123456 --source=5678 POSITIONAL ARGUMENTS - Organization resource - The organization to be used for the SCC (Security - Command Center) command. This represents a Cloud resource. + Parent resource - parent organization, folder, or project in the Google + Cloud resource hierarchy to be used for the gcloud scc command. Specify + the argument as either [RESOURCE_TYPE/RESOURCE_ID] or [RESOURCE_ID], as + shown in the preceding examples. This represents a Cloud resource. - [ORGANIZATION] - ID of the organization or fully qualified identifier for the - organization. + [PARENT] + ID of the parent or fully qualified identifier for the parent. - To set the organization attribute: - ▸ provide the argument organization on the command line; - ▸ Set the organization property in configuration using gcloud - config set scc/organization if it is not specified in command - line.. + To set the parent attribute: + ▸ provide the argument parent on the command line; + ▸ Set the parent property in configuration using gcloud config set + scc/parent if it is not specified in command line. REQUIRED FLAGS Exactly one of these must be specified: diff --git a/gcloud/secrets/delete b/gcloud/secrets/delete index a6c0a4542..47b090cff 100644 --- a/gcloud/secrets/delete +++ b/gcloud/secrets/delete @@ -11,13 +11,13 @@ DESCRIPTION succeed, but the operation will be a no-op. EXAMPLES - Delete a secret 'my-secret': + Delete a secret my-secret: $ gcloud secrets delete my-secret - Delete a secret 'my-secret' using an etag: + Delete a secret my-secret using an etag: - $ gcloud secrets delete my-secret --etag=\"123\" + $ gcloud secrets delete my-secret --etag=123 POSITIONAL ARGUMENTS Secret resource - The secret to delete. This represents a Cloud resource. @@ -40,9 +40,8 @@ POSITIONAL ARGUMENTS FLAGS --etag=ETAG - Current entity tag (ETag) of the secret. If this flag is defined, the - secret is updated only if the ETag provided matched the current - secret's ETag. + Current entity tag (ETag) of the secret. If specified, the secret is + deleted only if the ETag provided matches the current secret's ETag. Location resource - The location to delete secret. This represents a Cloud resource. (NOTE) Some attributes are not given arguments in this group but diff --git a/gcloud/secrets/update b/gcloud/secrets/update index 5e0ea031e..cd7fc25c4 100644 --- a/gcloud/secrets/update +++ b/gcloud/secrets/update @@ -25,14 +25,13 @@ DESCRIPTION if given a secret that does not exist. EXAMPLES - Update the label of a secret named 'my-secret'. + Update the label of a secret named my-secret. $ gcloud secrets update my-secret --update-labels=foo=bar Update the label of a secret using an etag. - $ gcloud secrets update my-secret --update-labels=foo=bar \ - --etag=\"123\" + $ gcloud secrets update my-secret --update-labels=foo=bar --etag=123 Update a secret to have a next-rotation-time: @@ -82,9 +81,8 @@ POSITIONAL ARGUMENTS FLAGS --etag=ETAG - Current entity tag (ETag) of the secret. If this flag is defined, the - secret is updated only if the ETag provided matched the current - secret's ETag. + Current entity tag (ETag) of the secret. If specified, the secret is + updated only if the ETag provided matches the current secret's ETag. Location resource - The location to update secret. This represents a Cloud resource. (NOTE) Some attributes are not given arguments in this group but diff --git a/gcloud/secrets/versions/destroy b/gcloud/secrets/versions/destroy index 69266b5ab..1c53f8304 100644 --- a/gcloud/secrets/versions/destroy +++ b/gcloud/secrets/versions/destroy @@ -11,14 +11,13 @@ DESCRIPTION irreversible. EXAMPLES - Destroy version '123' of the secret named 'my-secret': + Destroy version 123 of the secret named my-secret: $ gcloud secrets versions destroy 123 --secret=my-secret - Destroy version '123' of the secret named 'my-secret' using etag: + Destroy version 123 of the secret named my-secret using etag: - $ gcloud secrets versions destroy 123 --secret=my-secret \ - --etag=\"123\" + $ gcloud secrets versions destroy 123 --secret=my-secret --etag=123 POSITIONAL ARGUMENTS Version resource - Numeric secret version to destroy. The arguments in @@ -53,9 +52,9 @@ POSITIONAL ARGUMENTS FLAGS --etag=ETAG - Current entity tag (ETag) of the secret version. If this flag is - defined, the version is updated only if the ETag provided matched the - current version's ETag. + Current entity tag (ETag) of the secret version. If specified, the + version is destroyed only if the ETag provided matches the current + version's ETag. Location resource - The location to destroy . This represents a Cloud resource. (NOTE) Some attributes are not given arguments in this group but diff --git a/gcloud/secrets/versions/disable b/gcloud/secrets/versions/disable index 28636794e..d15e90abb 100644 --- a/gcloud/secrets/versions/disable +++ b/gcloud/secrets/versions/disable @@ -11,14 +11,13 @@ DESCRIPTION gcloud secrets versions enable. EXAMPLES - Disable version '123' of the secret named 'my-secret': + Disable version 123 of the secret named my-secret: $ gcloud secrets versions disable 123 --secret=my-secret - Disable version '123' of the secret named 'my-secret' using etag: + Disable version 123 of the secret named my-secret using etag: - $ gcloud secrets versions disable 123 --secret=my-secret \ - --etag=\"123\" + $ gcloud secrets versions disable 123 --secret=my-secret --etag=123 POSITIONAL ARGUMENTS Version resource - Numeric secret version to disable. The arguments in @@ -53,9 +52,9 @@ POSITIONAL ARGUMENTS FLAGS --etag=ETAG - Current entity tag (ETag) of the secret version. If this flag is - defined, the version is updated only if the ETag provided matched the - current version's ETag. + Current entity tag (ETag) of the secret version. If specified, the + version is disabled only if the ETag provided matches the current + version's ETag. Location resource - The location to disable. This represents a Cloud resource. (NOTE) Some attributes are not given arguments in this group but diff --git a/gcloud/secrets/versions/enable b/gcloud/secrets/versions/enable index f84065d5b..657a240ea 100644 --- a/gcloud/secrets/versions/enable +++ b/gcloud/secrets/versions/enable @@ -10,14 +10,13 @@ DESCRIPTION secrets versions disable. EXAMPLES - Enable version '123' of the secret named 'my-secret': + Enable version 123 of the secret named my-secret: $ gcloud secrets versions enable 123 --secret=my-secret - Enable version '123' of the secret named 'my-secret' using etag: + Enable version 123 of the secret named my-secret using etag: - $ gcloud secrets versions enable 123 --secret=my-secret \ - --etag=\"123\" + $ gcloud secrets versions enable 123 --secret=my-secret --etag=123 POSITIONAL ARGUMENTS Version resource - Numeric secret version to enable. The arguments in this @@ -52,9 +51,9 @@ POSITIONAL ARGUMENTS FLAGS --etag=ETAG - Current entity tag (ETag) of the secret version. If this flag is - defined, the version is updated only if the ETag provided matched the - current version's ETag. + Current entity tag (ETag) of the secret version. If specified, the + version is enabled only if the ETag provided matches the current + version's ETag. Location resource - The location to enable. This represents a Cloud resource. (NOTE) Some attributes are not given arguments in this group but diff --git a/gcloud/spanner/instance-configs/create b/gcloud/spanner/instance-configs/create index 877c5919b..3aad87284 100644 --- a/gcloud/spanner/instance-configs/create +++ b/gcloud/spanner/instance-configs/create @@ -16,17 +16,17 @@ DESCRIPTION EXAMPLES To create a custom Cloud Spanner instance configuration based on an - existing Google-managed configuration (nam3) by adding a 'READ_ONLY' type - replica in location 'us-east4', run: + existing Google-managed configuration (nam3) by adding a READ_ONLY type + replica in location us-east4, run: $ gcloud spanner instance-configs create custom-instance-config \ --clone-config=nam3 \ --add-replicas=location=us-east4,type=READ_ONLY To create a custom Cloud Spanner instance configuration based on another - custom configuration (custom-instance-config) by adding a 'READ_ONLY' type - replica in location 'us-east1' and removing a 'READ_ONLY' type replica in - location 'us-east4', run: + custom configuration (custom-instance-config) by adding a READ_ONLY type + replica in location us-east1 and removing a READ_ONLY type replica in + location us-east4, run: $ gcloud spanner instance-configs create custom-instance-config1 \ --clone-config=custom-instance-config \ @@ -144,8 +144,8 @@ OPTIONAL FLAGS numbers. --validate-only - Use this flag to validate that the request will succeed before - executing it. + If specified, validate that the creation will succeed without creating + the instance configuration. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/spanner/instance-configs/delete b/gcloud/spanner/instance-configs/delete index 465c14b70..34756cdce 100644 --- a/gcloud/spanner/instance-configs/delete +++ b/gcloud/spanner/instance-configs/delete @@ -24,8 +24,8 @@ FLAGS simultaneous deletes of an instance config from overwriting each other. --validate-only - Use this flag to validate that the request will succeed before - executing it. + If specified, validate that the deletion will succeed without deleting + the instance config. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/spanner/instances/create b/gcloud/spanner/instances/create index 0e6e38257..096ab4556 100644 --- a/gcloud/spanner/instances/create +++ b/gcloud/spanner/instances/create @@ -3,8 +3,8 @@ NAME SYNOPSIS gcloud spanner instances create INSTANCE --config=CONFIG - --description=DESCRIPTION [--async] [--expire-behavior=EXPIRE_BEHAVIOR] - [--instance-type=INSTANCE_TYPE] + --description=DESCRIPTION [--async] [--edition=EDITION] + [--expire-behavior=EXPIRE_BEHAVIOR] [--instance-type=INSTANCE_TYPE] [--nodes=NODES | --processing-units=PROCESSING_UNITS] [GCLOUD_WIDE_FLAG ...] @@ -36,6 +36,20 @@ OPTIONAL FLAGS Return immediately, without waiting for the operation in progress to complete. + --edition=EDITION + Cloud Spanner edition. EDITION must be one of: + + EDITION_UNSPECIFIED + Spanner's legacy pricing model. For more information, see the + Spanner editions overview + (https://cloud.google.com/spanner/docs/editions-overview) + ENTERPRISE + Enterprise edition + ENTERPRISE_PLUS + Enterprise Plus edition + STANDARD + Standard edition + --expire-behavior=EXPIRE_BEHAVIOR The expire behavior of a free trial instance. EXPIRE_BEHAVIOR must be one of: diff --git a/gcloud/spanner/instances/update b/gcloud/spanner/instances/update index b88ec0ff4..684321b08 100644 --- a/gcloud/spanner/instances/update +++ b/gcloud/spanner/instances/update @@ -3,8 +3,8 @@ NAME SYNOPSIS gcloud spanner instances update INSTANCE [--async] - [--description=DESCRIPTION] [--expire-behavior=EXPIRE_BEHAVIOR] - [--instance-type=INSTANCE_TYPE] + [--description=DESCRIPTION] [--edition=EDITION] + [--expire-behavior=EXPIRE_BEHAVIOR] [--instance-type=INSTANCE_TYPE] [--nodes=NODES | --processing-units=PROCESSING_UNITS] [GCLOUD_WIDE_FLAG ...] @@ -33,6 +33,15 @@ FLAGS --description=DESCRIPTION Description of the instance. + --edition=EDITION + Cloud Spanner edition. You can upgrade your Standard edition instance + to the ENTERPRISE edition or ENTERPRISE_PLUS edition. You can also + upgrade your Enterprise edition instance to the ENTERPRISE_PLUS + edition. Self-service downgrade isn't available. To downgrade the + edition of your instance, file a support ticket. For more information, + see the Spanner editions overview + (https://cloud.google.com/spanner/docs/editions-overview) + --expire-behavior=EXPIRE_BEHAVIOR The expire behavior of a free trial instance. EXPIRE_BEHAVIOR must be one of: diff --git a/gcloud/sql/backups/restore b/gcloud/sql/backups/restore index 2b56f58ad..c387debf1 100644 --- a/gcloud/sql/backups/restore +++ b/gcloud/sql/backups/restore @@ -3,7 +3,8 @@ NAME SYNOPSIS gcloud sql backups restore ID --restore-instance=RESTORE_INSTANCE [--async] - [--backup-instance=BACKUP_INSTANCE] [GCLOUD_WIDE_FLAG ...] + [--backup-instance=BACKUP_INSTANCE] [--backup-project=BACKUP_PROJECT] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION Restores a backup of a Cloud SQL instance. @@ -27,6 +28,10 @@ OPTIONAL FLAGS restore instance. If it is not specified, the backup instance is considered the same as the restore instance. + --backup-project=BACKUP_PROJECT + The project of the instance to which the backup belongs. If it isn't + specified, backup and restore instances are in the same project. + 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/sql/instances/create b/gcloud/sql/instances/create index 191c322da..802465281 100644 --- a/gcloud/sql/instances/create +++ b/gcloud/sql/instances/create @@ -19,7 +19,7 @@ SYNOPSIS [--deny-maintenance-period-end-date=DENY_MAINTENANCE_PERIOD_END_DATE] [--deny-maintenance-period-start-date=DENY_MAINTENANCE_PERIOD_START_DATE] [--deny-maintenance-period-time=DENY_MAINTENANCE_PERIOD_TIME] - [--edition=EDITION] [--enable-bin-log] [--enable-data-cache] + [--edition=EDITION] [--enable-bin-log] [--[no-]enable-data-cache] [--[no-]enable-dataplex-integration] [--[no-]enable-google-ml-integration] [--enable-google-private-path] [--enable-password-policy] [--enable-point-in-time-recovery] @@ -228,9 +228,10 @@ FLAGS fraction of a second. Must have automatic backups enabled to use. Make sure storage can support at least 7 days of logs. - --enable-data-cache + --[no-]enable-data-cache Enable use of data cache for accelerated read performance. This flag is - only available for Enterprise_Plus edition instances. + only available for Enterprise_Plus edition instances. Use + --enable-data-cache to enable and --no-enable-data-cache to disable. --[no-]enable-dataplex-integration Enable Dataplex integration for Google Cloud SQL. Use diff --git a/gcloud/sql/instances/patch b/gcloud/sql/instances/patch index 257aa01ab..decf8ff66 100644 --- a/gcloud/sql/instances/patch +++ b/gcloud/sql/instances/patch @@ -13,7 +13,7 @@ SYNOPSIS [--deny-maintenance-period-end-date=DENY_MAINTENANCE_PERIOD_END_DATE] [--deny-maintenance-period-start-date=DENY_MAINTENANCE_PERIOD_START_DATE] [--deny-maintenance-period-time=DENY_MAINTENANCE_PERIOD_TIME] [--diff] - [--edition=EDITION] [--[no-]enable-bin-log] [--enable-data-cache] + [--edition=EDITION] [--[no-]enable-bin-log] [--[no-]enable-data-cache] [--[no-]enable-database-replication] [--[no-]enable-dataplex-integration] [--[no-]enable-google-ml-integration] @@ -174,9 +174,10 @@ FLAGS sure storage can support at least 7 days of logs. Use --enable-bin-log to enable and --no-enable-bin-log to disable. - --enable-data-cache + --[no-]enable-data-cache Enable use of data cache for accelerated read performance. This flag is - only available for Enterprise_Plus edition instances. + only available for Enterprise_Plus edition instances. Use + --enable-data-cache to enable and --no-enable-data-cache to disable. --[no-]enable-database-replication Enable database replication. Applicable only for read replica diff --git a/gcloud/workstations/configs/create b/gcloud/workstations/configs/create index afef4c192..b3afb7d32 100644 --- a/gcloud/workstations/configs/create +++ b/gcloud/workstations/configs/create @@ -249,7 +249,7 @@ FLAGS and the administrator must manually delete the disk. --pool-size=POOL_SIZE - Number of instances to pool for faster Workstation starup. + Number of instances to pool for faster Workstation startup. --replica-zones=[REPLICA_ZONES,...] Specifies the zones the VM and disk resources will be replicated within diff --git a/gcloud/workstations/configs/update b/gcloud/workstations/configs/update index 874fd7bb9..4da44e968 100644 --- a/gcloud/workstations/configs/update +++ b/gcloud/workstations/configs/update @@ -201,7 +201,7 @@ FLAGS $ gcloud workstations configs update --network-tags=tag_1,tag_2 --pool-size=POOL_SIZE - Number of instances to pool for faster Workstation starup. + Number of instances to pool for faster Workstation startup. --running-timeout=RUNNING_TIMEOUT How long (in seconds) to wait before automatically stopping a