From 7e2535c53d99401c59a4674e7b3412c3fc6cd216 Mon Sep 17 00:00:00 2001 From: Automated Date: Wed, 3 Apr 2024 09:23:31 +0000 Subject: [PATCH] gcloud: Wed Apr 3 09:23:31 UTC 2024 --- gcloud/_version | 10 +- gcloud/alloydb/instances/create | 13 +- gcloud/alloydb/instances/update | 22 ++- gcloud/alpha/alloydb/clusters/create | 6 +- gcloud/alpha/alloydb/clusters/restore | 6 +- gcloud/alpha/alloydb/instances/create | 2 +- gcloud/alpha/alloydb/instances/update | 2 +- gcloud/alpha/artifacts/docker/images/list | 3 +- .../alpha/builds/get-default-service-account | 43 +++++ gcloud/alpha/builds/help | 3 + gcloud/alpha/composer/environments/help | 10 ++ .../composer/environments/list-workloads | 65 +++++++ .../user-workloads-config-maps/create | 73 ++++++++ .../user-workloads-config-maps/delete | 72 ++++++++ .../user-workloads-config-maps/describe | 74 ++++++++ .../user-workloads-config-maps/help | 44 +++++ .../user-workloads-config-maps/list | 68 ++++++++ .../user-workloads-config-maps/update | 73 ++++++++ .../user-workloads-secrets/create | 72 ++++++++ .../user-workloads-secrets/delete | 72 ++++++++ .../user-workloads-secrets/describe | 73 ++++++++ .../environments/user-workloads-secrets/help | 44 +++++ .../environments/user-workloads-secrets/list | 68 ++++++++ .../user-workloads-secrets/update | 72 ++++++++ gcloud/alpha/compute/help | 6 + gcloud/alpha/compute/images/create | 22 +++ .../managed/resize-requests/cancel | 4 +- .../managed/resize-requests/create | 4 +- .../managed/resize-requests/delete | 4 +- .../managed/resize-requests/describe | 4 +- .../managed/resize-requests/help | 4 +- .../managed/resize-requests/list | 4 +- .../alpha/compute/instance-templates/create | 16 ++ gcloud/alpha/compute/instances/bulk/create | 16 ++ gcloud/alpha/compute/instances/create | 22 ++- gcloud/alpha/compute/instances/set-scheduling | 25 +++ gcloud/alpha/compute/queued-resources/create | 16 ++ .../alpha/compute/storage-pool-types/describe | 72 ++++++++ gcloud/alpha/compute/storage-pool-types/help | 33 ++++ gcloud/alpha/compute/storage-pool-types/list | 71 ++++++++ gcloud/alpha/compute/storage-pools/create | 129 ++++++++++++++ gcloud/alpha/compute/storage-pools/delete | 76 ++++++++ gcloud/alpha/compute/storage-pools/describe | 71 ++++++++ .../compute/storage-pools/get-iam-policy | 99 +++++++++++ gcloud/alpha/compute/storage-pools/help | 51 ++++++ gcloud/alpha/compute/storage-pools/list | 94 ++++++++++ gcloud/alpha/compute/storage-pools/list-disks | 72 ++++++++ .../compute/storage-pools/set-iam-policy | 80 +++++++++ gcloud/alpha/compute/storage-pools/update | 93 ++++++++++ gcloud/alpha/container/clusters/create | 20 ++- gcloud/alpha/container/clusters/create-auto | 17 +- gcloud/alpha/container/clusters/update | 18 +- gcloud/alpha/container/fleet/scopes/help | 3 +- gcloud/alpha/container/fleet/scopes/list | 1 + .../container/fleet/scopes/list-memberships | 6 +- gcloud/alpha/container/hub/scopes/help | 3 +- gcloud/alpha/container/hub/scopes/list | 1 + .../container/hub/scopes/list-memberships | 6 +- .../alpha/firestore/indexes/composite/create | 17 +- gcloud/alpha/pubsub/subscriptions/create | 12 +- gcloud/alpha/pubsub/subscriptions/update | 12 +- gcloud/alpha/redis/clusters/create | 7 +- gcloud/alpha/spanner/operations/describe | 9 +- gcloud/alpha/spanner/operations/help | 2 +- gcloud/alpha/spanner/operations/list | 5 + gcloud/alpha/sql/instances/patch | 16 +- gcloud/alpha/storage/mv | 2 +- gcloud/artifacts/docker/images/list | 3 +- gcloud/beta/artifacts/docker/images/list | 3 +- .../beta/builds/get-default-service-account | 41 +++++ gcloud/beta/builds/help | 3 + gcloud/beta/composer/environments/help | 10 ++ .../beta/composer/environments/list-workloads | 63 +++++++ .../user-workloads-config-maps/create | 72 ++++++++ .../user-workloads-config-maps/delete | 71 ++++++++ .../user-workloads-config-maps/describe | 72 ++++++++ .../user-workloads-config-maps/help | 42 +++++ .../user-workloads-config-maps/list | 66 +++++++ .../user-workloads-config-maps/update | 72 ++++++++ .../user-workloads-secrets/create | 70 ++++++++ .../user-workloads-secrets/delete | 70 ++++++++ .../user-workloads-secrets/describe | 71 ++++++++ .../environments/user-workloads-secrets/help | 41 +++++ .../environments/user-workloads-secrets/list | 66 +++++++ .../user-workloads-secrets/update | 70 ++++++++ gcloud/beta/compute/help | 6 + .../managed/resize-requests/cancel | 6 +- .../managed/resize-requests/create | 6 +- .../managed/resize-requests/delete | 6 +- .../managed/resize-requests/describe | 6 +- .../managed/resize-requests/help | 6 +- .../managed/resize-requests/list | 6 +- gcloud/beta/compute/instance-templates/create | 16 ++ gcloud/beta/compute/instances/bulk/create | 16 ++ gcloud/beta/compute/instances/create | 22 ++- gcloud/beta/compute/instances/set-scheduling | 25 +++ .../beta/compute/storage-pool-types/describe | 70 ++++++++ gcloud/beta/compute/storage-pool-types/help | 31 ++++ gcloud/beta/compute/storage-pool-types/list | 69 ++++++++ gcloud/beta/compute/storage-pools/create | 127 ++++++++++++++ gcloud/beta/compute/storage-pools/delete | 74 ++++++++ gcloud/beta/compute/storage-pools/describe | 69 ++++++++ .../beta/compute/storage-pools/get-iam-policy | 97 ++++++++++ gcloud/beta/compute/storage-pools/help | 49 ++++++ gcloud/beta/compute/storage-pools/list | 92 ++++++++++ gcloud/beta/compute/storage-pools/list-disks | 70 ++++++++ .../beta/compute/storage-pools/set-iam-policy | 78 +++++++++ gcloud/beta/compute/storage-pools/update | 91 ++++++++++ gcloud/beta/container/clusters/create | 20 ++- gcloud/beta/container/clusters/create-auto | 17 +- gcloud/beta/container/clusters/update | 18 +- gcloud/beta/container/fleet/scopes/help | 6 +- gcloud/beta/container/fleet/scopes/list | 1 + .../container/fleet/scopes/list-memberships | 93 ++++++++++ gcloud/beta/container/hub/scopes/help | 6 +- gcloud/beta/container/hub/scopes/list | 1 + .../container/hub/scopes/list-memberships | 93 ++++++++++ gcloud/beta/netapp/backup-policies/create | 5 +- gcloud/beta/netapp/backup-policies/delete | 5 +- gcloud/beta/netapp/backup-policies/describe | 5 +- gcloud/beta/netapp/backup-policies/help | 5 +- gcloud/beta/netapp/backup-policies/list | 5 +- gcloud/beta/netapp/backup-policies/update | 5 +- .../beta/netapp/backup-vaults/backups/create | 5 +- .../beta/netapp/backup-vaults/backups/delete | 5 +- .../netapp/backup-vaults/backups/describe | 5 +- gcloud/beta/netapp/backup-vaults/backups/help | 5 +- gcloud/beta/netapp/backup-vaults/backups/list | 5 +- .../beta/netapp/backup-vaults/backups/update | 5 +- gcloud/beta/netapp/backup-vaults/create | 5 +- gcloud/beta/netapp/backup-vaults/delete | 5 +- gcloud/beta/netapp/backup-vaults/describe | 5 +- gcloud/beta/netapp/backup-vaults/help | 5 +- gcloud/beta/netapp/backup-vaults/list | 5 +- gcloud/beta/netapp/backup-vaults/update | 5 +- .../regional-endpoints/create | 6 +- gcloud/beta/pubsub/subscriptions/create | 12 +- gcloud/beta/pubsub/subscriptions/update | 12 +- gcloud/beta/redis/clusters/create | 7 +- gcloud/beta/sql/instances/patch | 16 +- gcloud/builds/get-default-service-account | 40 +++++ gcloud/builds/help | 3 + gcloud/compute/help | 6 + gcloud/compute/instance-groups/managed/help | 3 + .../managed/resize-requests/cancel | 67 +++++++ .../managed/resize-requests/create | 77 ++++++++ .../managed/resize-requests/delete | 68 ++++++++ .../managed/resize-requests/describe | 67 +++++++ .../managed/resize-requests/help | 42 +++++ .../managed/resize-requests/list | 98 +++++++++++ gcloud/compute/instances/create | 6 +- gcloud/compute/os-config/help | 3 + .../project-feature-settings/describe | 28 +++ .../os-config/project-feature-settings/help | 24 +++ .../os-config/project-feature-settings/update | 44 +++++ gcloud/compute/storage-pool-types/describe | 68 ++++++++ gcloud/compute/storage-pool-types/help | 30 ++++ gcloud/compute/storage-pool-types/list | 68 ++++++++ gcloud/compute/storage-pools/create | 126 +++++++++++++ gcloud/compute/storage-pools/delete | 73 ++++++++ gcloud/compute/storage-pools/describe | 68 ++++++++ gcloud/compute/storage-pools/get-iam-policy | 96 ++++++++++ gcloud/compute/storage-pools/help | 48 +++++ gcloud/compute/storage-pools/list | 90 ++++++++++ gcloud/compute/storage-pools/list-disks | 69 ++++++++ gcloud/compute/storage-pools/set-iam-policy | 77 ++++++++ gcloud/compute/storage-pools/update | 90 ++++++++++ gcloud/container/clusters/create | 5 +- gcloud/container/clusters/create-auto | 5 +- gcloud/container/clusters/update | 5 +- gcloud/container/fleet/scopes/help | 5 +- gcloud/container/fleet/scopes/list | 1 + .../container/fleet/scopes/list-memberships | 92 ++++++++++ gcloud/container/hub/scopes/help | 5 +- gcloud/container/hub/scopes/list | 3 +- gcloud/container/hub/scopes/list-memberships | 92 ++++++++++ .../connection-profiles/create/help | 3 + .../connection-profiles/create/sqlserver | 106 +++++++++++ .../database-migration/migration-jobs/create | 36 ++++ .../deployments/export-statefile | 10 +- gcloud/infra-manager/previews/export | 9 +- gcloud/netapp/backup-policies/create | 105 +++++++++++ gcloud/netapp/backup-policies/delete | 73 ++++++++ gcloud/netapp/backup-policies/describe | 69 ++++++++ gcloud/netapp/backup-policies/help | 38 ++++ gcloud/netapp/backup-policies/list | 88 ++++++++++ gcloud/netapp/backup-policies/update | 134 ++++++++++++++ gcloud/netapp/backup-vaults/backups/create | 165 ++++++++++++++++++ gcloud/netapp/backup-vaults/backups/delete | 99 +++++++++++ gcloud/netapp/backup-vaults/backups/describe | 91 ++++++++++ gcloud/netapp/backup-vaults/backups/help | 38 ++++ gcloud/netapp/backup-vaults/backups/list | 108 ++++++++++++ gcloud/netapp/backup-vaults/backups/update | 128 ++++++++++++++ gcloud/netapp/backup-vaults/create | 80 +++++++++ gcloud/netapp/backup-vaults/delete | 73 ++++++++ gcloud/netapp/backup-vaults/describe | 69 ++++++++ gcloud/netapp/backup-vaults/help | 43 +++++ gcloud/netapp/backup-vaults/list | 87 +++++++++ gcloud/netapp/backup-vaults/update | 109 ++++++++++++ gcloud/netapp/help | 6 + gcloud/netapp/volumes/create | 54 +++++- gcloud/netapp/volumes/update | 54 +++++- gcloud/privateca/certificates/create | 9 +- gcloud/privateca/roots/create | 10 +- gcloud/privateca/subordinates/create | 9 +- gcloud/privateca/templates/create | 11 +- gcloud/pubsub/subscriptions/create | 12 +- gcloud/pubsub/subscriptions/update | 12 +- gcloud/redis/clusters/create | 8 +- gcloud/storage/mv | 2 +- gcloud/workbench/instances/create | 2 +- gcloud/workbench/instances/update | 2 +- 212 files changed, 8070 insertions(+), 151 deletions(-) create mode 100644 gcloud/alpha/builds/get-default-service-account create mode 100644 gcloud/alpha/composer/environments/list-workloads create mode 100644 gcloud/alpha/composer/environments/user-workloads-config-maps/create create mode 100644 gcloud/alpha/composer/environments/user-workloads-config-maps/delete create mode 100644 gcloud/alpha/composer/environments/user-workloads-config-maps/describe create mode 100644 gcloud/alpha/composer/environments/user-workloads-config-maps/help create mode 100644 gcloud/alpha/composer/environments/user-workloads-config-maps/list create mode 100644 gcloud/alpha/composer/environments/user-workloads-config-maps/update create mode 100644 gcloud/alpha/composer/environments/user-workloads-secrets/create create mode 100644 gcloud/alpha/composer/environments/user-workloads-secrets/delete create mode 100644 gcloud/alpha/composer/environments/user-workloads-secrets/describe create mode 100644 gcloud/alpha/composer/environments/user-workloads-secrets/help create mode 100644 gcloud/alpha/composer/environments/user-workloads-secrets/list create mode 100644 gcloud/alpha/composer/environments/user-workloads-secrets/update create mode 100644 gcloud/alpha/compute/storage-pool-types/describe create mode 100644 gcloud/alpha/compute/storage-pool-types/help create mode 100644 gcloud/alpha/compute/storage-pool-types/list create mode 100644 gcloud/alpha/compute/storage-pools/create create mode 100644 gcloud/alpha/compute/storage-pools/delete create mode 100644 gcloud/alpha/compute/storage-pools/describe create mode 100644 gcloud/alpha/compute/storage-pools/get-iam-policy create mode 100644 gcloud/alpha/compute/storage-pools/help create mode 100644 gcloud/alpha/compute/storage-pools/list create mode 100644 gcloud/alpha/compute/storage-pools/list-disks create mode 100644 gcloud/alpha/compute/storage-pools/set-iam-policy create mode 100644 gcloud/alpha/compute/storage-pools/update create mode 100644 gcloud/beta/builds/get-default-service-account create mode 100644 gcloud/beta/composer/environments/list-workloads create mode 100644 gcloud/beta/composer/environments/user-workloads-config-maps/create create mode 100644 gcloud/beta/composer/environments/user-workloads-config-maps/delete create mode 100644 gcloud/beta/composer/environments/user-workloads-config-maps/describe create mode 100644 gcloud/beta/composer/environments/user-workloads-config-maps/help create mode 100644 gcloud/beta/composer/environments/user-workloads-config-maps/list create mode 100644 gcloud/beta/composer/environments/user-workloads-config-maps/update create mode 100644 gcloud/beta/composer/environments/user-workloads-secrets/create create mode 100644 gcloud/beta/composer/environments/user-workloads-secrets/delete create mode 100644 gcloud/beta/composer/environments/user-workloads-secrets/describe create mode 100644 gcloud/beta/composer/environments/user-workloads-secrets/help create mode 100644 gcloud/beta/composer/environments/user-workloads-secrets/list create mode 100644 gcloud/beta/composer/environments/user-workloads-secrets/update create mode 100644 gcloud/beta/compute/storage-pool-types/describe create mode 100644 gcloud/beta/compute/storage-pool-types/help create mode 100644 gcloud/beta/compute/storage-pool-types/list create mode 100644 gcloud/beta/compute/storage-pools/create create mode 100644 gcloud/beta/compute/storage-pools/delete create mode 100644 gcloud/beta/compute/storage-pools/describe create mode 100644 gcloud/beta/compute/storage-pools/get-iam-policy create mode 100644 gcloud/beta/compute/storage-pools/help create mode 100644 gcloud/beta/compute/storage-pools/list create mode 100644 gcloud/beta/compute/storage-pools/list-disks create mode 100644 gcloud/beta/compute/storage-pools/set-iam-policy create mode 100644 gcloud/beta/compute/storage-pools/update create mode 100644 gcloud/beta/container/fleet/scopes/list-memberships create mode 100644 gcloud/beta/container/hub/scopes/list-memberships create mode 100644 gcloud/builds/get-default-service-account create mode 100644 gcloud/compute/instance-groups/managed/resize-requests/cancel create mode 100644 gcloud/compute/instance-groups/managed/resize-requests/create create mode 100644 gcloud/compute/instance-groups/managed/resize-requests/delete create mode 100644 gcloud/compute/instance-groups/managed/resize-requests/describe create mode 100644 gcloud/compute/instance-groups/managed/resize-requests/help create mode 100644 gcloud/compute/instance-groups/managed/resize-requests/list create mode 100644 gcloud/compute/os-config/project-feature-settings/describe create mode 100644 gcloud/compute/os-config/project-feature-settings/help create mode 100644 gcloud/compute/os-config/project-feature-settings/update create mode 100644 gcloud/compute/storage-pool-types/describe create mode 100644 gcloud/compute/storage-pool-types/help create mode 100644 gcloud/compute/storage-pool-types/list create mode 100644 gcloud/compute/storage-pools/create create mode 100644 gcloud/compute/storage-pools/delete create mode 100644 gcloud/compute/storage-pools/describe create mode 100644 gcloud/compute/storage-pools/get-iam-policy create mode 100644 gcloud/compute/storage-pools/help create mode 100644 gcloud/compute/storage-pools/list create mode 100644 gcloud/compute/storage-pools/list-disks create mode 100644 gcloud/compute/storage-pools/set-iam-policy create mode 100644 gcloud/compute/storage-pools/update create mode 100644 gcloud/container/fleet/scopes/list-memberships create mode 100644 gcloud/container/hub/scopes/list-memberships create mode 100644 gcloud/database-migration/connection-profiles/create/sqlserver create mode 100644 gcloud/netapp/backup-policies/create create mode 100644 gcloud/netapp/backup-policies/delete create mode 100644 gcloud/netapp/backup-policies/describe create mode 100644 gcloud/netapp/backup-policies/help create mode 100644 gcloud/netapp/backup-policies/list create mode 100644 gcloud/netapp/backup-policies/update create mode 100644 gcloud/netapp/backup-vaults/backups/create create mode 100644 gcloud/netapp/backup-vaults/backups/delete create mode 100644 gcloud/netapp/backup-vaults/backups/describe create mode 100644 gcloud/netapp/backup-vaults/backups/help create mode 100644 gcloud/netapp/backup-vaults/backups/list create mode 100644 gcloud/netapp/backup-vaults/backups/update create mode 100644 gcloud/netapp/backup-vaults/create create mode 100644 gcloud/netapp/backup-vaults/delete create mode 100644 gcloud/netapp/backup-vaults/describe create mode 100644 gcloud/netapp/backup-vaults/help create mode 100644 gcloud/netapp/backup-vaults/list create mode 100644 gcloud/netapp/backup-vaults/update diff --git a/gcloud/_version b/gcloud/_version index 66a974f1e..2677f1d82 100644 --- a/gcloud/_version +++ b/gcloud/_version @@ -1,8 +1,8 @@ -Google Cloud SDK 470.0.0 -alpha 2024.03.22 -beta 2024.03.22 -bq 2.1.2 +Google Cloud SDK 471.0.0 +alpha 2024.03.29 +beta 2024.03.29 +bq 2.1.3 bundled-python3-unix 3.11.8 -core 2024.03.22 +core 2024.03.29 gcloud-crc32c 1.0.0 gsutil 5.27 diff --git a/gcloud/alloydb/instances/create b/gcloud/alloydb/instances/create index 6212e2c93..3df496f39 100644 --- a/gcloud/alloydb/instances/create +++ b/gcloud/alloydb/instances/create @@ -5,7 +5,8 @@ NAME SYNOPSIS gcloud alloydb instances create INSTANCE --cluster=CLUSTER --cpu-count=CPU_COUNT --instance-type=INSTANCE_TYPE --region=REGION - [--async] [--availability-type=AVAILABILITY_TYPE] + [--assign-inbound-public-ip=ASSIGN_INBOUND_PUBLIC_IP] [--async] + [--availability-type=AVAILABILITY_TYPE] [--database-flags=FLAG=VALUE,[FLAG=VALUE,...]] [--insights-config-query-plans-per-minute=INSIGHTS_CONFIG_QUERY_PLANS_PER_MINUTE] [--insights-config-query-string-length=INSIGHTS_CONFIG_QUERY_STRING_LENGTH] @@ -61,6 +62,16 @@ REQUIRED FLAGS regions at https://cloud.google.com/sql/docs/instance-locations. OPTIONAL FLAGS + --assign-inbound-public-ip=ASSIGN_INBOUND_PUBLIC_IP + Specify to enable or disable public IP on an instance. On instance + creation only disabling public IP is allowed. If you want to enable + public IP, an instance must be created with public IP disabled first, + then update the instance to enable public IP. ASSIGN_INBOUND_PUBLIC_IP + must be (only one value is supported): + + NO_PUBLIC_IP + This disables public IP on the instance. + --async Return immediately, without waiting for the operation in progress to complete. diff --git a/gcloud/alloydb/instances/update b/gcloud/alloydb/instances/update index 05a9f8604..1b93b1055 100644 --- a/gcloud/alloydb/instances/update +++ b/gcloud/alloydb/instances/update @@ -4,8 +4,10 @@ NAME SYNOPSIS gcloud alloydb instances update INSTANCE --cluster=CLUSTER --region=REGION - [--async] [--availability-type=AVAILABILITY_TYPE] - [--cpu-count=CPU_COUNT] [--database-flags=FLAG=VALUE,[FLAG=VALUE,...]] + [--assign-inbound-public-ip=ASSIGN_INBOUND_PUBLIC_IP] [--async] + [--authorized-external-networks=[AUTHORIZED_NETWORK,...]] + [--availability-type=AVAILABILITY_TYPE] [--cpu-count=CPU_COUNT] + [--database-flags=FLAG=VALUE,[FLAG=VALUE,...]] [--insights-config-query-plans-per-minute=INSIGHTS_CONFIG_QUERY_PLANS_PER_MINUTE] [--insights-config-query-string-length=INSIGHTS_CONFIG_QUERY_STRING_LENGTH] [--[no-]insights-config-record-application-tags] @@ -37,11 +39,27 @@ REQUIRED FLAGS regions at https://cloud.google.com/sql/docs/instance-locations. OPTIONAL FLAGS + --assign-inbound-public-ip=ASSIGN_INBOUND_PUBLIC_IP + Specify to enable or disable public IP on an instance. + ASSIGN_INBOUND_PUBLIC_IP must be one of: + ◆ NO_PUBLIC_IP + ▸ This disables public IP on the instance. Updating an instance to + disable public IP will clear the list of authorized networks. + ◆ ASSIGN_IPV4 + ▸ Assign an inbound public IPv4 address for the instance. public IP + is enabled. + --async Return immediately, without waiting for the operation in progress to complete. The default is True. Enabled by default, use --no-async to disable. + --authorized-external-networks=[AUTHORIZED_NETWORK,...] + Comma-separated list of authorized external networks to set on the + instance. Authorized networks should use CIDR notation (e.g. + 1.2.3.4/30). This flag is only allowed to be set for instances with + public IP enabled. + --availability-type=AVAILABILITY_TYPE Specifies level of availability. AVAILABILITY_TYPE must be one of: diff --git a/gcloud/alpha/alloydb/clusters/create b/gcloud/alpha/alloydb/clusters/create index 3fdc9ce51..0d9431f27 100644 --- a/gcloud/alpha/alloydb/clusters/create +++ b/gcloud/alpha/alloydb/clusters/create @@ -6,7 +6,7 @@ SYNOPSIS gcloud alpha alloydb clusters create CLUSTER --password=PASSWORD --region=REGION [--allocated-ip-range-name=ALLOCATED_IP_RANGE_NAME] [--async] [--database-version=DATABASE_VERSION] - [--enable-private-services-connect] [--network=NETWORK] + [--enable-private-service-connect] [--network=NETWORK] [--continuous-backup-recovery-window-days=RECOVERY_PERIOD --enable-continuous-backup [--continuous-backup-encryption-key=CONTINUOUS_BACKUP_ENCRYPTION_KEY @@ -59,8 +59,8 @@ OPTIONAL FLAGS Database version of the cluster. DATABASE_VERSION must be one of: POSTGRES_14, POSTGRES_15. - --enable-private-services-connect - Enable Private Services Connect (PSC) connectivity for the cluster. + --enable-private-service-connect + Enable Private Service Connect (PSC) connectivity for the cluster. --network=NETWORK Network in the current project that the instance will be part of. To diff --git a/gcloud/alpha/alloydb/clusters/restore b/gcloud/alpha/alloydb/clusters/restore index 864d5b2cc..c9c581202 100644 --- a/gcloud/alpha/alloydb/clusters/restore +++ b/gcloud/alpha/alloydb/clusters/restore @@ -7,7 +7,7 @@ SYNOPSIS (--backup=BACKUP | --point-in-time=POINT_IN_TIME --source-cluster=SOURCE_CLUSTER) [--allocated-ip-range-name=ALLOCATED_IP_RANGE_NAME] [--async] - [--enable-private-services-connect] [--network=NETWORK] + [--enable-private-service-connect] [--network=NETWORK] [--kms-key=KMS_KEY : --kms-keyring=KMS_KEYRING --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT] [GCLOUD_WIDE_FLAG ...] @@ -81,8 +81,8 @@ OPTIONAL FLAGS Return immediately, without waiting for the operation in progress to complete. - --enable-private-services-connect - Enable Private Services Connect (PSC) connectivity for the cluster. + --enable-private-service-connect + Enable Private Service Connect (PSC) connectivity for the cluster. --network=NETWORK Network in the current project that the instance will be part of. To diff --git a/gcloud/alpha/alloydb/instances/create b/gcloud/alpha/alloydb/instances/create index 0bb8b0158..de71d9e70 100644 --- a/gcloud/alpha/alloydb/instances/create +++ b/gcloud/alpha/alloydb/instances/create @@ -66,7 +66,7 @@ REQUIRED FLAGS OPTIONAL FLAGS --allowed-psc-projects=[ALLOWED_PSC_PROJECTS,...] Comma-separated list of allowed consumer projects to create endpoints - for Private Services Connect (PSC) connectivity for the instance. Only + for Private Service Connect (PSC) connectivity for the instance. Only instances in PSC-enabled clusters are allowed to set this field.(e.g., --allowed-psc-projects=project1,12345678,project2) diff --git a/gcloud/alpha/alloydb/instances/update b/gcloud/alpha/alloydb/instances/update index 2e23a6561..ae3f206f1 100644 --- a/gcloud/alpha/alloydb/instances/update +++ b/gcloud/alpha/alloydb/instances/update @@ -42,7 +42,7 @@ REQUIRED FLAGS OPTIONAL FLAGS --allowed-psc-projects=[ALLOWED_PSC_PROJECTS,...] Comma-separated list of allowed consumer projects to create endpoints - for Private Services Connect (PSC) connectivity for the instance. Only + for Private Service Connect (PSC) connectivity for the instance. Only instances in PSC-enabled clusters are allowed to set this field.(e.g., --allowed-psc-projects=project1,12345678,project2) diff --git a/gcloud/alpha/artifacts/docker/images/list b/gcloud/alpha/artifacts/docker/images/list index 3a53538d2..954607eef 100644 --- a/gcloud/alpha/artifacts/docker/images/list +++ b/gcloud/alpha/artifacts/docker/images/list @@ -57,7 +57,8 @@ POSITIONAL ARGUMENTS FLAGS --include-tags - If specified, all tags associated with each image digest are displayed. + If specified, tags associated with each image digest are displayed up + to a maximum of 100 tags per version. --occurrence-filter=OCCURRENCE_FILTER; default='kind="BUILD" OR kind="IMAGE" OR kind="DISCOVERY" OR kind="SBOM_REFERENCE"' A filter for the occurrences which will be summarized. diff --git a/gcloud/alpha/builds/get-default-service-account b/gcloud/alpha/builds/get-default-service-account new file mode 100644 index 000000000..afd6d0075 --- /dev/null +++ b/gcloud/alpha/builds/get-default-service-account @@ -0,0 +1,43 @@ +NAME + gcloud alpha builds get-default-service-account - get the default service + account for a project + +SYNOPSIS + gcloud alpha builds get-default-service-account [--region=REGION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Get the default service account for a project. + +EXAMPLES + To get the default service account for the project: + + $ gcloud alpha builds get-default-service-account + +FLAGS + --region=REGION + The region of the Cloud Build Service to use. Must be set to a + supported region name (e.g. us-central1). If unset, builds/region, + which is the default region to use when working with Cloud Build + resources, is used. If builds/region is unset, region is set to global. + Note: Region must be specified in 2nd gen repo; global is not + supported. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. These variants are also available: + + $ gcloud builds get-default-service-account + + $ gcloud beta builds get-default-service-account + diff --git a/gcloud/alpha/builds/help b/gcloud/alpha/builds/help index 686b701fd..9d5399517 100644 --- a/gcloud/alpha/builds/help +++ b/gcloud/alpha/builds/help @@ -42,6 +42,9 @@ COMMANDS describe (ALPHA) Get information about a particular build. + get-default-service-account + (ALPHA) Get the default service account for a project. + list (ALPHA) List builds. diff --git a/gcloud/alpha/composer/environments/help b/gcloud/alpha/composer/environments/help index 93d470171..422a76837 100644 --- a/gcloud/alpha/composer/environments/help +++ b/gcloud/alpha/composer/environments/help @@ -28,6 +28,12 @@ GROUPS (ALPHA) Manage Cloud Storage objects stored as part of Cloud Composer environments. + user-workloads-config-maps + (ALPHA) Create and manage user workloads ConfigMaps of environment. + + user-workloads-secrets + (ALPHA) Create and manage user workloads Secrets of environment. + COMMANDS COMMAND is one of the following: @@ -61,6 +67,10 @@ COMMANDS (ALPHA) List the Cloud Composer image version upgrades for a specific environment. + list-workloads + (ALPHA) List Composer workloads, supported in Composer 3 environments + or greater. + restart-web-server (ALPHA) Restart web server for a Cloud Composer environment. diff --git a/gcloud/alpha/composer/environments/list-workloads b/gcloud/alpha/composer/environments/list-workloads new file mode 100644 index 000000000..b04ab14aa --- /dev/null +++ b/gcloud/alpha/composer/environments/list-workloads @@ -0,0 +1,65 @@ +NAME + gcloud alpha composer environments list-workloads - list Composer + workloads, supported in Composer 3 environments or greater + +SYNOPSIS + gcloud alpha composer environments list-workloads + (ENVIRONMENT : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List Composer workloads, supported in Composer 3 environments or + greater. + +EXAMPLES + To display Composer workloads for the environment named environment-1, run: $ gcloud alpha composer environments list-workloads environment-1 + +POSITIONAL ARGUMENTS + Environment resource - The environment for which to display workloads. 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 environment 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. + + ENVIRONMENT + ID of the environment or fully qualified identifier for the + environment. + + To set the environment attribute: + ▸ provide the argument environment on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Region where Composer environment runs or in which to create the + environment. + + To set the location attribute: + ▸ provide the argument environment on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property composer/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta composer environments list-workloads + diff --git a/gcloud/alpha/composer/environments/user-workloads-config-maps/create b/gcloud/alpha/composer/environments/user-workloads-config-maps/create new file mode 100644 index 000000000..0c9eabdc4 --- /dev/null +++ b/gcloud/alpha/composer/environments/user-workloads-config-maps/create @@ -0,0 +1,73 @@ +NAME + gcloud alpha composer environments user-workloads-config-maps create - + create a user workloads ConfigMap + +SYNOPSIS + gcloud alpha composer environments user-workloads-config-maps create + --config-map-file-path=CONFIG_MAP_FILE_PATH + (--environment=ENVIRONMENT : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create a user workloads ConfigMap. + +EXAMPLES + To create a user workloads ConfigMap of the environment named env-1, run: + + $ gcloud alpha composer environments user-workloads-config-maps \ + create --environment=env-1 \ + --config-map-file-path=config_map.yaml + +REQUIRED FLAGS + --config-map-file-path=CONFIG_MAP_FILE_PATH + Path to a local file with a single Kubernetes ConfigMap in YAML format. + + Environment resource - The environment where the user workloads ConfigMap + must be created. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --environment 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. + + --environment=ENVIRONMENT + ID of the environment or fully qualified identifier for the + environment. + + To set the environment attribute: + ▸ provide the argument --environment on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + Region where Composer environment runs or in which to create the + environment. + + To set the location attribute: + ▸ provide the argument --environment on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property composer/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta composer environments user-workloads-config-maps create + diff --git a/gcloud/alpha/composer/environments/user-workloads-config-maps/delete b/gcloud/alpha/composer/environments/user-workloads-config-maps/delete new file mode 100644 index 000000000..cb0f4c7e1 --- /dev/null +++ b/gcloud/alpha/composer/environments/user-workloads-config-maps/delete @@ -0,0 +1,72 @@ +NAME + gcloud alpha composer environments user-workloads-config-maps delete - + delete a user workloads ConfigMap + +SYNOPSIS + gcloud alpha composer environments user-workloads-config-maps delete + [CONFIG_MAP_NAME] (--environment=ENVIRONMENT : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete a user workloads ConfigMap. + +EXAMPLES + To delete a user workloads ConfigMap of the environment named env-1, run: + + $ gcloud alpha composer environments user-workloads-config-maps \ + delete config-map-1 --environment=env-1 + +POSITIONAL ARGUMENTS + [CONFIG_MAP_NAME] + Name of the ConfigMap. + +REQUIRED FLAGS + Environment resource - The environment of the config_map. 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 --environment 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. + + --environment=ENVIRONMENT + ID of the environment or fully qualified identifier for the + environment. + + To set the environment attribute: + ▸ provide the argument --environment on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + Region where Composer environment runs or in which to create the + environment. + + To set the location attribute: + ▸ provide the argument --environment on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property composer/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta composer environments user-workloads-config-maps delete + diff --git a/gcloud/alpha/composer/environments/user-workloads-config-maps/describe b/gcloud/alpha/composer/environments/user-workloads-config-maps/describe new file mode 100644 index 000000000..9757c8ffd --- /dev/null +++ b/gcloud/alpha/composer/environments/user-workloads-config-maps/describe @@ -0,0 +1,74 @@ +NAME + gcloud alpha composer environments user-workloads-config-maps describe - + get details about a user workloads ConfigMap + +SYNOPSIS + gcloud alpha composer environments user-workloads-config-maps describe + [CONFIG_MAP_NAME] (--environment=ENVIRONMENT : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Get details about a user workloads ConfigMap. + +EXAMPLES + To get details about a user workloads ConfigMap of the environment named + env-1, run: + + $ gcloud alpha composer environments user-workloads-config-maps \ + describe config-map-1 --environment=env-1 + +POSITIONAL ARGUMENTS + [CONFIG_MAP_NAME] + Name of the ConfigMap. + +REQUIRED FLAGS + Environment resource - The environment of the config_map. 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 --environment 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. + + --environment=ENVIRONMENT + ID of the environment or fully qualified identifier for the + environment. + + To set the environment attribute: + ▸ provide the argument --environment on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + Region where Composer environment runs or in which to create the + environment. + + To set the location attribute: + ▸ provide the argument --environment on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property composer/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta composer environments user-workloads-config-maps \ + describe + diff --git a/gcloud/alpha/composer/environments/user-workloads-config-maps/help b/gcloud/alpha/composer/environments/user-workloads-config-maps/help new file mode 100644 index 000000000..0bf81ed20 --- /dev/null +++ b/gcloud/alpha/composer/environments/user-workloads-config-maps/help @@ -0,0 +1,44 @@ +NAME + gcloud alpha composer environments user-workloads-config-maps - create and + manage user workloads ConfigMaps of environment + +SYNOPSIS + gcloud alpha composer environments user-workloads-config-maps COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) The gcloud alpha composer environments user-workloads-config-maps + command group manages user workloads ConfigMaps of Cloud Composer + environments. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (ALPHA) Create a user workloads ConfigMap. + + delete + (ALPHA) Delete a user workloads ConfigMap. + + describe + (ALPHA) Get details about a user workloads ConfigMap. + + list + (ALPHA) List user workloads ConfigMaps. + + update + (ALPHA) Update a user workloads ConfigMap. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta composer environments user-workloads-config-maps + diff --git a/gcloud/alpha/composer/environments/user-workloads-config-maps/list b/gcloud/alpha/composer/environments/user-workloads-config-maps/list new file mode 100644 index 000000000..1dc0cd272 --- /dev/null +++ b/gcloud/alpha/composer/environments/user-workloads-config-maps/list @@ -0,0 +1,68 @@ +NAME + gcloud alpha composer environments user-workloads-config-maps list - list + user workloads ConfigMaps + +SYNOPSIS + gcloud alpha composer environments user-workloads-config-maps list + (--environment=ENVIRONMENT : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List user workloads ConfigMaps. + +EXAMPLES + To list user workloads ConfigMaps of the environment named env-1, run: + + $ gcloud alpha composer environments user-workloads-config-maps \ + list --environment=env-1 + +REQUIRED FLAGS + Environment resource - The environment to list user workloads ConfigMaps. + 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 --environment 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. + + --environment=ENVIRONMENT + ID of the environment or fully qualified identifier for the + environment. + + To set the environment attribute: + ▸ provide the argument --environment on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + Region where Composer environment runs or in which to create the + environment. + + To set the location attribute: + ▸ provide the argument --environment on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property composer/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta composer environments user-workloads-config-maps list + diff --git a/gcloud/alpha/composer/environments/user-workloads-config-maps/update b/gcloud/alpha/composer/environments/user-workloads-config-maps/update new file mode 100644 index 000000000..13591c8e6 --- /dev/null +++ b/gcloud/alpha/composer/environments/user-workloads-config-maps/update @@ -0,0 +1,73 @@ +NAME + gcloud alpha composer environments user-workloads-config-maps update - + update a user workloads ConfigMap + +SYNOPSIS + gcloud alpha composer environments user-workloads-config-maps update + --config-map-file-path=CONFIG_MAP_FILE_PATH + (--environment=ENVIRONMENT : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Update a user workloads ConfigMap. + +EXAMPLES + To update a user workloads ConfigMap of the environment named env-1, run: + + $ gcloud alpha composer environments user-workloads-config-maps \ + update --environment=env-1 \ + --config-map-file-path=config_map.yaml + +REQUIRED FLAGS + --config-map-file-path=CONFIG_MAP_FILE_PATH + Path to a local file with a single Kubernetes ConfigMap in YAML format. + + Environment resource - The environment where the user workloads ConfigMap + must be updated. 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 --environment 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. + + --environment=ENVIRONMENT + ID of the environment or fully qualified identifier for the + environment. + + To set the environment attribute: + ▸ provide the argument --environment on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + Region where Composer environment runs or in which to create the + environment. + + To set the location attribute: + ▸ provide the argument --environment on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property composer/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta composer environments user-workloads-config-maps update + diff --git a/gcloud/alpha/composer/environments/user-workloads-secrets/create b/gcloud/alpha/composer/environments/user-workloads-secrets/create new file mode 100644 index 000000000..3b48ada80 --- /dev/null +++ b/gcloud/alpha/composer/environments/user-workloads-secrets/create @@ -0,0 +1,72 @@ +NAME + gcloud alpha composer environments user-workloads-secrets create - create a + user workloads Secret + +SYNOPSIS + gcloud alpha composer environments user-workloads-secrets create + --secret-file-path=SECRET_FILE_PATH + (--environment=ENVIRONMENT : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create a user workloads Secret. + +EXAMPLES + To create a user workloads Secret of the environment named env-1, run: + + $ gcloud alpha composer environments user-workloads-secrets create \ + --environment=env-1 --secret-file-path=secret.yaml + +REQUIRED FLAGS + --secret-file-path=SECRET_FILE_PATH + Path to a local file with a single Kubernetes Secret in YAML format. + + Environment resource - The environment where the user workloads Secret + must be created. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --environment 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. + + --environment=ENVIRONMENT + ID of the environment or fully qualified identifier for the + environment. + + To set the environment attribute: + ▸ provide the argument --environment on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + Region where Composer environment runs or in which to create the + environment. + + To set the location attribute: + ▸ provide the argument --environment on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property composer/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta composer environments user-workloads-secrets create + diff --git a/gcloud/alpha/composer/environments/user-workloads-secrets/delete b/gcloud/alpha/composer/environments/user-workloads-secrets/delete new file mode 100644 index 000000000..9a26ad845 --- /dev/null +++ b/gcloud/alpha/composer/environments/user-workloads-secrets/delete @@ -0,0 +1,72 @@ +NAME + gcloud alpha composer environments user-workloads-secrets delete - delete a + user workloads Secret + +SYNOPSIS + gcloud alpha composer environments user-workloads-secrets delete + [SECRET_NAME] (--environment=ENVIRONMENT : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete a user workloads Secret. + +EXAMPLES + To delete a user workloads Secret of the environment named env-1, run: + + $ gcloud alpha composer environments user-workloads-secrets delete \ + secret-1 --environment=env-1 + +POSITIONAL ARGUMENTS + [SECRET_NAME] + Name of the Secret. + +REQUIRED FLAGS + Environment resource - The environment of the secret. 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 --environment 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. + + --environment=ENVIRONMENT + ID of the environment or fully qualified identifier for the + environment. + + To set the environment attribute: + ▸ provide the argument --environment on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + Region where Composer environment runs or in which to create the + environment. + + To set the location attribute: + ▸ provide the argument --environment on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property composer/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta composer environments user-workloads-secrets delete + diff --git a/gcloud/alpha/composer/environments/user-workloads-secrets/describe b/gcloud/alpha/composer/environments/user-workloads-secrets/describe new file mode 100644 index 000000000..484a2cf6c --- /dev/null +++ b/gcloud/alpha/composer/environments/user-workloads-secrets/describe @@ -0,0 +1,73 @@ +NAME + gcloud alpha composer environments user-workloads-secrets describe - get + details about a user workloads Secret + +SYNOPSIS + gcloud alpha composer environments user-workloads-secrets describe + [SECRET_NAME] (--environment=ENVIRONMENT : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Get details about a user workloads Secret. + +EXAMPLES + To get details about a user workloads Secret of the environment named + env-1, run: + + $ gcloud alpha composer environments user-workloads-secrets \ + describe secret-1 --environment=env-1 + +POSITIONAL ARGUMENTS + [SECRET_NAME] + Name of the Secret. + +REQUIRED FLAGS + Environment resource - The environment of the secret. 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 --environment 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. + + --environment=ENVIRONMENT + ID of the environment or fully qualified identifier for the + environment. + + To set the environment attribute: + ▸ provide the argument --environment on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + Region where Composer environment runs or in which to create the + environment. + + To set the location attribute: + ▸ provide the argument --environment on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property composer/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta composer environments user-workloads-secrets describe + diff --git a/gcloud/alpha/composer/environments/user-workloads-secrets/help b/gcloud/alpha/composer/environments/user-workloads-secrets/help new file mode 100644 index 000000000..e0a1bb5b2 --- /dev/null +++ b/gcloud/alpha/composer/environments/user-workloads-secrets/help @@ -0,0 +1,44 @@ +NAME + gcloud alpha composer environments user-workloads-secrets - create and + manage user workloads Secrets of environment + +SYNOPSIS + gcloud alpha composer environments user-workloads-secrets COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) The gcloud alpha composer environments user-workloads-secrets + command group manages user workloads Secrets of Cloud Composer + environments. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (ALPHA) Create a user workloads Secret. + + delete + (ALPHA) Delete a user workloads Secret. + + describe + (ALPHA) Get details about a user workloads Secret. + + list + (ALPHA) List user workloads Secrets. + + update + (ALPHA) Update a user workloads Secret. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta composer environments user-workloads-secrets + diff --git a/gcloud/alpha/composer/environments/user-workloads-secrets/list b/gcloud/alpha/composer/environments/user-workloads-secrets/list new file mode 100644 index 000000000..eacf19685 --- /dev/null +++ b/gcloud/alpha/composer/environments/user-workloads-secrets/list @@ -0,0 +1,68 @@ +NAME + gcloud alpha composer environments user-workloads-secrets list - list user + workloads Secrets + +SYNOPSIS + gcloud alpha composer environments user-workloads-secrets list + (--environment=ENVIRONMENT : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List user workloads Secrets. + +EXAMPLES + To list user workloads Secrets of the environment named env-1, run: + + $ gcloud alpha composer environments user-workloads-secrets list \ + --environment=env-1 + +REQUIRED FLAGS + Environment resource - The environment to list user workloads Secrets. 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 --environment 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. + + --environment=ENVIRONMENT + ID of the environment or fully qualified identifier for the + environment. + + To set the environment attribute: + ▸ provide the argument --environment on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + Region where Composer environment runs or in which to create the + environment. + + To set the location attribute: + ▸ provide the argument --environment on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property composer/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta composer environments user-workloads-secrets list + diff --git a/gcloud/alpha/composer/environments/user-workloads-secrets/update b/gcloud/alpha/composer/environments/user-workloads-secrets/update new file mode 100644 index 000000000..33decab3d --- /dev/null +++ b/gcloud/alpha/composer/environments/user-workloads-secrets/update @@ -0,0 +1,72 @@ +NAME + gcloud alpha composer environments user-workloads-secrets update - update a + user workloads Secret + +SYNOPSIS + gcloud alpha composer environments user-workloads-secrets update + --secret-file-path=SECRET_FILE_PATH + (--environment=ENVIRONMENT : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Update a user workloads Secret. + +EXAMPLES + To update a user workloads Secret of the environment named env-1, run: + + $ gcloud alpha composer environments user-workloads-secrets update \ + --environment=env-1 --secret-file-path=secret.yaml + +REQUIRED FLAGS + --secret-file-path=SECRET_FILE_PATH + Path to a local file with a single Kubernetes Secret in YAML format. + + Environment resource - The environment where the user workloads Secret + must be updated. 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 --environment 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. + + --environment=ENVIRONMENT + ID of the environment or fully qualified identifier for the + environment. + + To set the environment attribute: + ▸ provide the argument --environment on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + Region where Composer environment runs or in which to create the + environment. + + To set the location attribute: + ▸ provide the argument --environment on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property composer/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta composer environments user-workloads-secrets update + diff --git a/gcloud/alpha/compute/help b/gcloud/alpha/compute/help index 3d79c5db5..55d066202 100644 --- a/gcloud/alpha/compute/help +++ b/gcloud/alpha/compute/help @@ -185,6 +185,12 @@ GROUPS ssl-policies (ALPHA) List, create, delete and update Compute Engine SSL policies. + storage-pool-types + (ALPHA) Read storage pool types. + + storage-pools + (ALPHA) Read and manipulate storage pools. + target-grpc-proxies (ALPHA) Manage Compute Engine target gRPC proxy resources. diff --git a/gcloud/alpha/compute/images/create b/gcloud/alpha/compute/images/create index e4ae2cc9e..7312006de 100644 --- a/gcloud/alpha/compute/images/create +++ b/gcloud/alpha/compute/images/create @@ -13,6 +13,8 @@ SYNOPSIS [--key-exchange-key-file=[KEK_VALUE,...]] [--labels=[KEY=VALUE,...]] [--licenses=[LICENSES,...]] [--platform-key-file=PLATFORM_KEY_FILE] [--no-require-csek-key-create] + [--rollout-override=[default_rollout_time=DEFAULT_ROLLOUT_TIME], + [location_rollout_policies=LOCATION_ROLLOUT_POLICIES]] [--signature-database-file=[DB_VALUE,...]] [--source-disk-project=SOURCE_DISK_PROJECT] [--source-disk-zone=SOURCE_DISK_ZONE] @@ -189,6 +191,26 @@ OPTIONAL FLAGS for more details. Enabled by default, use --no-require-csek-key-create to disable. + --rollout-override=[default_rollout_time=DEFAULT_ROLLOUT_TIME],[location_rollout_policies=LOCATION_ROLLOUT_POLICIES] + A rollout policy for the image. A rollout policy is used to restrict + the zones where this image is accessible when using a zonal image + family reference. When specified, the rollout policy overrides per-zone + references to the image through the associated image family. When the + rollout policy does not include the user specified zone, or if the zone + is rolled out, this image is accessible. + + default_rollout_time + This is an optional RFC3339 timestamp on or after which + the update is considered rolled out to any zone that is not + explicitly stated. + + location_rollout_policies + Location based rollout policies to apply to the resource. + Currently only zone names are supported as the key and must be + represented as valid URLs, like: zones/us-central1-a. + The value expects an RFC3339 timestamp on or after which the update + is considered rolled out to the specified location. + --signature-database-file=[DB_VALUE,...] Comma-separated list of file paths that point to valid X.509 certificates in DER format or raw binary files. When you create a diff --git a/gcloud/alpha/compute/instance-groups/managed/resize-requests/cancel b/gcloud/alpha/compute/instance-groups/managed/resize-requests/cancel index 1d4edaefe..f29793157 100644 --- a/gcloud/alpha/compute/instance-groups/managed/resize-requests/cancel +++ b/gcloud/alpha/compute/instance-groups/managed/resize-requests/cancel @@ -69,7 +69,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud compute instance-groups managed resize-requests cancel $ gcloud beta compute instance-groups managed resize-requests cancel diff --git a/gcloud/alpha/compute/instance-groups/managed/resize-requests/create b/gcloud/alpha/compute/instance-groups/managed/resize-requests/create index c5516c84b..659050d51 100644 --- a/gcloud/alpha/compute/instance-groups/managed/resize-requests/create +++ b/gcloud/alpha/compute/instance-groups/managed/resize-requests/create @@ -73,7 +73,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud compute instance-groups managed resize-requests create $ gcloud beta compute instance-groups managed resize-requests create diff --git a/gcloud/alpha/compute/instance-groups/managed/resize-requests/delete b/gcloud/alpha/compute/instance-groups/managed/resize-requests/delete index 22b4cb2e8..fd6631ac2 100644 --- a/gcloud/alpha/compute/instance-groups/managed/resize-requests/delete +++ b/gcloud/alpha/compute/instance-groups/managed/resize-requests/delete @@ -63,7 +63,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud compute instance-groups managed resize-requests delete $ gcloud beta compute instance-groups managed resize-requests delete diff --git a/gcloud/alpha/compute/instance-groups/managed/resize-requests/describe b/gcloud/alpha/compute/instance-groups/managed/resize-requests/describe index e0de86271..09a349018 100644 --- a/gcloud/alpha/compute/instance-groups/managed/resize-requests/describe +++ b/gcloud/alpha/compute/instance-groups/managed/resize-requests/describe @@ -62,7 +62,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud compute instance-groups managed resize-requests describe $ gcloud beta compute instance-groups managed resize-requests \ describe diff --git a/gcloud/alpha/compute/instance-groups/managed/resize-requests/help b/gcloud/alpha/compute/instance-groups/managed/resize-requests/help index 3bbdb1cae..e250bad82 100644 --- a/gcloud/alpha/compute/instance-groups/managed/resize-requests/help +++ b/gcloud/alpha/compute/instance-groups/managed/resize-requests/help @@ -37,7 +37,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud compute instance-groups managed resize-requests $ gcloud beta compute instance-groups managed resize-requests diff --git a/gcloud/alpha/compute/instance-groups/managed/resize-requests/list b/gcloud/alpha/compute/instance-groups/managed/resize-requests/list index ad51d4e36..e079bf98d 100644 --- a/gcloud/alpha/compute/instance-groups/managed/resize-requests/list +++ b/gcloud/alpha/compute/instance-groups/managed/resize-requests/list @@ -91,7 +91,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud compute instance-groups managed resize-requests list $ gcloud beta compute instance-groups managed resize-requests list diff --git a/gcloud/alpha/compute/instance-templates/create b/gcloud/alpha/compute/instance-templates/create index a35b3ec57..2eb7407f0 100644 --- a/gcloud/alpha/compute/instance-templates/create +++ b/gcloud/alpha/compute/instance-templates/create @@ -11,6 +11,7 @@ SYNOPSIS [--boot-disk-size=BOOT_DISK_SIZE] [--boot-disk-type=BOOT_DISK_TYPE] [--can-ip-forward] [--configure-disk=[PROPERTY=VALUE,...]] [--create-disk=[PROPERTY=VALUE,...]] [--description=DESCRIPTION] + [--discard-local-ssds-at-termination-timestamp=DISCARD_LOCAL_SSDS_AT_TERMINATION_TIMESTAMP] [--disk=[auto-delete=AUTO-DELETE], [boot=BOOT],[device-name=DEVICE-NAME],[mode=MODE],[name=NAME]] [--[no-]enable-nested-virtualization] [--[no-]enable-uefi-networking] @@ -345,6 +346,21 @@ FLAGS --description=DESCRIPTION Specifies a textual description for the instance template. + --discard-local-ssds-at-termination-timestamp=DISCARD_LOCAL_SSDS_AT_TERMINATION_TIMESTAMP + Required and only allowed for VMs that have one or more local SSDs, use + --termination-action=STOP (default), and use either --max-run-duration + or --termination-time. This flag indicates whether you want Compute + Engine to discard (true) or preserve (false) local SSD data when the + VM's terminationTimestamp is reached. + + If set to false, Compute Engine will preserve local SSD data by + including the --discard-local-ssd=false flag in the automatic + termination command. The --discard-local-ssd=false flag preserves local + SSD data by migrating it to persistent storage until you rerun the VM. + Importantly, preserving local SSD data incurs costs and is subject to + restrictions. For more information, see + https://cloud.google.com/compute/docs/disks/local-ssd#stop_instance. + --disk=[auto-delete=AUTO-DELETE],[boot=BOOT],[device-name=DEVICE-NAME],[mode=MODE],[name=NAME] Attaches an existing persistent disk to the instances. diff --git a/gcloud/alpha/compute/instances/bulk/create b/gcloud/alpha/compute/instances/bulk/create index 220a4f601..aa537e985 100644 --- a/gcloud/alpha/compute/instances/bulk/create +++ b/gcloud/alpha/compute/instances/bulk/create @@ -14,6 +14,7 @@ SYNOPSIS [--boot-disk-size=BOOT_DISK_SIZE] [--boot-disk-type=BOOT_DISK_TYPE] [--can-ip-forward] [--count=COUNT] [--create-disk=[PROPERTY=VALUE,...]] [--description=DESCRIPTION] + [--discard-local-ssds-at-termination-timestamp=DISCARD_LOCAL_SSDS_AT_TERMINATION_TIMESTAMP] [--disk=[boot=BOOT], [device-name=DEVICE-NAME],[name=NAME],[scope=SCOPE]] [--enable-display-device] [--[no-]enable-nested-virtualization] @@ -381,6 +382,21 @@ OPTIONAL FLAGS --description=DESCRIPTION Specifies a textual description of the instances. + --discard-local-ssds-at-termination-timestamp=DISCARD_LOCAL_SSDS_AT_TERMINATION_TIMESTAMP + Required and only allowed for VMs that have one or more local SSDs, use + --termination-action=STOP (default), and use either --max-run-duration + or --termination-time. This flag indicates whether you want Compute + Engine to discard (true) or preserve (false) local SSD data when the + VM's terminationTimestamp is reached. + + If set to false, Compute Engine will preserve local SSD data by + including the --discard-local-ssd=false flag in the automatic + termination command. The --discard-local-ssd=false flag preserves local + SSD data by migrating it to persistent storage until you rerun the VM. + Importantly, preserving local SSD data incurs costs and is subject to + restrictions. For more information, see + https://cloud.google.com/compute/docs/disks/local-ssd#stop_instance. + --disk=[boot=BOOT],[device-name=DEVICE-NAME],[name=NAME],[scope=SCOPE] Attaches persistent disks to the instances. The disks specified must already exist. diff --git a/gcloud/alpha/compute/instances/create b/gcloud/alpha/compute/instances/create index 63e4f882c..350b38859 100644 --- a/gcloud/alpha/compute/instances/create +++ b/gcloud/alpha/compute/instances/create @@ -14,6 +14,7 @@ SYNOPSIS [--can-ip-forward] [--create-disk=[PROPERTY=VALUE,...]] [--csek-key-file=FILE] [--deletion-protection] [--description=DESCRIPTION] + [--discard-local-ssds-at-termination-timestamp=DISCARD_LOCAL_SSDS_AT_TERMINATION_TIMESTAMP] [--disk=[auto-delete=AUTO-DELETE],[boot=BOOT],[device-name=DEVICE-NAME], [force-attach=FORCE-ATTACH],[mode=MODE],[name=NAME],[scope=SCOPE]] [--enable-display-device] [--[no-]enable-nested-virtualization] @@ -445,6 +446,21 @@ FLAGS --description=DESCRIPTION Specifies a textual description of the instances. + --discard-local-ssds-at-termination-timestamp=DISCARD_LOCAL_SSDS_AT_TERMINATION_TIMESTAMP + Required and only allowed for VMs that have one or more local SSDs, use + --termination-action=STOP (default), and use either --max-run-duration + or --termination-time. This flag indicates whether you want Compute + Engine to discard (true) or preserve (false) local SSD data when the + VM's terminationTimestamp is reached. + + If set to false, Compute Engine will preserve local SSD data by + including the --discard-local-ssd=false flag in the automatic + termination command. The --discard-local-ssd=false flag preserves local + SSD data by migrating it to persistent storage until you rerun the VM. + Importantly, preserving local SSD data incurs costs and is subject to + restrictions. For more information, see + https://cloud.google.com/compute/docs/disks/local-ssd#stop_instance. + --disk=[auto-delete=AUTO-DELETE],[boot=BOOT],[device-name=DEVICE-NAME],[force-attach=FORCE-ATTACH],[mode=MODE],[name=NAME],[scope=SCOPE] Attaches an existing persistent disk to the instances. @@ -585,9 +601,9 @@ FLAGS --ipv6-public-ptr-domain=IPV6_PUBLIC_PTR_DOMAIN Assigns a custom PTR domain for the external IPv6 in the IPv6 access - configuration of instance. If its value is not specified, the default - PTR record will be used. This option can only be specified for the - default network interface, nic0. + configuration of instance. If unspecified or specified to be an empty + string, the default PTR record will be used. This option can only be + specified for the default network interface, nic0. --key-revocation-action-type=POLICY Specifies the behavior of the instance when the KMS key of one of its diff --git a/gcloud/alpha/compute/instances/set-scheduling b/gcloud/alpha/compute/instances/set-scheduling index 9fb62eb9f..b7477e6c8 100644 --- a/gcloud/alpha/compute/instances/set-scheduling +++ b/gcloud/alpha/compute/instances/set-scheduling @@ -11,6 +11,8 @@ SYNOPSIS [--min-node-cpu=MIN_NODE_CPU] [--[no-]preemptible] [--provisioning-model=PROVISIONING_MODEL] [--[no-]restart-on-failure] [--zone=ZONE] + [--clear-discard-local-ssds-at-termination-timestamp + | --discard-local-ssds-at-termination-timestamp=DISCARD_LOCAL_SSDS_AT_TERMINATION_TIMESTAMP] [--clear-instance-termination-action | --instance-termination-action=INSTANCE_TERMINATION_ACTION] [--clear-max-run-duration | --max-run-duration=MAX_RUN_DURATION] @@ -118,6 +120,29 @@ FLAGS Alternatively, the zone can be stored in the environment variable CLOUDSDK_COMPUTE_ZONE. + Discard Local SSDs At Termination Timestamp + + At most one of these can be specified: + + --clear-discard-local-ssds-at-termination-timestamp + Removes the discard-local-ssds-at-termination-timestamp field from + the scheduling options. + + --discard-local-ssds-at-termination-timestamp=DISCARD_LOCAL_SSDS_AT_TERMINATION_TIMESTAMP + Required and only allowed for VMs that have one or more local SSDs, + use --termination-action=STOP (default), and use either + --max-run-duration or --termination-time. This flag indicates whether + you want Compute Engine to discard (true) or preserve (false) local + SSD data when the VM's terminationTimestamp is reached. + + If set to false, Compute Engine will preserve local SSD data by + including the --discard-local-ssd=false flag in the automatic + termination command. The --discard-local-ssd=false flag preserves + local SSD data by migrating it to persistent storage until you rerun + the VM. Importantly, preserving local SSD data incurs costs and is + subject to restrictions. For more information, see + https://cloud.google.com/compute/docs/disks/local-ssd#stop_instance. + Instance Termination Action At most one of these can be specified: diff --git a/gcloud/alpha/compute/queued-resources/create b/gcloud/alpha/compute/queued-resources/create index f46de81a9..6e4a9681e 100644 --- a/gcloud/alpha/compute/queued-resources/create +++ b/gcloud/alpha/compute/queued-resources/create @@ -15,6 +15,7 @@ SYNOPSIS [--boot-disk-size=BOOT_DISK_SIZE] [--boot-disk-type=BOOT_DISK_TYPE] [--can-ip-forward] [--count=COUNT] [--create-disk=[PROPERTY=VALUE,...]] [--description=DESCRIPTION] + [--discard-local-ssds-at-termination-timestamp=DISCARD_LOCAL_SSDS_AT_TERMINATION_TIMESTAMP] [--disk=[boot=BOOT], [device-name=DEVICE-NAME],[name=NAME],[scope=SCOPE]] [--enable-display-device] [--[no-]enable-nested-virtualization] @@ -365,6 +366,21 @@ OPTIONAL FLAGS --description=DESCRIPTION Specifies a textual description of the instances. + --discard-local-ssds-at-termination-timestamp=DISCARD_LOCAL_SSDS_AT_TERMINATION_TIMESTAMP + Required and only allowed for VMs that have one or more local SSDs, use + --termination-action=STOP (default), and use either --max-run-duration + or --termination-time. This flag indicates whether you want Compute + Engine to discard (true) or preserve (false) local SSD data when the + VM's terminationTimestamp is reached. + + If set to false, Compute Engine will preserve local SSD data by + including the --discard-local-ssd=false flag in the automatic + termination command. The --discard-local-ssd=false flag preserves local + SSD data by migrating it to persistent storage until you rerun the VM. + Importantly, preserving local SSD data incurs costs and is subject to + restrictions. For more information, see + https://cloud.google.com/compute/docs/disks/local-ssd#stop_instance. + --disk=[boot=BOOT],[device-name=DEVICE-NAME],[name=NAME],[scope=SCOPE] Attaches persistent disks to the instances. The disks specified must already exist. diff --git a/gcloud/alpha/compute/storage-pool-types/describe b/gcloud/alpha/compute/storage-pool-types/describe new file mode 100644 index 000000000..507ddb979 --- /dev/null +++ b/gcloud/alpha/compute/storage-pool-types/describe @@ -0,0 +1,72 @@ +NAME + gcloud alpha compute storage-pool-types describe - describe a storage pool + type + +SYNOPSIS + gcloud alpha compute storage-pool-types describe + (STORAGE_POOL_TYPE : --zone=ZONE) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe a storage pool. + +EXAMPLES + To retrieve a single storage pool type and print its properties, run the + following command: + + $ gcloud alpha compute storage-pool-types describe my-storage-pool + +POSITIONAL ARGUMENTS + Storage pool type resource - Name of the storage pool you want to inspect. + 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 storage_pool_type on the command line with a + fully specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + STORAGE_POOL_TYPE + ID of the storage pool type or fully qualified identifier for the + storage pool type. + + To set the storage_pool_type attribute: + ▸ provide the argument storage_pool_type 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 storage_pool_type 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/alpha API. The full documentation for this + API can be found at: https://cloud.google.com/compute/ + +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 storage-pool-types describe + + $ gcloud beta compute storage-pool-types describe + diff --git a/gcloud/alpha/compute/storage-pool-types/help b/gcloud/alpha/compute/storage-pool-types/help new file mode 100644 index 000000000..8a8365a3e --- /dev/null +++ b/gcloud/alpha/compute/storage-pool-types/help @@ -0,0 +1,33 @@ +NAME + gcloud alpha compute storage-pool-types - read storage pool types + +SYNOPSIS + gcloud alpha compute storage-pool-types COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Read Compute Engine storage pool types. + +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 storage pool type. + + list + (ALPHA) View storage pools types. + +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 storage-pool-types + + $ gcloud beta compute storage-pool-types + diff --git a/gcloud/alpha/compute/storage-pool-types/list b/gcloud/alpha/compute/storage-pool-types/list new file mode 100644 index 000000000..b09b333af --- /dev/null +++ b/gcloud/alpha/compute/storage-pool-types/list @@ -0,0 +1,71 @@ +NAME + gcloud alpha compute storage-pool-types list - view storage pools types + +SYNOPSIS + gcloud alpha compute storage-pool-types list [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) View storage pools. + +EXAMPLES + To display all storage pool types and their locations visible the project, + run the following command: + + $ gcloud alpha compute storage-pool-types list + + The --filter option can be used to filter down available options. To + display all available storage pool types in US-based zones, run the + following command: + + $ gcloud alpha compute storage-pool-types list --filter="zone ~ us" + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the compute/alpha API. The full documentation for this + API can be found at: https://cloud.google.com/compute/ + +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 storage-pool-types list + + $ gcloud beta compute storage-pool-types list + diff --git a/gcloud/alpha/compute/storage-pools/create b/gcloud/alpha/compute/storage-pools/create new file mode 100644 index 000000000..1a995ffd1 --- /dev/null +++ b/gcloud/alpha/compute/storage-pools/create @@ -0,0 +1,129 @@ +NAME + gcloud alpha compute storage-pools create - create a storage pool + +SYNOPSIS + gcloud alpha compute storage-pools create STORAGE_POOL + --provisioned-capacity=PROVISIONED_CAPACITY + --storage-pool-type=STORAGE_POOL_TYPE [--async] + [--capacity-provisioning-type=CAPACITY_PROVISIONING_TYPE] + [--description=DESCRIPTION] + [--performance-provisioning-type=PERFORMANCE_PROVISIONING_TYPE] + [--provisioned-iops=PROVISIONED_IOPS] + [--provisioned-throughput=PROVISIONED_THROUGHPUT] [--zone=ZONE] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create a storage pool. + +EXAMPLES + To create a new storage pool named my-storage-pool, run the following + command: + + $ gcloud alpha compute storage-pools create my-storage-pool \ + --storage-pool-type=hyperdisk-throughput \ + --provisioned-capacity=10TB --provisioned-throughput=200 + +POSITIONAL ARGUMENTS + Storage pool resource - The name of the storage pool you want to create. + 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 storage_pool on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + To set the zone attribute: + ◆ provide the argument storage_pool on the command line with a fully + specified name; + ◆ provide the argument --zone on the command line; + ◆ set the property compute/zone. + + This must be specified. + + STORAGE_POOL + ID of the storage pool or fully qualified identifier for the storage + pool. + + To set the storage_pool attribute: + ▸ provide the argument storage_pool on the command line. + +REQUIRED FLAGS + --provisioned-capacity=PROVISIONED_CAPACITY + Provisioned capacity of the storage pool. + + Storage pool type resource - Type of the storage pool. 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 --storage-pool-type on the command line with a + fully specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + To set the zone attribute: + ◆ provide the argument --storage-pool-type on the command line with a + fully specified name; + ◆ provide the argument --zone on the command line; + ◆ set the property compute/zone. + + This must be specified. + + --storage-pool-type=STORAGE_POOL_TYPE + ID of the storage pool type or fully qualified identifier for the + storage pool type. + + To set the storage-pool-type attribute: + ▸ provide the argument --storage-pool-type on the command line. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --capacity-provisioning-type=CAPACITY_PROVISIONING_TYPE + Capacity provisioning type. CAPACITY_PROVISIONING_TYPE must be one of: + advanced, standard. + + --description=DESCRIPTION + Description of the storage pool. + + --performance-provisioning-type=PERFORMANCE_PROVISIONING_TYPE + Performance provisioning type. PERFORMANCE_PROVISIONING_TYPE must be + one of: advanced, standard. + + --provisioned-iops=PROVISIONED_IOPS + IOPS with which to provision the pool. + + --provisioned-throughput=PROVISIONED_THROUGHPUT + Throughput in MB/s with which to provision the pool. + + --zone=ZONE + For resources [storage pool, storage pool type], provides fallback + value for resource zone attribute. When the resource's full URI path is + not provided, zone will fallback to this flag value. + +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/alpha API. The full documentation for this + API can be found at: https://cloud.google.com/compute/ + +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 storage-pools create + + $ gcloud beta compute storage-pools create + diff --git a/gcloud/alpha/compute/storage-pools/delete b/gcloud/alpha/compute/storage-pools/delete new file mode 100644 index 000000000..e21271046 --- /dev/null +++ b/gcloud/alpha/compute/storage-pools/delete @@ -0,0 +1,76 @@ +NAME + gcloud alpha compute storage-pools delete - delete a storage pool + +SYNOPSIS + gcloud alpha compute storage-pools delete (STORAGE_POOL : --zone=ZONE) + [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Deleta a storage pool. + +EXAMPLES + To delete a single storage pool named my-storage-pool, run the following + command: + + $ gcloud alpha compute storage-pools delete my-storage-pool + +POSITIONAL ARGUMENTS + Storage pool resource - Name of the storage pool 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 storage_pool on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + STORAGE_POOL + ID of the storage pool or fully qualified identifier for the storage + pool. + + To set the storage_pool attribute: + ▸ provide the argument storage_pool 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 storage_pool 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/alpha API. The full documentation for this + API can be found at: https://cloud.google.com/compute/ + +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 storage-pools delete + + $ gcloud beta compute storage-pools delete + diff --git a/gcloud/alpha/compute/storage-pools/describe b/gcloud/alpha/compute/storage-pools/describe new file mode 100644 index 000000000..8738ca2fb --- /dev/null +++ b/gcloud/alpha/compute/storage-pools/describe @@ -0,0 +1,71 @@ +NAME + gcloud alpha compute storage-pools describe - describe a storage pool + +SYNOPSIS + gcloud alpha compute storage-pools describe (STORAGE_POOL : --zone=ZONE) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe a storage pool. + +EXAMPLES + To retrieve a single storage pool and print its properties, run the + following command: + + $ gcloud alpha compute storage-pools describe my-storage-pool + +POSITIONAL ARGUMENTS + Storage pool resource - Name of the storage pool you want to inspect. 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 storage_pool on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + STORAGE_POOL + ID of the storage pool or fully qualified identifier for the storage + pool. + + To set the storage_pool attribute: + ▸ provide the argument storage_pool 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 storage_pool 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/alpha API. The full documentation for this + API can be found at: https://cloud.google.com/compute/ + +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 storage-pools describe + + $ gcloud beta compute storage-pools describe + diff --git a/gcloud/alpha/compute/storage-pools/get-iam-policy b/gcloud/alpha/compute/storage-pools/get-iam-policy new file mode 100644 index 000000000..0586bb282 --- /dev/null +++ b/gcloud/alpha/compute/storage-pools/get-iam-policy @@ -0,0 +1,99 @@ +NAME + gcloud alpha compute storage-pools get-iam-policy - get the IAM policy of a + storage pool + +SYNOPSIS + gcloud alpha compute storage-pools get-iam-policy + (STORAGE_POOL : --zone=ZONE) [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Get the IAM policy of a storage pool. + +EXAMPLES + The following command retrieves the IAM configuration of the specified + storage pool. + + $ gcloud alpha compute storage-pools get-iam-policy my-storage-pool + +POSITIONAL ARGUMENTS + Storage pool resource - Storage pool you want to get the IAM permissions + of. 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 storage_pool on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + STORAGE_POOL + ID of the storage pool or fully qualified identifier for the storage + pool. + + To set the storage_pool attribute: + ▸ provide the argument storage_pool 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 storage_pool on the command line with a + fully specified name; + ▸ provide the argument --zone on the command line; + ▸ set the property compute/zone. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the compute/alpha API. The full documentation for this + API can be found at: https://cloud.google.com/compute/ + +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 storage-pools get-iam-policy + + $ gcloud beta compute storage-pools get-iam-policy + diff --git a/gcloud/alpha/compute/storage-pools/help b/gcloud/alpha/compute/storage-pools/help new file mode 100644 index 000000000..77436fe5a --- /dev/null +++ b/gcloud/alpha/compute/storage-pools/help @@ -0,0 +1,51 @@ +NAME + gcloud alpha compute storage-pools - read and manipulate storage pools + +SYNOPSIS + gcloud alpha compute storage-pools COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Read and manipulate Compute Engine storage pools. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (ALPHA) Create a storage pool. + + delete + (ALPHA) Delete a storage pool. + + describe + (ALPHA) Describe a storage pool. + + get-iam-policy + (ALPHA) Get the IAM policy of a storage pool. + + list + (ALPHA) View storage pools. + + list-disks + (ALPHA) View the disks that are in a storage pool. + + set-iam-policy + (ALPHA) Set the IAM policy of the given storage pool. + + update + (ALPHA) Update a storage pool. + +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 storage-pools + + $ gcloud beta compute storage-pools + diff --git a/gcloud/alpha/compute/storage-pools/list b/gcloud/alpha/compute/storage-pools/list new file mode 100644 index 000000000..3b73f16ae --- /dev/null +++ b/gcloud/alpha/compute/storage-pools/list @@ -0,0 +1,94 @@ +NAME + gcloud alpha compute storage-pools list - view storage pools + +SYNOPSIS + gcloud alpha compute storage-pools list [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) View storage pools. + + The compact default output format is explained below: + + The type column contains all three types -- storage pool type, capacity and + performance. For example, the value + + > "Hdb/Adv/Std" + + means the storage pool type is "hyperdisk-balanced", its capacity type is + "advanced", and its performance type is "standard." + + The list of storage pool abbreviations is as follows: + + ▪ HdB: Hyperdisk Balanced + ▪ HdT: Hyperdisk Throughput + + The list of capacity/performance abbreviations is as follows: + + ▪ Adv: Advanced + ▪ Std: Standard + + The capacity, iops and throughput columns describe used, provisioned, the + utilization rate. For example, the following value for capacity: + + 40 / 50 (80%) + + means 40 TB of it is used, 50 TB provisioned, and its utilization rate is + 80%. The utilization rate is equivalent to used capacity divided by + provisioned capacity. + +EXAMPLES + To display all storage pools in all regions and zones, run the following + command: + + $ gcloud alpha compute storage-pools list + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + +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/alpha API. The full documentation for this + API can be found at: https://cloud.google.com/compute/ + +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 storage-pools list + + $ gcloud beta compute storage-pools list + diff --git a/gcloud/alpha/compute/storage-pools/list-disks b/gcloud/alpha/compute/storage-pools/list-disks new file mode 100644 index 000000000..ef49b25cb --- /dev/null +++ b/gcloud/alpha/compute/storage-pools/list-disks @@ -0,0 +1,72 @@ +NAME + gcloud alpha compute storage-pools list-disks - view the disks that are in + a storage pool + +SYNOPSIS + gcloud alpha compute storage-pools list-disks (STORAGE_POOL : --zone=ZONE) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) View the disks that are in a given storage pool. + +EXAMPLES + The following command retrieves all disks belonging to a storage pool and + lists them: + + $ gcloud alpha compute storage-pools list-disks my-storage-pool + +POSITIONAL ARGUMENTS + Storage pool resource - Name of the storage pool you want to inspect. 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 storage_pool on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + STORAGE_POOL + ID of the storage pool or fully qualified identifier for the storage + pool. + + To set the storage_pool attribute: + ▸ provide the argument storage_pool 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 storage_pool 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/alpha API. The full documentation for this + API can be found at: https://cloud.google.com/compute/ + +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 storage-pools list-disks + + $ gcloud beta compute storage-pools list-disks + diff --git a/gcloud/alpha/compute/storage-pools/set-iam-policy b/gcloud/alpha/compute/storage-pools/set-iam-policy new file mode 100644 index 000000000..a07a47e48 --- /dev/null +++ b/gcloud/alpha/compute/storage-pools/set-iam-policy @@ -0,0 +1,80 @@ +NAME + gcloud alpha compute storage-pools set-iam-policy - set the IAM policy of + the given storage pool + +SYNOPSIS + gcloud alpha compute storage-pools set-iam-policy + (STORAGE_POOL : --zone=ZONE) POLICY_FILE [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Set the IAM policy of the given storage pool. + +EXAMPLES + The following command sets the IAM configuration of the specified storage + pool with the specified policy file. + + $ gcloud alpha compute storage-pools set-iam-policy \ + my-storage-pool policy.json + +POSITIONAL ARGUMENTS + Storage pool resource - Storage pool you want to get the IAM permissions + of. 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 storage_pool on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + STORAGE_POOL + ID of the storage pool or fully qualified identifier for the storage + pool. + + To set the storage_pool attribute: + ▸ provide the argument storage_pool 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 storage_pool on the command line with a + fully specified name; + ▸ provide the argument --zone on the command line; + ▸ set the property compute/zone. + + POLICY_FILE + Path to a local JSON or YAML formatted file containing a valid policy. + + The output of the get-iam-policy command is a valid file, as is any + JSON or YAML file conforming to the structure of a Policy + (https://cloud.google.com/iam/reference/rest/v1/Policy). + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the compute/alpha API. The full documentation for this + API can be found at: https://cloud.google.com/compute/ + +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 storage-pools set-iam-policy + + $ gcloud beta compute storage-pools set-iam-policy + diff --git a/gcloud/alpha/compute/storage-pools/update b/gcloud/alpha/compute/storage-pools/update new file mode 100644 index 000000000..8a29429b1 --- /dev/null +++ b/gcloud/alpha/compute/storage-pools/update @@ -0,0 +1,93 @@ +NAME + gcloud alpha compute storage-pools update - update a storage pool + +SYNOPSIS + gcloud alpha compute storage-pools update (STORAGE_POOL : --zone=ZONE) + [--async] [--description=DESCRIPTION] + [--provisioned-capacity=PROVISIONED_CAPACITY] + [--provisioned-iops=PROVISIONED_IOPS] + [--provisioned-throughput=PROVISIONED_THROUGHPUT] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Update a storage pool. + +EXAMPLES + To update the size of a storage pool named 'my-storage-pool', run th + following command: + + $ gcloud alpha compute storage-pools update my-storage-pool \ + --provisioned-capacity=20TB + +POSITIONAL ARGUMENTS + Storage pool resource - Storage pool you want to update. The arguments in + this group can be used to specify the attributes of this resource. (NOTE) + Some attributes are not given arguments in this group but can be set in + other ways. + + To set the project attribute: + ◆ provide the argument storage_pool on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + STORAGE_POOL + ID of the storage pool or fully qualified identifier for the storage + pool. + + To set the storage_pool attribute: + ▸ provide the argument storage_pool 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 storage_pool 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. + + --description=DESCRIPTION + Description of the storage pool. + + --provisioned-capacity=PROVISIONED_CAPACITY + Provisioned capacity of the storage pool. + + --provisioned-iops=PROVISIONED_IOPS + IOPS to provision the pool with. + + --provisioned-throughput=PROVISIONED_THROUGHPUT + Throughput in MB/s provision the pool with. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the compute/alpha API. The full documentation for this + API can be found at: https://cloud.google.com/compute/ + +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 storage-pools update + + $ gcloud beta compute storage-pools update + diff --git a/gcloud/alpha/container/clusters/create b/gcloud/alpha/container/clusters/create index 2e96db5b0..d74457ee5 100644 --- a/gcloud/alpha/container/clusters/create +++ b/gcloud/alpha/container/clusters/create @@ -79,7 +79,9 @@ SYNOPSIS --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE | --enable-binauthz] [--cluster-dns=CLUSTER_DNS --cluster-dns-domain=CLUSTER_DNS_DOMAIN - --cluster-dns-scope=CLUSTER_DNS_SCOPE] + --cluster-dns-scope=CLUSTER_DNS_SCOPE + --additive-vpc-scope-dns-domain=ADDITIVE_VPC_SCOPE_DNS_DOMAIN + | --disable-additive-vpc-scope] [--dataplane-v2-observability-mode=DATAPLANE_V2_OBSERVABILITY_MODE | --disable-dataplane-v2-flow-observability | --enable-dataplane-v2-flow-observability] @@ -1126,13 +1128,16 @@ FLAGS 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 enable in standard mode explicitly set the flag to --security-posture=standard To disable in an existing cluster, explicitly set the flag to --security-posture=disabled. - SECURITY_POSTURE must be one of: disabled, standard. + SECURITY_POSTURE must be one of: disabled, standard, enterprise. --services-ipv4-cidr=CIDR Set the IP range for the services IPs. @@ -1426,6 +1431,17 @@ FLAGS vpc Configures the Cloud DNS zone to be private to the VPC Network. + ClusterDNS_AdditiveVPCScope_EnabledDisable + + At most one of these can be specified: + + --additive-vpc-scope-dns-domain=ADDITIVE_VPC_SCOPE_DNS_DOMAIN + The domain used in Additive VPC scope. Only works with Cluster + Scope. + + --disable-additive-vpc-scope + Disables Additive VPC Scope. + At most one of these can be specified: --dataplane-v2-observability-mode=DATAPLANE_V2_OBSERVABILITY_MODE diff --git a/gcloud/alpha/container/clusters/create-auto b/gcloud/alpha/container/clusters/create-auto index e22fa74d0..559032eba 100644 --- a/gcloud/alpha/container/clusters/create-auto +++ b/gcloud/alpha/container/clusters/create-auto @@ -24,6 +24,8 @@ SYNOPSIS [--services-secondary-range-name=NAME] [--subnetwork=SUBNETWORK] [--workload-policies=WORKLOAD_POLICIES] [--workload-vulnerability-scanning=WORKLOAD_VULNERABILITY_SCANNING] + [--additive-vpc-scope-dns-domain=ADDITIVE_VPC_SCOPE_DNS_DOMAIN + | --disable-additive-vpc-scope] [--binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE --binauthz-policy-bindings=[name=BINAUTHZ_POLICY]] [--dataplane-v2-observability-mode=DATAPLANE_V2_OBSERVABILITY_MODE @@ -329,13 +331,16 @@ FLAGS 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 enable in standard mode explicitly set the flag to --security-posture=standard To disable in an existing cluster, explicitly set the flag to --security-posture=disabled. - SECURITY_POSTURE must be one of: disabled, standard. + SECURITY_POSTURE must be one of: disabled, standard, enterprise. --services-ipv4-cidr=CIDR Set the IP range for the services IPs. @@ -388,6 +393,16 @@ FLAGS WORKLOAD_VULNERABILITY_SCANNING must be one of: disabled, standard, enterprise. + ClusterDNS_AdditiveVPCScope_EnabledDisable + + At most one of these can be specified: + + --additive-vpc-scope-dns-domain=ADDITIVE_VPC_SCOPE_DNS_DOMAIN + The domain used in Additive VPC scope. Only works with Cluster Scope. + + --disable-additive-vpc-scope + Disables Additive VPC Scope. + Flags for Binary Authorization: --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE diff --git a/gcloud/alpha/container/clusters/update b/gcloud/alpha/container/clusters/update index e92aa1410..3ca1b8194 100644 --- a/gcloud/alpha/container/clusters/update +++ b/gcloud/alpha/container/clusters/update @@ -64,6 +64,8 @@ SYNOPSIS --resource-usage-bigquery-dataset=RESOURCE_USAGE_BIGQUERY_DATASET | --cluster-dns=CLUSTER_DNS --cluster-dns-domain=CLUSTER_DNS_DOMAIN --cluster-dns-scope=CLUSTER_DNS_SCOPE + --additive-vpc-scope-dns-domain=ADDITIVE_VPC_SCOPE_DNS_DOMAIN + | --disable-additive-vpc-scope | --dataplane-v2-observability-mode=DATAPLANE_V2_OBSERVABILITY_MODE | --disable-dataplane-v2-flow-observability | --enable-dataplane-v2-flow-observability @@ -607,13 +609,16 @@ REQUIRED FLAGS 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 enable in standard mode explicitly set the flag to --security-posture=standard To disable in an existing cluster, explicitly set the flag to --security-posture=disabled. - SECURITY_POSTURE must be one of: disabled, standard. + SECURITY_POSTURE must be one of: disabled, standard, enterprise. --security-profile=SECURITY_PROFILE Name and version of the security profile to be applied to the @@ -968,6 +973,17 @@ REQUIRED FLAGS vpc Configures the Cloud DNS zone to be private to the VPC Network. + ClusterDNS_AdditiveVPCScope_EnabledDisable + + At most one of these can be specified: + + --additive-vpc-scope-dns-domain=ADDITIVE_VPC_SCOPE_DNS_DOMAIN + The domain used in Additive VPC scope. Only works with Cluster + Scope. + + --disable-additive-vpc-scope + Disables Additive VPC Scope. + At most one of these can be specified: --dataplane-v2-observability-mode=DATAPLANE_V2_OBSERVABILITY_MODE diff --git a/gcloud/alpha/container/fleet/scopes/help b/gcloud/alpha/container/fleet/scopes/help index 6283bb2f0..337ae0d9d 100644 --- a/gcloud/alpha/container/fleet/scopes/help +++ b/gcloud/alpha/container/fleet/scopes/help @@ -41,7 +41,8 @@ COMMANDS (ALPHA) Get the IAM policy for a Fleet Scope. list - (ALPHA) List fleet scopes in a project. + (ALPHA) List fleet scopes in a project permitted to be viewed by the + caller. list-memberships (ALPHA) List memberships bound to a fleet scope. diff --git a/gcloud/alpha/container/fleet/scopes/list b/gcloud/alpha/container/fleet/scopes/list index b08148175..f1882637a 100644 --- a/gcloud/alpha/container/fleet/scopes/list +++ b/gcloud/alpha/container/fleet/scopes/list @@ -1,5 +1,6 @@ NAME gcloud alpha container fleet scopes list - list fleet scopes in a project + permitted to be viewed by the caller SYNOPSIS gcloud alpha container fleet scopes list [--filter=EXPRESSION] diff --git a/gcloud/alpha/container/fleet/scopes/list-memberships b/gcloud/alpha/container/fleet/scopes/list-memberships index 8e9686b07..e46f94400 100644 --- a/gcloud/alpha/container/fleet/scopes/list-memberships +++ b/gcloud/alpha/container/fleet/scopes/list-memberships @@ -87,5 +87,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. These variants are also available: + + $ gcloud container fleet scopes list-memberships + + $ gcloud beta container fleet scopes list-memberships diff --git a/gcloud/alpha/container/hub/scopes/help b/gcloud/alpha/container/hub/scopes/help index 5b1554a0c..e96a80168 100644 --- a/gcloud/alpha/container/hub/scopes/help +++ b/gcloud/alpha/container/hub/scopes/help @@ -41,7 +41,8 @@ COMMANDS (ALPHA) Get the IAM policy for a Fleet Scope. list - (ALPHA) List fleet scopes in a project. + (ALPHA) List fleet scopes in a project permitted to be viewed by the + caller. list-memberships (ALPHA) List memberships bound to a fleet scope. diff --git a/gcloud/alpha/container/hub/scopes/list b/gcloud/alpha/container/hub/scopes/list index 301e180e7..7b0be9679 100644 --- a/gcloud/alpha/container/hub/scopes/list +++ b/gcloud/alpha/container/hub/scopes/list @@ -1,5 +1,6 @@ NAME gcloud alpha container hub scopes list - list fleet scopes in a project + permitted to be viewed by the caller SYNOPSIS gcloud alpha container hub scopes list [--filter=EXPRESSION] diff --git a/gcloud/alpha/container/hub/scopes/list-memberships b/gcloud/alpha/container/hub/scopes/list-memberships index 0b3ef2e09..0ffd96d85 100644 --- a/gcloud/alpha/container/hub/scopes/list-memberships +++ b/gcloud/alpha/container/hub/scopes/list-memberships @@ -87,5 +87,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. These variants are also available: + + $ gcloud container hub scopes list-memberships + + $ gcloud beta container hub scopes list-memberships diff --git a/gcloud/alpha/firestore/indexes/composite/create b/gcloud/alpha/firestore/indexes/composite/create index 372bb2e11..a5fcecf5e 100644 --- a/gcloud/alpha/firestore/indexes/composite/create +++ b/gcloud/alpha/firestore/indexes/composite/create @@ -5,7 +5,7 @@ NAME SYNOPSIS gcloud alpha firestore indexes composite create --field-config=[array-config=ARRAY-CONFIG], - [field-path=FIELD-PATH],[order=ORDER] + [field-path=FIELD-PATH],[order=ORDER],[vector-config=VECTOR-CONFIG] (--collection-group=COLLECTION_GROUP : --database=DATABASE) [--api-scope=API_SCOPE; default="any-api"] [--async] [--query-scope=QUERY_SCOPE; default="collection"] @@ -30,7 +30,7 @@ EXAMPLES --field-config=field-path=timestamp,order=descending REQUIRED FLAGS - --field-config=[array-config=ARRAY-CONFIG],[field-path=FIELD-PATH],[order=ORDER] + --field-config=[array-config=ARRAY-CONFIG],[field-path=FIELD-PATH],[order=ORDER],[vector-config=VECTOR-CONFIG] Configuration for a field. Required, Configuration for a field. array-config @@ -45,13 +45,22 @@ REQUIRED FLAGS Specifies the order. Valid options are 'ascending', 'descending'. Exactly one of order or array-config must be specified. + vector-config + Specifies the vector config. + + dimension + Sets dimension value. + + flat + Sets flat value. + Shorthand Example: - --field-config=array-config=string,field-path=string,order=string --field-config=array-config=string,field-path=string,order=string + --field-config='array-config=string,field-path=string,order=string,vector-config={"dimension": int, "flat": {"string"}}' --field-config='array-config=string,field-path=string,order=string,vector-config={"dimension": int, "flat": {"string"}}' JSON Example: - --field-config='[{"array-config": "string", "field-path": "string", "order": "string"}]' + --field-config='[{"array-config": "string", "field-path": "string", "order": "string", "vector-config": {"dimension": int, "flat": {"string"}}}]' File Example: diff --git a/gcloud/alpha/pubsub/subscriptions/create b/gcloud/alpha/pubsub/subscriptions/create index 15c516391..912447f4c 100644 --- a/gcloud/alpha/pubsub/subscriptions/create +++ b/gcloud/alpha/pubsub/subscriptions/create @@ -15,12 +15,7 @@ SYNOPSIS [[--bigquery-table=BIGQUERY_TABLE : --drop-unknown-fields --write-metadata --use-table-schema | --use-topic-schema] | [--cloud-storage-bucket=CLOUD_STORAGE_BUCKET - : --cloud-storage-file-prefix=CLOUD_STORAGE_FILE_PREFIX - --cloud-storage-file-suffix=CLOUD_STORAGE_FILE_SUFFIX - --cloud-storage-max-bytes=CLOUD_STORAGE_MAX_BYTES - --cloud-storage-max-duration=CLOUD_STORAGE_MAX_DURATION - --cloud-storage-output-format=OUTPUT_FORMAT; - default="text" --cloud-storage-write-metadata]] + : --cloud-storage-file-datetime-format=CLOUD_STORAGE_FILE_DATETIME_FORMAT --cloud-storage-file-prefix=CLOUD_STORAGE_FILE_PREFIX --cloud-storage-file-suffix=CLOUD_STORAGE_FILE_SUFFIX --cloud-storage-max-bytes=CLOUD_STORAGE_MAX_BYTES --cloud-storage-max-duration=CLOUD_STORAGE_MAX_DURATION --cloud-storage-output-format=OUTPUT_FORMAT; default="text" --cloud-storage-write-metadata]] [--max-delivery-attempts=MAX_DELIVERY_ATTEMPTS [--dead-letter-topic=DEAD_LETTER_TOPIC : --dead-letter-topic-project=DEAD_LETTER_TOPIC_PROJECT]] @@ -207,6 +202,11 @@ OPTIONAL FLAGS This flag argument must be specified if any of the other arguments in this group are specified. + --cloud-storage-file-datetime-format=CLOUD_STORAGE_FILE_DATETIME_FORMAT + The custom datetime format string for Cloud Storage filename. See + the datetime format guidance + (https://cloud.google.com/pubsub/docs/create-cloudstorage-subscription#file_names). + --cloud-storage-file-prefix=CLOUD_STORAGE_FILE_PREFIX The prefix for Cloud Storage filename. diff --git a/gcloud/alpha/pubsub/subscriptions/update b/gcloud/alpha/pubsub/subscriptions/update index e5147d9bc..f2c5bed88 100644 --- a/gcloud/alpha/pubsub/subscriptions/update +++ b/gcloud/alpha/pubsub/subscriptions/update @@ -15,12 +15,7 @@ SYNOPSIS : --drop-unknown-fields --write-metadata --use-table-schema | --use-topic-schema] | --clear-cloud-storage-config | [--cloud-storage-bucket=CLOUD_STORAGE_BUCKET - : --cloud-storage-file-prefix=CLOUD_STORAGE_FILE_PREFIX - --cloud-storage-file-suffix=CLOUD_STORAGE_FILE_SUFFIX - --cloud-storage-max-bytes=CLOUD_STORAGE_MAX_BYTES - --cloud-storage-max-duration=CLOUD_STORAGE_MAX_DURATION - --cloud-storage-output-format=OUTPUT_FORMAT; - default="text" --cloud-storage-write-metadata]] + : --cloud-storage-file-datetime-format=CLOUD_STORAGE_FILE_DATETIME_FORMAT --cloud-storage-file-prefix=CLOUD_STORAGE_FILE_PREFIX --cloud-storage-file-suffix=CLOUD_STORAGE_FILE_SUFFIX --cloud-storage-max-bytes=CLOUD_STORAGE_MAX_BYTES --cloud-storage-max-duration=CLOUD_STORAGE_MAX_DURATION --cloud-storage-output-format=OUTPUT_FORMAT; default="text" --cloud-storage-write-metadata]] [--clear-dead-letter-policy | --max-delivery-attempts=MAX_DELIVERY_ATTEMPTS [--dead-letter-topic=DEAD_LETTER_TOPIC @@ -187,6 +182,11 @@ FLAGS This flag argument must be specified if any of the other arguments in this group are specified. + --cloud-storage-file-datetime-format=CLOUD_STORAGE_FILE_DATETIME_FORMAT + The custom datetime format string for Cloud Storage filename. See + the datetime format guidance + (https://cloud.google.com/pubsub/docs/create-cloudstorage-subscription#file_names). + --cloud-storage-file-prefix=CLOUD_STORAGE_FILE_PREFIX The prefix for Cloud Storage filename. diff --git a/gcloud/alpha/redis/clusters/create b/gcloud/alpha/redis/clusters/create index 8fa697529..42643f328 100644 --- a/gcloud/alpha/redis/clusters/create +++ b/gcloud/alpha/redis/clusters/create @@ -6,7 +6,7 @@ SYNOPSIS gcloud alpha redis clusters create (CLUSTER : --region=REGION) --network=NETWORK --shard-count=SHARD_COUNT [--aof-append-fsync=AOF_APPEND_FSYNC] [--async] [--auth-mode=AUTH_MODE] - [--persistence-mode=PERSISTENCE_MODE] + [--node-type=NODE_TYPE] [--persistence-mode=PERSISTENCE_MODE] [--rdb-snapshot-period=RDB_SNAPSHOT_PERIOD] [--rdb-snapshot-start-time=RDB_SNAPSHOT_START_TIME] [--redis-config=[KEY=VALUE,...]] [--replica-count=REPLICA_COUNT] @@ -114,6 +114,11 @@ OPTIONAL FLAGS iam-auth IAM basic authorization is enabled for the cluster. + --node-type=NODE_TYPE + Node Type of the redis cluster Node. NODE_TYPE must be one of: + redis-highmem-medium, redis-highmem-xlarge, redis-shared-core-nano, + redis-standard-small. + --persistence-mode=PERSISTENCE_MODE Operation mode for persistence. PERSISTENCE_MODE must be one of: diff --git a/gcloud/alpha/spanner/operations/describe b/gcloud/alpha/spanner/operations/describe index 60cd8afda..05b611009 100644 --- a/gcloud/alpha/spanner/operations/describe +++ b/gcloud/alpha/spanner/operations/describe @@ -1,6 +1,6 @@ NAME gcloud alpha spanner operations describe - describe a Cloud Spanner - operation + operation with ALPHA features SYNOPSIS gcloud alpha spanner operations describe OPERATION-ID @@ -8,7 +8,7 @@ SYNOPSIS [--backup=BACKUP] [--database=DATABASE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Describe a Cloud Spanner operation. + (ALPHA) Describe a Cloud Spanner operation with ALPHA features. EXAMPLES To describe a Cloud Spanner instance operation, run: @@ -26,6 +26,11 @@ EXAMPLES $ gcloud alpha spanner operations describe _auto_12345 \ --instance=my-instance-id --backup=my-backup-id + To describe a Cloud Spanner instance partition operation, run: + + $ gcloud alpha spanner operations describe _auto_12345 \ + --instance=my-instance-id --instance-partition=my-partition-id + POSITIONAL ARGUMENTS OPERATION-ID ID of the operation diff --git a/gcloud/alpha/spanner/operations/help b/gcloud/alpha/spanner/operations/help index 5b40175d9..bb6918453 100644 --- a/gcloud/alpha/spanner/operations/help +++ b/gcloud/alpha/spanner/operations/help @@ -19,7 +19,7 @@ COMMANDS (ALPHA) Cancel a Cloud Spanner operation with ALPHA features. describe - (ALPHA) Describe a Cloud Spanner operation. + (ALPHA) Describe a Cloud Spanner operation with ALPHA features. list (ALPHA) List the Cloud Spanner operations with ALPHA features. diff --git a/gcloud/alpha/spanner/operations/list b/gcloud/alpha/spanner/operations/list index c301dc1d6..0d8ea8dde 100644 --- a/gcloud/alpha/spanner/operations/list +++ b/gcloud/alpha/spanner/operations/list @@ -49,6 +49,11 @@ EXAMPLES $ gcloud alpha spanner operations list --instance=my-instance-id \ --instance-partition=my-partition-id --type=INSTANCE_PARTITION + To list Cloud Spanner instance partition operations for an instance, run: + + $ gcloud alpha spanner operations list --instance=my-instance-id \ + --type=INSTANCE_PARTITION + REQUIRED FLAGS Exactly one of these must be specified: diff --git a/gcloud/alpha/sql/instances/patch b/gcloud/alpha/sql/instances/patch index 6496bdd04..b0480ef45 100644 --- a/gcloud/alpha/sql/instances/patch +++ b/gcloud/alpha/sql/instances/patch @@ -10,7 +10,8 @@ SYNOPSIS [--async] [--audit-bucket-path=AUDIT_BUCKET_PATH] [--audit-retention-interval=AUDIT_RETENTION_INTERVAL] [--audit-upload-interval=AUDIT_UPLOAD_INTERVAL] - [--availability-type=AVAILABILITY_TYPE] [--clear-password-policy] + [--availability-type=AVAILABILITY_TYPE] + [--clear-failover-dr-replica-name] [--clear-password-policy] [--connector-enforcement=CONNECTOR_ENFORCEMENT] [--cpu=CPU] [--database-version=DATABASE_VERSION] [--[no-]deletion-protection] [--deny-maintenance-period-end-date=DENY_MAINTENANCE_PERIOD_END_DATE] @@ -20,7 +21,9 @@ SYNOPSIS [--[no-]enable-database-replication] [--[no-]enable-google-ml-integration] [--[no-]enable-google-private-path] [--enable-password-policy] - [--enable-point-in-time-recovery] [--follow-gae-app=FOLLOW_GAE_APP] + [--enable-point-in-time-recovery] + [--failover-dr-replica-name=FAILOVER_DR_REPLICA_NAME] + [--follow-gae-app=FOLLOW_GAE_APP] [--[no-]insights-config-query-insights-enabled] [--insights-config-query-plans-per-minute=INSIGHTS_CONFIG_QUERY_PLANS_PER_MINUTE] [--insights-config-query-string-length=INSIGHTS_CONFIG_QUERY_STRING_LENGTH] @@ -118,6 +121,10 @@ FLAGS zonal Provides no failover capability. This is the default. + --clear-failover-dr-replica-name + Clear the DR replica setting for the primary instance. Flag is only + available for MySQL. + --clear-password-policy Clear the existing password policy. This flag is only available for Postgres. @@ -207,6 +214,11 @@ FLAGS fraction of a second, via write-ahead logs. Must have automatic backups enabled to use. Make sure storage can support at least 7 days of logs. + --failover-dr-replica-name=FAILOVER_DR_REPLICA_NAME + Set a Disaster Recovery (DR) replica with the specified name for the + primary instance. This must be one of the existing cross region + replicas of the primary instance. Flag is only available for MySQL. + --follow-gae-app=FOLLOW_GAE_APP First Generation instances only. The App Engine app this instance should follow. It must be in the same region as the instance. WARNING: diff --git a/gcloud/alpha/storage/mv b/gcloud/alpha/storage/mv index 1c0024d4e..ea04a0bbe 100644 --- a/gcloud/alpha/storage/mv +++ b/gcloud/alpha/storage/mv @@ -34,7 +34,7 @@ SYNOPSIS DESCRIPTION (ALPHA) The mv command allows you to move data between your local file system and the cloud, move data within the cloud, and move data between - cloud storage providers + cloud storage providers. Renaming Groups Of Objects diff --git a/gcloud/artifacts/docker/images/list b/gcloud/artifacts/docker/images/list index f9c835d2f..5892359eb 100644 --- a/gcloud/artifacts/docker/images/list +++ b/gcloud/artifacts/docker/images/list @@ -57,7 +57,8 @@ POSITIONAL ARGUMENTS FLAGS --include-tags - If specified, all tags associated with each image digest are displayed. + If specified, tags associated with each image digest are displayed up + to a maximum of 100 tags per version. --occurrence-filter=OCCURRENCE_FILTER; default='kind="BUILD" OR kind="IMAGE" OR kind="DISCOVERY" OR kind="SBOM_REFERENCE"' A filter for the occurrences which will be summarized. diff --git a/gcloud/beta/artifacts/docker/images/list b/gcloud/beta/artifacts/docker/images/list index fa506c51f..cb13826d5 100644 --- a/gcloud/beta/artifacts/docker/images/list +++ b/gcloud/beta/artifacts/docker/images/list @@ -57,7 +57,8 @@ POSITIONAL ARGUMENTS FLAGS --include-tags - If specified, all tags associated with each image digest are displayed. + If specified, tags associated with each image digest are displayed up + to a maximum of 100 tags per version. --occurrence-filter=OCCURRENCE_FILTER; default='kind="BUILD" OR kind="IMAGE" OR kind="DISCOVERY" OR kind="SBOM_REFERENCE"' A filter for the occurrences which will be summarized. diff --git a/gcloud/beta/builds/get-default-service-account b/gcloud/beta/builds/get-default-service-account new file mode 100644 index 000000000..164330586 --- /dev/null +++ b/gcloud/beta/builds/get-default-service-account @@ -0,0 +1,41 @@ +NAME + gcloud beta builds get-default-service-account - get the default service + account for a project + +SYNOPSIS + gcloud beta builds get-default-service-account [--region=REGION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Get the default service account for a project. + +EXAMPLES + To get the default service account for the project: + + $ gcloud beta builds get-default-service-account + +FLAGS + --region=REGION + The region of the Cloud Build Service to use. Must be set to a + supported region name (e.g. us-central1). If unset, builds/region, + which is the default region to use when working with Cloud Build + resources, is used. If builds/region is unset, region is set to global. + Note: Region must be specified in 2nd gen repo; global is not + supported. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud builds get-default-service-account + + $ gcloud alpha builds get-default-service-account + diff --git a/gcloud/beta/builds/help b/gcloud/beta/builds/help index eb3e241ae..2efbca2e8 100644 --- a/gcloud/beta/builds/help +++ b/gcloud/beta/builds/help @@ -39,6 +39,9 @@ COMMANDS describe (BETA) Get information about a particular build. + get-default-service-account + (BETA) Get the default service account for a project. + list (BETA) List builds. diff --git a/gcloud/beta/composer/environments/help b/gcloud/beta/composer/environments/help index 130865bd7..77d7b5282 100644 --- a/gcloud/beta/composer/environments/help +++ b/gcloud/beta/composer/environments/help @@ -28,6 +28,12 @@ GROUPS (BETA) Manage Cloud Storage objects stored as part of Cloud Composer environments. + user-workloads-config-maps + (BETA) Create and manage user workloads ConfigMaps of environment. + + user-workloads-secrets + (BETA) Create and manage user workloads Secrets of environment. + COMMANDS COMMAND is one of the following: @@ -61,6 +67,10 @@ COMMANDS (BETA) List the Cloud Composer image version upgrades for a specific environment. + list-workloads + (BETA) List Composer workloads, supported in Composer 3 environments or + greater. + restart-web-server (BETA) Restart web server for a Cloud Composer environment. diff --git a/gcloud/beta/composer/environments/list-workloads b/gcloud/beta/composer/environments/list-workloads new file mode 100644 index 000000000..9e42c2b3f --- /dev/null +++ b/gcloud/beta/composer/environments/list-workloads @@ -0,0 +1,63 @@ +NAME + gcloud beta composer environments list-workloads - list Composer workloads, + supported in Composer 3 environments or greater + +SYNOPSIS + gcloud beta composer environments list-workloads + (ENVIRONMENT : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) List Composer workloads, supported in Composer 3 environments or + greater. + +EXAMPLES + To display Composer workloads for the environment named environment-1, run: $ gcloud beta composer environments list-workloads environment-1 + +POSITIONAL ARGUMENTS + Environment resource - The environment for which to display workloads. 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 environment 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. + + ENVIRONMENT + ID of the environment or fully qualified identifier for the + environment. + + To set the environment attribute: + ▸ provide the argument environment on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Region where Composer environment runs or in which to create the + environment. + + To set the location attribute: + ▸ provide the argument environment on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property composer/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha composer environments list-workloads + diff --git a/gcloud/beta/composer/environments/user-workloads-config-maps/create b/gcloud/beta/composer/environments/user-workloads-config-maps/create new file mode 100644 index 000000000..101c6c991 --- /dev/null +++ b/gcloud/beta/composer/environments/user-workloads-config-maps/create @@ -0,0 +1,72 @@ +NAME + gcloud beta composer environments user-workloads-config-maps create - + create a user workloads ConfigMap + +SYNOPSIS + gcloud beta composer environments user-workloads-config-maps create + --config-map-file-path=CONFIG_MAP_FILE_PATH + (--environment=ENVIRONMENT : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Create a user workloads ConfigMap. + +EXAMPLES + To create a user workloads ConfigMap of the environment named env-1, run: + + $ gcloud beta composer environments user-workloads-config-maps \ + create --environment=env-1 \ + --config-map-file-path=config_map.yaml + +REQUIRED FLAGS + --config-map-file-path=CONFIG_MAP_FILE_PATH + Path to a local file with a single Kubernetes ConfigMap in YAML format. + + Environment resource - The environment where the user workloads ConfigMap + must be created. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --environment 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. + + --environment=ENVIRONMENT + ID of the environment or fully qualified identifier for the + environment. + + To set the environment attribute: + ▸ provide the argument --environment on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + Region where Composer environment runs or in which to create the + environment. + + To set the location attribute: + ▸ provide the argument --environment on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property composer/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha composer environments user-workloads-config-maps \ + create + diff --git a/gcloud/beta/composer/environments/user-workloads-config-maps/delete b/gcloud/beta/composer/environments/user-workloads-config-maps/delete new file mode 100644 index 000000000..0c970f5db --- /dev/null +++ b/gcloud/beta/composer/environments/user-workloads-config-maps/delete @@ -0,0 +1,71 @@ +NAME + gcloud beta composer environments user-workloads-config-maps delete - + delete a user workloads ConfigMap + +SYNOPSIS + gcloud beta composer environments user-workloads-config-maps delete + [CONFIG_MAP_NAME] (--environment=ENVIRONMENT : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Delete a user workloads ConfigMap. + +EXAMPLES + To delete a user workloads ConfigMap of the environment named env-1, run: + + $ gcloud beta composer environments user-workloads-config-maps \ + delete config-map-1 --environment=env-1 + +POSITIONAL ARGUMENTS + [CONFIG_MAP_NAME] + Name of the ConfigMap. + +REQUIRED FLAGS + Environment resource - The environment of the config_map. 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 --environment 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. + + --environment=ENVIRONMENT + ID of the environment or fully qualified identifier for the + environment. + + To set the environment attribute: + ▸ provide the argument --environment on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + Region where Composer environment runs or in which to create the + environment. + + To set the location attribute: + ▸ provide the argument --environment on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property composer/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha composer environments user-workloads-config-maps \ + delete + diff --git a/gcloud/beta/composer/environments/user-workloads-config-maps/describe b/gcloud/beta/composer/environments/user-workloads-config-maps/describe new file mode 100644 index 000000000..1c660fe5e --- /dev/null +++ b/gcloud/beta/composer/environments/user-workloads-config-maps/describe @@ -0,0 +1,72 @@ +NAME + gcloud beta composer environments user-workloads-config-maps describe - get + details about a user workloads ConfigMap + +SYNOPSIS + gcloud beta composer environments user-workloads-config-maps describe + [CONFIG_MAP_NAME] (--environment=ENVIRONMENT : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Get details about a user workloads ConfigMap. + +EXAMPLES + To get details about a user workloads ConfigMap of the environment named + env-1, run: + + $ gcloud beta composer environments user-workloads-config-maps \ + describe config-map-1 --environment=env-1 + +POSITIONAL ARGUMENTS + [CONFIG_MAP_NAME] + Name of the ConfigMap. + +REQUIRED FLAGS + Environment resource - The environment of the config_map. 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 --environment 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. + + --environment=ENVIRONMENT + ID of the environment or fully qualified identifier for the + environment. + + To set the environment attribute: + ▸ provide the argument --environment on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + Region where Composer environment runs or in which to create the + environment. + + To set the location attribute: + ▸ provide the argument --environment on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property composer/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha composer environments user-workloads-config-maps \ + describe + diff --git a/gcloud/beta/composer/environments/user-workloads-config-maps/help b/gcloud/beta/composer/environments/user-workloads-config-maps/help new file mode 100644 index 000000000..b3dcf0b25 --- /dev/null +++ b/gcloud/beta/composer/environments/user-workloads-config-maps/help @@ -0,0 +1,42 @@ +NAME + gcloud beta composer environments user-workloads-config-maps - create and + manage user workloads ConfigMaps of environment + +SYNOPSIS + gcloud beta composer environments user-workloads-config-maps COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) The gcloud beta composer environments user-workloads-config-maps + command group manages user workloads ConfigMaps of Cloud Composer + environments. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (BETA) Create a user workloads ConfigMap. + + delete + (BETA) Delete a user workloads ConfigMap. + + describe + (BETA) Get details about a user workloads ConfigMap. + + list + (BETA) List user workloads ConfigMaps. + + update + (BETA) Update a user workloads ConfigMap. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha composer environments user-workloads-config-maps + diff --git a/gcloud/beta/composer/environments/user-workloads-config-maps/list b/gcloud/beta/composer/environments/user-workloads-config-maps/list new file mode 100644 index 000000000..e01c5f617 --- /dev/null +++ b/gcloud/beta/composer/environments/user-workloads-config-maps/list @@ -0,0 +1,66 @@ +NAME + gcloud beta composer environments user-workloads-config-maps list - list + user workloads ConfigMaps + +SYNOPSIS + gcloud beta composer environments user-workloads-config-maps list + (--environment=ENVIRONMENT : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) List user workloads ConfigMaps. + +EXAMPLES + To list user workloads ConfigMaps of the environment named env-1, run: + + $ gcloud beta composer environments user-workloads-config-maps \ + list --environment=env-1 + +REQUIRED FLAGS + Environment resource - The environment to list user workloads ConfigMaps. + 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 --environment 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. + + --environment=ENVIRONMENT + ID of the environment or fully qualified identifier for the + environment. + + To set the environment attribute: + ▸ provide the argument --environment on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + Region where Composer environment runs or in which to create the + environment. + + To set the location attribute: + ▸ provide the argument --environment on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property composer/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha composer environments user-workloads-config-maps list + diff --git a/gcloud/beta/composer/environments/user-workloads-config-maps/update b/gcloud/beta/composer/environments/user-workloads-config-maps/update new file mode 100644 index 000000000..c355eff2c --- /dev/null +++ b/gcloud/beta/composer/environments/user-workloads-config-maps/update @@ -0,0 +1,72 @@ +NAME + gcloud beta composer environments user-workloads-config-maps update - + update a user workloads ConfigMap + +SYNOPSIS + gcloud beta composer environments user-workloads-config-maps update + --config-map-file-path=CONFIG_MAP_FILE_PATH + (--environment=ENVIRONMENT : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Update a user workloads ConfigMap. + +EXAMPLES + To update a user workloads ConfigMap of the environment named env-1, run: + + $ gcloud beta composer environments user-workloads-config-maps \ + update --environment=env-1 \ + --config-map-file-path=config_map.yaml + +REQUIRED FLAGS + --config-map-file-path=CONFIG_MAP_FILE_PATH + Path to a local file with a single Kubernetes ConfigMap in YAML format. + + Environment resource - The environment where the user workloads ConfigMap + must be updated. 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 --environment 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. + + --environment=ENVIRONMENT + ID of the environment or fully qualified identifier for the + environment. + + To set the environment attribute: + ▸ provide the argument --environment on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + Region where Composer environment runs or in which to create the + environment. + + To set the location attribute: + ▸ provide the argument --environment on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property composer/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha composer environments user-workloads-config-maps \ + update + diff --git a/gcloud/beta/composer/environments/user-workloads-secrets/create b/gcloud/beta/composer/environments/user-workloads-secrets/create new file mode 100644 index 000000000..2515dee2a --- /dev/null +++ b/gcloud/beta/composer/environments/user-workloads-secrets/create @@ -0,0 +1,70 @@ +NAME + gcloud beta composer environments user-workloads-secrets create - create a + user workloads Secret + +SYNOPSIS + gcloud beta composer environments user-workloads-secrets create + --secret-file-path=SECRET_FILE_PATH + (--environment=ENVIRONMENT : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Create a user workloads Secret. + +EXAMPLES + To create a user workloads Secret of the environment named env-1, run: + + $ gcloud beta composer environments user-workloads-secrets create \ + --environment=env-1 --secret-file-path=secret.yaml + +REQUIRED FLAGS + --secret-file-path=SECRET_FILE_PATH + Path to a local file with a single Kubernetes Secret in YAML format. + + Environment resource - The environment where the user workloads Secret + must be created. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --environment 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. + + --environment=ENVIRONMENT + ID of the environment or fully qualified identifier for the + environment. + + To set the environment attribute: + ▸ provide the argument --environment on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + Region where Composer environment runs or in which to create the + environment. + + To set the location attribute: + ▸ provide the argument --environment on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property composer/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha composer environments user-workloads-secrets create + diff --git a/gcloud/beta/composer/environments/user-workloads-secrets/delete b/gcloud/beta/composer/environments/user-workloads-secrets/delete new file mode 100644 index 000000000..2225eaa65 --- /dev/null +++ b/gcloud/beta/composer/environments/user-workloads-secrets/delete @@ -0,0 +1,70 @@ +NAME + gcloud beta composer environments user-workloads-secrets delete - delete a + user workloads Secret + +SYNOPSIS + gcloud beta composer environments user-workloads-secrets delete + [SECRET_NAME] (--environment=ENVIRONMENT : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Delete a user workloads Secret. + +EXAMPLES + To delete a user workloads Secret of the environment named env-1, run: + + $ gcloud beta composer environments user-workloads-secrets delete \ + secret-1 --environment=env-1 + +POSITIONAL ARGUMENTS + [SECRET_NAME] + Name of the Secret. + +REQUIRED FLAGS + Environment resource - The environment of the secret. 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 --environment 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. + + --environment=ENVIRONMENT + ID of the environment or fully qualified identifier for the + environment. + + To set the environment attribute: + ▸ provide the argument --environment on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + Region where Composer environment runs or in which to create the + environment. + + To set the location attribute: + ▸ provide the argument --environment on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property composer/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha composer environments user-workloads-secrets delete + diff --git a/gcloud/beta/composer/environments/user-workloads-secrets/describe b/gcloud/beta/composer/environments/user-workloads-secrets/describe new file mode 100644 index 000000000..39cc78783 --- /dev/null +++ b/gcloud/beta/composer/environments/user-workloads-secrets/describe @@ -0,0 +1,71 @@ +NAME + gcloud beta composer environments user-workloads-secrets describe - get + details about a user workloads Secret + +SYNOPSIS + gcloud beta composer environments user-workloads-secrets describe + [SECRET_NAME] (--environment=ENVIRONMENT : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Get details about a user workloads Secret. + +EXAMPLES + To get details about a user workloads Secret of the environment named + env-1, run: + + $ gcloud beta composer environments user-workloads-secrets \ + describe secret-1 --environment=env-1 + +POSITIONAL ARGUMENTS + [SECRET_NAME] + Name of the Secret. + +REQUIRED FLAGS + Environment resource - The environment of the secret. 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 --environment 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. + + --environment=ENVIRONMENT + ID of the environment or fully qualified identifier for the + environment. + + To set the environment attribute: + ▸ provide the argument --environment on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + Region where Composer environment runs or in which to create the + environment. + + To set the location attribute: + ▸ provide the argument --environment on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property composer/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha composer environments user-workloads-secrets describe + diff --git a/gcloud/beta/composer/environments/user-workloads-secrets/help b/gcloud/beta/composer/environments/user-workloads-secrets/help new file mode 100644 index 000000000..15ba6a529 --- /dev/null +++ b/gcloud/beta/composer/environments/user-workloads-secrets/help @@ -0,0 +1,41 @@ +NAME + gcloud beta composer environments user-workloads-secrets - create and + manage user workloads Secrets of environment + +SYNOPSIS + gcloud beta composer environments user-workloads-secrets COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) The gcloud beta composer environments user-workloads-secrets command + group manages user workloads Secrets of Cloud Composer environments. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (BETA) Create a user workloads Secret. + + delete + (BETA) Delete a user workloads Secret. + + describe + (BETA) Get details about a user workloads Secret. + + list + (BETA) List user workloads Secrets. + + update + (BETA) Update a user workloads Secret. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha composer environments user-workloads-secrets + diff --git a/gcloud/beta/composer/environments/user-workloads-secrets/list b/gcloud/beta/composer/environments/user-workloads-secrets/list new file mode 100644 index 000000000..944d1c815 --- /dev/null +++ b/gcloud/beta/composer/environments/user-workloads-secrets/list @@ -0,0 +1,66 @@ +NAME + gcloud beta composer environments user-workloads-secrets list - list user + workloads Secrets + +SYNOPSIS + gcloud beta composer environments user-workloads-secrets list + (--environment=ENVIRONMENT : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) List user workloads Secrets. + +EXAMPLES + To list user workloads Secrets of the environment named env-1, run: + + $ gcloud beta composer environments user-workloads-secrets list \ + --environment=env-1 + +REQUIRED FLAGS + Environment resource - The environment to list user workloads Secrets. 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 --environment 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. + + --environment=ENVIRONMENT + ID of the environment or fully qualified identifier for the + environment. + + To set the environment attribute: + ▸ provide the argument --environment on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + Region where Composer environment runs or in which to create the + environment. + + To set the location attribute: + ▸ provide the argument --environment on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property composer/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha composer environments user-workloads-secrets list + diff --git a/gcloud/beta/composer/environments/user-workloads-secrets/update b/gcloud/beta/composer/environments/user-workloads-secrets/update new file mode 100644 index 000000000..0cb00136c --- /dev/null +++ b/gcloud/beta/composer/environments/user-workloads-secrets/update @@ -0,0 +1,70 @@ +NAME + gcloud beta composer environments user-workloads-secrets update - update a + user workloads Secret + +SYNOPSIS + gcloud beta composer environments user-workloads-secrets update + --secret-file-path=SECRET_FILE_PATH + (--environment=ENVIRONMENT : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Update a user workloads Secret. + +EXAMPLES + To update a user workloads Secret of the environment named env-1, run: + + $ gcloud beta composer environments user-workloads-secrets update \ + --environment=env-1 --secret-file-path=secret.yaml + +REQUIRED FLAGS + --secret-file-path=SECRET_FILE_PATH + Path to a local file with a single Kubernetes Secret in YAML format. + + Environment resource - The environment where the user workloads Secret + must be updated. 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 --environment 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. + + --environment=ENVIRONMENT + ID of the environment or fully qualified identifier for the + environment. + + To set the environment attribute: + ▸ provide the argument --environment on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + Region where Composer environment runs or in which to create the + environment. + + To set the location attribute: + ▸ provide the argument --environment on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property composer/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha composer environments user-workloads-secrets update + diff --git a/gcloud/beta/compute/help b/gcloud/beta/compute/help index f0cba19c6..c13bf15f0 100644 --- a/gcloud/beta/compute/help +++ b/gcloud/beta/compute/help @@ -181,6 +181,12 @@ GROUPS ssl-policies (BETA) List, create, delete and update Compute Engine SSL policies. + storage-pool-types + (BETA) Read storage pool types. + + storage-pools + (BETA) Read and manipulate storage pools. + target-grpc-proxies (BETA) Manage Compute Engine target gRPC proxy resources. diff --git a/gcloud/beta/compute/instance-groups/managed/resize-requests/cancel b/gcloud/beta/compute/instance-groups/managed/resize-requests/cancel index bedc92da4..508cc14bf 100644 --- a/gcloud/beta/compute/instance-groups/managed/resize-requests/cancel +++ b/gcloud/beta/compute/instance-groups/managed/resize-requests/cancel @@ -59,8 +59,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud compute instance-groups managed resize-requests cancel $ gcloud alpha compute instance-groups managed resize-requests cancel diff --git a/gcloud/beta/compute/instance-groups/managed/resize-requests/create b/gcloud/beta/compute/instance-groups/managed/resize-requests/create index d34a11e1a..56a64a4c5 100644 --- a/gcloud/beta/compute/instance-groups/managed/resize-requests/create +++ b/gcloud/beta/compute/instance-groups/managed/resize-requests/create @@ -69,8 +69,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud compute instance-groups managed resize-requests create $ gcloud alpha compute instance-groups managed resize-requests create diff --git a/gcloud/beta/compute/instance-groups/managed/resize-requests/delete b/gcloud/beta/compute/instance-groups/managed/resize-requests/delete index 7456d4cf6..936bb40d5 100644 --- a/gcloud/beta/compute/instance-groups/managed/resize-requests/delete +++ b/gcloud/beta/compute/instance-groups/managed/resize-requests/delete @@ -60,8 +60,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud compute instance-groups managed resize-requests delete $ gcloud alpha compute instance-groups managed resize-requests delete diff --git a/gcloud/beta/compute/instance-groups/managed/resize-requests/describe b/gcloud/beta/compute/instance-groups/managed/resize-requests/describe index 39bf4e0f2..9bdcfed0e 100644 --- a/gcloud/beta/compute/instance-groups/managed/resize-requests/describe +++ b/gcloud/beta/compute/instance-groups/managed/resize-requests/describe @@ -58,8 +58,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud compute instance-groups managed resize-requests describe $ gcloud alpha compute instance-groups managed resize-requests \ describe diff --git a/gcloud/beta/compute/instance-groups/managed/resize-requests/help b/gcloud/beta/compute/instance-groups/managed/resize-requests/help index 1adc52904..b525f04e6 100644 --- a/gcloud/beta/compute/instance-groups/managed/resize-requests/help +++ b/gcloud/beta/compute/instance-groups/managed/resize-requests/help @@ -34,8 +34,10 @@ COMMANDS (BETA) List Compute Engine managed instance group resize requests. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud compute instance-groups managed resize-requests $ gcloud alpha compute instance-groups managed resize-requests diff --git a/gcloud/beta/compute/instance-groups/managed/resize-requests/list b/gcloud/beta/compute/instance-groups/managed/resize-requests/list index 190f18a4f..2e3eb707c 100644 --- a/gcloud/beta/compute/instance-groups/managed/resize-requests/list +++ b/gcloud/beta/compute/instance-groups/managed/resize-requests/list @@ -90,8 +90,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud compute instance-groups managed resize-requests list $ gcloud alpha compute instance-groups managed resize-requests list diff --git a/gcloud/beta/compute/instance-templates/create b/gcloud/beta/compute/instance-templates/create index 9dc2e6bf2..ecbb46c77 100644 --- a/gcloud/beta/compute/instance-templates/create +++ b/gcloud/beta/compute/instance-templates/create @@ -11,6 +11,7 @@ SYNOPSIS [--boot-disk-size=BOOT_DISK_SIZE] [--boot-disk-type=BOOT_DISK_TYPE] [--can-ip-forward] [--configure-disk=[PROPERTY=VALUE,...]] [--create-disk=[PROPERTY=VALUE,...]] [--description=DESCRIPTION] + [--discard-local-ssds-at-termination-timestamp=DISCARD_LOCAL_SSDS_AT_TERMINATION_TIMESTAMP] [--disk=[auto-delete=AUTO-DELETE], [boot=BOOT],[device-name=DEVICE-NAME],[mode=MODE],[name=NAME]] [--[no-]enable-nested-virtualization] [--[no-]enable-uefi-networking] @@ -336,6 +337,21 @@ FLAGS --description=DESCRIPTION Specifies a textual description for the instance template. + --discard-local-ssds-at-termination-timestamp=DISCARD_LOCAL_SSDS_AT_TERMINATION_TIMESTAMP + Required and only allowed for VMs that have one or more local SSDs, use + --termination-action=STOP (default), and use either --max-run-duration + or --termination-time. This flag indicates whether you want Compute + Engine to discard (true) or preserve (false) local SSD data when the + VM's terminationTimestamp is reached. + + If set to false, Compute Engine will preserve local SSD data by + including the --discard-local-ssd=false flag in the automatic + termination command. The --discard-local-ssd=false flag preserves local + SSD data by migrating it to persistent storage until you rerun the VM. + Importantly, preserving local SSD data incurs costs and is subject to + restrictions. For more information, see + https://cloud.google.com/compute/docs/disks/local-ssd#stop_instance. + --disk=[auto-delete=AUTO-DELETE],[boot=BOOT],[device-name=DEVICE-NAME],[mode=MODE],[name=NAME] Attaches an existing persistent disk to the instances. diff --git a/gcloud/beta/compute/instances/bulk/create b/gcloud/beta/compute/instances/bulk/create index 563e82dd1..f0db9d215 100644 --- a/gcloud/beta/compute/instances/bulk/create +++ b/gcloud/beta/compute/instances/bulk/create @@ -14,6 +14,7 @@ SYNOPSIS [--boot-disk-size=BOOT_DISK_SIZE] [--boot-disk-type=BOOT_DISK_TYPE] [--can-ip-forward] [--count=COUNT] [--create-disk=[PROPERTY=VALUE,...]] [--description=DESCRIPTION] + [--discard-local-ssds-at-termination-timestamp=DISCARD_LOCAL_SSDS_AT_TERMINATION_TIMESTAMP] [--disk=[boot=BOOT], [device-name=DEVICE-NAME],[name=NAME],[scope=SCOPE]] [--enable-display-device] [--[no-]enable-nested-virtualization] @@ -377,6 +378,21 @@ OPTIONAL FLAGS --description=DESCRIPTION Specifies a textual description of the instances. + --discard-local-ssds-at-termination-timestamp=DISCARD_LOCAL_SSDS_AT_TERMINATION_TIMESTAMP + Required and only allowed for VMs that have one or more local SSDs, use + --termination-action=STOP (default), and use either --max-run-duration + or --termination-time. This flag indicates whether you want Compute + Engine to discard (true) or preserve (false) local SSD data when the + VM's terminationTimestamp is reached. + + If set to false, Compute Engine will preserve local SSD data by + including the --discard-local-ssd=false flag in the automatic + termination command. The --discard-local-ssd=false flag preserves local + SSD data by migrating it to persistent storage until you rerun the VM. + Importantly, preserving local SSD data incurs costs and is subject to + restrictions. For more information, see + https://cloud.google.com/compute/docs/disks/local-ssd#stop_instance. + --disk=[boot=BOOT],[device-name=DEVICE-NAME],[name=NAME],[scope=SCOPE] Attaches persistent disks to the instances. The disks specified must already exist. diff --git a/gcloud/beta/compute/instances/create b/gcloud/beta/compute/instances/create index d3349ef07..bcca1d1d5 100644 --- a/gcloud/beta/compute/instances/create +++ b/gcloud/beta/compute/instances/create @@ -13,6 +13,7 @@ SYNOPSIS [--can-ip-forward] [--create-disk=[PROPERTY=VALUE,...]] [--csek-key-file=FILE] [--deletion-protection] [--description=DESCRIPTION] + [--discard-local-ssds-at-termination-timestamp=DISCARD_LOCAL_SSDS_AT_TERMINATION_TIMESTAMP] [--disk=[auto-delete=AUTO-DELETE],[boot=BOOT],[device-name=DEVICE-NAME], [force-attach=FORCE-ATTACH],[mode=MODE],[name=NAME],[scope=SCOPE]] [--enable-display-device] [--[no-]enable-nested-virtualization] @@ -382,6 +383,21 @@ FLAGS --description=DESCRIPTION Specifies a textual description of the instances. + --discard-local-ssds-at-termination-timestamp=DISCARD_LOCAL_SSDS_AT_TERMINATION_TIMESTAMP + Required and only allowed for VMs that have one or more local SSDs, use + --termination-action=STOP (default), and use either --max-run-duration + or --termination-time. This flag indicates whether you want Compute + Engine to discard (true) or preserve (false) local SSD data when the + VM's terminationTimestamp is reached. + + If set to false, Compute Engine will preserve local SSD data by + including the --discard-local-ssd=false flag in the automatic + termination command. The --discard-local-ssd=false flag preserves local + SSD data by migrating it to persistent storage until you rerun the VM. + Importantly, preserving local SSD data incurs costs and is subject to + restrictions. For more information, see + https://cloud.google.com/compute/docs/disks/local-ssd#stop_instance. + --disk=[auto-delete=AUTO-DELETE],[boot=BOOT],[device-name=DEVICE-NAME],[force-attach=FORCE-ATTACH],[mode=MODE],[name=NAME],[scope=SCOPE] Attaches an existing persistent disk to the instances. @@ -500,9 +516,9 @@ FLAGS --ipv6-public-ptr-domain=IPV6_PUBLIC_PTR_DOMAIN Assigns a custom PTR domain for the external IPv6 in the IPv6 access - configuration of instance. If its value is not specified, the default - PTR record will be used. This option can only be specified for the - default network interface, nic0. + configuration of instance. If unspecified or specified to be an empty + string, the default PTR record will be used. This option can only be + specified for the default network interface, nic0. --key-revocation-action-type=POLICY Specifies the behavior of the instance when the KMS key of one of its diff --git a/gcloud/beta/compute/instances/set-scheduling b/gcloud/beta/compute/instances/set-scheduling index ed72e3dc7..20bf7a8de 100644 --- a/gcloud/beta/compute/instances/set-scheduling +++ b/gcloud/beta/compute/instances/set-scheduling @@ -10,6 +10,8 @@ SYNOPSIS [--maintenance-policy=MAINTENANCE_POLICY] [--min-node-cpu=MIN_NODE_CPU] [--[no-]preemptible] [--provisioning-model=PROVISIONING_MODEL] [--[no-]restart-on-failure] [--zone=ZONE] + [--clear-discard-local-ssds-at-termination-timestamp + | --discard-local-ssds-at-termination-timestamp=DISCARD_LOCAL_SSDS_AT_TERMINATION_TIMESTAMP] [--clear-instance-termination-action | --instance-termination-action=INSTANCE_TERMINATION_ACTION] [--clear-max-run-duration | --max-run-duration=MAX_RUN_DURATION] @@ -119,6 +121,29 @@ FLAGS Alternatively, the zone can be stored in the environment variable CLOUDSDK_COMPUTE_ZONE. + Discard Local SSDs At Termination Timestamp + + At most one of these can be specified: + + --clear-discard-local-ssds-at-termination-timestamp + Removes the discard-local-ssds-at-termination-timestamp field from + the scheduling options. + + --discard-local-ssds-at-termination-timestamp=DISCARD_LOCAL_SSDS_AT_TERMINATION_TIMESTAMP + Required and only allowed for VMs that have one or more local SSDs, + use --termination-action=STOP (default), and use either + --max-run-duration or --termination-time. This flag indicates whether + you want Compute Engine to discard (true) or preserve (false) local + SSD data when the VM's terminationTimestamp is reached. + + If set to false, Compute Engine will preserve local SSD data by + including the --discard-local-ssd=false flag in the automatic + termination command. The --discard-local-ssd=false flag preserves + local SSD data by migrating it to persistent storage until you rerun + the VM. Importantly, preserving local SSD data incurs costs and is + subject to restrictions. For more information, see + https://cloud.google.com/compute/docs/disks/local-ssd#stop_instance. + Instance Termination Action At most one of these can be specified: diff --git a/gcloud/beta/compute/storage-pool-types/describe b/gcloud/beta/compute/storage-pool-types/describe new file mode 100644 index 000000000..971057815 --- /dev/null +++ b/gcloud/beta/compute/storage-pool-types/describe @@ -0,0 +1,70 @@ +NAME + gcloud beta compute storage-pool-types describe - describe a storage pool + type + +SYNOPSIS + gcloud beta compute storage-pool-types describe + (STORAGE_POOL_TYPE : --zone=ZONE) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Describe a storage pool. + +EXAMPLES + To retrieve a single storage pool type and print its properties, run the + following command: + + $ gcloud beta compute storage-pool-types describe my-storage-pool + +POSITIONAL ARGUMENTS + Storage pool type resource - Name of the storage pool you want to inspect. + 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 storage_pool_type on the command line with a + fully specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + STORAGE_POOL_TYPE + ID of the storage pool type or fully qualified identifier for the + storage pool type. + + To set the storage_pool_type attribute: + ▸ provide the argument storage_pool_type 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 storage_pool_type 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/beta API. The full documentation for this API + 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 storage-pool-types describe + + $ gcloud alpha compute storage-pool-types describe + diff --git a/gcloud/beta/compute/storage-pool-types/help b/gcloud/beta/compute/storage-pool-types/help new file mode 100644 index 000000000..0c160c0bb --- /dev/null +++ b/gcloud/beta/compute/storage-pool-types/help @@ -0,0 +1,31 @@ +NAME + gcloud beta compute storage-pool-types - read storage pool types + +SYNOPSIS + gcloud beta compute storage-pool-types COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Read Compute Engine storage pool types. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + (BETA) Describe a storage pool type. + + list + (BETA) View storage pools types. + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud compute storage-pool-types + + $ gcloud alpha compute storage-pool-types + diff --git a/gcloud/beta/compute/storage-pool-types/list b/gcloud/beta/compute/storage-pool-types/list new file mode 100644 index 000000000..b6d82c269 --- /dev/null +++ b/gcloud/beta/compute/storage-pool-types/list @@ -0,0 +1,69 @@ +NAME + gcloud beta compute storage-pool-types list - view storage pools types + +SYNOPSIS + gcloud beta compute storage-pool-types list [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) View storage pools. + +EXAMPLES + To display all storage pool types and their locations visible the project, + run the following command: + + $ gcloud beta compute storage-pool-types list + + The --filter option can be used to filter down available options. To + display all available storage pool types in US-based zones, run the + following command: + + $ gcloud beta compute storage-pool-types list --filter="zone ~ us" + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the compute/beta API. The full documentation for this API + 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 storage-pool-types list + + $ gcloud alpha compute storage-pool-types list + diff --git a/gcloud/beta/compute/storage-pools/create b/gcloud/beta/compute/storage-pools/create new file mode 100644 index 000000000..86aec8faf --- /dev/null +++ b/gcloud/beta/compute/storage-pools/create @@ -0,0 +1,127 @@ +NAME + gcloud beta compute storage-pools create - create a storage pool + +SYNOPSIS + gcloud beta compute storage-pools create STORAGE_POOL + --provisioned-capacity=PROVISIONED_CAPACITY + --storage-pool-type=STORAGE_POOL_TYPE [--async] + [--capacity-provisioning-type=CAPACITY_PROVISIONING_TYPE] + [--description=DESCRIPTION] + [--performance-provisioning-type=PERFORMANCE_PROVISIONING_TYPE] + [--provisioned-iops=PROVISIONED_IOPS] + [--provisioned-throughput=PROVISIONED_THROUGHPUT] [--zone=ZONE] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Create a storage pool. + +EXAMPLES + To create a new storage pool named my-storage-pool, run the following + command: + + $ gcloud beta compute storage-pools create my-storage-pool \ + --storage-pool-type=hyperdisk-throughput \ + --provisioned-capacity=10TB --provisioned-throughput=200 + +POSITIONAL ARGUMENTS + Storage pool resource - The name of the storage pool you want to create. + 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 storage_pool on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + To set the zone attribute: + ◆ provide the argument storage_pool on the command line with a fully + specified name; + ◆ provide the argument --zone on the command line; + ◆ set the property compute/zone. + + This must be specified. + + STORAGE_POOL + ID of the storage pool or fully qualified identifier for the storage + pool. + + To set the storage_pool attribute: + ▸ provide the argument storage_pool on the command line. + +REQUIRED FLAGS + --provisioned-capacity=PROVISIONED_CAPACITY + Provisioned capacity of the storage pool. + + Storage pool type resource - Type of the storage pool. 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 --storage-pool-type on the command line with a + fully specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + To set the zone attribute: + ◆ provide the argument --storage-pool-type on the command line with a + fully specified name; + ◆ provide the argument --zone on the command line; + ◆ set the property compute/zone. + + This must be specified. + + --storage-pool-type=STORAGE_POOL_TYPE + ID of the storage pool type or fully qualified identifier for the + storage pool type. + + To set the storage-pool-type attribute: + ▸ provide the argument --storage-pool-type on the command line. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --capacity-provisioning-type=CAPACITY_PROVISIONING_TYPE + Capacity provisioning type. CAPACITY_PROVISIONING_TYPE must be one of: + advanced, standard. + + --description=DESCRIPTION + Description of the storage pool. + + --performance-provisioning-type=PERFORMANCE_PROVISIONING_TYPE + Performance provisioning type. PERFORMANCE_PROVISIONING_TYPE must be + one of: advanced, standard. + + --provisioned-iops=PROVISIONED_IOPS + IOPS with which to provision the pool. + + --provisioned-throughput=PROVISIONED_THROUGHPUT + Throughput in MB/s with which to provision the pool. + + --zone=ZONE + For resources [storage pool, storage pool type], provides fallback + value for resource zone attribute. When the resource's full URI path is + not provided, zone will fallback to this flag value. + +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/beta API. The full documentation for this API + 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 storage-pools create + + $ gcloud alpha compute storage-pools create + diff --git a/gcloud/beta/compute/storage-pools/delete b/gcloud/beta/compute/storage-pools/delete new file mode 100644 index 000000000..af5c7e707 --- /dev/null +++ b/gcloud/beta/compute/storage-pools/delete @@ -0,0 +1,74 @@ +NAME + gcloud beta compute storage-pools delete - delete a storage pool + +SYNOPSIS + gcloud beta compute storage-pools delete (STORAGE_POOL : --zone=ZONE) + [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Deleta a storage pool. + +EXAMPLES + To delete a single storage pool named my-storage-pool, run the following + command: + + $ gcloud beta compute storage-pools delete my-storage-pool + +POSITIONAL ARGUMENTS + Storage pool resource - Name of the storage pool 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 storage_pool on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + STORAGE_POOL + ID of the storage pool or fully qualified identifier for the storage + pool. + + To set the storage_pool attribute: + ▸ provide the argument storage_pool 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 storage_pool 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/beta API. The full documentation for this API + 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 storage-pools delete + + $ gcloud alpha compute storage-pools delete + diff --git a/gcloud/beta/compute/storage-pools/describe b/gcloud/beta/compute/storage-pools/describe new file mode 100644 index 000000000..8d0cf0c31 --- /dev/null +++ b/gcloud/beta/compute/storage-pools/describe @@ -0,0 +1,69 @@ +NAME + gcloud beta compute storage-pools describe - describe a storage pool + +SYNOPSIS + gcloud beta compute storage-pools describe (STORAGE_POOL : --zone=ZONE) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Describe a storage pool. + +EXAMPLES + To retrieve a single storage pool and print its properties, run the + following command: + + $ gcloud beta compute storage-pools describe my-storage-pool + +POSITIONAL ARGUMENTS + Storage pool resource - Name of the storage pool you want to inspect. 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 storage_pool on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + STORAGE_POOL + ID of the storage pool or fully qualified identifier for the storage + pool. + + To set the storage_pool attribute: + ▸ provide the argument storage_pool 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 storage_pool 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/beta API. The full documentation for this API + 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 storage-pools describe + + $ gcloud alpha compute storage-pools describe + diff --git a/gcloud/beta/compute/storage-pools/get-iam-policy b/gcloud/beta/compute/storage-pools/get-iam-policy new file mode 100644 index 000000000..ebfaf8581 --- /dev/null +++ b/gcloud/beta/compute/storage-pools/get-iam-policy @@ -0,0 +1,97 @@ +NAME + gcloud beta compute storage-pools get-iam-policy - get the IAM policy of a + storage pool + +SYNOPSIS + gcloud beta compute storage-pools get-iam-policy + (STORAGE_POOL : --zone=ZONE) [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Get the IAM policy of a storage pool. + +EXAMPLES + The following command retrieves the IAM configuration of the specified + storage pool. + + $ gcloud beta compute storage-pools get-iam-policy my-storage-pool + +POSITIONAL ARGUMENTS + Storage pool resource - Storage pool you want to get the IAM permissions + of. 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 storage_pool on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + STORAGE_POOL + ID of the storage pool or fully qualified identifier for the storage + pool. + + To set the storage_pool attribute: + ▸ provide the argument storage_pool 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 storage_pool on the command line with a + fully specified name; + ▸ provide the argument --zone on the command line; + ▸ set the property compute/zone. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the compute/beta API. The full documentation for this API + 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 storage-pools get-iam-policy + + $ gcloud alpha compute storage-pools get-iam-policy + diff --git a/gcloud/beta/compute/storage-pools/help b/gcloud/beta/compute/storage-pools/help new file mode 100644 index 000000000..03b50b3bc --- /dev/null +++ b/gcloud/beta/compute/storage-pools/help @@ -0,0 +1,49 @@ +NAME + gcloud beta compute storage-pools - read and manipulate storage pools + +SYNOPSIS + gcloud beta compute storage-pools COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Read and manipulate Compute Engine storage pools. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (BETA) Create a storage pool. + + delete + (BETA) Delete a storage pool. + + describe + (BETA) Describe a storage pool. + + get-iam-policy + (BETA) Get the IAM policy of a storage pool. + + list + (BETA) View storage pools. + + list-disks + (BETA) View the disks that are in a storage pool. + + set-iam-policy + (BETA) Set the IAM policy of the given storage pool. + + update + (BETA) Update a storage pool. + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud compute storage-pools + + $ gcloud alpha compute storage-pools + diff --git a/gcloud/beta/compute/storage-pools/list b/gcloud/beta/compute/storage-pools/list new file mode 100644 index 000000000..2031b3cb2 --- /dev/null +++ b/gcloud/beta/compute/storage-pools/list @@ -0,0 +1,92 @@ +NAME + gcloud beta compute storage-pools list - view storage pools + +SYNOPSIS + gcloud beta compute storage-pools list [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) View storage pools. + + The compact default output format is explained below: + + The type column contains all three types -- storage pool type, capacity and + performance. For example, the value + + > "Hdb/Adv/Std" + + means the storage pool type is "hyperdisk-balanced", its capacity type is + "advanced", and its performance type is "standard." + + The list of storage pool abbreviations is as follows: + + ▪ HdB: Hyperdisk Balanced + ▪ HdT: Hyperdisk Throughput + + The list of capacity/performance abbreviations is as follows: + + ▪ Adv: Advanced + ▪ Std: Standard + + The capacity, iops and throughput columns describe used, provisioned, the + utilization rate. For example, the following value for capacity: + + 40 / 50 (80%) + + means 40 TB of it is used, 50 TB provisioned, and its utilization rate is + 80%. The utilization rate is equivalent to used capacity divided by + provisioned capacity. + +EXAMPLES + To display all storage pools in all regions and zones, run the following + command: + + $ gcloud beta compute storage-pools list + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + +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/beta API. The full documentation for this API + 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 storage-pools list + + $ gcloud alpha compute storage-pools list + diff --git a/gcloud/beta/compute/storage-pools/list-disks b/gcloud/beta/compute/storage-pools/list-disks new file mode 100644 index 000000000..691a904cf --- /dev/null +++ b/gcloud/beta/compute/storage-pools/list-disks @@ -0,0 +1,70 @@ +NAME + gcloud beta compute storage-pools list-disks - view the disks that are in a + storage pool + +SYNOPSIS + gcloud beta compute storage-pools list-disks (STORAGE_POOL : --zone=ZONE) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) View the disks that are in a given storage pool. + +EXAMPLES + The following command retrieves all disks belonging to a storage pool and + lists them: + + $ gcloud beta compute storage-pools list-disks my-storage-pool + +POSITIONAL ARGUMENTS + Storage pool resource - Name of the storage pool you want to inspect. 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 storage_pool on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + STORAGE_POOL + ID of the storage pool or fully qualified identifier for the storage + pool. + + To set the storage_pool attribute: + ▸ provide the argument storage_pool 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 storage_pool 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/beta API. The full documentation for this API + 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 storage-pools list-disks + + $ gcloud alpha compute storage-pools list-disks + diff --git a/gcloud/beta/compute/storage-pools/set-iam-policy b/gcloud/beta/compute/storage-pools/set-iam-policy new file mode 100644 index 000000000..e1de4c11b --- /dev/null +++ b/gcloud/beta/compute/storage-pools/set-iam-policy @@ -0,0 +1,78 @@ +NAME + gcloud beta compute storage-pools set-iam-policy - set the IAM policy of + the given storage pool + +SYNOPSIS + gcloud beta compute storage-pools set-iam-policy + (STORAGE_POOL : --zone=ZONE) POLICY_FILE [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Set the IAM policy of the given storage pool. + +EXAMPLES + The following command sets the IAM configuration of the specified storage + pool with the specified policy file. + + $ gcloud beta compute storage-pools set-iam-policy my-storage-pool \ + policy.json + +POSITIONAL ARGUMENTS + Storage pool resource - Storage pool you want to get the IAM permissions + of. 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 storage_pool on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + STORAGE_POOL + ID of the storage pool or fully qualified identifier for the storage + pool. + + To set the storage_pool attribute: + ▸ provide the argument storage_pool 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 storage_pool on the command line with a + fully specified name; + ▸ provide the argument --zone on the command line; + ▸ set the property compute/zone. + + POLICY_FILE + Path to a local JSON or YAML formatted file containing a valid policy. + + The output of the get-iam-policy command is a valid file, as is any + JSON or YAML file conforming to the structure of a Policy + (https://cloud.google.com/iam/reference/rest/v1/Policy). + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the compute/beta API. The full documentation for this API + 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 storage-pools set-iam-policy + + $ gcloud alpha compute storage-pools set-iam-policy + diff --git a/gcloud/beta/compute/storage-pools/update b/gcloud/beta/compute/storage-pools/update new file mode 100644 index 000000000..f69300558 --- /dev/null +++ b/gcloud/beta/compute/storage-pools/update @@ -0,0 +1,91 @@ +NAME + gcloud beta compute storage-pools update - update a storage pool + +SYNOPSIS + gcloud beta compute storage-pools update (STORAGE_POOL : --zone=ZONE) + [--async] [--description=DESCRIPTION] + [--provisioned-capacity=PROVISIONED_CAPACITY] + [--provisioned-iops=PROVISIONED_IOPS] + [--provisioned-throughput=PROVISIONED_THROUGHPUT] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Update a storage pool. + +EXAMPLES + To update the size of a storage pool named 'my-storage-pool', run th + following command: + + $ gcloud beta compute storage-pools update my-storage-pool \ + --provisioned-capacity=20TB + +POSITIONAL ARGUMENTS + Storage pool resource - Storage pool you want to update. The arguments in + this group can be used to specify the attributes of this resource. (NOTE) + Some attributes are not given arguments in this group but can be set in + other ways. + + To set the project attribute: + ◆ provide the argument storage_pool on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + STORAGE_POOL + ID of the storage pool or fully qualified identifier for the storage + pool. + + To set the storage_pool attribute: + ▸ provide the argument storage_pool 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 storage_pool 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. + + --description=DESCRIPTION + Description of the storage pool. + + --provisioned-capacity=PROVISIONED_CAPACITY + Provisioned capacity of the storage pool. + + --provisioned-iops=PROVISIONED_IOPS + IOPS to provision the pool with. + + --provisioned-throughput=PROVISIONED_THROUGHPUT + Throughput in MB/s provision the pool with. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the compute/beta API. The full documentation for this API + 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 storage-pools update + + $ gcloud alpha compute storage-pools update + diff --git a/gcloud/beta/container/clusters/create b/gcloud/beta/container/clusters/create index 7948a779e..5f98861ef 100644 --- a/gcloud/beta/container/clusters/create +++ b/gcloud/beta/container/clusters/create @@ -78,7 +78,9 @@ SYNOPSIS --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE | --enable-binauthz] [--cluster-dns=CLUSTER_DNS --cluster-dns-domain=CLUSTER_DNS_DOMAIN - --cluster-dns-scope=CLUSTER_DNS_SCOPE] + --cluster-dns-scope=CLUSTER_DNS_SCOPE + --additive-vpc-scope-dns-domain=ADDITIVE_VPC_SCOPE_DNS_DOMAIN + | --disable-additive-vpc-scope] [--dataplane-v2-observability-mode=DATAPLANE_V2_OBSERVABILITY_MODE | --disable-dataplane-v2-flow-observability | --enable-dataplane-v2-flow-observability] @@ -1093,13 +1095,16 @@ FLAGS 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 enable in standard mode explicitly set the flag to --security-posture=standard To disable in an existing cluster, explicitly set the flag to --security-posture=disabled. - SECURITY_POSTURE must be one of: disabled, standard. + SECURITY_POSTURE must be one of: disabled, standard, enterprise. --services-ipv4-cidr=CIDR Set the IP range for the services IPs. @@ -1393,6 +1398,17 @@ FLAGS vpc Configures the Cloud DNS zone to be private to the VPC Network. + ClusterDNS_AdditiveVPCScope_EnabledDisable + + At most one of these can be specified: + + --additive-vpc-scope-dns-domain=ADDITIVE_VPC_SCOPE_DNS_DOMAIN + The domain used in Additive VPC scope. Only works with Cluster + Scope. + + --disable-additive-vpc-scope + Disables Additive VPC Scope. + At most one of these can be specified: --dataplane-v2-observability-mode=DATAPLANE_V2_OBSERVABILITY_MODE diff --git a/gcloud/beta/container/clusters/create-auto b/gcloud/beta/container/clusters/create-auto index d56c6c92f..6cce4cc32 100644 --- a/gcloud/beta/container/clusters/create-auto +++ b/gcloud/beta/container/clusters/create-auto @@ -24,6 +24,8 @@ SYNOPSIS [--services-secondary-range-name=NAME] [--subnetwork=SUBNETWORK] [--workload-policies=WORKLOAD_POLICIES] [--workload-vulnerability-scanning=WORKLOAD_VULNERABILITY_SCANNING] + [--additive-vpc-scope-dns-domain=ADDITIVE_VPC_SCOPE_DNS_DOMAIN + | --disable-additive-vpc-scope] [--binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE --binauthz-policy-bindings=[name=BINAUTHZ_POLICY]] [--dataplane-v2-observability-mode=DATAPLANE_V2_OBSERVABILITY_MODE @@ -329,13 +331,16 @@ FLAGS 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 enable in standard mode explicitly set the flag to --security-posture=standard To disable in an existing cluster, explicitly set the flag to --security-posture=disabled. - SECURITY_POSTURE must be one of: disabled, standard. + SECURITY_POSTURE must be one of: disabled, standard, enterprise. --services-ipv4-cidr=CIDR Set the IP range for the services IPs. @@ -388,6 +393,16 @@ FLAGS WORKLOAD_VULNERABILITY_SCANNING must be one of: disabled, standard, enterprise. + ClusterDNS_AdditiveVPCScope_EnabledDisable + + At most one of these can be specified: + + --additive-vpc-scope-dns-domain=ADDITIVE_VPC_SCOPE_DNS_DOMAIN + The domain used in Additive VPC scope. Only works with Cluster Scope. + + --disable-additive-vpc-scope + Disables Additive VPC Scope. + Flags for Binary Authorization: --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE diff --git a/gcloud/beta/container/clusters/update b/gcloud/beta/container/clusters/update index f17ab4acb..9e583b04f 100644 --- a/gcloud/beta/container/clusters/update +++ b/gcloud/beta/container/clusters/update @@ -63,6 +63,8 @@ SYNOPSIS --resource-usage-bigquery-dataset=RESOURCE_USAGE_BIGQUERY_DATASET | --cluster-dns=CLUSTER_DNS --cluster-dns-domain=CLUSTER_DNS_DOMAIN --cluster-dns-scope=CLUSTER_DNS_SCOPE + --additive-vpc-scope-dns-domain=ADDITIVE_VPC_SCOPE_DNS_DOMAIN + | --disable-additive-vpc-scope | --dataplane-v2-observability-mode=DATAPLANE_V2_OBSERVABILITY_MODE | --disable-dataplane-v2-flow-observability | --enable-dataplane-v2-flow-observability @@ -606,13 +608,16 @@ REQUIRED FLAGS 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 enable in standard mode explicitly set the flag to --security-posture=standard To disable in an existing cluster, explicitly set the flag to --security-posture=disabled. - SECURITY_POSTURE must be one of: disabled, standard. + SECURITY_POSTURE must be one of: disabled, standard, enterprise. --set-password Set the basic auth password to the specified value, keeping the @@ -957,6 +962,17 @@ REQUIRED FLAGS vpc Configures the Cloud DNS zone to be private to the VPC Network. + ClusterDNS_AdditiveVPCScope_EnabledDisable + + At most one of these can be specified: + + --additive-vpc-scope-dns-domain=ADDITIVE_VPC_SCOPE_DNS_DOMAIN + The domain used in Additive VPC scope. Only works with Cluster + Scope. + + --disable-additive-vpc-scope + Disables Additive VPC Scope. + At most one of these can be specified: --dataplane-v2-observability-mode=DATAPLANE_V2_OBSERVABILITY_MODE diff --git a/gcloud/beta/container/fleet/scopes/help b/gcloud/beta/container/fleet/scopes/help index a1c81edf7..f6260f5e3 100644 --- a/gcloud/beta/container/fleet/scopes/help +++ b/gcloud/beta/container/fleet/scopes/help @@ -41,7 +41,11 @@ COMMANDS (BETA) Get the IAM policy for a Fleet Scope. list - (BETA) List fleet scopes in a project. + (BETA) List fleet scopes in a project permitted to be viewed by the + caller. + + list-memberships + (BETA) List memberships bound to a fleet scope. remove-iam-policy-binding (BETA) Remove IAM policy binding of a Fleet Scope. diff --git a/gcloud/beta/container/fleet/scopes/list b/gcloud/beta/container/fleet/scopes/list index 233f98d8e..32784695e 100644 --- a/gcloud/beta/container/fleet/scopes/list +++ b/gcloud/beta/container/fleet/scopes/list @@ -1,5 +1,6 @@ NAME gcloud beta container fleet scopes list - list fleet scopes in a project + permitted to be viewed by the caller SYNOPSIS gcloud beta container fleet scopes list [--filter=EXPRESSION] diff --git a/gcloud/beta/container/fleet/scopes/list-memberships b/gcloud/beta/container/fleet/scopes/list-memberships new file mode 100644 index 000000000..fa35d710f --- /dev/null +++ b/gcloud/beta/container/fleet/scopes/list-memberships @@ -0,0 +1,93 @@ +NAME + gcloud beta container fleet scopes list-memberships - list memberships + bound to a fleet scope + +SYNOPSIS + gcloud beta container fleet scopes list-memberships SCOPE + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) This command can fail for the following reasons: + ▪ The scope specified does not exist. + ▪ The user does not have access to the specified scope. + +EXAMPLES + The following command lists memberships bound to scope SCOPE in project + PROJECT_ID: + + $ gcloud beta container fleet scopes list-memberships SCOPE \ + --project=PROJECT_ID + +POSITIONAL ARGUMENTS + Scope resource - The group of arguments defining the Fleet Scope. 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 SCOPE on the command line with a fully specified + name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument SCOPE on the command line with a fully specified + name; + ◆ global is the only supported location. + + This must be specified. + + SCOPE + ID of the scope or fully qualified identifier for the scope. + + To set the scope attribute: + ▸ provide the argument SCOPE on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container fleet scopes list-memberships + + $ gcloud alpha container fleet scopes list-memberships + diff --git a/gcloud/beta/container/hub/scopes/help b/gcloud/beta/container/hub/scopes/help index b2ac287c1..4c6c288f8 100644 --- a/gcloud/beta/container/hub/scopes/help +++ b/gcloud/beta/container/hub/scopes/help @@ -41,7 +41,11 @@ COMMANDS (BETA) Get the IAM policy for a Fleet Scope. list - (BETA) List fleet scopes in a project. + (BETA) List fleet scopes in a project permitted to be viewed by the + caller. + + list-memberships + (BETA) List memberships bound to a fleet scope. remove-iam-policy-binding (BETA) Remove IAM policy binding of a Fleet Scope. diff --git a/gcloud/beta/container/hub/scopes/list b/gcloud/beta/container/hub/scopes/list index fc3f527f8..42861331a 100644 --- a/gcloud/beta/container/hub/scopes/list +++ b/gcloud/beta/container/hub/scopes/list @@ -1,5 +1,6 @@ NAME gcloud beta container hub scopes list - list fleet scopes in a project + permitted to be viewed by the caller SYNOPSIS gcloud beta container hub scopes list [--filter=EXPRESSION] [--limit=LIMIT] diff --git a/gcloud/beta/container/hub/scopes/list-memberships b/gcloud/beta/container/hub/scopes/list-memberships new file mode 100644 index 000000000..081f71e30 --- /dev/null +++ b/gcloud/beta/container/hub/scopes/list-memberships @@ -0,0 +1,93 @@ +NAME + gcloud beta container hub scopes list-memberships - list memberships bound + to a fleet scope + +SYNOPSIS + gcloud beta container hub scopes list-memberships SCOPE + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) This command can fail for the following reasons: + ▪ The scope specified does not exist. + ▪ The user does not have access to the specified scope. + +EXAMPLES + The following command lists memberships bound to scope SCOPE in project + PROJECT_ID: + + $ gcloud beta container hub scopes list-memberships SCOPE \ + --project=PROJECT_ID + +POSITIONAL ARGUMENTS + Scope resource - The group of arguments defining the Fleet Scope. 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 SCOPE on the command line with a fully specified + name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument SCOPE on the command line with a fully specified + name; + ◆ global is the only supported location. + + This must be specified. + + SCOPE + ID of the scope or fully qualified identifier for the scope. + + To set the scope attribute: + ▸ provide the argument SCOPE on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container hub scopes list-memberships + + $ gcloud alpha container hub scopes list-memberships + diff --git a/gcloud/beta/netapp/backup-policies/create b/gcloud/beta/netapp/backup-policies/create index dd664c6c2..2d1dfd83c 100644 --- a/gcloud/beta/netapp/backup-policies/create +++ b/gcloud/beta/netapp/backup-policies/create @@ -101,5 +101,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud netapp backup-policies create diff --git a/gcloud/beta/netapp/backup-policies/delete b/gcloud/beta/netapp/backup-policies/delete index 09520459b..15cd8f426 100644 --- a/gcloud/beta/netapp/backup-policies/delete +++ b/gcloud/beta/netapp/backup-policies/delete @@ -67,5 +67,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud netapp backup-policies delete diff --git a/gcloud/beta/netapp/backup-policies/describe b/gcloud/beta/netapp/backup-policies/describe index f7018f5a4..d175d4b56 100644 --- a/gcloud/beta/netapp/backup-policies/describe +++ b/gcloud/beta/netapp/backup-policies/describe @@ -63,5 +63,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud netapp backup-policies describe diff --git a/gcloud/beta/netapp/backup-policies/help b/gcloud/beta/netapp/backup-policies/help index fc0a67669..01251e313 100644 --- a/gcloud/beta/netapp/backup-policies/help +++ b/gcloud/beta/netapp/backup-policies/help @@ -32,5 +32,8 @@ COMMANDS (BETA) Update a Cloud NetApp Volumes Backup Policies. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud netapp backup-policies diff --git a/gcloud/beta/netapp/backup-policies/list b/gcloud/beta/netapp/backup-policies/list index 59d72e60e..6b169a63f 100644 --- a/gcloud/beta/netapp/backup-policies/list +++ b/gcloud/beta/netapp/backup-policies/list @@ -82,5 +82,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud netapp backup-policies list diff --git a/gcloud/beta/netapp/backup-policies/update b/gcloud/beta/netapp/backup-policies/update index 276271531..59cf55844 100644 --- a/gcloud/beta/netapp/backup-policies/update +++ b/gcloud/beta/netapp/backup-policies/update @@ -129,5 +129,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud netapp backup-policies update diff --git a/gcloud/beta/netapp/backup-vaults/backups/create b/gcloud/beta/netapp/backup-vaults/backups/create index eeacdc8e1..9f4a05522 100644 --- a/gcloud/beta/netapp/backup-vaults/backups/create +++ b/gcloud/beta/netapp/backup-vaults/backups/create @@ -161,5 +161,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud netapp backup-vaults backups create diff --git a/gcloud/beta/netapp/backup-vaults/backups/delete b/gcloud/beta/netapp/backup-vaults/backups/delete index 73d36172f..a297adbdf 100644 --- a/gcloud/beta/netapp/backup-vaults/backups/delete +++ b/gcloud/beta/netapp/backup-vaults/backups/delete @@ -95,5 +95,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud netapp backup-vaults backups delete diff --git a/gcloud/beta/netapp/backup-vaults/backups/describe b/gcloud/beta/netapp/backup-vaults/backups/describe index 54ba05b26..73afa9f07 100644 --- a/gcloud/beta/netapp/backup-vaults/backups/describe +++ b/gcloud/beta/netapp/backup-vaults/backups/describe @@ -86,5 +86,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud netapp backup-vaults backups describe diff --git a/gcloud/beta/netapp/backup-vaults/backups/help b/gcloud/beta/netapp/backup-vaults/backups/help index 612501ec2..c87fac1b8 100644 --- a/gcloud/beta/netapp/backup-vaults/backups/help +++ b/gcloud/beta/netapp/backup-vaults/backups/help @@ -32,5 +32,8 @@ COMMANDS (BETA) Update a Cloud NetApp Backup. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud netapp backup-vaults backups diff --git a/gcloud/beta/netapp/backup-vaults/backups/list b/gcloud/beta/netapp/backup-vaults/backups/list index c60c59e31..0be4fff4a 100644 --- a/gcloud/beta/netapp/backup-vaults/backups/list +++ b/gcloud/beta/netapp/backup-vaults/backups/list @@ -102,5 +102,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud netapp backup-vaults backups list diff --git a/gcloud/beta/netapp/backup-vaults/backups/update b/gcloud/beta/netapp/backup-vaults/backups/update index e8a7716d9..01c4b2dc5 100644 --- a/gcloud/beta/netapp/backup-vaults/backups/update +++ b/gcloud/beta/netapp/backup-vaults/backups/update @@ -123,5 +123,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud netapp backup-vaults backups update diff --git a/gcloud/beta/netapp/backup-vaults/create b/gcloud/beta/netapp/backup-vaults/create index ace0a157f..fea6d2ae3 100644 --- a/gcloud/beta/netapp/backup-vaults/create +++ b/gcloud/beta/netapp/backup-vaults/create @@ -76,5 +76,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud netapp backup-vaults create diff --git a/gcloud/beta/netapp/backup-vaults/delete b/gcloud/beta/netapp/backup-vaults/delete index 5d8184e8d..355c5a6f4 100644 --- a/gcloud/beta/netapp/backup-vaults/delete +++ b/gcloud/beta/netapp/backup-vaults/delete @@ -67,5 +67,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud netapp backup-vaults delete diff --git a/gcloud/beta/netapp/backup-vaults/describe b/gcloud/beta/netapp/backup-vaults/describe index 7aabeb65d..401b4d0a3 100644 --- a/gcloud/beta/netapp/backup-vaults/describe +++ b/gcloud/beta/netapp/backup-vaults/describe @@ -63,5 +63,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud netapp backup-vaults describe diff --git a/gcloud/beta/netapp/backup-vaults/help b/gcloud/beta/netapp/backup-vaults/help index 321b80cd3..210b9fb0c 100644 --- a/gcloud/beta/netapp/backup-vaults/help +++ b/gcloud/beta/netapp/backup-vaults/help @@ -38,5 +38,8 @@ COMMANDS (BETA) Update a Cloud NetApp Volumes Backup Vault. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud netapp backup-vaults diff --git a/gcloud/beta/netapp/backup-vaults/list b/gcloud/beta/netapp/backup-vaults/list index c43595319..8c49a33fa 100644 --- a/gcloud/beta/netapp/backup-vaults/list +++ b/gcloud/beta/netapp/backup-vaults/list @@ -83,5 +83,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud netapp backup-vaults list diff --git a/gcloud/beta/netapp/backup-vaults/update b/gcloud/beta/netapp/backup-vaults/update index 0ddabe1be..6a4668c27 100644 --- a/gcloud/beta/netapp/backup-vaults/update +++ b/gcloud/beta/netapp/backup-vaults/update @@ -104,5 +104,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud netapp backup-vaults update diff --git a/gcloud/beta/network-connectivity/regional-endpoints/create b/gcloud/beta/network-connectivity/regional-endpoints/create index ffe8cba64..f9d372f19 100644 --- a/gcloud/beta/network-connectivity/regional-endpoints/create +++ b/gcloud/beta/network-connectivity/regional-endpoints/create @@ -5,7 +5,7 @@ NAME SYNOPSIS gcloud beta network-connectivity regional-endpoints create (REGIONAL_ENDPOINT : --region=REGION) - --target-google-api=TARGET_GOOGLE_API [--async] + --target-google-api=TARGET_GOOGLE_API [--address=ADDRESS] [--async] [--description=DESCRIPTION] [--enable-global-access] [--labels=[KEY=VALUE,...]] [--network=NETWORK] [--subnetwork=SUBNETWORK] [GCLOUD_WIDE_FLAG ...] @@ -59,6 +59,10 @@ REQUIRED FLAGS The service endpoint the regional endpoint will connect to. OPTIONAL FLAGS + --address=ADDRESS + The IP address or address resource URI of the Regional Endpoint. When + no address value is provided, an IP from the subnetwork is allocated. + --async Return immediately, without waiting for the operation in progress to complete. diff --git a/gcloud/beta/pubsub/subscriptions/create b/gcloud/beta/pubsub/subscriptions/create index 54eab03f9..0f289a359 100644 --- a/gcloud/beta/pubsub/subscriptions/create +++ b/gcloud/beta/pubsub/subscriptions/create @@ -15,12 +15,7 @@ SYNOPSIS [[--bigquery-table=BIGQUERY_TABLE : --drop-unknown-fields --write-metadata --use-table-schema | --use-topic-schema] | [--cloud-storage-bucket=CLOUD_STORAGE_BUCKET - : --cloud-storage-file-prefix=CLOUD_STORAGE_FILE_PREFIX - --cloud-storage-file-suffix=CLOUD_STORAGE_FILE_SUFFIX - --cloud-storage-max-bytes=CLOUD_STORAGE_MAX_BYTES - --cloud-storage-max-duration=CLOUD_STORAGE_MAX_DURATION - --cloud-storage-output-format=OUTPUT_FORMAT; - default="text" --cloud-storage-write-metadata]] + : --cloud-storage-file-datetime-format=CLOUD_STORAGE_FILE_DATETIME_FORMAT --cloud-storage-file-prefix=CLOUD_STORAGE_FILE_PREFIX --cloud-storage-file-suffix=CLOUD_STORAGE_FILE_SUFFIX --cloud-storage-max-bytes=CLOUD_STORAGE_MAX_BYTES --cloud-storage-max-duration=CLOUD_STORAGE_MAX_DURATION --cloud-storage-output-format=OUTPUT_FORMAT; default="text" --cloud-storage-write-metadata]] [--max-delivery-attempts=MAX_DELIVERY_ATTEMPTS [--dead-letter-topic=DEAD_LETTER_TOPIC : --dead-letter-topic-project=DEAD_LETTER_TOPIC_PROJECT]] @@ -207,6 +202,11 @@ OPTIONAL FLAGS This flag argument must be specified if any of the other arguments in this group are specified. + --cloud-storage-file-datetime-format=CLOUD_STORAGE_FILE_DATETIME_FORMAT + The custom datetime format string for Cloud Storage filename. See + the datetime format guidance + (https://cloud.google.com/pubsub/docs/create-cloudstorage-subscription#file_names). + --cloud-storage-file-prefix=CLOUD_STORAGE_FILE_PREFIX The prefix for Cloud Storage filename. diff --git a/gcloud/beta/pubsub/subscriptions/update b/gcloud/beta/pubsub/subscriptions/update index fe2dad385..4ba0c5f68 100644 --- a/gcloud/beta/pubsub/subscriptions/update +++ b/gcloud/beta/pubsub/subscriptions/update @@ -15,12 +15,7 @@ SYNOPSIS : --drop-unknown-fields --write-metadata --use-table-schema | --use-topic-schema] | --clear-cloud-storage-config | [--cloud-storage-bucket=CLOUD_STORAGE_BUCKET - : --cloud-storage-file-prefix=CLOUD_STORAGE_FILE_PREFIX - --cloud-storage-file-suffix=CLOUD_STORAGE_FILE_SUFFIX - --cloud-storage-max-bytes=CLOUD_STORAGE_MAX_BYTES - --cloud-storage-max-duration=CLOUD_STORAGE_MAX_DURATION - --cloud-storage-output-format=OUTPUT_FORMAT; - default="text" --cloud-storage-write-metadata]] + : --cloud-storage-file-datetime-format=CLOUD_STORAGE_FILE_DATETIME_FORMAT --cloud-storage-file-prefix=CLOUD_STORAGE_FILE_PREFIX --cloud-storage-file-suffix=CLOUD_STORAGE_FILE_SUFFIX --cloud-storage-max-bytes=CLOUD_STORAGE_MAX_BYTES --cloud-storage-max-duration=CLOUD_STORAGE_MAX_DURATION --cloud-storage-output-format=OUTPUT_FORMAT; default="text" --cloud-storage-write-metadata]] [--clear-dead-letter-policy | --max-delivery-attempts=MAX_DELIVERY_ATTEMPTS [--dead-letter-topic=DEAD_LETTER_TOPIC @@ -187,6 +182,11 @@ FLAGS This flag argument must be specified if any of the other arguments in this group are specified. + --cloud-storage-file-datetime-format=CLOUD_STORAGE_FILE_DATETIME_FORMAT + The custom datetime format string for Cloud Storage filename. See + the datetime format guidance + (https://cloud.google.com/pubsub/docs/create-cloudstorage-subscription#file_names). + --cloud-storage-file-prefix=CLOUD_STORAGE_FILE_PREFIX The prefix for Cloud Storage filename. diff --git a/gcloud/beta/redis/clusters/create b/gcloud/beta/redis/clusters/create index ff3911656..546b2957e 100644 --- a/gcloud/beta/redis/clusters/create +++ b/gcloud/beta/redis/clusters/create @@ -6,7 +6,7 @@ SYNOPSIS gcloud beta redis clusters create (CLUSTER : --region=REGION) --network=NETWORK --shard-count=SHARD_COUNT [--aof-append-fsync=AOF_APPEND_FSYNC] [--async] [--auth-mode=AUTH_MODE] - [--persistence-mode=PERSISTENCE_MODE] + [--node-type=NODE_TYPE] [--persistence-mode=PERSISTENCE_MODE] [--rdb-snapshot-period=RDB_SNAPSHOT_PERIOD] [--rdb-snapshot-start-time=RDB_SNAPSHOT_START_TIME] [--redis-config=[KEY=VALUE,...]] [--replica-count=REPLICA_COUNT] @@ -114,6 +114,11 @@ OPTIONAL FLAGS iam-auth IAM basic authorization is enabled for the cluster. + --node-type=NODE_TYPE + Node Type of the redis cluster Node. NODE_TYPE must be one of: + redis-highmem-medium, redis-highmem-xlarge, redis-shared-core-nano, + redis-standard-small. + --persistence-mode=PERSISTENCE_MODE Operation mode for persistence. PERSISTENCE_MODE must be one of: diff --git a/gcloud/beta/sql/instances/patch b/gcloud/beta/sql/instances/patch index 344eb0643..faab99a03 100644 --- a/gcloud/beta/sql/instances/patch +++ b/gcloud/beta/sql/instances/patch @@ -10,7 +10,8 @@ SYNOPSIS [--async] [--audit-bucket-path=AUDIT_BUCKET_PATH] [--audit-retention-interval=AUDIT_RETENTION_INTERVAL] [--audit-upload-interval=AUDIT_UPLOAD_INTERVAL] - [--availability-type=AVAILABILITY_TYPE] [--clear-password-policy] + [--availability-type=AVAILABILITY_TYPE] + [--clear-failover-dr-replica-name] [--clear-password-policy] [--connector-enforcement=CONNECTOR_ENFORCEMENT] [--cpu=CPU] [--database-version=DATABASE_VERSION] [--[no-]deletion-protection] [--deny-maintenance-period-end-date=DENY_MAINTENANCE_PERIOD_END_DATE] @@ -20,7 +21,9 @@ SYNOPSIS [--[no-]enable-database-replication] [--[no-]enable-google-ml-integration] [--[no-]enable-google-private-path] [--enable-password-policy] - [--enable-point-in-time-recovery] [--follow-gae-app=FOLLOW_GAE_APP] + [--enable-point-in-time-recovery] + [--failover-dr-replica-name=FAILOVER_DR_REPLICA_NAME] + [--follow-gae-app=FOLLOW_GAE_APP] [--[no-]insights-config-query-insights-enabled] [--insights-config-query-plans-per-minute=INSIGHTS_CONFIG_QUERY_PLANS_PER_MINUTE] [--insights-config-query-string-length=INSIGHTS_CONFIG_QUERY_STRING_LENGTH] @@ -118,6 +121,10 @@ FLAGS zonal Provides no failover capability. This is the default. + --clear-failover-dr-replica-name + Clear the DR replica setting for the primary instance. Flag is only + available for MySQL. + --clear-password-policy Clear the existing password policy. This flag is only available for Postgres. @@ -207,6 +214,11 @@ FLAGS fraction of a second, via write-ahead logs. Must have automatic backups enabled to use. Make sure storage can support at least 7 days of logs. + --failover-dr-replica-name=FAILOVER_DR_REPLICA_NAME + Set a Disaster Recovery (DR) replica with the specified name for the + primary instance. This must be one of the existing cross region + replicas of the primary instance. Flag is only available for MySQL. + --follow-gae-app=FOLLOW_GAE_APP First Generation instances only. The App Engine app this instance should follow. It must be in the same region as the instance. WARNING: diff --git a/gcloud/builds/get-default-service-account b/gcloud/builds/get-default-service-account new file mode 100644 index 000000000..443527db7 --- /dev/null +++ b/gcloud/builds/get-default-service-account @@ -0,0 +1,40 @@ +NAME + gcloud builds get-default-service-account - get the default service account + for a project + +SYNOPSIS + gcloud builds get-default-service-account [--region=REGION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Get the default service account for a project. + +EXAMPLES + To get the default service account for the project: + + $ gcloud builds get-default-service-account + +FLAGS + --region=REGION + The region of the Cloud Build Service to use. Must be set to a + supported region name (e.g. us-central1). If unset, builds/region, + which is the default region to use when working with Cloud Build + resources, is used. If builds/region is unset, region is set to global. + Note: Region must be specified in 2nd gen repo; global is not + supported. + +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 builds get-default-service-account + + $ gcloud beta builds get-default-service-account + diff --git a/gcloud/builds/help b/gcloud/builds/help index c2a00b74f..8ac053e2b 100644 --- a/gcloud/builds/help +++ b/gcloud/builds/help @@ -36,6 +36,9 @@ COMMANDS describe Get information about a particular build. + get-default-service-account + Get the default service account for a project. + list List builds. diff --git a/gcloud/compute/help b/gcloud/compute/help index 2b11f3e2b..0bdc4029d 100644 --- a/gcloud/compute/help +++ b/gcloud/compute/help @@ -168,6 +168,12 @@ GROUPS ssl-policies List, create, delete and update Compute Engine SSL policies. + storage-pool-types + Read storage pool types. + + storage-pools + Read and manipulate storage pools. + target-grpc-proxies Manage Compute Engine target gRPC proxy resources. diff --git a/gcloud/compute/instance-groups/managed/help b/gcloud/compute/instance-groups/managed/help index 0a3799384..c21089672 100644 --- a/gcloud/compute/instance-groups/managed/help +++ b/gcloud/compute/instance-groups/managed/help @@ -24,6 +24,9 @@ GROUPS instance-configs Manage instance-specific settings in a managed instance group. + resize-requests + List, create, delete, cancel, and describe ResizeRequests. + rolling-action Manipulate rolling actions on Compute Engine managed instance groups. diff --git a/gcloud/compute/instance-groups/managed/resize-requests/cancel b/gcloud/compute/instance-groups/managed/resize-requests/cancel new file mode 100644 index 000000000..1e3123282 --- /dev/null +++ b/gcloud/compute/instance-groups/managed/resize-requests/cancel @@ -0,0 +1,67 @@ +NAME + gcloud compute instance-groups managed resize-requests cancel - cancel a + Compute Engine managed instance group resize request + +SYNOPSIS + gcloud compute instance-groups managed resize-requests cancel + INSTANCE_GROUP_MANAGER --resize-requests=RESIZE_REQUEST_NAMES,[...] + [--zone=ZONE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + gcloud compute instance-groups managed resize-requests cancel cancels one + or more Compute Engine managed instance group resize requests. + + You can only cancel a resize request when it is in the ACCEPTED state. + +EXAMPLES + To cancel a resize request for a managed instance group, run the following + command: + + $ gcloud compute instance-groups managed resize-requests cancel \ + my-mig --resize-requests=resize-request-1 + +POSITIONAL ARGUMENTS + INSTANCE_GROUP_MANAGER + Name of the managed instance group to operate on. + +REQUIRED FLAGS + --resize-requests=RESIZE_REQUEST_NAMES,[...] + A list of comma-separated names of resize requests to cancel. + +OPTIONAL FLAGS + --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). + + To avoid prompting when this flag is omitted, you can set the + compute/zone property: + + $ gcloud config set compute/zone ZONE + + A list of zones can be fetched by running: + + $ gcloud compute zones list + + To unset the property, run: + + $ gcloud config unset compute/zone + + Alternatively, the zone can be stored in the environment variable + CLOUDSDK_COMPUTE_ZONE. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha compute instance-groups managed resize-requests cancel + + $ gcloud beta compute instance-groups managed resize-requests cancel + diff --git a/gcloud/compute/instance-groups/managed/resize-requests/create b/gcloud/compute/instance-groups/managed/resize-requests/create new file mode 100644 index 000000000..2d3335e88 --- /dev/null +++ b/gcloud/compute/instance-groups/managed/resize-requests/create @@ -0,0 +1,77 @@ +NAME + gcloud compute instance-groups managed resize-requests create - create a + Compute Engine managed instance group resize request + +SYNOPSIS + gcloud compute instance-groups managed resize-requests create + INSTANCE_GROUP_MANAGER --requested-run-duration=REQUESTED_RUN_DURATION + --resize-by=RESIZE_BY --resize-request=RESIZE_REQUEST_NAME + [--zone=ZONE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create a Compute Engine managed instance group resize request. + +EXAMPLES + To create a resize request for a managed instance group, run the following + command: + + $ gcloud compute instance-groups managed resize-requests create \ + my-mig --resize-request=resize-request-1 --resize-by=1 \ + --requested-run-duration=3d1h30s + +POSITIONAL ARGUMENTS + INSTANCE_GROUP_MANAGER + Name of the managed instance group to operate on. + +REQUIRED FLAGS + --requested-run-duration=REQUESTED_RUN_DURATION + The time you need the requested VMs to run before being automatically + deleted. The value must be formatted as the number of days, hours, + minutes, or seconds followed by d, h, m, and s respectively. For + example, specify 30m for a duration of 30 minutes or 1d2h3m4s for 1 + day, 2 hours, 3 minutes, and 4 seconds. The value must be between 10m + (10 minutes) and 7d (7 days). + + --resize-by=RESIZE_BY + The number of VMs to resize managed instance group by. + + --resize-request=RESIZE_REQUEST_NAME + The name of the resize request to create. + +OPTIONAL FLAGS + --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). + + To avoid prompting when this flag is omitted, you can set the + compute/zone property: + + $ gcloud config set compute/zone ZONE + + A list of zones can be fetched by running: + + $ gcloud compute zones list + + To unset the property, run: + + $ gcloud config unset compute/zone + + Alternatively, the zone can be stored in the environment variable + CLOUDSDK_COMPUTE_ZONE. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha compute instance-groups managed resize-requests create + + $ gcloud beta compute instance-groups managed resize-requests create + diff --git a/gcloud/compute/instance-groups/managed/resize-requests/delete b/gcloud/compute/instance-groups/managed/resize-requests/delete new file mode 100644 index 000000000..103480255 --- /dev/null +++ b/gcloud/compute/instance-groups/managed/resize-requests/delete @@ -0,0 +1,68 @@ +NAME + gcloud compute instance-groups managed resize-requests delete - delete a + Compute Engine managed instance group resize request + +SYNOPSIS + gcloud compute instance-groups managed resize-requests delete + INSTANCE_GROUP_MANAGER --resize-requests=RESIZE_REQUEST_NAMES,[...] + [--zone=ZONE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + gcloud compute instance-groups managed resize-requests delete deletes one + or more Compute Engine managed instance group resize requests. + + You can only delete a request when it is in a state SUCCEEDED, FAILED, or + CANCELLED. + +EXAMPLES + To delete a resize request for a managed instance group, run the following + command: + + $ gcloud compute instance-groups managed resize-requests delete \ + my-mig --resize-requests=resize-request-1 + +POSITIONAL ARGUMENTS + INSTANCE_GROUP_MANAGER + Name of the managed instance group to operate on. + +REQUIRED FLAGS + --resize-requests=RESIZE_REQUEST_NAMES,[...] + A list of comma-separated names of resize requests to delete. + +OPTIONAL FLAGS + --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). + + To avoid prompting when this flag is omitted, you can set the + compute/zone property: + + $ gcloud config set compute/zone ZONE + + A list of zones can be fetched by running: + + $ gcloud compute zones list + + To unset the property, run: + + $ gcloud config unset compute/zone + + Alternatively, the zone can be stored in the environment variable + CLOUDSDK_COMPUTE_ZONE. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha compute instance-groups managed resize-requests delete + + $ gcloud beta compute instance-groups managed resize-requests delete + diff --git a/gcloud/compute/instance-groups/managed/resize-requests/describe b/gcloud/compute/instance-groups/managed/resize-requests/describe new file mode 100644 index 000000000..f0eaf5b71 --- /dev/null +++ b/gcloud/compute/instance-groups/managed/resize-requests/describe @@ -0,0 +1,67 @@ +NAME + gcloud compute instance-groups managed resize-requests describe - describe + a Compute Engine managed instance group resize request resource + +SYNOPSIS + gcloud compute instance-groups managed resize-requests describe + INSTANCE_GROUP_MANAGER --resize-request=RESIZE_REQUEST_NAME + [--zone=ZONE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + gcloud compute instance-groups managed resize-requests describe describes a + Compute Engine managed instance group resize request resource. + +EXAMPLES + To describe a resize request for a managed instance group, run the + following command: + + $ gcloud compute instance-groups managed resize-requests describe \ + my-mig --resize-request=resize-request-1 + +POSITIONAL ARGUMENTS + INSTANCE_GROUP_MANAGER + Name of the managed instance group to operate on. + +REQUIRED FLAGS + --resize-request=RESIZE_REQUEST_NAME + The name of the resize request to describe. + +OPTIONAL FLAGS + --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). + + To avoid prompting when this flag is omitted, you can set the + compute/zone property: + + $ gcloud config set compute/zone ZONE + + A list of zones can be fetched by running: + + $ gcloud compute zones list + + To unset the property, run: + + $ gcloud config unset compute/zone + + Alternatively, the zone can be stored in the environment variable + CLOUDSDK_COMPUTE_ZONE. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha compute instance-groups managed resize-requests \ + describe + + $ gcloud beta compute instance-groups managed resize-requests \ + describe + diff --git a/gcloud/compute/instance-groups/managed/resize-requests/help b/gcloud/compute/instance-groups/managed/resize-requests/help new file mode 100644 index 000000000..35d3360e5 --- /dev/null +++ b/gcloud/compute/instance-groups/managed/resize-requests/help @@ -0,0 +1,42 @@ +NAME + gcloud compute instance-groups managed resize-requests - list, create, + delete, cancel, and describe ResizeRequests + +SYNOPSIS + gcloud compute instance-groups managed resize-requests COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List, create, delete, cancel, and describe ResizeRequests. + +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 managed instance group resize request. + + create + Create a Compute Engine managed instance group resize request. + + delete + Delete a Compute Engine managed instance group resize request. + + describe + Describe a Compute Engine managed instance group resize request + resource. + + list + List Compute Engine managed instance group resize requests. + +NOTES + These variants are also available: + + $ gcloud alpha compute instance-groups managed resize-requests + + $ gcloud beta compute instance-groups managed resize-requests + diff --git a/gcloud/compute/instance-groups/managed/resize-requests/list b/gcloud/compute/instance-groups/managed/resize-requests/list new file mode 100644 index 000000000..7bea83860 --- /dev/null +++ b/gcloud/compute/instance-groups/managed/resize-requests/list @@ -0,0 +1,98 @@ +NAME + gcloud compute instance-groups managed resize-requests list - list Compute + Engine managed instance group resize requests + +SYNOPSIS + gcloud compute instance-groups managed resize-requests list + INSTANCE_GROUP_MANAGER [--zone=ZONE] [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + gcloud compute instance-groups managed resize-requests list displays all + Compute Engine resize requests in a managed instance group. + +EXAMPLES + To list all resize requests in a managed instance group in table form, run: + + $ gcloud compute instance-groups managed resize-requests list \ + example-managed-instance-group --zone=us-central1-a + + To list the URIs of all resize requests in a managed instance group, run: + + $ gcloud compute instance-groups managed resize-requests list \ + example-managed-instance-group --zone=us-central1-a --uri + +POSITIONAL ARGUMENTS + INSTANCE_GROUP_MANAGER + Name of the managed instance group to operate on. + +FLAGS + --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). + + 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 + These variants are also available: + + $ gcloud alpha compute instance-groups managed resize-requests list + + $ gcloud beta compute instance-groups managed resize-requests list + diff --git a/gcloud/compute/instances/create b/gcloud/compute/instances/create index e3bb0e364..5f61cac55 100644 --- a/gcloud/compute/instances/create +++ b/gcloud/compute/instances/create @@ -488,9 +488,9 @@ FLAGS --ipv6-public-ptr-domain=IPV6_PUBLIC_PTR_DOMAIN Assigns a custom PTR domain for the external IPv6 in the IPv6 access - configuration of instance. If its value is not specified, the default - PTR record will be used. This option can only be specified for the - default network interface, nic0. + configuration of instance. If unspecified or specified to be an empty + string, the default PTR record will be used. This option can only be + specified for the default network interface, nic0. --key-revocation-action-type=POLICY Specifies the behavior of the instance when the KMS key of one of its diff --git a/gcloud/compute/os-config/help b/gcloud/compute/os-config/help index c69e8784c..6d544de5f 100644 --- a/gcloud/compute/os-config/help +++ b/gcloud/compute/os-config/help @@ -31,6 +31,9 @@ GROUPS patch-jobs Manage OS patches for Compute Engine VMs. + project-feature-settings + Manage VM Manager project feature settings. + vulnerability-reports Display vulnerability reports for a Compute Engine VM. diff --git a/gcloud/compute/os-config/project-feature-settings/describe b/gcloud/compute/os-config/project-feature-settings/describe new file mode 100644 index 000000000..c96ce5231 --- /dev/null +++ b/gcloud/compute/os-config/project-feature-settings/describe @@ -0,0 +1,28 @@ +NAME + gcloud compute os-config project-feature-settings describe - get all VM + Manager project feature settings + +SYNOPSIS + gcloud compute os-config project-feature-settings describe + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Get all VM Manager project feature settings. + +EXAMPLES + To get project feature settings for project my-project: + + $ gcloud compute os-config project-feature-settings describe \ + --project=my-project + +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 osconfig/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/compute/docs/osconfig/rest diff --git a/gcloud/compute/os-config/project-feature-settings/help b/gcloud/compute/os-config/project-feature-settings/help new file mode 100644 index 000000000..0a154c0cf --- /dev/null +++ b/gcloud/compute/os-config/project-feature-settings/help @@ -0,0 +1,24 @@ +NAME + gcloud compute os-config project-feature-settings - manage VM Manager + project feature settings + +SYNOPSIS + gcloud compute os-config project-feature-settings COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage VM Manager project feature settings. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + Get all VM Manager project feature settings. + + update + Update VM Manager project feature settings. diff --git a/gcloud/compute/os-config/project-feature-settings/update b/gcloud/compute/os-config/project-feature-settings/update new file mode 100644 index 000000000..65b15c74d --- /dev/null +++ b/gcloud/compute/os-config/project-feature-settings/update @@ -0,0 +1,44 @@ +NAME + gcloud compute os-config project-feature-settings update - update VM + Manager project feature settings + +SYNOPSIS + gcloud compute os-config project-feature-settings update + --patch-and-config-feature-set=PATCH_AND_CONFIG_FEATURE_SET + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Update VM Manager project feature settings. + +EXAMPLES + To update project feature settings for project my-project: + + $ gcloud compute os-config project-feature-settings update \ + --project=my-project --patch-and-config-feature-set=full + +REQUIRED FLAGS + --patch-and-config-feature-set=PATCH_AND_CONFIG_FEATURE_SET + Specifies the feature set for VM Manager. PATCH_AND_CONFIG_FEATURE_SET + must be one of: + + full + Full set of VM Manager functionality (alias for osconfig-c). + limited + Limited feature set. Enables only the basic set of features (alias + for osconfig-b). + osconfig-b + Limited feature set. Enables only the basic set of features. + osconfig-c + Full set of VM Manager functionality. + +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 osconfig/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/compute/docs/osconfig/rest diff --git a/gcloud/compute/storage-pool-types/describe b/gcloud/compute/storage-pool-types/describe new file mode 100644 index 000000000..da387d5d8 --- /dev/null +++ b/gcloud/compute/storage-pool-types/describe @@ -0,0 +1,68 @@ +NAME + gcloud compute storage-pool-types describe - describe a storage pool type + +SYNOPSIS + gcloud compute storage-pool-types describe + (STORAGE_POOL_TYPE : --zone=ZONE) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe a storage pool. + +EXAMPLES + To retrieve a single storage pool type and print its properties, run the + following command: + + $ gcloud compute storage-pool-types describe my-storage-pool + +POSITIONAL ARGUMENTS + Storage pool type resource - Name of the storage pool you want to inspect. + 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 storage_pool_type on the command line with a + fully specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + STORAGE_POOL_TYPE + ID of the storage pool type or fully qualified identifier for the + storage pool type. + + To set the storage_pool_type attribute: + ▸ provide the argument storage_pool_type 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 storage_pool_type 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 storage-pool-types describe + + $ gcloud beta compute storage-pool-types describe + diff --git a/gcloud/compute/storage-pool-types/help b/gcloud/compute/storage-pool-types/help new file mode 100644 index 000000000..d61b52c81 --- /dev/null +++ b/gcloud/compute/storage-pool-types/help @@ -0,0 +1,30 @@ +NAME + gcloud compute storage-pool-types - read storage pool types + +SYNOPSIS + gcloud compute storage-pool-types COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Read Compute Engine storage pool types. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + Describe a storage pool type. + + list + View storage pools types. + +NOTES + These variants are also available: + + $ gcloud alpha compute storage-pool-types + + $ gcloud beta compute storage-pool-types + diff --git a/gcloud/compute/storage-pool-types/list b/gcloud/compute/storage-pool-types/list new file mode 100644 index 000000000..eff4c4a83 --- /dev/null +++ b/gcloud/compute/storage-pool-types/list @@ -0,0 +1,68 @@ +NAME + gcloud compute storage-pool-types list - view storage pools types + +SYNOPSIS + gcloud compute storage-pool-types list [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + View storage pools. + +EXAMPLES + To display all storage pool types and their locations visible the project, + run the following command: + + $ gcloud compute storage-pool-types list + + The --filter option can be used to filter down available options. To + display all available storage pool types in US-based zones, run the + following command: + + $ gcloud compute storage-pool-types list --filter="zone ~ us" + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the 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 storage-pool-types list + + $ gcloud beta compute storage-pool-types list + diff --git a/gcloud/compute/storage-pools/create b/gcloud/compute/storage-pools/create new file mode 100644 index 000000000..4195a9aad --- /dev/null +++ b/gcloud/compute/storage-pools/create @@ -0,0 +1,126 @@ +NAME + gcloud compute storage-pools create - create a storage pool + +SYNOPSIS + gcloud compute storage-pools create STORAGE_POOL + --provisioned-capacity=PROVISIONED_CAPACITY + --storage-pool-type=STORAGE_POOL_TYPE [--async] + [--capacity-provisioning-type=CAPACITY_PROVISIONING_TYPE] + [--description=DESCRIPTION] + [--performance-provisioning-type=PERFORMANCE_PROVISIONING_TYPE] + [--provisioned-iops=PROVISIONED_IOPS] + [--provisioned-throughput=PROVISIONED_THROUGHPUT] [--zone=ZONE] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create a storage pool. + +EXAMPLES + To create a new storage pool named my-storage-pool, run the following + command: + + $ gcloud compute storage-pools create my-storage-pool \ + --storage-pool-type=hyperdisk-throughput \ + --provisioned-capacity=10TB --provisioned-throughput=200 + +POSITIONAL ARGUMENTS + Storage pool resource - The name of the storage pool you want to create. + 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 storage_pool on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + To set the zone attribute: + ◆ provide the argument storage_pool on the command line with a fully + specified name; + ◆ provide the argument --zone on the command line; + ◆ set the property compute/zone. + + This must be specified. + + STORAGE_POOL + ID of the storage pool or fully qualified identifier for the storage + pool. + + To set the storage_pool attribute: + ▸ provide the argument storage_pool on the command line. + +REQUIRED FLAGS + --provisioned-capacity=PROVISIONED_CAPACITY + Provisioned capacity of the storage pool. + + Storage pool type resource - Type of the storage pool. 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 --storage-pool-type on the command line with a + fully specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + To set the zone attribute: + ◆ provide the argument --storage-pool-type on the command line with a + fully specified name; + ◆ provide the argument --zone on the command line; + ◆ set the property compute/zone. + + This must be specified. + + --storage-pool-type=STORAGE_POOL_TYPE + ID of the storage pool type or fully qualified identifier for the + storage pool type. + + To set the storage-pool-type attribute: + ▸ provide the argument --storage-pool-type on the command line. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --capacity-provisioning-type=CAPACITY_PROVISIONING_TYPE + Capacity provisioning type. CAPACITY_PROVISIONING_TYPE must be one of: + advanced, standard. + + --description=DESCRIPTION + Description of the storage pool. + + --performance-provisioning-type=PERFORMANCE_PROVISIONING_TYPE + Performance provisioning type. PERFORMANCE_PROVISIONING_TYPE must be + one of: advanced, standard. + + --provisioned-iops=PROVISIONED_IOPS + IOPS with which to provision the pool. + + --provisioned-throughput=PROVISIONED_THROUGHPUT + Throughput in MB/s with which to provision the pool. + + --zone=ZONE + For resources [storage pool, storage pool type], provides fallback + value for resource zone attribute. When the resource's full URI path is + not provided, zone will fallback to this flag value. + +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 storage-pools create + + $ gcloud beta compute storage-pools create + diff --git a/gcloud/compute/storage-pools/delete b/gcloud/compute/storage-pools/delete new file mode 100644 index 000000000..f8a7c0fe0 --- /dev/null +++ b/gcloud/compute/storage-pools/delete @@ -0,0 +1,73 @@ +NAME + gcloud compute storage-pools delete - delete a storage pool + +SYNOPSIS + gcloud compute storage-pools delete (STORAGE_POOL : --zone=ZONE) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Deleta a storage pool. + +EXAMPLES + To delete a single storage pool named my-storage-pool, run the following + command: + + $ gcloud compute storage-pools delete my-storage-pool + +POSITIONAL ARGUMENTS + Storage pool resource - Name of the storage pool 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 storage_pool on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + STORAGE_POOL + ID of the storage pool or fully qualified identifier for the storage + pool. + + To set the storage_pool attribute: + ▸ provide the argument storage_pool 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 storage_pool 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 storage-pools delete + + $ gcloud beta compute storage-pools delete + diff --git a/gcloud/compute/storage-pools/describe b/gcloud/compute/storage-pools/describe new file mode 100644 index 000000000..d578b8d0d --- /dev/null +++ b/gcloud/compute/storage-pools/describe @@ -0,0 +1,68 @@ +NAME + gcloud compute storage-pools describe - describe a storage pool + +SYNOPSIS + gcloud compute storage-pools describe (STORAGE_POOL : --zone=ZONE) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe a storage pool. + +EXAMPLES + To retrieve a single storage pool and print its properties, run the + following command: + + $ gcloud compute storage-pools describe my-storage-pool + +POSITIONAL ARGUMENTS + Storage pool resource - Name of the storage pool you want to inspect. 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 storage_pool on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + STORAGE_POOL + ID of the storage pool or fully qualified identifier for the storage + pool. + + To set the storage_pool attribute: + ▸ provide the argument storage_pool 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 storage_pool 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 storage-pools describe + + $ gcloud beta compute storage-pools describe + diff --git a/gcloud/compute/storage-pools/get-iam-policy b/gcloud/compute/storage-pools/get-iam-policy new file mode 100644 index 000000000..862786f8d --- /dev/null +++ b/gcloud/compute/storage-pools/get-iam-policy @@ -0,0 +1,96 @@ +NAME + gcloud compute storage-pools get-iam-policy - get the IAM policy of a + storage pool + +SYNOPSIS + gcloud compute storage-pools get-iam-policy (STORAGE_POOL : --zone=ZONE) + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Get the IAM policy of a storage pool. + +EXAMPLES + The following command retrieves the IAM configuration of the specified + storage pool. + + $ gcloud compute storage-pools get-iam-policy my-storage-pool + +POSITIONAL ARGUMENTS + Storage pool resource - Storage pool you want to get the IAM permissions + of. 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 storage_pool on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + STORAGE_POOL + ID of the storage pool or fully qualified identifier for the storage + pool. + + To set the storage_pool attribute: + ▸ provide the argument storage_pool 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 storage_pool on the command line with a + fully specified name; + ▸ provide the argument --zone on the command line; + ▸ set the property compute/zone. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the 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 storage-pools get-iam-policy + + $ gcloud beta compute storage-pools get-iam-policy + diff --git a/gcloud/compute/storage-pools/help b/gcloud/compute/storage-pools/help new file mode 100644 index 000000000..e4bcb728c --- /dev/null +++ b/gcloud/compute/storage-pools/help @@ -0,0 +1,48 @@ +NAME + gcloud compute storage-pools - read and manipulate storage pools + +SYNOPSIS + gcloud compute storage-pools COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Read and manipulate Compute Engine storage pools. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + Create a storage pool. + + delete + Delete a storage pool. + + describe + Describe a storage pool. + + get-iam-policy + Get the IAM policy of a storage pool. + + list + View storage pools. + + list-disks + View the disks that are in a storage pool. + + set-iam-policy + Set the IAM policy of the given storage pool. + + update + Update a storage pool. + +NOTES + These variants are also available: + + $ gcloud alpha compute storage-pools + + $ gcloud beta compute storage-pools + diff --git a/gcloud/compute/storage-pools/list b/gcloud/compute/storage-pools/list new file mode 100644 index 000000000..0cb36d09a --- /dev/null +++ b/gcloud/compute/storage-pools/list @@ -0,0 +1,90 @@ +NAME + gcloud compute storage-pools list - view storage pools + +SYNOPSIS + gcloud compute storage-pools list [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + View storage pools. + + The compact default output format is explained below: + + The type column contains all three types -- storage pool type, capacity and + performance. For example, the value + + > "Hdb/Adv/Std" + + means the storage pool type is "hyperdisk-balanced", its capacity type is + "advanced", and its performance type is "standard." + + The list of storage pool abbreviations is as follows: + + ▪ HdB: Hyperdisk Balanced + ▪ HdT: Hyperdisk Throughput + + The list of capacity/performance abbreviations is as follows: + + ▪ Adv: Advanced + ▪ Std: Standard + + The capacity, iops and throughput columns describe used, provisioned, the + utilization rate. For example, the following value for capacity: + + 40 / 50 (80%) + + means 40 TB of it is used, 50 TB provisioned, and its utilization rate is + 80%. The utilization rate is equivalent to used capacity divided by + provisioned capacity. + +EXAMPLES + To display all storage pools in all regions and zones, run the following + command: + + $ gcloud compute storage-pools list + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + +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 storage-pools list + + $ gcloud beta compute storage-pools list + diff --git a/gcloud/compute/storage-pools/list-disks b/gcloud/compute/storage-pools/list-disks new file mode 100644 index 000000000..a5da6e687 --- /dev/null +++ b/gcloud/compute/storage-pools/list-disks @@ -0,0 +1,69 @@ +NAME + gcloud compute storage-pools list-disks - view the disks that are in a + storage pool + +SYNOPSIS + gcloud compute storage-pools list-disks (STORAGE_POOL : --zone=ZONE) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + View the disks that are in a given storage pool. + +EXAMPLES + The following command retrieves all disks belonging to a storage pool and + lists them: + + $ gcloud compute storage-pools list-disks my-storage-pool + +POSITIONAL ARGUMENTS + Storage pool resource - Name of the storage pool you want to inspect. 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 storage_pool on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + STORAGE_POOL + ID of the storage pool or fully qualified identifier for the storage + pool. + + To set the storage_pool attribute: + ▸ provide the argument storage_pool 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 storage_pool 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 storage-pools list-disks + + $ gcloud beta compute storage-pools list-disks + diff --git a/gcloud/compute/storage-pools/set-iam-policy b/gcloud/compute/storage-pools/set-iam-policy new file mode 100644 index 000000000..77ff9fa63 --- /dev/null +++ b/gcloud/compute/storage-pools/set-iam-policy @@ -0,0 +1,77 @@ +NAME + gcloud compute storage-pools set-iam-policy - set the IAM policy of the + given storage pool + +SYNOPSIS + gcloud compute storage-pools set-iam-policy (STORAGE_POOL : --zone=ZONE) + POLICY_FILE [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Set the IAM policy of the given storage pool. + +EXAMPLES + The following command sets the IAM configuration of the specified storage + pool with the specified policy file. + + $ gcloud compute storage-pools set-iam-policy my-storage-pool \ + policy.json + +POSITIONAL ARGUMENTS + Storage pool resource - Storage pool you want to get the IAM permissions + of. 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 storage_pool on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + STORAGE_POOL + ID of the storage pool or fully qualified identifier for the storage + pool. + + To set the storage_pool attribute: + ▸ provide the argument storage_pool 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 storage_pool on the command line with a + fully specified name; + ▸ provide the argument --zone on the command line; + ▸ set the property compute/zone. + + POLICY_FILE + Path to a local JSON or YAML formatted file containing a valid policy. + + The output of the get-iam-policy command is a valid file, as is any + JSON or YAML file conforming to the structure of a Policy + (https://cloud.google.com/iam/reference/rest/v1/Policy). + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the 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 storage-pools set-iam-policy + + $ gcloud beta compute storage-pools set-iam-policy + diff --git a/gcloud/compute/storage-pools/update b/gcloud/compute/storage-pools/update new file mode 100644 index 000000000..cd8c6de49 --- /dev/null +++ b/gcloud/compute/storage-pools/update @@ -0,0 +1,90 @@ +NAME + gcloud compute storage-pools update - update a storage pool + +SYNOPSIS + gcloud compute storage-pools update (STORAGE_POOL : --zone=ZONE) [--async] + [--description=DESCRIPTION] + [--provisioned-capacity=PROVISIONED_CAPACITY] + [--provisioned-iops=PROVISIONED_IOPS] + [--provisioned-throughput=PROVISIONED_THROUGHPUT] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Update a storage pool. + +EXAMPLES + To update the size of a storage pool named 'my-storage-pool', run th + following command: + + $ gcloud compute storage-pools update my-storage-pool \ + --provisioned-capacity=20TB + +POSITIONAL ARGUMENTS + Storage pool resource - Storage pool you want to update. The arguments in + this group can be used to specify the attributes of this resource. (NOTE) + Some attributes are not given arguments in this group but can be set in + other ways. + + To set the project attribute: + ◆ provide the argument storage_pool on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + STORAGE_POOL + ID of the storage pool or fully qualified identifier for the storage + pool. + + To set the storage_pool attribute: + ▸ provide the argument storage_pool 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 storage_pool 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. + + --description=DESCRIPTION + Description of the storage pool. + + --provisioned-capacity=PROVISIONED_CAPACITY + Provisioned capacity of the storage pool. + + --provisioned-iops=PROVISIONED_IOPS + IOPS to provision the pool with. + + --provisioned-throughput=PROVISIONED_THROUGHPUT + Throughput in MB/s provision the pool with. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the 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 storage-pools update + + $ gcloud beta compute storage-pools update + diff --git a/gcloud/container/clusters/create b/gcloud/container/clusters/create index 1721a71bd..4bf10d85a 100644 --- a/gcloud/container/clusters/create +++ b/gcloud/container/clusters/create @@ -1041,13 +1041,16 @@ FLAGS 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 enable in standard mode explicitly set the flag to --security-posture=standard To disable in an existing cluster, explicitly set the flag to --security-posture=disabled. - SECURITY_POSTURE must be one of: disabled, standard. + SECURITY_POSTURE must be one of: disabled, standard, enterprise. --services-ipv4-cidr=CIDR Set the IP range for the services IPs. diff --git a/gcloud/container/clusters/create-auto b/gcloud/container/clusters/create-auto index 0dd92a6bd..9d9b4e1f4 100644 --- a/gcloud/container/clusters/create-auto +++ b/gcloud/container/clusters/create-auto @@ -325,13 +325,16 @@ FLAGS 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 enable in standard mode explicitly set the flag to --security-posture=standard To disable in an existing cluster, explicitly set the flag to --security-posture=disabled. - SECURITY_POSTURE must be one of: disabled, standard. + SECURITY_POSTURE must be one of: disabled, standard, enterprise. --services-ipv4-cidr=CIDR Set the IP range for the services IPs. diff --git a/gcloud/container/clusters/update b/gcloud/container/clusters/update index aa194bad1..02fbf1e0e 100644 --- a/gcloud/container/clusters/update +++ b/gcloud/container/clusters/update @@ -578,13 +578,16 @@ REQUIRED FLAGS 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 enable in standard mode explicitly set the flag to --security-posture=standard To disable in an existing cluster, explicitly set the flag to --security-posture=disabled. - SECURITY_POSTURE must be one of: disabled, standard. + SECURITY_POSTURE must be one of: disabled, standard, enterprise. --set-password Set the basic auth password to the specified value, keeping the diff --git a/gcloud/container/fleet/scopes/help b/gcloud/container/fleet/scopes/help index a0ecf3ea5..68212cc1a 100644 --- a/gcloud/container/fleet/scopes/help +++ b/gcloud/container/fleet/scopes/help @@ -40,7 +40,10 @@ COMMANDS Get the IAM policy for a Fleet Scope. list - List fleet scopes in a project. + List fleet scopes in a project permitted to be viewed by the caller. + + list-memberships + List memberships bound to a fleet scope. remove-iam-policy-binding Remove IAM policy binding of a Fleet Scope. diff --git a/gcloud/container/fleet/scopes/list b/gcloud/container/fleet/scopes/list index 201f1c4e0..b2c4fb975 100644 --- a/gcloud/container/fleet/scopes/list +++ b/gcloud/container/fleet/scopes/list @@ -1,5 +1,6 @@ NAME gcloud container fleet scopes list - list fleet scopes in a project + permitted to be viewed by the caller SYNOPSIS gcloud container fleet scopes list [--filter=EXPRESSION] [--limit=LIMIT] diff --git a/gcloud/container/fleet/scopes/list-memberships b/gcloud/container/fleet/scopes/list-memberships new file mode 100644 index 000000000..b5c3f749c --- /dev/null +++ b/gcloud/container/fleet/scopes/list-memberships @@ -0,0 +1,92 @@ +NAME + gcloud container fleet scopes list-memberships - list memberships bound to + a fleet scope + +SYNOPSIS + gcloud container fleet scopes list-memberships SCOPE [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + This command can fail for the following reasons: + ▪ The scope specified does not exist. + ▪ The user does not have access to the specified scope. + +EXAMPLES + The following command lists memberships bound to scope SCOPE in project + PROJECT_ID: + + $ gcloud container fleet scopes list-memberships SCOPE \ + --project=PROJECT_ID + +POSITIONAL ARGUMENTS + Scope resource - The group of arguments defining the Fleet Scope. 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 SCOPE on the command line with a fully specified + name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument SCOPE on the command line with a fully specified + name; + ◆ global is the only supported location. + + This must be specified. + + SCOPE + ID of the scope or fully qualified identifier for the scope. + + To set the scope attribute: + ▸ provide the argument SCOPE on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha container fleet scopes list-memberships + + $ gcloud beta container fleet scopes list-memberships + diff --git a/gcloud/container/hub/scopes/help b/gcloud/container/hub/scopes/help index 51513ad81..e2833ed85 100644 --- a/gcloud/container/hub/scopes/help +++ b/gcloud/container/hub/scopes/help @@ -40,7 +40,10 @@ COMMANDS Get the IAM policy for a Fleet Scope. list - List fleet scopes in a project. + List fleet scopes in a project permitted to be viewed by the caller. + + list-memberships + List memberships bound to a fleet scope. remove-iam-policy-binding Remove IAM policy binding of a Fleet Scope. diff --git a/gcloud/container/hub/scopes/list b/gcloud/container/hub/scopes/list index 4de3ff9ee..687b92566 100644 --- a/gcloud/container/hub/scopes/list +++ b/gcloud/container/hub/scopes/list @@ -1,5 +1,6 @@ NAME - gcloud container hub scopes list - list fleet scopes in a project + gcloud container hub scopes list - list fleet scopes in a project permitted + to be viewed by the caller SYNOPSIS gcloud container hub scopes list [--filter=EXPRESSION] [--limit=LIMIT] diff --git a/gcloud/container/hub/scopes/list-memberships b/gcloud/container/hub/scopes/list-memberships new file mode 100644 index 000000000..26e7b0e3f --- /dev/null +++ b/gcloud/container/hub/scopes/list-memberships @@ -0,0 +1,92 @@ +NAME + gcloud container hub scopes list-memberships - list memberships bound to a + fleet scope + +SYNOPSIS + gcloud container hub scopes list-memberships SCOPE [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + This command can fail for the following reasons: + ▪ The scope specified does not exist. + ▪ The user does not have access to the specified scope. + +EXAMPLES + The following command lists memberships bound to scope SCOPE in project + PROJECT_ID: + + $ gcloud container hub scopes list-memberships SCOPE \ + --project=PROJECT_ID + +POSITIONAL ARGUMENTS + Scope resource - The group of arguments defining the Fleet Scope. 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 SCOPE on the command line with a fully specified + name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument SCOPE on the command line with a fully specified + name; + ◆ global is the only supported location. + + This must be specified. + + SCOPE + ID of the scope or fully qualified identifier for the scope. + + To set the scope attribute: + ▸ provide the argument SCOPE on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha container hub scopes list-memberships + + $ gcloud beta container hub scopes list-memberships + diff --git a/gcloud/database-migration/connection-profiles/create/help b/gcloud/database-migration/connection-profiles/create/help index 4f8b659be..13bfb62b3 100644 --- a/gcloud/database-migration/connection-profiles/create/help +++ b/gcloud/database-migration/connection-profiles/create/help @@ -37,6 +37,9 @@ COMMANDS postgresql Create a Database Migration Service connection profile for PostgreSQL. + sqlserver + Create a Database Migration Service connection profile for SQL Server. + NOTES This variant is also available: diff --git a/gcloud/database-migration/connection-profiles/create/sqlserver b/gcloud/database-migration/connection-profiles/create/sqlserver new file mode 100644 index 000000000..85d99705b --- /dev/null +++ b/gcloud/database-migration/connection-profiles/create/sqlserver @@ -0,0 +1,106 @@ +NAME + gcloud database-migration connection-profiles create sqlserver - create a + Database Migration Service connection profile for SQL Server + +SYNOPSIS + gcloud database-migration connection-profiles create sqlserver + (CONNECTION_PROFILE : --region=REGION) + (--cloudsql-instance=CLOUDSQL_INSTANCE | [--gcs-bucket=GCS_BUCKET + : --gcs-prefix=GCS_PREFIX --provider=PROVIDER]) [--no-async] + [--display-name=DISPLAY_NAME] [--labels=[KEY=VALUE,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create a Database Migration Service connection profile for SQL Server. + +EXAMPLES + To create a source connection profile my-source-profile for SQL Server: + + $ gcloud database-migration connection-profiles create sqlserver \ + my-source-profile --region=us-central1 \ + --gcs-bucket=bucket-name --gcs-prefix=prefix/path + + To create a destination connection profile my-dest-profile for SQL Server: + + $ gcloud database-migration connection-profiles create sqlserver \ + my-dest-profile --region=us-central1 \ + --cloudsql-instance=cloudsql-id + +POSITIONAL ARGUMENTS + Connection profile resource - The connection profile to create. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument connection_profile 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. + + CONNECTION_PROFILE + ID of the connection_profile or fully qualified identifier for the + connection_profile. + + To set the connection_profile attribute: + ▸ provide the argument connection_profile on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + The Cloud region for the connection_profile. + + To set the region attribute: + ▸ provide the argument connection_profile on the command line with + a fully specified name; + ▸ provide the argument --region on the command line. + +REQUIRED FLAGS + Exactly one of these must be specified: + + --cloudsql-instance=CLOUDSQL_INSTANCE + If the source or destination is a Cloud SQL database, then use this + field to provide the respective Cloud SQL instance ID. + + --gcs-bucket=GCS_BUCKET + Cloud Storage bucket for the source SQL Server connection profile + where the backups are stored. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --gcs-prefix=GCS_PREFIX + Cloud Storage prefix path within the bucket for the source SQL Server + connection profile where the backups are stored. + + --provider=PROVIDER + Database provider, for managed databases. PROVIDER must be (only one + value is supported): RDS. + +OPTIONAL FLAGS + --no-async + Waits for the operation in progress to complete before returning. + + --display-name=DISPLAY_NAME + A user-friendly name for the connection profile. The display name can + include letters, numbers, spaces, and hyphens, and must start with a + letter. + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. diff --git a/gcloud/database-migration/migration-jobs/create b/gcloud/database-migration/migration-jobs/create index 9cb154c30..833e0f771 100644 --- a/gcloud/database-migration/migration-jobs/create +++ b/gcloud/database-migration/migration-jobs/create @@ -14,6 +14,10 @@ SYNOPSIS : --cmek-keyring=CMEK_KEYRING --cmek-project=CMEK_PROJECT] [--peer-vpc=PEER_VPC | --static-ip | [--vm-ip=VM_IP --vm-port=VM_PORT --vpc=VPC : --vm=VM]] + [--sqlserver-databases=databaseName,[...] + : --sqlserver-backup-file-pattern=SQLSERVER_BACKUP_FILE_PATTERN; + default=".(\\.|)(\\d)\\.(trn|bak|trn\\.final)" + --sqlserver-encrypted-databases=SQLSERVER_ENCRYPTED_DATABASES] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -289,6 +293,38 @@ OPTIONAL FLAGS --vm=VM Name of VM that will host the SSH tunnel bastion. + The SQL Server homogeneous migration config. This is used only for SQL + Server to CloudSQL SQL Server migrations. + + --sqlserver-databases=databaseName,[...] + A list of databases to be migrated to the destination Cloud SQL + instance. Provide databases as a comma separated list. This list + should contain all encrypted and non-encrypted database names. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --sqlserver-backup-file-pattern=SQLSERVER_BACKUP_FILE_PATTERN; default=".(\\.|)(\\d)\\.(trn|bak|trn\\.final)" + Pattern that describes the default backup naming strategy. The + specified pattern should ensure lexicographical order of backups. The + pattern should define the following capture group set epoch - unix + timestamp Example: For backup files TestDB.1691448240.bak, + TestDB.1691448254.trn, TestDB.1691448284.trn.final use pattern: + .\.(\d)\.(trn|bak|trn\.final) or + .\.(\d)\.(trn|bak|trn\.final) + + --sqlserver-encrypted-databases=SQLSERVER_ENCRYPTED_DATABASES + A JSON/YAML file describing the encryption settings per database for + all encrytped databases. An example of a JSON request: [{ "database": + "db1", "encryptionOptions": { "certPath": "Path to certificate 1", + "pvkPath": "Path to certificate private key 1", "pvkPassword": + "Private key password 1" } }, { "database": "db2", + "encryptionOptions": { "certPath": "Path to certificate 2", + "pvkPath": "Path to certificate private key 2", "pvkPassword": + "Private key password 2" } }] + + This flag accepts "-" for stdin. + 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/infra-manager/deployments/export-statefile b/gcloud/infra-manager/deployments/export-statefile index f8418ec3e..2bfe88c34 100644 --- a/gcloud/infra-manager/deployments/export-statefile +++ b/gcloud/infra-manager/deployments/export-statefile @@ -4,7 +4,8 @@ NAME SYNOPSIS gcloud infra-manager deployments export-statefile - (DEPLOYMENT : --location=LOCATION) [--draft] [GCLOUD_WIDE_FLAG ...] + (DEPLOYMENT : --location=LOCATION) [--draft] [--file=FILE] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION This command generates a signed url to download a terraform state file. @@ -53,6 +54,13 @@ FLAGS If this flag is set to true, the exported deployment state file will be the draft state + --file=FILE + File name for statefile. It is optional and it specifies the filename + or complete path for the downloaded statefile. If only a file path is + provided, the statefile will be downloaded as "statefile" within that + directory. If a filename is included, the statefile will be downloaded + with that 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/infra-manager/previews/export b/gcloud/infra-manager/previews/export index 22beb0ec6..fc2ccabec 100644 --- a/gcloud/infra-manager/previews/export +++ b/gcloud/infra-manager/previews/export @@ -48,10 +48,11 @@ POSITIONAL ARGUMENTS FLAGS --file=FILE - File name for preview export artifacts. It is optional and if --file is - specified with a name or complete path, the artifacts will be - downloaded to either the current directory with files named as the name - provided or to the complete path. + File name for preview export artifacts. It is optional and it specifies + the filename or complete path for the downloaded preview export + artifacts. If only a file path is provided, the artifacts will be + downloaded as "preview" within that directory. If a filename is + included, the artifacts will be downloaded with that name. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/netapp/backup-policies/create b/gcloud/netapp/backup-policies/create new file mode 100644 index 000000000..e9fa72e6c --- /dev/null +++ b/gcloud/netapp/backup-policies/create @@ -0,0 +1,105 @@ +NAME + gcloud netapp backup-policies create - create a Cloud NetApp Backup Policy + +SYNOPSIS + gcloud netapp backup-policies create (BACKUP_POLICY : --location=LOCATION) + [--async] [--description=DESCRIPTION] [--enabled=ENABLED] + [--labels=[KEY=VALUE,...]] + [--daily-backup-limit=DAILY_BACKUP_LIMIT + --monthly-backup-limit=MONTHLY_BACKUP_LIMIT + --weekly-backup-limit=WEEKLY_BACKUP_LIMIT] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Creates a Backup Policy for Cloud NetApp Volumes. + +EXAMPLES + The following command creates a Backup Policy named BACKUP_POLICY with all + possible arguments: + + $ gcloud netapp backup-policies create BACKUP_POLICY \ + --location=us-central1 --enabled=true --daily-backup-limit=3 \ + --weekly-backup-limit=5 --monthly-backup-limit=2 \ + --description="first backup policy" --labels=key1=val1 + +POSITIONAL ARGUMENTS + Backup policy resource - The Backup Policy to create The arguments in this + group can be used to specify the attributes of this resource. (NOTE) Some + attributes are not given arguments in this group but can be set in other + ways. + + To set the project attribute: + ◆ provide the argument backup_policy on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + BACKUP_POLICY + ID of the backup_policy or fully qualified identifier for the + backup_policy. + + To set the backup_policy attribute: + ▸ provide the argument backup_policy on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the backup_policy. + + To set the location attribute: + ▸ provide the argument backup_policy on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + A description of the Cloud NetApp Backup Policy + + --enabled=ENABLED + The Boolean value indiciating whether backups are made automatically + according to the schedules. If enabled, this will be applied to all + volumes that have this backup policy attached and enforced on the + volume level. If not specified, the default is true. + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + Add backup limit arguments. + + --daily-backup-limit=DAILY_BACKUP_LIMIT + Maximum number of daily backups to keep. Note that the minimum daily + backup limit is 2. + + --monthly-backup-limit=MONTHLY_BACKUP_LIMIT + Number of monthly backups to keep. Note that the sum of daily, weekly + and monthly backups should be greater than 1 + + --weekly-backup-limit=WEEKLY_BACKUP_LIMIT + Number of weekly backups to keep. Note that the sum of daily, weekly + and monthly backups should be greater than 1 + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud beta netapp backup-policies create + diff --git a/gcloud/netapp/backup-policies/delete b/gcloud/netapp/backup-policies/delete new file mode 100644 index 000000000..b57b027bb --- /dev/null +++ b/gcloud/netapp/backup-policies/delete @@ -0,0 +1,73 @@ +NAME + gcloud netapp backup-policies delete - delete a Cloud NetApp Volumes Backup + Policy + +SYNOPSIS + gcloud netapp backup-policies delete (BACKUP_POLICY : --location=LOCATION) + [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete a Backup Policy + +EXAMPLES + The following command deletes a Backup Policy instance named BACKUP_POLICY + in the default netapp/location + + $ gcloud netapp backup-policies delete BACKUP_POLICY + + To delete a Backup Policy named BACKUP_POLICY asynchronously, run the + following command: + + $ gcloud netapp backup-policies delete BACKUP_POLICY --async + +POSITIONAL ARGUMENTS + Backup policy resource - The Backup Policy to delete The arguments in this + group can be used to specify the attributes of this resource. (NOTE) Some + attributes are not given arguments in this group but can be set in other + ways. + + To set the project attribute: + ◆ provide the argument backup_policy on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + BACKUP_POLICY + ID of the backup_policy or fully qualified identifier for the + backup_policy. + + To set the backup_policy attribute: + ▸ provide the argument backup_policy on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the backup_policy. + + To set the location attribute: + ▸ provide the argument backup_policy on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud beta netapp backup-policies delete + diff --git a/gcloud/netapp/backup-policies/describe b/gcloud/netapp/backup-policies/describe new file mode 100644 index 000000000..84c880e9a --- /dev/null +++ b/gcloud/netapp/backup-policies/describe @@ -0,0 +1,69 @@ +NAME + gcloud netapp backup-policies describe - show metadata for a Cloud NetApp + Volumes Backup Policy + +SYNOPSIS + gcloud netapp backup-policies describe + (BACKUP_POLICY : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe a Backup Policy + +EXAMPLES + The following command gets metadata using describe for a Backup Policy + named BACKUP_POLICY in the default netapp/location: + + $ gcloud netapp backup-policies describe BACKUP_POLICY + + To get metadata on a Backup Policy named BACKUP_POLICY in a specified + location, run: + + $ gcloud netapp backup-policies describe BACKUP_POLICY \ + --location=us-central1 + +POSITIONAL ARGUMENTS + Backup policy resource - The Backup Policy to describe. The arguments in + this group can be used to specify the attributes of this resource. (NOTE) + Some attributes are not given arguments in this group but can be set in + other ways. + + To set the project attribute: + ◆ provide the argument backup_policy on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + BACKUP_POLICY + ID of the backup_policy or fully qualified identifier for the + backup_policy. + + To set the backup_policy attribute: + ▸ provide the argument backup_policy on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the backup_policy. + + To set the location attribute: + ▸ provide the argument backup_policy on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud beta netapp backup-policies describe + diff --git a/gcloud/netapp/backup-policies/help b/gcloud/netapp/backup-policies/help new file mode 100644 index 000000000..f308b80f2 --- /dev/null +++ b/gcloud/netapp/backup-policies/help @@ -0,0 +1,38 @@ +NAME + gcloud netapp backup-policies - create and manage Cloud NetApp Backup + Policies + +SYNOPSIS + gcloud netapp backup-policies COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create and manage Cloud NetApp Backup Policies. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + Create a Cloud NetApp Backup Policy. + + delete + Delete a Cloud NetApp Volumes Backup Policy. + + describe + Show metadata for a Cloud NetApp Volumes Backup Policy. + + list + List Cloud NetApp Volumes Backup Policies. + + update + Update a Cloud NetApp Volumes Backup Policies. + +NOTES + This variant is also available: + + $ gcloud beta netapp backup-policies + diff --git a/gcloud/netapp/backup-policies/list b/gcloud/netapp/backup-policies/list new file mode 100644 index 000000000..035e26725 --- /dev/null +++ b/gcloud/netapp/backup-policies/list @@ -0,0 +1,88 @@ +NAME + gcloud netapp backup-policies list - list Cloud NetApp Volumes Backup + Policies + +SYNOPSIS + gcloud netapp backup-policies list [--location=LOCATION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Lists Backup Policies for Cloud NetApp Volumes + +EXAMPLES + The following command lists all Backup Policies in the default + netapp/location + + $ gcloud netapp backup-policies list + + To list all Backup Policies in a specified location, run: + + $ gcloud netapp backup-policies list --location=us-central1 + +FLAGS + Location resource - The location in which to list Backup Policies. 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; + ◆ uses all locations by default. with a fully specified name; + ◆ set the property netapp/location 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; + ▸ uses all locations by default.; + ▸ set the property netapp/location. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud beta netapp backup-policies list + diff --git a/gcloud/netapp/backup-policies/update b/gcloud/netapp/backup-policies/update new file mode 100644 index 000000000..51b98d56f --- /dev/null +++ b/gcloud/netapp/backup-policies/update @@ -0,0 +1,134 @@ +NAME + gcloud netapp backup-policies update - update a Cloud NetApp Volumes Backup + Policies + +SYNOPSIS + gcloud netapp backup-policies update (BACKUP_POLICY : --location=LOCATION) + [--async] [--description=DESCRIPTION] [--enabled=ENABLED] + [--update-labels=[KEY=VALUE,...]] + [--clear-labels | --remove-labels=[KEY,...]] + [--daily-backup-limit=DAILY_BACKUP_LIMIT + --monthly-backup-limit=MONTHLY_BACKUP_LIMIT + --weekly-backup-limit=WEEKLY_BACKUP_LIMIT] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Updates a Backup Policy + +EXAMPLES + The following command updates a Backup Policy named BACKUP_POLICY with all + possible arguments + + $ gcloud netapp backup-policies update BACKUP_POLICY \ + --location=us-central1 --enabled=True --daily-backup-limit=5 \ + --weekly-backup-limit=3 --monthly-backup-limit=2 + + To update a Backup Policy named BACKUP_POLICY asynchronously, run the + following command: + + $ gcloud netapp backup-policies update BACKUP_POLICY --async \ + --location=us-central1 --enabled=True --daily-backup-limit=5 \ + --weekly-backup-limit=3 --monthly-backup-limit=2 + +POSITIONAL ARGUMENTS + Backup policy resource - The Backup Policy to update The arguments in this + group can be used to specify the attributes of this resource. (NOTE) Some + attributes are not given arguments in this group but can be set in other + ways. + + To set the project attribute: + ◆ provide the argument backup_policy on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + BACKUP_POLICY + ID of the backup_policy or fully qualified identifier for the + backup_policy. + + To set the backup_policy attribute: + ▸ provide the argument backup_policy on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the backup_policy. + + To set the location attribute: + ▸ provide the argument backup_policy on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + A description of the Cloud NetApp Backup Policy + + --enabled=ENABLED + The Boolean value indiciating whether backups are made automatically + according to the schedules. If enabled, this will be applied to all + volumes that have this backup policy attached and enforced on the + volume level. If not specified, the default is true. + + --update-labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to update. If a label exists, its value + is modified. Otherwise, a new label is created. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + At most one of these can be specified: + + --clear-labels + Remove all labels. If --update-labels is also specified then + --clear-labels is applied first. + + For example, to remove all labels: + + $ gcloud netapp backup-policies update --clear-labels + + To remove all existing labels and create two new labels, foo and baz: + + $ gcloud netapp backup-policies update --clear-labels \ + --update-labels foo=bar,baz=qux + + --remove-labels=[KEY,...] + List of label keys to remove. If a label does not exist it is + silently ignored. If --update-labels is also specified then + --update-labels is applied first. + + Add backup limit arguments. + + --daily-backup-limit=DAILY_BACKUP_LIMIT + Maximum number of daily backups to keep. Note that the minimum daily + backup limit is 2. + + --monthly-backup-limit=MONTHLY_BACKUP_LIMIT + Number of monthly backups to keep. Note that the sum of daily, weekly + and monthly backups should be greater than 1 + + --weekly-backup-limit=WEEKLY_BACKUP_LIMIT + Number of weekly backups to keep. Note that the sum of daily, weekly + and monthly backups should be greater than 1 + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud beta netapp backup-policies update + diff --git a/gcloud/netapp/backup-vaults/backups/create b/gcloud/netapp/backup-vaults/backups/create new file mode 100644 index 000000000..450af348c --- /dev/null +++ b/gcloud/netapp/backup-vaults/backups/create @@ -0,0 +1,165 @@ +NAME + gcloud netapp backup-vaults backups create - create a Cloud NetApp Backup + +SYNOPSIS + gcloud netapp backup-vaults backups create (BACKUP : --location=LOCATION) + [--async] [--backup-vault=BACKUP_VAULT] [--description=DESCRIPTION] + [--labels=[KEY=VALUE,...]] [--source-snapshot=SOURCE_SNAPSHOT] + [--source-volume=SOURCE_VOLUME] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create a Cloud NetApp Backup. + +EXAMPLES + The following command creates a Backup named BACKUP attached to a Backup + Vault named BACKUP_VAULT, and a source volume named SOURCE_VOL + asynchronously using the specified arguments: + + $ gcloud netapp backup-vaults backups create BACKUP \ + --location=LOCATION --async --backup-vault=BACKUP_VAULT \ + --source-volume=SOURCE_VOL + +POSITIONAL ARGUMENTS + Backup resource - The Backup to create The arguments in this group can be + used to specify the attributes of this resource. (NOTE) Some attributes + are not given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument backup 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 backup_vault attribute: + ◆ provide the argument backup on the command line with a fully + specified name; + ◆ provide the argument --backup-vault on the command line. + + This must be specified. + + BACKUP + ID of the backup or fully qualified identifier for the backup. + + To set the backup attribute: + ▸ provide the argument backup on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the backup. + + To set the location attribute: + ▸ provide the argument backup on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + Backup vault resource - The Backup Vault that the Backup is stored in 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 --backup-vault on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument --backup-vault on the command line with a fully + specified name; + ◆ provide the argument --location on the command line; + ◆ set the property netapp/location. + + --backup-vault=BACKUP_VAULT + ID of the backup_vault or fully qualified identifier for the + backup_vault. + + To set the backup_vault attribute: + ▸ provide the argument --backup-vault on the command line. + + --description=DESCRIPTION + A description of the Cloud NetApp Backup Vault + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + Snapshot resource - The full name of the Source Snapshot that the Backup + is based on', Format: + projects/{project_id}/locations/{location}/volumes/{volume_id}/snapshots/{snapshot_id} + 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 --source-snapshot on the command line with a + fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument --source-snapshot on the command line with a + fully specified name; + ◆ set the property netapp/location. + + To set the volume attribute: + ◆ provide the argument --source-snapshot on the command line with a + fully specified name. + + --source-snapshot=SOURCE_SNAPSHOT + ID of the snapshot or fully qualified identifier for the snapshot. + + To set the snapshot attribute: + ▸ provide the argument --source-snapshot on the command line. + + Volume resource - The full name of the Source Volume that the Backup is + based on', Format: + projects/{projects_id}/locations/{location}/volumes/{volume_id} 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 --source-volume on the command line with a fully + specified name; + ◆ provide the argument --volume on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument --source-volume on the command line with a fully + specified name; + ◆ provide the argument --volume on the command line with a fully + specified name; + ◆ provide the argument --location on the command line; + ◆ set the property netapp/location. + + --source-volume=SOURCE_VOLUME + ID of the volume or fully qualified identifier for the volume. + + To set the volume attribute: + ▸ provide the argument --source-volume on the command line; + ▸ provide the argument --volume on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud beta netapp backup-vaults backups create + diff --git a/gcloud/netapp/backup-vaults/backups/delete b/gcloud/netapp/backup-vaults/backups/delete new file mode 100644 index 000000000..3013c6bd0 --- /dev/null +++ b/gcloud/netapp/backup-vaults/backups/delete @@ -0,0 +1,99 @@ +NAME + gcloud netapp backup-vaults backups delete - delete a Cloud NetApp Backup + +SYNOPSIS + gcloud netapp backup-vaults backups delete (BACKUP : --location=LOCATION) + [--async] [--backup-vault=BACKUP_VAULT] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete a Cloud NetApp Backup. + +EXAMPLES + The following command deletes a Backup named BACKUP inside a backup vault + named BACKUP_VAULT using the required arguments: + + $ gcloud netapp backup-vaults backups delete BACKUP \ + --location=us-central1 --backup-vault=BACKUP_VAULT + + To delete a Backup named BACKUP asynchronously, run the following command: + + $ gcloud netapp backup-vaults backups delete BACKUP \ + --location=us-central1 --backup-vault=BACKUP_VAULT --async + +POSITIONAL ARGUMENTS + Backup resource - The Backup 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 backup 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 backup_vault attribute: + ◆ provide the argument backup on the command line with a fully + specified name; + ◆ provide the argument --backup-vault on the command line. + + This must be specified. + + BACKUP + ID of the backup or fully qualified identifier for the backup. + + To set the backup attribute: + ▸ provide the argument backup on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the backup. + + To set the location attribute: + ▸ provide the argument backup on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + Backup vault resource - The Backup Vault that the Backup is stored in 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 --backup-vault on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument --backup-vault on the command line with a fully + specified name; + ◆ provide the argument --location on the command line; + ◆ set the property netapp/location. + + --backup-vault=BACKUP_VAULT + ID of the backup_vault or fully qualified identifier for the + backup_vault. + + To set the backup_vault attribute: + ▸ provide the argument --backup-vault on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud beta netapp backup-vaults backups delete + diff --git a/gcloud/netapp/backup-vaults/backups/describe b/gcloud/netapp/backup-vaults/backups/describe new file mode 100644 index 000000000..a857885e2 --- /dev/null +++ b/gcloud/netapp/backup-vaults/backups/describe @@ -0,0 +1,91 @@ +NAME + gcloud netapp backup-vaults backups describe - describe a Cloud NetApp + Backup + +SYNOPSIS + gcloud netapp backup-vaults backups describe (BACKUP : --location=LOCATION) + [--backup-vault=BACKUP_VAULT] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe a Cloud NetApp Backup. + +EXAMPLES + The following command describes a Backup named BACKUP in the given location + and backup vault: + + $ gcloud netapp backup-vaults backups describe NAME \ + --location=us-central1 --backup-vault=BACKUP_VAULT + +POSITIONAL ARGUMENTS + Backup resource - The Backup 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 backup 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 backup_vault attribute: + ◆ provide the argument backup on the command line with a fully + specified name; + ◆ provide the argument --backup-vault on the command line. + + This must be specified. + + BACKUP + ID of the backup or fully qualified identifier for the backup. + + To set the backup attribute: + ▸ provide the argument backup on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the backup. + + To set the location attribute: + ▸ provide the argument backup on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location. + +FLAGS + Backup vault resource - The Backup Vault that the Backup is stored in 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 --backup-vault on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument --backup-vault on the command line with a fully + specified name; + ◆ provide the argument --location on the command line; + ◆ set the property netapp/location. + + --backup-vault=BACKUP_VAULT + ID of the backup_vault or fully qualified identifier for the + backup_vault. + + To set the backup_vault attribute: + ▸ provide the argument --backup-vault on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud beta netapp backup-vaults backups describe + diff --git a/gcloud/netapp/backup-vaults/backups/help b/gcloud/netapp/backup-vaults/backups/help new file mode 100644 index 000000000..a88f0d9cf --- /dev/null +++ b/gcloud/netapp/backup-vaults/backups/help @@ -0,0 +1,38 @@ +NAME + gcloud netapp backup-vaults backups - create and manage Cloud NetApp + Backups + +SYNOPSIS + gcloud netapp backup-vaults backups COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create and manage Cloud NetApp Backups. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + Create a Cloud NetApp Backup. + + delete + Delete a Cloud NetApp Backup. + + describe + Describe a Cloud NetApp Backup. + + list + List Cloud NetApp Backups. + + update + Update a Cloud NetApp Backup. + +NOTES + This variant is also available: + + $ gcloud beta netapp backup-vaults backups + diff --git a/gcloud/netapp/backup-vaults/backups/list b/gcloud/netapp/backup-vaults/backups/list new file mode 100644 index 000000000..64a214a66 --- /dev/null +++ b/gcloud/netapp/backup-vaults/backups/list @@ -0,0 +1,108 @@ +NAME + gcloud netapp backup-vaults backups list - list Cloud NetApp Backups + +SYNOPSIS + gcloud netapp backup-vaults backups list [--backup-vault=BACKUP_VAULT] + [--location=LOCATION] [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Lists Cloud NetApp Backups. + +EXAMPLES + The following command lists all Backups in the given location and Backup + Vault named BACKUP_VAULT: + + $ gcloud netapp backup-vaults backups list --location=us-central1 \ + --backup-vault=BACKUP_VAULT + +FLAGS + Backup vault resource - The Backup Vault that the Backup is stored in 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 --backup-vault on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument --backup-vault on the command line with a fully + specified name; + ◆ provide the argument --location on the command line; + ◆ set the property netapp/location. + + --backup-vault=BACKUP_VAULT + ID of the backup_vault or fully qualified identifier for the + backup_vault. + + To set the backup_vault attribute: + ▸ provide the argument --backup-vault on the command line. + + Location resource - The location in which to list Backups. 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; + ◆ uses all locations by default. with a fully specified name; + ◆ set the property netapp/location 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; + ▸ uses all locations by default.; + ▸ set the property netapp/location. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud beta netapp backup-vaults backups list + diff --git a/gcloud/netapp/backup-vaults/backups/update b/gcloud/netapp/backup-vaults/backups/update new file mode 100644 index 000000000..65e14a6fe --- /dev/null +++ b/gcloud/netapp/backup-vaults/backups/update @@ -0,0 +1,128 @@ +NAME + gcloud netapp backup-vaults backups update - update a Cloud NetApp Backup + +SYNOPSIS + gcloud netapp backup-vaults backups update (BACKUP : --location=LOCATION) + [--async] [--backup-vault=BACKUP_VAULT] [--description=DESCRIPTION] + [--update-labels=[KEY=VALUE,...]] + [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Update a Cloud NetApp Backup and its specified parameters. + +EXAMPLES + The following command updates a Backup named BACKUP and its specified + parameters: + + $ gcloud netapp backup-vaults backups update NAME \ + --location=us-central1 --description="new description" + +POSITIONAL ARGUMENTS + Backup resource - The Backup to update The arguments in this group can be + used to specify the attributes of this resource. (NOTE) Some attributes + are not given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument backup 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 backup_vault attribute: + ◆ provide the argument backup on the command line with a fully + specified name; + ◆ provide the argument --backup-vault on the command line. + + This must be specified. + + BACKUP + ID of the backup or fully qualified identifier for the backup. + + To set the backup attribute: + ▸ provide the argument backup on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the backup. + + To set the location attribute: + ▸ provide the argument backup on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + Backup vault resource - The Backup Vault that the Backup is stored in 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 --backup-vault on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument --backup-vault on the command line with a fully + specified name; + ◆ provide the argument --location on the command line; + ◆ set the property netapp/location. + + --backup-vault=BACKUP_VAULT + ID of the backup_vault or fully qualified identifier for the + backup_vault. + + To set the backup_vault attribute: + ▸ provide the argument --backup-vault on the command line. + + --description=DESCRIPTION + A description of the Cloud NetApp Backup + + --update-labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to update. If a label exists, its value + is modified. Otherwise, a new label is created. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + At most one of these can be specified: + + --clear-labels + Remove all labels. If --update-labels is also specified then + --clear-labels is applied first. + + For example, to remove all labels: + + $ gcloud netapp backup-vaults backups update --clear-labels + + To remove all existing labels and create two new labels, foo and baz: + + $ gcloud netapp backup-vaults backups update --clear-labels \ + --update-labels foo=bar,baz=qux + + --remove-labels=[KEY,...] + List of label keys to remove. If a label does not exist it is + silently ignored. If --update-labels is also specified then + --update-labels is applied first. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud beta netapp backup-vaults backups update + diff --git a/gcloud/netapp/backup-vaults/create b/gcloud/netapp/backup-vaults/create new file mode 100644 index 000000000..ff98b48c8 --- /dev/null +++ b/gcloud/netapp/backup-vaults/create @@ -0,0 +1,80 @@ +NAME + gcloud netapp backup-vaults create - create a Cloud NetApp Backup Vault + +SYNOPSIS + gcloud netapp backup-vaults create (BACKUP_VAULT : --location=LOCATION) + [--async] [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create a Cloud NetApp Backup Vault. + +EXAMPLES + The following command creates a Backup Vault named BACKUP_VAULT + asynchronously using the specified arguments: + + $ gcloud netapp backup-vaults create BACKUP_VAULT \ + --location=LOCATION --async --description="test" + +POSITIONAL ARGUMENTS + Backup vault resource - The Backup Vault to create The arguments in this + group can be used to specify the attributes of this resource. (NOTE) Some + attributes are not given arguments in this group but can be set in other + ways. + + To set the project attribute: + ◆ provide the argument backup_vault 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. + + BACKUP_VAULT + ID of the backup_vault or fully qualified identifier for the + backup_vault. + + To set the backup_vault attribute: + ▸ provide the argument backup_vault on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the backup_vault. + + To set the location attribute: + ▸ provide the argument backup_vault on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + A description of the Cloud NetApp Backup Vault + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud beta netapp backup-vaults create + diff --git a/gcloud/netapp/backup-vaults/delete b/gcloud/netapp/backup-vaults/delete new file mode 100644 index 000000000..6132d96e6 --- /dev/null +++ b/gcloud/netapp/backup-vaults/delete @@ -0,0 +1,73 @@ +NAME + gcloud netapp backup-vaults delete - delete a Cloud NetApp Volumes Backup + Vault + +SYNOPSIS + gcloud netapp backup-vaults delete (BACKUP_VAULT : --location=LOCATION) + [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete a Backup Vault. + +EXAMPLES + The following command deletes a Backup Vault instance named BACKUP_VAULT in + the default netapp/location: + + $ gcloud netapp backup-vaults delete BACKUP_VAULT + + To delete a Backup Vault named BACKUP_VAULT asynchronously, run the + following command: + + $ gcloud netapp backup-vaults delete BACKUP_VAULT --async + +POSITIONAL ARGUMENTS + Backup vault resource - The Backup Vault 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 backup_vault 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. + + BACKUP_VAULT + ID of the backup_vault or fully qualified identifier for the + backup_vault. + + To set the backup_vault attribute: + ▸ provide the argument backup_vault on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the backup_vault. + + To set the location attribute: + ▸ provide the argument backup_vault on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud beta netapp backup-vaults delete + diff --git a/gcloud/netapp/backup-vaults/describe b/gcloud/netapp/backup-vaults/describe new file mode 100644 index 000000000..08700dbc8 --- /dev/null +++ b/gcloud/netapp/backup-vaults/describe @@ -0,0 +1,69 @@ +NAME + gcloud netapp backup-vaults describe - show metadata for a Cloud NetApp + Volumes Backup Vault + +SYNOPSIS + gcloud netapp backup-vaults describe (BACKUP_VAULT : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe a Backup Vault. + +EXAMPLES + The following command gets metadata using describe for a Backup Vault + instance named BACKUP_VAULT in the default netapp/location: + + $ gcloud netapp backup-vaults describe BACKUP_VAULT + + To get metadata on a Backup Vault named BACKUP_VAULT in a specified + location, run: + + $ gcloud netapp backup-vaults describe BACKUP_VAULT \ + --location=us-central1 + +POSITIONAL ARGUMENTS + Backup vault resource - The Backup Vault 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 backup_vault 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. + + BACKUP_VAULT + ID of the backup_vault or fully qualified identifier for the + backup_vault. + + To set the backup_vault attribute: + ▸ provide the argument backup_vault on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the backup_vault. + + To set the location attribute: + ▸ provide the argument backup_vault on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud beta netapp backup-vaults describe + diff --git a/gcloud/netapp/backup-vaults/help b/gcloud/netapp/backup-vaults/help new file mode 100644 index 000000000..2320afdbb --- /dev/null +++ b/gcloud/netapp/backup-vaults/help @@ -0,0 +1,43 @@ +NAME + gcloud netapp backup-vaults - create and manage Cloud NetApp Backup Vaults + +SYNOPSIS + gcloud netapp backup-vaults GROUP | COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create and manage Cloud NetApp Backup Vaults. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + backups + Create and manage Cloud NetApp Backups. + +COMMANDS + COMMAND is one of the following: + + create + Create a Cloud NetApp Backup Vault. + + delete + Delete a Cloud NetApp Volumes Backup Vault. + + describe + Show metadata for a Cloud NetApp Volumes Backup Vault. + + list + List Cloud NetApp Volumes Backup Vaults. + + update + Update a Cloud NetApp Volumes Backup Vault. + +NOTES + This variant is also available: + + $ gcloud beta netapp backup-vaults + diff --git a/gcloud/netapp/backup-vaults/list b/gcloud/netapp/backup-vaults/list new file mode 100644 index 000000000..7b2b45a5d --- /dev/null +++ b/gcloud/netapp/backup-vaults/list @@ -0,0 +1,87 @@ +NAME + gcloud netapp backup-vaults list - list Cloud NetApp Volumes Backup Vaults + +SYNOPSIS + gcloud netapp backup-vaults list [--location=LOCATION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Lists Cloud NetApp Backup Vaults to store Cloud NetApp Volumes Backups. + +EXAMPLES + The following command lists all Backup Vaults in the default + netapp/location + + $ gcloud netapp backup-vaults list + + To list all Backup Vaults in a specified location, run: + + $ gcloud netapp backup-vaults list --location=us-central1 + +FLAGS + Location resource - The location in which to list Backup Vaults. 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; + ◆ uses all locations by default. with a fully specified name; + ◆ set the property netapp/location 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; + ▸ uses all locations by default.; + ▸ set the property netapp/location. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud beta netapp backup-vaults list + diff --git a/gcloud/netapp/backup-vaults/update b/gcloud/netapp/backup-vaults/update new file mode 100644 index 000000000..3782b8dc9 --- /dev/null +++ b/gcloud/netapp/backup-vaults/update @@ -0,0 +1,109 @@ +NAME + gcloud netapp backup-vaults update - update a Cloud NetApp Volumes Backup + Vault + +SYNOPSIS + gcloud netapp backup-vaults update (BACKUP_VAULT : --location=LOCATION) + [--async] [--description=DESCRIPTION] [--update-labels=[KEY=VALUE,...]] + [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Updates a Backup Vault + +EXAMPLES + The following command updates a Backup Vault instance named BACKUP_VAULT + + $ gcloud netapp backup-vaults update BACKUP_VAULT \ + --location=us-central1 --description="new description" \ + --update-labels=newkey=newval + + To update a Backup Vault named BACKUP_VAULT asynchronously, run the + following command: + + $ gcloud netapp backup-vaults update BACKUP_VAULT --async \ + --location=us-central1 --description="new description" \ + --update-labels=newkey=newval + +POSITIONAL ARGUMENTS + Backup vault resource - The Backup Vault to update The arguments in this + group can be used to specify the attributes of this resource. (NOTE) Some + attributes are not given arguments in this group but can be set in other + ways. + + To set the project attribute: + ◆ provide the argument backup_vault 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. + + BACKUP_VAULT + ID of the backup_vault or fully qualified identifier for the + backup_vault. + + To set the backup_vault attribute: + ▸ provide the argument backup_vault on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the backup_vault. + + To set the location attribute: + ▸ provide the argument backup_vault on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + A description of the Cloud NetApp Backup Vault + + --update-labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to update. If a label exists, its value + is modified. Otherwise, a new label is created. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + At most one of these can be specified: + + --clear-labels + Remove all labels. If --update-labels is also specified then + --clear-labels is applied first. + + For example, to remove all labels: + + $ gcloud netapp backup-vaults update --clear-labels + + To remove all existing labels and create two new labels, foo and baz: + + $ gcloud netapp backup-vaults update --clear-labels \ + --update-labels foo=bar,baz=qux + + --remove-labels=[KEY,...] + List of label keys to remove. If a label does not exist it is + silently ignored. If --update-labels is also specified then + --update-labels is applied first. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud beta netapp backup-vaults update + diff --git a/gcloud/netapp/help b/gcloud/netapp/help index ce720762c..795b0ea89 100644 --- a/gcloud/netapp/help +++ b/gcloud/netapp/help @@ -28,6 +28,12 @@ GROUPS active-directories Create and manage Cloud NetApp Active Directories. + backup-policies + Create and manage Cloud NetApp Backup Policies. + + backup-vaults + Create and manage Cloud NetApp Backup Vaults. + kms-configs Create and manage Cloud NetApp Volumes KMS Configs. diff --git a/gcloud/netapp/volumes/create b/gcloud/netapp/volumes/create index d384182a2..e28e6d5e2 100644 --- a/gcloud/netapp/volumes/create +++ b/gcloud/netapp/volumes/create @@ -5,6 +5,9 @@ SYNOPSIS gcloud netapp volumes create (VOLUME : --location=LOCATION) --capacity=CAPACITY --protocols=PROTOCOL,[PROTOCOL,...] --share-name=SHARE_NAME --storage-pool=STORAGE_POOL [--async] + [--backup-config=[backup-policies=BACKUP-POLICIES], + [backup-vault=BACKUP-VAULT], + [enable-scheduled-backups=ENABLE-SCHEDULED-BACKUPS]] [--description=DESCRIPTION] [--enable-kerberos=ENABLE_KERBEROS] [--export-policy=[access-type=ACCESS-TYPE], [allowed-clients=ALLOWED-CLIENTS],[has-root-access=HAS-ROOT-ACCESS], @@ -29,7 +32,9 @@ SYNOPSIS [--snapshot-weekly=[day=DAY], [hour=HOUR],[minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP]] [--source-snapshot=SOURCE_SNAPSHOT] - [--unix-permissions=UNIX_PERMISSIONS] [GCLOUD_WIDE_FLAG ...] + [--unix-permissions=UNIX_PERMISSIONS] + [--source-backup=SOURCE_BACKUP : --backup_vault=BACKUP_VAULT] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION Create a Cloud NetApp Volume @@ -125,6 +130,19 @@ OPTIONAL FLAGS Return immediately, without waiting for the operation in progress to complete. + --backup-config=[backup-policies=BACKUP-POLICIES],[backup-vault=BACKUP-VAULT],[enable-scheduled-backups=ENABLE-SCHEDULED-BACKUPS] + Backup Config contains backup related config on a volume. + + Backup Config will have the following format + `--backup-config=backup-policies=BACKUP_POLICIES, + backup-vault=BACKUP_VAULT_NAME, + enable-scheduled-backups=ENABLE_SCHEDULED_BACKUPS + + backup-policies is a pound-separated (#) list of backup policy names, + backup-vault can include a single backup-vault resource name, and + enable-scheduled-backups is a Boolean value indicating whether or not + scheduled backups are enabled on the volume. + --description=DESCRIPTION A description of the Cloud NetApp Volume @@ -225,6 +243,40 @@ OPTIONAL FLAGS Unix permissions the mount point will be created with. Unix permissions are only applicable with NFS protocol only + Backup resource - The source Backup to create the Volume from. 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 --source-backup on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument --source-backup on the command line with a fully + specified name; + ◆ set the property netapp/location. + + --source-backup=SOURCE_BACKUP + ID of the backup or fully qualified identifier for the backup. + + To set the backup attribute: + ▸ provide the argument --source-backup on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --backup_vault=BACKUP_VAULT + The Backup Vault of the backup. + + To set the backup_vault attribute: + ▸ provide the argument --source-backup on the command line with a + fully specified name; + ▸ provide the argument --backup_vault on the command line; + ▸ provide the argument --backup-vault 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, diff --git a/gcloud/netapp/volumes/update b/gcloud/netapp/volumes/update index ba6a00560..4a4ca30f8 100644 --- a/gcloud/netapp/volumes/update +++ b/gcloud/netapp/volumes/update @@ -3,6 +3,9 @@ NAME SYNOPSIS gcloud netapp volumes update (VOLUME : --location=LOCATION) [--async] + [--backup-config=[backup-policies=BACKUP-POLICIES], + [backup-vault=BACKUP-VAULT], + [enable-scheduled-backups=ENABLE-SCHEDULED-BACKUPS]] [--capacity=CAPACITY] [--description=DESCRIPTION] [--enable-kerberos=ENABLE_KERBEROS] [--export-policy=[access-type=ACCESS-TYPE], @@ -30,7 +33,9 @@ SYNOPSIS [hour=HOUR],[minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP]] [--source-snapshot=SOURCE_SNAPSHOT] [--storage-pool=STORAGE_POOL] [--unix-permissions=UNIX_PERMISSIONS] [--update-labels=[KEY=VALUE,...]] - [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] + [--clear-labels | --remove-labels=[KEY,...]] + [--source-backup=SOURCE_BACKUP : --backup_vault=BACKUP_VAULT] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION Update a Cloud NetApp Volume and its specified parameters @@ -80,6 +85,19 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + --backup-config=[backup-policies=BACKUP-POLICIES],[backup-vault=BACKUP-VAULT],[enable-scheduled-backups=ENABLE-SCHEDULED-BACKUPS] + Backup Config contains backup related config on a volume. + + Backup Config will have the following format + `--backup-config=backup-policies=BACKUP_POLICIES, + backup-vault=BACKUP_VAULT_NAME, + enable-scheduled-backups=ENABLE_SCHEDULED_BACKUPS + + backup-policies is a pound-separated (#) list of backup policy names, + backup-vault can include a single backup-vault resource name, and + enable-scheduled-backups is a Boolean value indicating whether or not + scheduled backups are enabled on the volume. + --capacity=CAPACITY The desired capacity of the Volume in GiB or TiB units.If no capacity unit is specified, GiB is assumed. @@ -235,6 +253,40 @@ FLAGS silently ignored. If --update-labels is also specified then --update-labels is applied first. + Backup resource - The source Backup to create the Volume from. 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 --source-backup on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument --source-backup on the command line with a fully + specified name; + ◆ set the property netapp/location. + + --source-backup=SOURCE_BACKUP + ID of the backup or fully qualified identifier for the backup. + + To set the backup attribute: + ▸ provide the argument --source-backup on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --backup_vault=BACKUP_VAULT + The Backup Vault of the backup. + + To set the backup_vault attribute: + ▸ provide the argument --source-backup on the command line with a + fully specified name; + ▸ provide the argument --backup_vault on the command line; + ▸ provide the argument --backup-vault 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, diff --git a/gcloud/privateca/certificates/create b/gcloud/privateca/certificates/create index c0d234f4f..c1b54d1dc 100644 --- a/gcloud/privateca/certificates/create +++ b/gcloud/privateca/certificates/create @@ -25,7 +25,8 @@ SYNOPSIS --name-permitted-email=[NAME_PERMITTED_EMAIL,...] --name-permitted-ip=[NAME_PERMITTED_IP,...] --name-permitted-uri=[NAME_PERMITTED_URI,...]]) [--ca=CA] - [--labels=[KEY=VALUE,...]] [--validity=VALIDITY; default="P30D"] + [--labels=[KEY=VALUE,...]] [--subject-key-id=SUBJECT_KEY_ID] + [--validity=VALIDITY; default="P30D"] [--template=TEMPLATE : --template-location=TEMPLATE_LOCATION] [GCLOUD_WIDE_FLAG ...] @@ -333,6 +334,12 @@ OPTIONAL FLAGS contain only hyphens (-), underscores (_), lowercase characters, and numbers. + --subject-key-id=SUBJECT_KEY_ID + Optional field to specify subject key ID for certificate. DO NOT USE + except to maintain a previously established identifier for a public + key, whose SKI was not generated using method (1) described in RFC 5280 + section 4.2.1.2. + --validity=VALIDITY; default="P30D" The validity of this certificate, as an ISO8601 duration. Defaults to 30 days. diff --git a/gcloud/privateca/roots/create b/gcloud/privateca/roots/create index a3b2ce2ec..e12cf6558 100644 --- a/gcloud/privateca/roots/create +++ b/gcloud/privateca/roots/create @@ -7,8 +7,8 @@ SYNOPSIS [--auto-enable] [--bucket=BUCKET] [--dns-san=[DNS_SAN,...]] [--email-san=[EMAIL_SAN,...]] [--from-ca=FROM_CA] [--ip-san=[IP_SAN,...]] [--labels=[KEY=VALUE,...]] - [--subject=[SUBJECT,...]] [--uri-san=[URI_SAN,...]] - [--validity=VALIDITY; default="P10Y"] + [--subject=[SUBJECT,...]] [--subject-key-id=SUBJECT_KEY_ID] + [--uri-san=[URI_SAN,...]] [--validity=VALIDITY; default="P10Y"] [--key-algorithm=KEY_ALGORITHM; default="rsa-pkcs1-4096-sha256" | [--kms-key-version=KMS_KEY_VERSION : --kms-key=KMS_KEY --kms-keyring=KMS_KEYRING @@ -150,6 +150,12 @@ FLAGS X.501 name of the certificate subject. Example: --subject "C=US,ST=California,L=Mountain View,O=Google LLC,CN=google.com" + --subject-key-id=SUBJECT_KEY_ID + Optional field to specify subject key ID for certificate. DO NOT USE + except to maintain a previously established identifier for a public + key, whose SKI was not generated using method (1) described in RFC 5280 + section 4.2.1.2. + --uri-san=[URI_SAN,...] One or more comma-separated URI Subject Alternative Names. diff --git a/gcloud/privateca/subordinates/create b/gcloud/privateca/subordinates/create index 531833a9d..e73ee46ae 100644 --- a/gcloud/privateca/subordinates/create +++ b/gcloud/privateca/subordinates/create @@ -11,7 +11,8 @@ SYNOPSIS [--email-san=[EMAIL_SAN,...]] [--from-ca=FROM_CA] [--ip-san=[IP_SAN,...]] [--issuer-ca=ISSUER_CA] [--labels=[KEY=VALUE,...]] [--subject=[SUBJECT,...]] - [--uri-san=[URI_SAN,...]] [--validity=VALIDITY; default="P3Y"] + [--subject-key-id=SUBJECT_KEY_ID] [--uri-san=[URI_SAN,...]] + [--validity=VALIDITY; default="P3Y"] [--key-algorithm=KEY_ALGORITHM; default="rsa-pkcs1-2048-sha256" | [--kms-key-version=KMS_KEY_VERSION : --kms-key=KMS_KEY --kms-keyring=KMS_KEYRING @@ -219,6 +220,12 @@ OPTIONAL FLAGS X.501 name of the certificate subject. Example: --subject "C=US,ST=California,L=Mountain View,O=Google LLC,CN=google.com" + --subject-key-id=SUBJECT_KEY_ID + Optional field to specify subject key ID for certificate. DO NOT USE + except to maintain a previously established identifier for a public + key, whose SKI was not generated using method (1) described in RFC 5280 + section 4.2.1.2. + --uri-san=[URI_SAN,...] One or more comma-separated URI Subject Alternative Names. diff --git a/gcloud/privateca/templates/create b/gcloud/privateca/templates/create index 946f78dc7..9420b5f20 100644 --- a/gcloud/privateca/templates/create +++ b/gcloud/privateca/templates/create @@ -6,7 +6,7 @@ SYNOPSIS (CERTIFICATE_TEMPLATE : --location=LOCATION) --copy-sans --copy-subject [--description=DESCRIPTION] [--identity-cel-expression=IDENTITY_CEL_EXPRESSION] - [--labels=[KEY=VALUE,...]] + [--labels=[KEY=VALUE,...]] [--maximum-lifetime=MAXIMUM_LIFETIME] [--predefined-values-file=PREDEFINED_VALUES_FILE] [--copy-all-requested-extensions | --copy-extensions-by-oid=[OBJECT_ID,...] @@ -115,6 +115,15 @@ OPTIONAL FLAGS contain only hyphens (-), underscores (_), lowercase characters, and numbers. + --maximum-lifetime=MAXIMUM_LIFETIME + If this is set, then issued certificate's lifetime will be truncated to + the value provided. If the issuing CaPool's IssuancePolicy specifies a + maximum lifetime the minimum of the two durations will be the maximum + lifetime for the issued certificate. Note that if the issuing + CertificateAuthority expires before a Certificate's requested + maximum_lifetime, the effective lifetime will be explicitly truncated + to match it. + --predefined-values-file=PREDEFINED_VALUES_FILE A YAML file describing any predefined X.509 values set by this template. The provided extensions will be copied over to any diff --git a/gcloud/pubsub/subscriptions/create b/gcloud/pubsub/subscriptions/create index 41f5334e3..55a14171a 100644 --- a/gcloud/pubsub/subscriptions/create +++ b/gcloud/pubsub/subscriptions/create @@ -15,12 +15,7 @@ SYNOPSIS [[--bigquery-table=BIGQUERY_TABLE : --drop-unknown-fields --write-metadata --use-table-schema | --use-topic-schema] | [--cloud-storage-bucket=CLOUD_STORAGE_BUCKET - : --cloud-storage-file-prefix=CLOUD_STORAGE_FILE_PREFIX - --cloud-storage-file-suffix=CLOUD_STORAGE_FILE_SUFFIX - --cloud-storage-max-bytes=CLOUD_STORAGE_MAX_BYTES - --cloud-storage-max-duration=CLOUD_STORAGE_MAX_DURATION - --cloud-storage-output-format=OUTPUT_FORMAT; - default="text" --cloud-storage-write-metadata]] + : --cloud-storage-file-datetime-format=CLOUD_STORAGE_FILE_DATETIME_FORMAT --cloud-storage-file-prefix=CLOUD_STORAGE_FILE_PREFIX --cloud-storage-file-suffix=CLOUD_STORAGE_FILE_SUFFIX --cloud-storage-max-bytes=CLOUD_STORAGE_MAX_BYTES --cloud-storage-max-duration=CLOUD_STORAGE_MAX_DURATION --cloud-storage-output-format=OUTPUT_FORMAT; default="text" --cloud-storage-write-metadata]] [--max-delivery-attempts=MAX_DELIVERY_ATTEMPTS [--dead-letter-topic=DEAD_LETTER_TOPIC : --dead-letter-topic-project=DEAD_LETTER_TOPIC_PROJECT]] @@ -207,6 +202,11 @@ OPTIONAL FLAGS This flag argument must be specified if any of the other arguments in this group are specified. + --cloud-storage-file-datetime-format=CLOUD_STORAGE_FILE_DATETIME_FORMAT + The custom datetime format string for Cloud Storage filename. See + the datetime format guidance + (https://cloud.google.com/pubsub/docs/create-cloudstorage-subscription#file_names). + --cloud-storage-file-prefix=CLOUD_STORAGE_FILE_PREFIX The prefix for Cloud Storage filename. diff --git a/gcloud/pubsub/subscriptions/update b/gcloud/pubsub/subscriptions/update index 50038c21c..e40ed81a1 100644 --- a/gcloud/pubsub/subscriptions/update +++ b/gcloud/pubsub/subscriptions/update @@ -15,12 +15,7 @@ SYNOPSIS : --drop-unknown-fields --write-metadata --use-table-schema | --use-topic-schema] | --clear-cloud-storage-config | [--cloud-storage-bucket=CLOUD_STORAGE_BUCKET - : --cloud-storage-file-prefix=CLOUD_STORAGE_FILE_PREFIX - --cloud-storage-file-suffix=CLOUD_STORAGE_FILE_SUFFIX - --cloud-storage-max-bytes=CLOUD_STORAGE_MAX_BYTES - --cloud-storage-max-duration=CLOUD_STORAGE_MAX_DURATION - --cloud-storage-output-format=OUTPUT_FORMAT; - default="text" --cloud-storage-write-metadata]] + : --cloud-storage-file-datetime-format=CLOUD_STORAGE_FILE_DATETIME_FORMAT --cloud-storage-file-prefix=CLOUD_STORAGE_FILE_PREFIX --cloud-storage-file-suffix=CLOUD_STORAGE_FILE_SUFFIX --cloud-storage-max-bytes=CLOUD_STORAGE_MAX_BYTES --cloud-storage-max-duration=CLOUD_STORAGE_MAX_DURATION --cloud-storage-output-format=OUTPUT_FORMAT; default="text" --cloud-storage-write-metadata]] [--clear-dead-letter-policy | --max-delivery-attempts=MAX_DELIVERY_ATTEMPTS [--dead-letter-topic=DEAD_LETTER_TOPIC @@ -187,6 +182,11 @@ FLAGS This flag argument must be specified if any of the other arguments in this group are specified. + --cloud-storage-file-datetime-format=CLOUD_STORAGE_FILE_DATETIME_FORMAT + The custom datetime format string for Cloud Storage filename. See + the datetime format guidance + (https://cloud.google.com/pubsub/docs/create-cloudstorage-subscription#file_names). + --cloud-storage-file-prefix=CLOUD_STORAGE_FILE_PREFIX The prefix for Cloud Storage filename. diff --git a/gcloud/redis/clusters/create b/gcloud/redis/clusters/create index d7f522635..b01c2a962 100644 --- a/gcloud/redis/clusters/create +++ b/gcloud/redis/clusters/create @@ -5,7 +5,8 @@ NAME SYNOPSIS gcloud redis clusters create (CLUSTER : --region=REGION) --network=NETWORK --shard-count=SHARD_COUNT [--aof-append-fsync=AOF_APPEND_FSYNC] - [--async] [--auth-mode=AUTH_MODE] [--persistence-mode=PERSISTENCE_MODE] + [--async] [--auth-mode=AUTH_MODE] [--node-type=NODE_TYPE] + [--persistence-mode=PERSISTENCE_MODE] [--rdb-snapshot-period=RDB_SNAPSHOT_PERIOD] [--rdb-snapshot-start-time=RDB_SNAPSHOT_START_TIME] [--redis-config=[KEY=VALUE,...]] [--replica-count=REPLICA_COUNT] @@ -112,6 +113,11 @@ OPTIONAL FLAGS iam-auth IAM basic authorization is enabled for the cluster. + --node-type=NODE_TYPE + Node Type of the redis cluster Node. NODE_TYPE must be one of: + redis-highmem-medium, redis-highmem-xlarge, redis-shared-core-nano, + redis-standard-small. + --persistence-mode=PERSISTENCE_MODE Operation mode for persistence. PERSISTENCE_MODE must be one of: diff --git a/gcloud/storage/mv b/gcloud/storage/mv index c88cde25f..96eeae8e4 100644 --- a/gcloud/storage/mv +++ b/gcloud/storage/mv @@ -34,7 +34,7 @@ SYNOPSIS DESCRIPTION The mv command allows you to move data between your local file system and the cloud, move data within the cloud, and move data between cloud storage - providers + providers. Renaming Groups Of Objects diff --git a/gcloud/workbench/instances/create b/gcloud/workbench/instances/create index fd93f1e35..c670f1c88 100644 --- a/gcloud/workbench/instances/create +++ b/gcloud/workbench/instances/create @@ -158,7 +158,7 @@ FLAGS Type of this accelerator. ACCELERATOR_TYPE must be one of: NVIDIA_TESLA_K80, NVIDIA_TESLA_P100, NVIDIA_TESLA_V100, NVIDIA_TESLA_P4, NVIDIA_TESLA_T4, NVIDIA_TESLA_A100, - NVIDIA_TESLA_A100_80GB, NVIDIA_TESLA_T4_VWS, NVIDIA_TESLA_P100_VWS, + NVIDIA_A100_80GB, NVIDIA_TESLA_T4_VWS, NVIDIA_TESLA_P100_VWS, NVIDIA_TESLA_P4_VWS. Boot disk configurations. diff --git a/gcloud/workbench/instances/update b/gcloud/workbench/instances/update index bb126f8ca..08425bd9a 100644 --- a/gcloud/workbench/instances/update +++ b/gcloud/workbench/instances/update @@ -91,7 +91,7 @@ FLAGS Type of this accelerator. ACCELERATOR_TYPE must be one of: NVIDIA_TESLA_K80, NVIDIA_TESLA_P100, NVIDIA_TESLA_V100, NVIDIA_TESLA_P4, NVIDIA_TESLA_T4, NVIDIA_TESLA_A100, - NVIDIA_TESLA_A100_80GB, NVIDIA_TESLA_T4_VWS, NVIDIA_TESLA_P100_VWS, + NVIDIA_A100_80GB, NVIDIA_TESLA_T4_VWS, NVIDIA_TESLA_P100_VWS, NVIDIA_TESLA_P4_VWS. GPU driver configurations.