From f645b4c02da2feed387fdbbd267191d274e68018 Mon Sep 17 00:00:00 2001 From: Automated Date: Thu, 26 Jun 2025 10:50:44 +0000 Subject: [PATCH] gcloud: Thu Jun 26 10:50:44 UTC 2025 --- gcloud/_version | 8 +- gcloud/alloydb/instances/create | 4 +- gcloud/alloydb/instances/update | 4 +- gcloud/alpha/ai/endpoints/list | 11 +- gcloud/alpha/alloydb/clusters/upgrade | 2 +- gcloud/alpha/alloydb/instances/create | 4 +- gcloud/alpha/alloydb/instances/update | 4 +- gcloud/alpha/api-gateway/api-configs/create | 2 +- .../backup-dr/backup-plan-revisions/describe | 76 +++ .../backup-dr/backup-plan-revisions/help | 30 ++ .../backup-dr/backup-plan-revisions/list | 110 +++++ gcloud/alpha/backup-dr/backup-plans/help | 3 + gcloud/alpha/backup-dr/backup-plans/update | 289 +++++++++++ gcloud/alpha/backup-dr/help | 3 + gcloud/alpha/compute/backend-buckets/describe | 12 +- .../application-awareness/delete | 40 ++ .../interconnects/application-awareness/help | 4 + gcloud/alpha/compute/reservations/update | 8 +- gcloud/alpha/container/ai/help | 2 +- .../ai/recommender/accelerators/help | 7 +- .../ai/recommender/accelerators/list | 13 +- gcloud/alpha/container/ai/recommender/help | 26 +- .../container/ai/recommender/manifests/create | 14 +- .../container/ai/recommender/manifests/help | 9 +- .../model-and-server-combinations/help | 8 +- .../model-and-server-combinations/list | 9 +- .../ai/recommender/model-server-versions/help | 8 +- .../ai/recommender/model-server-versions/list | 15 +- .../ai/recommender/model-servers/help | 7 +- .../ai/recommender/model-servers/list | 11 +- .../container/ai/recommender/models/help | 7 +- .../container/ai/recommender/models/list | 5 +- gcloud/alpha/dataproc/clusters/create | 55 ++- gcloud/alpha/dataproc/clusters/update | 53 +- gcloud/alpha/firestore/databases/create | 14 +- gcloud/alpha/managed-kafka/clusters/create | 1 + gcloud/alpha/managed-kafka/clusters/update | 30 +- .../schema-registries/subject/describe | 9 +- .../schema-registries/subject/update | 4 - gcloud/alpha/memorystore/instances/create | 49 +- gcloud/alpha/memorystore/instances/update | 62 ++- gcloud/alpha/metastore/federations/create | 6 +- gcloud/alpha/metastore/services/create | 4 + .../alpha/migration/vms/image-imports/create | 19 +- .../vms/machine-image-imports/create | 19 +- .../volumes/replications/establish-peering | 3 +- .../backend-authentication-configs/create | 4 +- .../backend-authentication-configs/delete | 4 +- .../backend-authentication-configs/describe | 4 +- .../backend-authentication-configs/export | 4 +- .../backend-authentication-configs/help | 4 +- .../backend-authentication-configs/import | 4 +- .../backend-authentication-configs/list | 4 +- .../org-address-groups/create | 7 +- .../org-address-groups/update | 6 +- gcloud/alpha/run/deploy | 18 + gcloud/alpha/run/multi-region-services/update | 18 + gcloud/alpha/run/services/update | 18 + gcloud/alpha/run/worker-pools/delete | 4 +- gcloud/alpha/run/worker-pools/deploy | 4 +- gcloud/alpha/run/worker-pools/describe | 4 +- gcloud/alpha/run/worker-pools/help | 4 +- gcloud/alpha/run/worker-pools/list | 4 +- gcloud/alpha/run/worker-pools/replace | 4 +- .../alpha/run/worker-pools/revisions/delete | 4 +- .../alpha/run/worker-pools/revisions/describe | 4 +- gcloud/alpha/run/worker-pools/revisions/help | 4 +- gcloud/alpha/run/worker-pools/revisions/list | 4 +- gcloud/alpha/run/worker-pools/update | 4 +- .../run/worker-pools/update-instance-split | 4 +- gcloud/alpha/services/identity/create | 11 +- gcloud/alpha/spanner/backups/create | 2 +- gcloud/alpha/spanner/cli | 123 +++++ gcloud/alpha/spanner/help | 8 +- .../storage/batch-operations/jobs/create | 6 +- .../storage/insights/dataset-configs/create | 29 +- .../insights/dataset-configs/create-link | 6 +- .../storage/insights/dataset-configs/delete | 10 +- .../insights/dataset-configs/delete-link | 6 +- .../storage/insights/dataset-configs/describe | 6 +- .../storage/insights/dataset-configs/update | 103 +++- gcloud/api-gateway/api-configs/create | 2 +- gcloud/beta/ai/endpoints/list | 11 +- gcloud/beta/alloydb/clusters/upgrade | 2 +- gcloud/beta/alloydb/instances/create | 4 +- gcloud/beta/alloydb/instances/update | 4 +- gcloud/beta/api-gateway/api-configs/create | 2 +- gcloud/beta/compute/disks/update | 41 ++ gcloud/beta/compute/reservations/update | 8 +- gcloud/beta/dataproc/clusters/create | 55 ++- gcloud/beta/dataproc/clusters/update | 53 +- gcloud/beta/iam/policy-bindings/create | 15 +- gcloud/beta/memorystore/instances/create | 49 +- gcloud/beta/memorystore/instances/update | 62 ++- gcloud/beta/metastore/federations/create | 6 +- gcloud/beta/metastore/services/create | 4 + .../volumes/replications/establish-peering | 3 +- .../backend-authentication-configs/create | 6 +- .../backend-authentication-configs/delete | 6 +- .../backend-authentication-configs/describe | 6 +- .../backend-authentication-configs/export | 6 +- .../backend-authentication-configs/help | 6 +- .../backend-authentication-configs/import | 6 +- .../backend-authentication-configs/list | 6 +- .../org-address-groups/create | 7 +- .../org-address-groups/update | 6 +- gcloud/beta/quotas/adjuster/settings/describe | 26 +- gcloud/beta/quotas/adjuster/settings/help | 5 +- gcloud/beta/quotas/adjuster/settings/update | 27 +- gcloud/beta/run/deploy | 8 +- gcloud/beta/run/help | 3 + gcloud/beta/run/multi-region-services/update | 8 +- gcloud/beta/run/services/update | 8 +- gcloud/beta/run/worker-pools/delete | 69 +++ gcloud/beta/run/worker-pools/deploy | 467 ++++++++++++++++++ gcloud/beta/run/worker-pools/describe | 66 +++ gcloud/beta/run/worker-pools/help | 58 +++ gcloud/beta/run/worker-pools/list | 67 +++ gcloud/beta/run/worker-pools/replace | 46 ++ gcloud/beta/run/worker-pools/revisions/delete | 81 +++ .../beta/run/worker-pools/revisions/describe | 55 +++ gcloud/beta/run/worker-pools/revisions/help | 39 ++ gcloud/beta/run/worker-pools/revisions/list | 72 +++ gcloud/beta/run/worker-pools/update | 444 +++++++++++++++++ .../run/worker-pools/update-instance-split | 134 +++++ gcloud/beta/services/identity/create | 11 +- gcloud/beta/spanner/backups/create | 2 +- gcloud/compute/disks/update | 38 ++ gcloud/compute/reservations/update | 7 + gcloud/dataproc/clusters/create | 54 +- gcloud/dataproc/clusters/update | 53 +- gcloud/memorystore/instances/create | 49 +- gcloud/memorystore/instances/update | 62 ++- gcloud/metastore/federations/create | 6 +- gcloud/metastore/services/create | 4 + gcloud/migration/vms/image-imports/create | 19 +- .../vms/machine-image-imports/create | 19 +- gcloud/netapp/volumes/create | 9 +- .../volumes/replications/establish-peering | 3 +- .../backend-authentication-configs/create | 95 ++++ .../backend-authentication-configs/delete | 80 +++ .../backend-authentication-configs/describe | 73 +++ .../backend-authentication-configs/export | 80 +++ .../backend-authentication-configs/help | 44 ++ .../backend-authentication-configs/import | 86 ++++ .../backend-authentication-configs/list | 89 ++++ gcloud/network-security/help | 3 + gcloud/privateca/subordinates/update | 3 +- gcloud/spanner/backups/create | 2 +- gcloud/storage/batch-operations/jobs/create | 6 +- 150 files changed, 4099 insertions(+), 393 deletions(-) create mode 100644 gcloud/alpha/backup-dr/backup-plan-revisions/describe create mode 100644 gcloud/alpha/backup-dr/backup-plan-revisions/help create mode 100644 gcloud/alpha/backup-dr/backup-plan-revisions/list create mode 100644 gcloud/alpha/backup-dr/backup-plans/update create mode 100644 gcloud/alpha/compute/interconnects/application-awareness/delete create mode 100644 gcloud/alpha/spanner/cli create mode 100644 gcloud/beta/run/worker-pools/delete create mode 100644 gcloud/beta/run/worker-pools/deploy create mode 100644 gcloud/beta/run/worker-pools/describe create mode 100644 gcloud/beta/run/worker-pools/help create mode 100644 gcloud/beta/run/worker-pools/list create mode 100644 gcloud/beta/run/worker-pools/replace create mode 100644 gcloud/beta/run/worker-pools/revisions/delete create mode 100644 gcloud/beta/run/worker-pools/revisions/describe create mode 100644 gcloud/beta/run/worker-pools/revisions/help create mode 100644 gcloud/beta/run/worker-pools/revisions/list create mode 100644 gcloud/beta/run/worker-pools/update create mode 100644 gcloud/beta/run/worker-pools/update-instance-split create mode 100644 gcloud/network-security/backend-authentication-configs/create create mode 100644 gcloud/network-security/backend-authentication-configs/delete create mode 100644 gcloud/network-security/backend-authentication-configs/describe create mode 100644 gcloud/network-security/backend-authentication-configs/export create mode 100644 gcloud/network-security/backend-authentication-configs/help create mode 100644 gcloud/network-security/backend-authentication-configs/import create mode 100644 gcloud/network-security/backend-authentication-configs/list diff --git a/gcloud/_version b/gcloud/_version index 9190352f5..de1bad2ec 100644 --- a/gcloud/_version +++ b/gcloud/_version @@ -1,8 +1,8 @@ -Google Cloud SDK 527.0.0 -alpha 2025.06.13 -beta 2025.06.13 +Google Cloud SDK 528.0.0 +alpha 2025.06.20 +beta 2025.06.20 bq 2.1.18 bundled-python3-unix 3.12.9 -core 2025.06.13 +core 2025.06.20 gcloud-crc32c 1.0.0 gsutil 5.34 diff --git a/gcloud/alloydb/instances/create b/gcloud/alloydb/instances/create index 22725e3d1..f22c8be91 100644 --- a/gcloud/alloydb/instances/create +++ b/gcloud/alloydb/instances/create @@ -155,7 +155,9 @@ OPTIONAL FLAGS n2-highmem-64, n2-highmem-96, n2-highmem-128, c4a-highmem-1, c4a-highmem-4-lssd, c4a-highmem-8-lssd, c4a-highmem-16-lssd, c4a-highmem-32-lssd, c4a-highmem-48-lssd, c4a-highmem-64-lssd, - c4a-highmem-72-lssd. + c4a-highmem-72-lssd, z3-highmem-14-standardlssd, + z3-highmem-22-standardlssd, z3-highmem-44-standardlssd, + z3-highmem-88-standardlssd. --[no-]outbound-public-ip Add outbound Public IP connectivity to an AlloyDB instance. Use diff --git a/gcloud/alloydb/instances/update b/gcloud/alloydb/instances/update index 6ea9d5b4f..6d9116ace 100644 --- a/gcloud/alloydb/instances/update +++ b/gcloud/alloydb/instances/update @@ -141,7 +141,9 @@ OPTIONAL FLAGS n2-highmem-64, n2-highmem-96, n2-highmem-128, c4a-highmem-1, c4a-highmem-4-lssd, c4a-highmem-8-lssd, c4a-highmem-16-lssd, c4a-highmem-32-lssd, c4a-highmem-48-lssd, c4a-highmem-64-lssd, - c4a-highmem-72-lssd. + c4a-highmem-72-lssd, z3-highmem-14-standardlssd, + z3-highmem-22-standardlssd, z3-highmem-44-standardlssd, + z3-highmem-88-standardlssd. --[no-]outbound-public-ip Add outbound Public IP connectivity to an AlloyDB instance. Use diff --git a/gcloud/alpha/ai/endpoints/list b/gcloud/alpha/ai/endpoints/list index e7ea851f7..5d1c4fa1e 100644 --- a/gcloud/alpha/ai/endpoints/list +++ b/gcloud/alpha/ai/endpoints/list @@ -2,10 +2,10 @@ NAME gcloud alpha ai endpoints list - list existing Vertex AI endpoints SYNOPSIS - gcloud alpha ai endpoints list [--list-model-garden-endpoints-only] - [--region=REGION] [--filter=EXPRESSION] [--limit=LIMIT] - [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] - [GCLOUD_WIDE_FLAG ...] + gcloud alpha ai endpoints list [--gdc-zone=GDC_ZONE] + [--list-model-garden-endpoints-only] [--region=REGION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] EXAMPLES To list the endpoints under project example in region us-central1, run: @@ -20,6 +20,9 @@ EXAMPLES --region=us-central1 --list-model-garden-endpoints-only FLAGS + --gdc-zone=GDC_ZONE + The name of the GDC zone. If set, the endpoint is for GDCc. + --list-model-garden-endpoints-only Whether to only list endpoints related to Model Garden. diff --git a/gcloud/alpha/alloydb/clusters/upgrade b/gcloud/alpha/alloydb/clusters/upgrade index d45e562aa..9f99abc13 100644 --- a/gcloud/alpha/alloydb/clusters/upgrade +++ b/gcloud/alpha/alloydb/clusters/upgrade @@ -26,7 +26,7 @@ REQUIRED FLAGS --version=VERSION Target database version for the upgrade. VERSION must be one of: - POSTGRES_14, POSTGRES_15, POSTGRES_16. + POSTGRES_14, POSTGRES_15, POSTGRES_16, POSTGRES_17. OPTIONAL FLAGS --async diff --git a/gcloud/alpha/alloydb/instances/create b/gcloud/alpha/alloydb/instances/create index 91346bfd1..7697228c8 100644 --- a/gcloud/alpha/alloydb/instances/create +++ b/gcloud/alpha/alloydb/instances/create @@ -209,7 +209,9 @@ OPTIONAL FLAGS n2-highmem-64, n2-highmem-96, n2-highmem-128, c4a-highmem-1, c4a-highmem-4-lssd, c4a-highmem-8-lssd, c4a-highmem-16-lssd, c4a-highmem-32-lssd, c4a-highmem-48-lssd, c4a-highmem-64-lssd, - c4a-highmem-72-lssd. + c4a-highmem-72-lssd, z3-highmem-14-standardlssd, + z3-highmem-22-standardlssd, z3-highmem-44-standardlssd, + z3-highmem-88-standardlssd. --[no-]observability-config-enabled Enable enhanced query insights feature. Use diff --git a/gcloud/alpha/alloydb/instances/update b/gcloud/alpha/alloydb/instances/update index 8339f83a0..c5fdc3ff4 100644 --- a/gcloud/alpha/alloydb/instances/update +++ b/gcloud/alpha/alloydb/instances/update @@ -195,7 +195,9 @@ OPTIONAL FLAGS n2-highmem-64, n2-highmem-96, n2-highmem-128, c4a-highmem-1, c4a-highmem-4-lssd, c4a-highmem-8-lssd, c4a-highmem-16-lssd, c4a-highmem-32-lssd, c4a-highmem-48-lssd, c4a-highmem-64-lssd, - c4a-highmem-72-lssd. + c4a-highmem-72-lssd, z3-highmem-14-standardlssd, + z3-highmem-22-standardlssd, z3-highmem-44-standardlssd, + z3-highmem-88-standardlssd. --[no-]observability-config-enabled Enable enhanced query insights feature. Use diff --git a/gcloud/alpha/api-gateway/api-configs/create b/gcloud/alpha/api-gateway/api-configs/create index 051567adb..bb0c4ca03 100644 --- a/gcloud/alpha/api-gateway/api-configs/create +++ b/gcloud/alpha/api-gateway/api-configs/create @@ -67,7 +67,7 @@ REQUIRED FLAGS listed. --openapi-spec=[FILE,...] - The OpenAPI v2 specifications containing service configuration + The OpenAPI specifications containing service configuration information, and API specification for the gateway. OPTIONAL FLAGS diff --git a/gcloud/alpha/backup-dr/backup-plan-revisions/describe b/gcloud/alpha/backup-dr/backup-plan-revisions/describe new file mode 100644 index 000000000..9f147f1fc --- /dev/null +++ b/gcloud/alpha/backup-dr/backup-plan-revisions/describe @@ -0,0 +1,76 @@ +NAME + gcloud alpha backup-dr backup-plan-revisions describe - show details of the + backup plan revision + +SYNOPSIS + gcloud alpha backup-dr backup-plan-revisions describe + (BACKUP_PLAN_REVISION : --backup_plan=BACKUP_PLAN --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Show all data associated with the specified backup plan revision. + +EXAMPLES + To view details for backup plan revision 'BACKUP_PLAN_REVISION', run: + + $ gcloud alpha backup-dr backup-plan-revisions describe \ + BACKUP_PLAN_REVISION + +POSITIONAL ARGUMENTS + Backup plan revision resource - Name of the backup plan revision 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_plan_revision 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_PLAN_REVISION + ID of the backup_plan_revision or fully qualified identifier for the + backup_plan_revision. + + To set the backup_plan_revision attribute: + ▸ provide the argument backup_plan_revision on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --backup_plan=BACKUP_PLAN + The ID of the Backup Plan + + To set the backup_plan attribute: + ▸ provide the argument backup_plan_revision on the command line + with a fully specified name; + ▸ provide the argument --backup_plan on the command line. + + --location=LOCATION + Location ID of the resource. + + To set the location attribute: + ▸ provide the argument backup_plan_revision on the command line + with a fully specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the backupdr/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/backup-disaster-recovery + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/backup-dr/backup-plan-revisions/help b/gcloud/alpha/backup-dr/backup-plan-revisions/help new file mode 100644 index 000000000..65b70fbe7 --- /dev/null +++ b/gcloud/alpha/backup-dr/backup-plan-revisions/help @@ -0,0 +1,30 @@ +NAME + gcloud alpha backup-dr backup-plan-revisions - view Backup and DR backup + plan revisions + +SYNOPSIS + gcloud alpha backup-dr backup-plan-revisions COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) View Backup and DR backup plan revisions. + +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) Show details of the backup plan revision. + + list + (ALPHA) List backup plan revisions. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/backup-dr/backup-plan-revisions/list b/gcloud/alpha/backup-dr/backup-plan-revisions/list new file mode 100644 index 000000000..31e898834 --- /dev/null +++ b/gcloud/alpha/backup-dr/backup-plan-revisions/list @@ -0,0 +1,110 @@ +NAME + gcloud alpha backup-dr backup-plan-revisions list - list backup plan + revisions + +SYNOPSIS + gcloud alpha backup-dr backup-plan-revisions list + [--backup-plan=BACKUP_PLAN --location=LOCATION] [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List backup plan revisions in the project. + +EXAMPLES + To list backup plan revisions for all backup plans and locations, run: + + $ gcloud alpha backup-dr backup-plan-revisions list + + To list all backup plan revisions for a backup plan my-backup-plan, run: + + $ gcloud alpha backup-dr backup-plan-revisions list \ + --backup-plan=my-backup-plan + + To list all backup plan revisions for a backup plan my-backup-plan in + location my-location, run: + + $ gcloud alpha backup-dr backup-plan-revisions list \ + --backup-plan=my-backup-plan --location=my-location + +FLAGS + Backup plan resource - Backup plan to list backup plan revisions 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 --backup-plan on the command line with a fully + specified name; + ◆ default is all backup plans with a fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --backup-plan=BACKUP_PLAN + ID of the backup_plan or fully qualified identifier for the + backup_plan. + + To set the backup-plan attribute: + ▸ provide the argument --backup-plan on the command line; + ▸ default is all backup plans . + + --location=LOCATION + Location ID of the resource. + + To set the location attribute: + ▸ provide the argument --backup-plan on the command line with a + fully specified name; + ▸ default is all backup plans with a fully specified name; + ▸ provide the argument --location on the command line; + ▸ default is all locations . + +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. + +API REFERENCE + This command uses the backupdr/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/backup-disaster-recovery + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/backup-dr/backup-plans/help b/gcloud/alpha/backup-dr/backup-plans/help index 1298795f6..fc94508c3 100644 --- a/gcloud/alpha/backup-dr/backup-plans/help +++ b/gcloud/alpha/backup-dr/backup-plans/help @@ -27,6 +27,9 @@ COMMANDS list (ALPHA) List backup plans in the project. + update + (ALPHA) Update a specific backup plan. + NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct diff --git a/gcloud/alpha/backup-dr/backup-plans/update b/gcloud/alpha/backup-dr/backup-plans/update new file mode 100644 index 000000000..274c61212 --- /dev/null +++ b/gcloud/alpha/backup-dr/backup-plans/update @@ -0,0 +1,289 @@ +NAME + gcloud alpha backup-dr backup-plans update - update a specific backup plan + +SYNOPSIS + gcloud alpha backup-dr backup-plans update + (BACKUP_PLAN : --location=LOCATION) + [--add-backup-rule=[PROPERTY=VALUE,...]] [--async] + [--backup-rule=[PROPERTY=VALUE,...]] + [--backup-rules-from-file=PATH_TO_FILE] [--description=DESCRIPTION] + [--remove-backup-rule=RULE-ID] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Update a specific backup plan in the project. It can only be + updated in regions supported by the Backup and DR Service. + +EXAMPLES + To update 2 backup rules and description of an existing backup plan + sample-backup-plan in project sample-project, at location us-central1: + + run: + + $ gcloud alpha backup-dr backup-plans update sample-backup-plan \ + --project=sample-project --location=us-central1 \ + --backup-rule --backup-rule \ + --description "This is a sample backup plan" + + To add backup rules to an existing backup plan sample-backup-plan in + project sample-project, at location us-central1: + + run: + + $ gcloud alpha backup-dr backup-plans update sample-backup-plan \ + --project=sample-project --location=us-central1 \ + --add-backup-rule --add-backup-rule + + To remove a backup rule with id sample-daily-rule from an existing backup + plan sample-backup-plan in project sample-project, at location us-central1: + + run: + + $ gcloud alpha backup-dr backup-plans update sample-backup-plan \ + --project=sample-project --location=us-central1 \ + --remove-backup-rule sample-daily-rule + + To override backup rules in an existing backup plan sample-backup-plan in + project sample-project, at location us-central1, pass a file path + containing backup rules in YAML or JSON format: This flag is mutually + exclusive with --add-backup-rule, --remove-backup-rule and --backup-rule + flags. + + run: $ gcloud alpha backup-dr backup-plans update sample-backup-plan \ + --project=sample-project --location=us-central1 \ + --backup-rules-fom-file + + Backup Rule Examples: + + 1. Hourly backup rule with hourly backup frequency of 6 hours and store it + for 30 days, and expect the backups to run only between 10:00 to 20:00 UTC + + : + rule-id=sample-hourly-rule,retention-days=30,recurrence=HOURLY,hourly-frequency=6,time-zone=UTC,backup-window-start=10,backup-window-end=20 + + Properties: + ▪ rule-id = "sample-hourly-rule" + ▪ retention-days = 30 + ▪ recurrence = HOURLY + ▪ hourly-frequency = 6 + ▪ time-zone = UTC + ▪ backup-window-start = 10 + ▪ backup-window-end = 20 + + 2. Daily backup rule with daily backup frequency of 6 hours and store it + for 7 days + + : + rule-id=sample-daily-rule,retention-days=7,recurrence=DAILY,backup-window-start=1,backup-window-end=14 + + Properties: + ▪ rule-id = "sample-daily-rule" + ▪ retention-days = 7 + ▪ recurrence = DAILY + ▪ backup-window-start = 1 + ▪ backup-window-end = 14 + + 3. Weekly backup rule with weekly backup frequency on every MONDAY & FRIDAY + and store it for 21 days + + : + rule-id=sample-weekly-rule,retention-days=21,recurrence=WEEKLY,days-of-week="MONDAY + FRIDAY",backup-window-start=10,backup-window-end=20 + + Properties: + ▪ rule-id = "sample-weekly-rule" + ▪ retention-days: 21 + ▪ recurrence = WEEKLY + ▪ days-of-week = "MONDAY FRIDAY" + ▪ backup-window-start = 10 + ▪ backup-window-end = 20 + + YAML and JSON file examples: + + YAML file example: + + backup-rules: + - rule-id: weekly-rule + retention-days: 7 + recurrence: WEEKLY + backup-window-start: 0 + backup-window-end: 23 + days-of-week: [MONDAY, TUESDAY] + time-zone: UTC + - rule-id: daily-rule + retention-days: 1 + recurrence: DAILY + backup-window-start: 1 + backup-window-end: 24 + time-zone: UTC + + JSON file example: { + "backup-rules": [ + { + "rule-id": "weekly-rule", + "retention-days": 7, + "recurrence": "WEEKLY", + "backup-window-start": 0, + "backup-window-end": 23, + "days-of-week": ["MONDAY", "TUESDAY"], + "time-zone": "UTC" + }, + { + "rule-id": "daily-rule", + "retention-days": 1, + "recurrence": "DAILY", + "backup-window-start": 1, + "backup-window-end": 24, + "time-zone": "UTC" + } + ] + } + +POSITIONAL ARGUMENTS + Backup Plan resource - Name of the backup plan to be updated. The name + must be unique for a project and location. 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_plan 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_PLAN + ID of the Backup Plan or fully qualified identifier for the Backup + Plan. + + To set the name attribute: + ▸ provide the argument backup_plan 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 Plan. + + To set the location attribute: + ▸ provide the argument backup_plan on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --add-backup-rule=[PROPERTY=VALUE,...] + Parameters of backup rule to be added to the Backup Plan. This flag can + be repeated to add more backup rules. + + --async + Return immediately, without waiting for the operation in progress to + complete. The default is True. Enabled by default, use --no-async to + disable. + + --backup-rule=[PROPERTY=VALUE,...] + Full definition of an existing backup rule with updated values. The + existing backup rule is replaced by this new set of values. This flag + can be repeated to update multiple backup rules. It is not allowed to + pass the same rule-id in this flag more than once in the same command. + + Parameters for the backup rule include: + + rule-id + Name of the backup rule. The name must be unique and start with a + lowercase letter followed by up to 62 lowercase letters, numbers, + or hyphens. + + retention-days + Duration for which backup data should be retained. It must be + defined in "days". The value should be greater than or equal to the + enforced retention period set for the backup vault. + + recurrence + Frequency for the backup schedule. It must be either: HOURLY, + DAILY, WEEKLY, MONTHLY or YEARLY. + + backup-window-start + Start time of the interval during which backup jobs should be + executed. It can be defined as backup-window-start=2, that means + backup window starts at 2 a.m. The start time and end time must + have an interval of 6 hours. + + backup-window-end + End time of the interval during which backup jobs should be + executed. It can be defined as backup-window-end=14, that means + backup window ends at 2 p.m. The start time and end time must have + an interval of 6 hours. + + Jobs are queued at the beginning of the window and will be marked + as SKIPPED if they do not start by the end time. Jobs that are in + progress will not be canceled at the end time. + + time-zone + The time zone to be used for the backup schedule. The value must + exist in the IANA tz database (https://www.iana.org/time-zones). + The default value is UTC. E.g., Europe/Paris + + Following flags are mutually exclusive: + + hourly-frequency + Frequency for hourly backups. An hourly frequency of 2 means backup + jobs will run every 2 hours from start time till the end time + defined. The hourly frequency must be between 4 and 23. The value + is needed only if recurrence type is HOURLY. + + days-of-week + Days of the week when the backup job should be executed. The value + is needed if recurrence type is WEEKLY. E.g., MONDAY,TUESDAY + + days-of-month + Days of the month when the backup job should be executed. The value + is needed only if recurrence type is YEARLY. E.g.,"1,5,14" + + months + Month for the backup schedule. The value is needed only if + recurrence type is YEARLY. E.g., JANUARY, MARCH + + week-day-of-month + Recurring day of the week in the month or year when the backup job + should be executed. E.g. FIRST-SUNDAY, THIRD-MONDAY. The value can + only be provided if the recurrence type is MONTHLY or YEARLY. + Allowed values for the number of week - FIRST, SECOND, THIRD, + FOURTH, LAST. Allowed values for days of the week - MONDAY to + SUNDAY. + + E.g., + "rule-id=sample-daily-rule,recurrence=WEEKLY,backup-window-start=2,backup-window-end=14,retention-days=20,days-of-week='SUNDAY + MONDAY'" + + --backup-rules-from-file=PATH_TO_FILE + Path to a YAML or JSON file containing backup rules. Use a full or + relative path to a local file containing the value of backup_rules. + + --description=DESCRIPTION + Provide a description of the backup plan, such as specific use cases + and relevant details, in 2048 characters or less. + + E.g., This is a backup plan that performs a daily backup at 6 p.m. and + retains data for 3 months. + + --remove-backup-rule=RULE-ID + Name of an existing backup rule to be removed from the Backup Plan. + This flag can be repeated to remove more backup rules. + +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. + +BRIEF + Update a specific backup plan + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/backup-dr/help b/gcloud/alpha/backup-dr/help index 9e7ba1663..f626bd804 100644 --- a/gcloud/alpha/backup-dr/help +++ b/gcloud/alpha/backup-dr/help @@ -18,6 +18,9 @@ GROUPS backup-plan-associations (ALPHA) Manage Backup and DR backup plan associations. + backup-plan-revisions + (ALPHA) View Backup and DR backup plan revisions. + backup-plans (ALPHA) Manage Backup and DR backup plans. diff --git a/gcloud/alpha/compute/backend-buckets/describe b/gcloud/alpha/compute/backend-buckets/describe index 47d9f1745..9810d8466 100644 --- a/gcloud/alpha/compute/backend-buckets/describe +++ b/gcloud/alpha/compute/backend-buckets/describe @@ -3,7 +3,7 @@ NAME SYNOPSIS gcloud alpha compute backend-buckets describe BACKEND_BUCKET_NAME - [GCLOUD_WIDE_FLAG ...] + [--global | --region=REGION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) gcloud alpha compute backend-buckets describe displays all data @@ -13,6 +13,16 @@ POSITIONAL ARGUMENTS BACKEND_BUCKET_NAME Name of the backend bucket to describe. +FLAGS + At most one of these can be specified: + + --global + If set, the backend bucket is global. + + --region=REGION + Region of the backend bucket to describe. Overrides the default + compute/region property value for this command invocation. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/compute/interconnects/application-awareness/delete b/gcloud/alpha/compute/interconnects/application-awareness/delete new file mode 100644 index 000000000..08efb43ba --- /dev/null +++ b/gcloud/alpha/compute/interconnects/application-awareness/delete @@ -0,0 +1,40 @@ +NAME + gcloud alpha compute interconnects application-awareness delete - delete + application awareness configuration of a Compute Engine interconnect + +SYNOPSIS + gcloud alpha compute interconnects application-awareness delete NAME + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) gcloud alpha compute interconnects application-awareness delete is + used to delete all configuration state for application awareness on + interconnect. + + For an example, refer to the EXAMPLES section below. + +EXAMPLES + To delete application awareness configuration for an interconnect + example-interconnect, run: + + $ gcloud alpha compute interconnects application-awareness delete \ + example-interconnect + +POSITIONAL ARGUMENTS + NAME + Name of the interconnect to patch. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/compute/interconnects/application-awareness/help b/gcloud/alpha/compute/interconnects/application-awareness/help index f8429bc18..0e809bac6 100644 --- a/gcloud/alpha/compute/interconnects/application-awareness/help +++ b/gcloud/alpha/compute/interconnects/application-awareness/help @@ -27,6 +27,10 @@ COMMANDS (ALPHA) Configure strict priority policy for application awareness configuration of a Compute Engine interconnect. + delete + (ALPHA) Delete application awareness configuration of a Compute Engine + interconnect. + get-config (ALPHA) Get application awareness configuration of a Compute Engine interconnect. diff --git a/gcloud/alpha/compute/reservations/update b/gcloud/alpha/compute/reservations/update index 6f4f7d99c..f1a38d76f 100644 --- a/gcloud/alpha/compute/reservations/update +++ b/gcloud/alpha/compute/reservations/update @@ -58,10 +58,10 @@ FLAGS with. You must list the projects using project IDs or project numbers. --[no-]enable-emergent-maintenance - The emergent maintenance flag for the reservation, which enrolls all - the underlying vms, hosts and SB infrastructure to receive emergent - maintenance notifications in advance. Use --enable-emergent-maintenance - to enable and --no-enable-emergent-maintenance to disable. + Enables the reservation to receive notifications when urgent + maintenance for a GPU VM starts after the VM encounters a host error. + Use --enable-emergent-maintenance to enable and + --no-enable-emergent-maintenance to disable. --remove-share-with=PROJECT,[PROJECT,...] A list of specific projects to remove from the list of projects that diff --git a/gcloud/alpha/container/ai/help b/gcloud/alpha/container/ai/help index 5f523bd2d..3fe1342a0 100644 --- a/gcloud/alpha/container/ai/help +++ b/gcloud/alpha/container/ai/help @@ -19,7 +19,7 @@ GROUPS (ALPHA) Quickstart engine for GKE AI workloads. recommender - (ALPHA) Recommendation engine for GKE AI workloads. + (ALPHA) (DEPRECATED) Recommendation engine for GKE AI workloads. NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/container/ai/recommender/accelerators/help b/gcloud/alpha/container/ai/recommender/accelerators/help index 8f8ab9483..80b159ce7 100644 --- a/gcloud/alpha/container/ai/recommender/accelerators/help +++ b/gcloud/alpha/container/ai/recommender/accelerators/help @@ -7,7 +7,10 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Manage supported accelerators for GKE recommender. + (ALPHA) (DEPRECATED) Manage supported accelerators for GKE recommender. + + This command group is deprecated. Use gcloud alpha container ai profiles + command group instead. GCLOUD WIDE FLAGS These flags are available to all commands: --help. @@ -18,7 +21,7 @@ COMMANDS COMMAND is one of the following: list - (ALPHA) List compatible accelerator profiles. + (ALPHA) (DEPRECATED) List compatible accelerator profiles. NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/container/ai/recommender/accelerators/list b/gcloud/alpha/container/ai/recommender/accelerators/list index 3b2e73d11..ec91c9417 100644 --- a/gcloud/alpha/container/ai/recommender/accelerators/list +++ b/gcloud/alpha/container/ai/recommender/accelerators/list @@ -12,10 +12,15 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) This command lists all supported accelerators with their - performance details. By default, the supported accelerators are displayed - in a table format with select information for each accelerator. To see all - details, use --format=yaml. + (ALPHA) (DEPRECATED) List compatible accelerator profiles. + + This command group is deprecated. Use gcloud alpha container ai profiles + command group instead. + + This command lists all supported accelerators with their performance + details. By default, the supported accelerators are displayed in a table + format with select information for each accelerator. To see all details, + use --format=yaml. To get supported model, model servers, and model server versions, run gcloud alpha container ai recommender models list, gcloud alpha container diff --git a/gcloud/alpha/container/ai/recommender/help b/gcloud/alpha/container/ai/recommender/help index 3ebb798b9..a69f2b83d 100644 --- a/gcloud/alpha/container/ai/recommender/help +++ b/gcloud/alpha/container/ai/recommender/help @@ -6,9 +6,14 @@ SYNOPSIS gcloud alpha container ai recommender GROUP [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) The GKE Inference Recommender helps simplify deploying AI inference - on Google Kubernetes Engine (GKE). It provides tailored recommendations - based on Google's internal benchmarks. Provide inputs like your preferred + (ALPHA) (DEPRECATED) Recommendation engine for GKE AI workloads. + + This command group is deprecated. Use gcloud alpha container ai profiles + command group instead. + + The GKE Inference Recommender helps simplify deploying AI inference on + Google Kubernetes Engine (GKE). It provides tailored recommendations based + on Google's internal benchmarks. Provide inputs like your preferred open-source model (e.g. Llama, Gemma, or Mistral) and your application's performance target. Based on these inputs, the recommender generates accelerator choices with performance metrics, and detailed, ready-to-deploy @@ -25,22 +30,25 @@ GROUPS GROUP is one of the following: accelerators - (ALPHA) Manage supported accelerators for GKE recommender. + (ALPHA) (DEPRECATED) Manage supported accelerators for GKE recommender. manifests - (ALPHA) Generate optimized Kubernetes manifests. + (ALPHA) (DEPRECATED) Generate optimized Kubernetes manifests. model-and-server-combinations - (ALPHA) Manage supported model and model servers for GKE recommender. + (ALPHA) (DEPRECATED) Manage supported model and model servers for GKE + recommender. model-server-versions - (ALPHA) Manage supported model server versions for GKE recommender. + (ALPHA) (DEPRECATED) Manage supported model server versions for GKE + recommender. model-servers - (ALPHA) Manage supported model servers for GKE recommender. + (ALPHA) (DEPRECATED) Manage supported model servers for GKE + recommender. models - (ALPHA) Manage supported models for GKE recommender. + (ALPHA) (DEPRECATED) Manage supported models for GKE recommender. NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/container/ai/recommender/manifests/create b/gcloud/alpha/container/ai/recommender/manifests/create index 429ce0496..627c18d46 100644 --- a/gcloud/alpha/container/ai/recommender/manifests/create +++ b/gcloud/alpha/container/ai/recommender/manifests/create @@ -13,10 +13,16 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) To get supported model, model servers, and model server versions, - run gcloud alpha container ai recommender model-and-server-combinations - list. To get supported accelerators with their performance metrics, run - gcloud alpha container ai recommender accelerators list. + (ALPHA) (DEPRECATED) Generate ready-to-deploy Kubernetes manifests with + compute, load balancing, and autoscaling capabilities. + + This command group is deprecated. Use gcloud alpha container ai profiles + command group instead. + + To get supported model, model servers, and model server versions, run + gcloud alpha container ai recommender model-and-server-combinations list. + To get supported accelerators with their performance metrics, run gcloud + alpha container ai recommender accelerators list. REQUIRED FLAGS --accelerator-type=ACCELERATOR_TYPE diff --git a/gcloud/alpha/container/ai/recommender/manifests/help b/gcloud/alpha/container/ai/recommender/manifests/help index 82e682956..8c0911545 100644 --- a/gcloud/alpha/container/ai/recommender/manifests/help +++ b/gcloud/alpha/container/ai/recommender/manifests/help @@ -7,7 +7,10 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Generate optimized Kubernetes manifests. + (ALPHA) (DEPRECATED) Generate optimized Kubernetes manifests. + + This command group is deprecated. Use gcloud alpha container ai profiles + command group instead. GCLOUD WIDE FLAGS These flags are available to all commands: --help. @@ -18,8 +21,8 @@ COMMANDS COMMAND is one of the following: create - (ALPHA) Generate ready-to-deploy Kubernetes manifests with compute, - load balancing, and autoscaling capabilities. + (ALPHA) (DEPRECATED) Generate ready-to-deploy Kubernetes manifests with + compute, load balancing, and autoscaling capabilities. NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/container/ai/recommender/model-and-server-combinations/help b/gcloud/alpha/container/ai/recommender/model-and-server-combinations/help index 058c854b2..e51397e3c 100644 --- a/gcloud/alpha/container/ai/recommender/model-and-server-combinations/help +++ b/gcloud/alpha/container/ai/recommender/model-and-server-combinations/help @@ -7,7 +7,11 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Manage supported model and model servers for GKE recommender. + (ALPHA) (DEPRECATED) Manage supported model and model servers for GKE + recommender. + + This command group is deprecated. Use gcloud alpha container ai profiles + command group instead. GCLOUD WIDE FLAGS These flags are available to all commands: --help. @@ -18,7 +22,7 @@ COMMANDS COMMAND is one of the following: list - (ALPHA) List supported model and server combinations. + (ALPHA) (DEPRECATED) List supported model and server combinations. NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/container/ai/recommender/model-and-server-combinations/list b/gcloud/alpha/container/ai/recommender/model-and-server-combinations/list index 1f4befc6f..8673ddc49 100644 --- a/gcloud/alpha/container/ai/recommender/model-and-server-combinations/list +++ b/gcloud/alpha/container/ai/recommender/model-and-server-combinations/list @@ -10,8 +10,13 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) This command lists all supported model, model server, and model - server version combinations. + (ALPHA) (DEPRECATED) List supported model and server combinations. + + This command group is deprecated. Use gcloud alpha container ai profiles + command group instead. + + This command lists all supported model, model server, and model server + version combinations. FLAGS --model=MODEL diff --git a/gcloud/alpha/container/ai/recommender/model-server-versions/help b/gcloud/alpha/container/ai/recommender/model-server-versions/help index 56c283b02..5070d7575 100644 --- a/gcloud/alpha/container/ai/recommender/model-server-versions/help +++ b/gcloud/alpha/container/ai/recommender/model-server-versions/help @@ -7,7 +7,11 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Manage supported model server versions for GKE recommender. + (ALPHA) (DEPRECATED) Manage supported model server versions for GKE + recommender. + + This command group is deprecated. Use gcloud alpha container ai profiles + command group instead. GCLOUD WIDE FLAGS These flags are available to all commands: --help. @@ -18,7 +22,7 @@ COMMANDS COMMAND is one of the following: list - (ALPHA) List supported model server versions. + (ALPHA) (DEPRECATED) List supported model server versions. NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/container/ai/recommender/model-server-versions/list b/gcloud/alpha/container/ai/recommender/model-server-versions/list index 1175ec3e1..5cd078e68 100644 --- a/gcloud/alpha/container/ai/recommender/model-server-versions/list +++ b/gcloud/alpha/container/ai/recommender/model-server-versions/list @@ -9,11 +9,16 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) To get supported model and model servers, run gcloud alpha - container ai recommender models list and gcloud alpha container ai - recommender model-servers list. Alternatively, run gcloud alpha container - ai recommender model-and-server-combinations list to get all supported - model and server combinations. + (ALPHA) (DEPRECATED) List supported model server versions. + + This command group is deprecated. Use gcloud alpha container ai profiles + command group instead. + + To get supported model and model servers, run gcloud alpha container ai + recommender models list and gcloud alpha container ai recommender + model-servers list. Alternatively, run gcloud alpha container ai + recommender model-and-server-combinations list to get all supported model + and server combinations. REQUIRED FLAGS --model=MODEL diff --git a/gcloud/alpha/container/ai/recommender/model-servers/help b/gcloud/alpha/container/ai/recommender/model-servers/help index 36046810a..3bf460293 100644 --- a/gcloud/alpha/container/ai/recommender/model-servers/help +++ b/gcloud/alpha/container/ai/recommender/model-servers/help @@ -7,7 +7,10 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Manage supported model servers for GKE recommender. + (ALPHA) (DEPRECATED) Manage supported model servers for GKE recommender. + + This command group is deprecated. Use gcloud alpha container ai profiles + command group instead. GCLOUD WIDE FLAGS These flags are available to all commands: --help. @@ -18,7 +21,7 @@ COMMANDS COMMAND is one of the following: list - (ALPHA) List supported model servers for a given model. + (ALPHA) (DEPRECATED) List supported model servers for a given model. NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/container/ai/recommender/model-servers/list b/gcloud/alpha/container/ai/recommender/model-servers/list index 14cc0af05..7eb91e38c 100644 --- a/gcloud/alpha/container/ai/recommender/model-servers/list +++ b/gcloud/alpha/container/ai/recommender/model-servers/list @@ -8,9 +8,14 @@ SYNOPSIS [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) To get supported models, run gcloud alpha container ai recommender - models list or to get all supported model and server combinations, run - gcloud alpha container ai recommender model-and-server-combinations list. + (ALPHA) (DEPRECATED) List supported model servers for a given model. + + This command group is deprecated. Use gcloud alpha container ai profiles + command group instead. + + To get supported models, run gcloud alpha container ai recommender models + list or to get all supported model and server combinations, run gcloud + alpha container ai recommender model-and-server-combinations list. REQUIRED FLAGS --model=MODEL diff --git a/gcloud/alpha/container/ai/recommender/models/help b/gcloud/alpha/container/ai/recommender/models/help index c16bf0144..e6d117e1c 100644 --- a/gcloud/alpha/container/ai/recommender/models/help +++ b/gcloud/alpha/container/ai/recommender/models/help @@ -6,7 +6,10 @@ SYNOPSIS gcloud alpha container ai recommender models COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Manage supported models for GKE recommender. + (ALPHA) (DEPRECATED) Manage supported models for GKE recommender. + + This command group is deprecated. Use gcloud alpha container ai profiles + command group instead. GCLOUD WIDE FLAGS These flags are available to all commands: --help. @@ -17,7 +20,7 @@ COMMANDS COMMAND is one of the following: list - (ALPHA) List supported models. + (ALPHA) (DEPRECATED) List supported models. NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/container/ai/recommender/models/list b/gcloud/alpha/container/ai/recommender/models/list index 1ee0d7d1a..58cd9185b 100644 --- a/gcloud/alpha/container/ai/recommender/models/list +++ b/gcloud/alpha/container/ai/recommender/models/list @@ -7,7 +7,10 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) List supported models. + (ALPHA) (DEPRECATED) List supported models. + + This command group is deprecated. Use gcloud alpha container ai profiles + command group instead. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/alpha/dataproc/clusters/create b/gcloud/alpha/dataproc/clusters/create index a2886d44c..6e69a408f 100644 --- a/gcloud/alpha/dataproc/clusters/create +++ b/gcloud/alpha/dataproc/clusters/create @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud alpha dataproc clusters create (CLUSTER : --region=REGION) [--async] [--autoscaling-policy=AUTOSCALING_POLICY] [--bucket=BUCKET] - [--cluster-type=TYPE] + [--cluster-type=TYPE] [--delete-max-idle=DELETE_MAX_IDLE] [--driver-pool-accelerator=[type=TYPE,[count=COUNT],...]] [--driver-pool-boot-disk-size=DRIVER_POOL_BOOT_DISK_SIZE] [--driver-pool-boot-disk-type=DRIVER_POOL_BOOT_DISK_TYPE] @@ -43,7 +43,8 @@ SYNOPSIS [--secondary-worker-standard-capacity-base=SECONDARY_WORKER_STANDARD_CAPACITY_BASE] [--secondary-worker-standard-capacity-percent-above-base=SECONDARY_WORKER_STANDARD_CAPACITY_PERCENT_ABOVE_BASE] [--shielded-integrity-monitoring] [--shielded-secure-boot] - [--shielded-vtpm] [--temp-bucket=TEMP_BUCKET] [--tier=TIER] + [--shielded-vtpm] [--stop-max-idle=STOP_MAX_IDLE] + [--temp-bucket=TEMP_BUCKET] [--tier=TIER] [--worker-accelerator=[type=TYPE,[count=COUNT],...]] [--worker-boot-disk-provisioned-iops=WORKER_BOOT_DISK_PROVISIONED_IOPS] [--worker-boot-disk-provisioned-throughput=WORKER_BOOT_DISK_PROVISIONED_THROUGHPUT] @@ -54,9 +55,7 @@ SYNOPSIS [--dataproc-metastore=DATAPROC_METASTORE | --bigquery-metastore --bigquery-metastore-database-location=BIGQUERY_METASTORE_DATABASE_LOCATION --bigquery-metastore-project-id=BIGQUERY_METASTORE_PROJECT_ID] [--delete-expiration-time=DELETE_EXPIRATION_TIME - | --delete-max-age=DELETE_MAX_AGE | --expiration-time=EXPIRATION_TIME - | --max-age=MAX_AGE] - [--delete-max-idle=DELETE_MAX_IDLE | --max-idle=MAX_IDLE] + | --delete-max-age=DELETE_MAX_AGE] [--gce-pd-kms-key=GCE_PD_KMS_KEY : --gce-pd-kms-key-keyring=GCE_PD_KMS_KEY_KEYRING --gce-pd-kms-key-location=GCE_PD_KMS_KEY_LOCATION @@ -77,6 +76,8 @@ SYNOPSIS --num-secondary-workers=NUM_SECONDARY_WORKERS --num-workers=NUM_WORKERS --secondary-worker-type=TYPE; default="preemptible"] + [--stop-expiration-time=STOP_EXPIRATION_TIME + | --stop-max-age=STOP_MAX_AGE] [--worker-machine-type=WORKER_MACHINE_TYPE | --worker-machine-types=type=MACHINE_TYPE[, type=MACHINE_TYPE...][,rank=RANK]] [GCLOUD_WIDE_FLAG ...] @@ -146,6 +147,11 @@ FLAGS The type of cluster. TYPE must be one of: standard, single-node, zero-scale. + --delete-max-idle=DELETE_MAX_IDLE + The duration after the last job completes to auto-delete the cluster, + such as "2h" or "1d". See $ gcloud topic datetimes for information on + duration formats. + --driver-pool-accelerator=[type=TYPE,[count=COUNT],...] Attaches accelerators, such as GPUs, to the driver-pool instance(s). @@ -418,6 +424,11 @@ FLAGS security operations, such as remote attestation, encryption, and sealing of keys. + --stop-max-idle=STOP_MAX_IDLE + The duration after the last job completes to auto-stop the cluster, + such as "2h" or "1d". See $ gcloud topic datetimes for information on + duration formats. + --temp-bucket=TEMP_BUCKET The Google Cloud Storage bucket to use by default to store ephemeral cluster and jobs data, such as Spark and MapReduce history files. @@ -517,28 +528,6 @@ FLAGS as "2h" or "1d". See $ gcloud topic datetimes for information on duration formats. - --expiration-time=EXPIRATION_TIME - The time when the cluster will be auto-deleted, such as - "2017-08-29T18:52:51.142Z." See $ gcloud topic datetimes for - information on time formats. - - --max-age=MAX_AGE - The lifespan of the cluster, with auto-deletion upon completion, such - as "2h" or "1d". See $ gcloud topic datetimes for information on - duration formats. - - At most one of these can be specified: - - --delete-max-idle=DELETE_MAX_IDLE - The duration after the last job completes to auto-delete the cluster, - such as "2h" or "1d". See $ gcloud topic datetimes for information on - duration formats. - - --max-idle=MAX_IDLE - The duration after the last job completes to autto-delete the - cluster, such as "2h" or "1d". See $ gcloud topic datetimes for - information on duration formats. - Key resource - The Cloud KMS (Key Management Service) cryptokey that will be used to protect the cluster. The 'Compute Engine Service Agent' service account must hold permission 'Cloud KMS CryptoKey Encrypter/Decrypter'. @@ -945,6 +934,18 @@ FLAGS The type of the secondary worker group. TYPE must be one of: preemptible, non-preemptible, spot. + At most one of these can be specified: + + --stop-expiration-time=STOP_EXPIRATION_TIME + The time when the cluster will be auto-stopped, such as + "2017-08-29T18:52:51.142Z." See $ gcloud topic datetimes for + information on time formats. + + --stop-max-age=STOP_MAX_AGE + The lifespan of the cluster, with auto-stop upon completion, such as + "2h" or "1d". See $ gcloud topic datetimes for information on + duration formats. + At most one of these can be specified: --worker-machine-type=WORKER_MACHINE_TYPE diff --git a/gcloud/alpha/dataproc/clusters/update b/gcloud/alpha/dataproc/clusters/update index 392179dd9..15efe877a 100644 --- a/gcloud/alpha/dataproc/clusters/update +++ b/gcloud/alpha/dataproc/clusters/update @@ -13,11 +13,12 @@ SYNOPSIS [--autoscaling-policy=AUTOSCALING_POLICY | --disable-autoscaling] [--clear-labels | --remove-labels=[KEY,...]] [--delete-expiration-time=DELETE_EXPIRATION_TIME - | --delete-max-age=DELETE_MAX_AGE | --no-delete-max-age - | --expiration-time=EXPIRATION_TIME | --max-age=MAX_AGE - | --no-max-age] - [--delete-max-idle=DELETE_MAX_IDLE | --no-delete-max-idle - | --max-idle=MAX_IDLE | --no-max-idle] [GCLOUD_WIDE_FLAG ...] + | --delete-max-age=DELETE_MAX_AGE | --no-delete-max-age] + [--delete-max-idle=DELETE_MAX_IDLE | --no-delete-max-idle] + [--stop-expiration-time=STOP_EXPIRATION_TIME + | --stop-max-age=STOP_MAX_AGE | --no-stop-max-age] + [--stop-max-idle=STOP_MAX_IDLE | --no-stop-max-idle] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Update the number of worker nodes and/or the labels in a cluster. @@ -187,20 +188,6 @@ FLAGS Cancels the cluster auto-deletion by maximum cluster age (configured by --delete-max-age or --delete-expiration-time flags) - --expiration-time=EXPIRATION_TIME - The time when the cluster will be auto-deleted, such as - "2017-08-29T18:52:51.142Z". See $ gcloud topic datetimes for - information on time formats. - - --max-age=MAX_AGE - The lifespan of the cluster, with auto-deletion upon completion, "2h" - or "1d". See $ gcloud topic datetimes for information on duration - formats. - - --no-max-age - Cancels the cluster auto-deletion by maximum cluster age (configured - by --max-age or --expiration-time flags) - At most one of these can be specified: --delete-max-idle=DELETE_MAX_IDLE @@ -212,14 +199,32 @@ FLAGS Cancels the cluster auto-deletion by cluster idle duration (configured by --delete-max-idle flag) - --max-idle=MAX_IDLE - The duration after the last job completes to auto-delete the cluster, + At most one of these can be specified: + + --stop-expiration-time=STOP_EXPIRATION_TIME + The time when the cluster will be auto-stopped, such as + "2017-08-29T18:52:51.142Z". See $ gcloud topic datetimes for + information on time formats. + + --stop-max-age=STOP_MAX_AGE + The lifespan of the cluster, with auto-stop upon completion, such as + "2h" or "1d". See $ gcloud topic datetimes for information on + duration formats. + + --no-stop-max-age + Cancels the cluster auto-stop by maximum cluster age (configured by + --stop-max-age or --stop-expiration-time flags) + + At most one of these can be specified: + + --stop-max-idle=STOP_MAX_IDLE + The duration after the last job completes to auto-stop the cluster, such as "2h" or "1d". See $ gcloud topic datetimes for information on duration formats. - --no-max-idle - Cancels the cluster auto-deletion by cluster idle duration - (configured by --max-idle flag) + --no-stop-max-idle + Cancels the cluster auto-stop by cluster idle duration (configured by + --stop-max-idle flag) GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/firestore/databases/create b/gcloud/alpha/firestore/databases/create index ef33e2a8e..363827d59 100644 --- a/gcloud/alpha/firestore/databases/create +++ b/gcloud/alpha/firestore/databases/create @@ -6,8 +6,8 @@ SYNOPSIS gcloud alpha firestore databases create --location=LOCATION [--database=DATABASE; default="(default)"] [--delete-protection] [--edition=EDITION; default="standard"] [--enable-pitr] - [--kms-key-name=KMS_KEY_NAME] [--type=TYPE; default="firestore-native"] - [GCLOUD_WIDE_FLAG ...] + [--kms-key-name=KMS_KEY_NAME] [--tags=[KEY=VALUE,...]] + [--type=TYPE; default="firestore-native"] [GCLOUD_WIDE_FLAG ...] EXAMPLES To create a Firestore Enterprise database named foo in nam5 for use with @@ -20,6 +20,11 @@ EXAMPLES $ gcloud alpha firestore databases create --location=nam5 + To create a Firestore Native database in us-central1 with tags. + + $ gcloud alpha firestore databases create --location=us-central1 \ + --tags=key1=value1,key2=value2 + To create a Datastore Mode database in us-east1. $ gcloud alpha firestore databases create --location=us-east1 \ @@ -106,6 +111,11 @@ OPTIONAL FLAGS How to retrieve this resource ID is listed at https://cloud.google.com/kms/docs/getting-resource-ids#getting_the_id_for_a_key_and_version. + --tags=[KEY=VALUE,...] + Tags to attach to the database + + Example: --tags=key1=value1,key2=value2 + --type=TYPE; default="firestore-native" The type of the database. TYPE must be one of: firestore-native, datastore-mode. diff --git a/gcloud/alpha/managed-kafka/clusters/create b/gcloud/alpha/managed-kafka/clusters/create index 90f7138f0..37b2a0fda 100644 --- a/gcloud/alpha/managed-kafka/clusters/create +++ b/gcloud/alpha/managed-kafka/clusters/create @@ -105,6 +105,7 @@ OPTIONAL FLAGS mTLS. A maximum of 10 CA pools can be specified. CA pools can be in a different project and region than the cluster. Each CA pool must be in the format projects/PROJECT_ID/locations/LOCATION/caPools/CA_POOL. + Clear the CA pools using the --clear-mtls-ca-pools flag. --ssl-principal-mapping-rules=SSL_PRINCIPAL_MAPPING_RULES The rules for mapping mTLS certificate Distinguished Names (DNs) to diff --git a/gcloud/alpha/managed-kafka/clusters/update b/gcloud/alpha/managed-kafka/clusters/update index 23122b7bf..19cd9a498 100644 --- a/gcloud/alpha/managed-kafka/clusters/update +++ b/gcloud/alpha/managed-kafka/clusters/update @@ -5,9 +5,10 @@ NAME SYNOPSIS gcloud alpha managed-kafka clusters update (CLUSTER : --location=LOCATION) (--auto-rebalance --cpu=CPU --labels=[KEY=VALUE,...] --memory=MEMORY - --mtls-ca-pools=[MTLS_CA_POOLS,...] --ssl-principal-mapping-rules=SSL_PRINCIPAL_MAPPING_RULES - --subnets=[SUBNETS,...]) [--async] [GCLOUD_WIDE_FLAG ...] + --subnets=[SUBNETS,...] --clear-mtls-ca-pools + | --mtls-ca-pools=[MTLS_CA_POOLS,...]) [--async] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Update a Managed Service for Apache Kafka cluster. @@ -75,15 +76,6 @@ REQUIRED FLAGS The memory to provision for the cluster in bytes. The value must be between 1 GiB and 8 GiB per vCPU. Ex. 1024Mi, 4Gi. - --mtls-ca-pools=[MTLS_CA_POOLS,...] - A comma-separated list of CA pools from the Google Cloud Certificate - Authority Service. The root certificates of these CA pools will be - installed in the truststore of each broker in the cluster for use - with mTLS. A maximum of 10 CA pools can be specified. CA pools can be - in a different project and region than the cluster. Each CA pool must - be in the format - projects/PROJECT_ID/locations/LOCATION/caPools/CA_POOL. - --ssl-principal-mapping-rules=SSL_PRINCIPAL_MAPPING_RULES The rules for mapping mTLS certificate Distinguished Names (DNs) to shortened principal names for Kafka ACLs. This flag corresponds @@ -104,6 +96,22 @@ REQUIRED FLAGS separate multiple subnets. The name of the subnet must be in the format projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET. + At most one of these can be specified: + + --clear-mtls-ca-pools + Remove all the CA pools from the cluster. This will remove all root + certificates from the truststore of each broker in the cluster. + + --mtls-ca-pools=[MTLS_CA_POOLS,...] + A comma-separated list of CA pools from the Google Cloud + Certificate Authority Service. The root certificates of these CA + pools will be installed in the truststore of each broker in the + cluster for use with mTLS. A maximum of 10 CA pools can be + specified. CA pools can be in a different project and region than + the cluster. Each CA pool must be in the format + projects/PROJECT_ID/locations/LOCATION/caPools/CA_POOL. Clear the + CA pools using the --clear-mtls-ca-pools flag. + OPTIONAL FLAGS --async Return immediately, without waiting for the operation in progress to diff --git a/gcloud/alpha/managed-kafka/schema-registries/subject/describe b/gcloud/alpha/managed-kafka/schema-registries/subject/describe index 71bcbacbc..87c67cdbb 100644 --- a/gcloud/alpha/managed-kafka/schema-registries/subject/describe +++ b/gcloud/alpha/managed-kafka/schema-registries/subject/describe @@ -5,8 +5,7 @@ NAME SYNOPSIS gcloud alpha managed-kafka schema-registries subject describe (SUBJECT : --location=LOCATION --schema-registry=SCHEMA_REGISTRY) - --schema_registry=SCHEMA_REGISTRY [--context=CONTEXT] - [GCLOUD_WIDE_FLAG ...] + [--context=CONTEXT] [GCLOUD_WIDE_FLAG ...] EXAMPLES Describe the subject in a schema registry with all of its fields: @@ -56,11 +55,7 @@ POSITIONAL ARGUMENTS specified name; ▸ provide the argument --schema-registry on the command line. -REQUIRED FLAGS - --schema_registry=SCHEMA_REGISTRY - The schema registry of the subject. - -OPTIONAL FLAGS +FLAGS --context=CONTEXT The context of the subject. diff --git a/gcloud/alpha/managed-kafka/schema-registries/subject/update b/gcloud/alpha/managed-kafka/schema-registries/subject/update index 9cf1740d2..99990f0af 100644 --- a/gcloud/alpha/managed-kafka/schema-registries/subject/update +++ b/gcloud/alpha/managed-kafka/schema-registries/subject/update @@ -5,7 +5,6 @@ NAME SYNOPSIS gcloud alpha managed-kafka schema-registries subject update (SUBJECT : --location=LOCATION --schema-registry=SCHEMA_REGISTRY) - --schema_registry=SCHEMA_REGISTRY (--compatibility=COMPATIBILITY | --mode=MODE) [--context=CONTEXT] [GCLOUD_WIDE_FLAG ...] @@ -62,9 +61,6 @@ POSITIONAL ARGUMENTS ▸ provide the argument --schema-registry on the command line. REQUIRED FLAGS - --schema_registry=SCHEMA_REGISTRY - The schema registry of the subject. - Exactly one of these must be specified: --compatibility=COMPATIBILITY diff --git a/gcloud/alpha/memorystore/instances/create b/gcloud/alpha/memorystore/instances/create index e9d3e320c..bd4889065 100644 --- a/gcloud/alpha/memorystore/instances/create +++ b/gcloud/alpha/memorystore/instances/create @@ -14,6 +14,7 @@ SYNOPSIS [--psc-auto-connections=[network=NETWORK], [port=PORT],[projectId=PROJECTID]] [--replica-count=REPLICA_COUNT] [--request-id=REQUEST_ID] [--shard-count=SHARD_COUNT] + [--simulate-maintenance-event] [--transit-encryption-mode=TRANSIT_ENCRYPTION_MODE] [--aof-config-append-fsync=AOF_CONFIG_APPEND_FSYNC --persistence-config-mode=PERSISTENCE_CONFIG_MODE @@ -25,6 +26,7 @@ SYNOPSIS [--cross-instance-replication-config-role=CROSS_INSTANCE_REPLICATION_CONFIG_ROLE : --cross-instance-replication-config-secondary-instances=[instance=INSTANCE] --primary-instance=PRIMARY_INSTANCE] [--gcs-source-uris=[GCS_SOURCE_URIS,...] | --managed-backup-source=MANAGED_BACKUP_SOURCE] + [--kms-key=KMS_KEY : --key-ring=KEY_RING] [--zone-distribution-config=ZONE_DISTRIBUTION_CONFIG --zone-distribution-config-mode=ZONE_DISTRIBUTION_CONFIG_MODE] [GCLOUD_WIDE_FLAG ...] @@ -190,9 +192,9 @@ FLAGS --labels=path_to_file.(yaml|json) --location=LOCATION - For resources [instance], provides fallback value for resource location - attribute. When the resource's full URI path is not provided, location - will fallback to this flag value. + For resources [instance, cryptoKey], provides fallback value for + resource location attribute. When the resource's full URI path is not + provided, location will fallback to this flag value. Maintenance policy per instance. @@ -318,6 +320,11 @@ FLAGS --shard-count=SHARD_COUNT Number of shards for the instance. + Arguments for the simulate maintenance event. + + --simulate-maintenance-event + Simulate a maintenance event. + --transit-encryption-mode=TRANSIT_ENCRYPTION_MODE In-transit encryption mode of the instance. TRANSIT_ENCRYPTION_MODE must be one of: @@ -513,6 +520,42 @@ FLAGS In this case, it assumes the backup is under memorystore.googleapis.com. + Arguments for the kms key. + + CryptoKey resource - The KMS key used to encrypt the at-rest data of the + cluster. 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 --kms-key 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 --kms-key on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --kms-key=KMS_KEY + ID of the cryptoKey or fully qualified identifier for the + cryptoKey. + + To set the crypto-key attribute: + ▫ provide the argument --kms-key on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --key-ring=KEY_RING + The keyRing id of the cryptoKey resource. + + To set the key-ring attribute: + ▫ provide the argument --kms-key on the command line with a fully + specified name; + ▫ provide the argument --key-ring on the command line. + Zone distribution configuration for allocation of instance resources. --zone-distribution-config=ZONE_DISTRIBUTION_CONFIG diff --git a/gcloud/alpha/memorystore/instances/update b/gcloud/alpha/memorystore/instances/update index c1389f4e7..cfae3260a 100644 --- a/gcloud/alpha/memorystore/instances/update +++ b/gcloud/alpha/memorystore/instances/update @@ -9,6 +9,7 @@ SYNOPSIS [--location=LOCATION] [--mode=MODE] [--node-type=NODE_TYPE] [--[no-]ondemand-maintenance] [--replica-count=REPLICA_COUNT] [--request-id=REQUEST_ID] [--shard-count=SHARD_COUNT] + [--[no-]simulate-maintenance-event] [--aof-config-append-fsync=AOF_CONFIG_APPEND_FSYNC --clear-persistence-config --persistence-config-mode=PERSISTENCE_CONFIG_MODE @@ -33,6 +34,7 @@ SYNOPSIS | --update-engine-configs=[UPDATE_ENGINE_CONFIGS,...] --clear-engine-configs | --remove-engine-configs=REMOVE_ENGINE_CONFIGS] + [--key-ring=KEY_RING --clear-kms-key | --kms-key=KMS_KEY] [--labels=[LABELS,...] | --update-labels=[UPDATE_LABELS,...] --clear-labels | --remove-labels=REMOVE_LABELS] [GCLOUD_WIDE_FLAG ...] @@ -105,9 +107,9 @@ FLAGS Engine version of the instance. --location=LOCATION - For resources [instance], provides fallback value for resource location - attribute. When the resource's full URI path is not provided, location - will fallback to this flag value. + For resources [instance, cryptoKey], provides fallback value for + resource location attribute. When the resource's full URI path is not + provided, location will fallback to this flag value. --mode=MODE The mode config for the instance. MODE must be one of: @@ -162,6 +164,12 @@ FLAGS --shard-count=SHARD_COUNT Number of shards for the instance. + Arguments for the simulate maintenance event. + + --[no-]simulate-maintenance-event + Simulate a maintenance event. Use --simulate-maintenance-event to + enable and --no-simulate-maintenance-event to disable. + Represents persistence configuration for a instance. Configuration for AOF based persistence. @@ -770,6 +778,54 @@ FLAGS --remove-engine-configs=path_to_file.(yaml|json) + Arguments for the kms key. + + All arguments needed to update kms_key. + + --key-ring=KEY_RING + The keyRing id of the cryptoKey resource. + + To set the key-ring attribute: + ▫ provide the argument --current on the command line with a fully + specified name; + ▫ provide the argument --key-ring on the command line. + + Update kms_key. + + At most one of these can be specified: + + --clear-kms-key + Clear kms_key value and set to null. + + CryptoKey resource - Set kms_key to new value. + + The KMS key used to encrypt the at-rest data of the cluster. 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 --kms-key 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 --kms-key on the command line with a fully + specified name; + ◇ provide the argument --location on the command line. + + To set the key-ring attribute: + ◇ provide the argument --kms-key on the command line with a fully + specified name; + ◇ provide the argument --key-ring on the command line. + + --kms-key=KMS_KEY + ID of the cryptoKey or fully qualified identifier for the + cryptoKey. + + To set the crypto-key attribute: + ▹ provide the argument --kms-key on the command line. + Update labels. At most one of these can be specified: diff --git a/gcloud/alpha/metastore/federations/create b/gcloud/alpha/metastore/federations/create index 9ba2027ca..45edc0f0d 100644 --- a/gcloud/alpha/metastore/federations/create +++ b/gcloud/alpha/metastore/federations/create @@ -6,7 +6,8 @@ SYNOPSIS gcloud alpha metastore federations create (FEDERATION : --location=LOCATION) --backends=RANK=BACKEND [--async] [--hive-metastore-version=HIVE_METASTORE_VERSION] - [--labels=[KEY=VALUE,...]] [GCLOUD_WIDE_FLAG ...] + [--labels=[KEY=VALUE,...]] [--tags=[KEY=VALUE,...]] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Create a new Dataproc Metastore federation with the given name and @@ -93,6 +94,9 @@ OPTIONAL FLAGS contain only hyphens (-), underscores (_), lowercase characters, and numbers. + --tags=[KEY=VALUE,...] + List of tag KEY=VALUE pairs to add. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/metastore/services/create b/gcloud/alpha/metastore/services/create index 9da023ff0..7993d3f75 100644 --- a/gcloud/alpha/metastore/services/create +++ b/gcloud/alpha/metastore/services/create @@ -11,6 +11,7 @@ SYNOPSIS [--hive-metastore-version=HIVE_METASTORE_VERSION] [--labels=[KEY=VALUE,...]] [--port=PORT; default=9083] [--release-channel=RELEASE_CHANNEL; default="stable"] + [--tags=[KEY=VALUE,...]] [--auxiliary-versions=[AUXILIARY_VERSIONS,...] | --auxiliary-versions-from-file=AUXILIARY_VERSIONS_FROM_FILE] [--consumer-subnetworks=[CONSUMER_SUBNETWORKS,...] | --network=NETWORK @@ -170,6 +171,9 @@ FLAGS The STABLE release channel contains features that are considered stable and have been validated for production use. + --tags=[KEY=VALUE,...] + List of tag KEY=VALUE pairs to add. + Auxiliary versions configuration for the Dataproc Metastore service. When specified, a secondary Hive metastore service is created along with the primary service. diff --git a/gcloud/alpha/migration/vms/image-imports/create b/gcloud/alpha/migration/vms/image-imports/create index 3db6a1c64..55e9f1b78 100644 --- a/gcloud/alpha/migration/vms/image-imports/create +++ b/gcloud/alpha/migration/vms/image-imports/create @@ -10,8 +10,11 @@ SYNOPSIS [--image-name=IMAGE_NAME] [--kms-key=KMS_KEY] [--labels=[KEY=VALUE,...]] [--single-region-storage] [--target-project=TARGET_PROJECT] - [--skip-os-adaptation | --boot-conversion=BOOT_CONVERSION - --generalize --license-type=LICENSE_TYPE] [GCLOUD_WIDE_FLAG ...] + [--skip-os-adaptation | --adaptation-modifiers=ADAPTATION_MODIFIERS + --boot-conversion=BOOT_CONVERSION --generalize + --license-type=LICENSE_TYPE + --rootfs-uuid=ROOTFS_UUID --suppress-package-installation-failure] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) gcloud alpha migration vms image-imports create imports images such @@ -108,6 +111,11 @@ OPTIONAL FLAGS --skip-os-adaptation If true, skip OS adaptation. Default false. + --adaptation-modifiers=ADAPTATION_MODIFIERS + A map of flags to pass to the OS adaptation process. The actual value + depends on the modifier and can also be empty. e.g. + --adaptation-modifiers=flag1=value1,flag2 + --boot-conversion=BOOT_CONVERSION This property will trigger an internal process which will convert the image from using the existing boot option to another. The size of the @@ -130,6 +138,13 @@ OPTIONAL FLAGS compute-engine-license-type-default, compute-engine-license-type-payg. + --rootfs-uuid=ROOTFS_UUID + Identifies the file system to adapt. + + --suppress-package-installation-failure + If true, suppress package installation failure and continue with a + warning. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/migration/vms/machine-image-imports/create b/gcloud/alpha/migration/vms/machine-image-imports/create index 7ea1ecb70..da0f2cd4c 100644 --- a/gcloud/alpha/migration/vms/machine-image-imports/create +++ b/gcloud/alpha/migration/vms/machine-image-imports/create @@ -15,8 +15,11 @@ SYNOPSIS [--target-project=TARGET_PROJECT] [--enable-integrity-monitoring --enable-vtpm --secure-boot=SECURE_BOOT] [--scopes=[SCOPES,...] --service-account=SERVICE_ACCOUNT] - [--skip-os-adaptation | --boot-conversion=BOOT_CONVERSION - --generalize --license-type=LICENSE_TYPE] [GCLOUD_WIDE_FLAG ...] + [--skip-os-adaptation | --adaptation-modifiers=ADAPTATION_MODIFIERS + --boot-conversion=BOOT_CONVERSION --generalize + --license-type=LICENSE_TYPE + --rootfs-uuid=ROOTFS_UUID --suppress-package-installation-failure] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) gcloud alpha migration vms machine-image-imports create Imports @@ -157,6 +160,11 @@ OPTIONAL FLAGS --skip-os-adaptation If true, skip OS adaptation. Default false. + --adaptation-modifiers=ADAPTATION_MODIFIERS + A map of flags to pass to the OS adaptation process. The actual value + depends on the modifier and can also be empty. e.g. + --adaptation-modifiers=flag1=value1,flag2 + --boot-conversion=BOOT_CONVERSION This property will trigger an internal process which will convert the image from using the existing boot option to another. The size of the @@ -177,6 +185,13 @@ OPTIONAL FLAGS compute-engine-license-type-default, compute-engine-license-type-payg. + --rootfs-uuid=ROOTFS_UUID + Identifies the file system to adapt. + + --suppress-package-installation-failure + If true, suppress package installation failure and continue with a + warning. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/netapp/volumes/replications/establish-peering b/gcloud/alpha/netapp/volumes/replications/establish-peering index ad6668368..98e9e488b 100644 --- a/gcloud/alpha/netapp/volumes/replications/establish-peering +++ b/gcloud/alpha/netapp/volumes/replications/establish-peering @@ -78,7 +78,8 @@ OPTIONAL FLAGS complete. --peer-ip-addresses=PEER_IP_ADDRESS,[...] - List of ip addresses to be used for peering. + List of ip addresses to be used for peering. This is required for + cluster peering, not required for svm peering. Volume resource - The Volume that the Replication is based on This represents a Cloud resource. (NOTE) Some attributes are not given diff --git a/gcloud/alpha/network-security/backend-authentication-configs/create b/gcloud/alpha/network-security/backend-authentication-configs/create index 71fd07fe5..605a88221 100644 --- a/gcloud/alpha/network-security/backend-authentication-configs/create +++ b/gcloud/alpha/network-security/backend-authentication-configs/create @@ -90,7 +90,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-security backend-authentication-configs create $ gcloud beta network-security backend-authentication-configs create diff --git a/gcloud/alpha/network-security/backend-authentication-configs/delete b/gcloud/alpha/network-security/backend-authentication-configs/delete index e193f00f3..df0c6ecc0 100644 --- a/gcloud/alpha/network-security/backend-authentication-configs/delete +++ b/gcloud/alpha/network-security/backend-authentication-configs/delete @@ -75,7 +75,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-security backend-authentication-configs delete $ gcloud beta network-security backend-authentication-configs delete diff --git a/gcloud/alpha/network-security/backend-authentication-configs/describe b/gcloud/alpha/network-security/backend-authentication-configs/describe index 14e43d08e..96b474400 100644 --- a/gcloud/alpha/network-security/backend-authentication-configs/describe +++ b/gcloud/alpha/network-security/backend-authentication-configs/describe @@ -66,7 +66,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-security backend-authentication-configs describe $ gcloud beta network-security backend-authentication-configs \ describe diff --git a/gcloud/alpha/network-security/backend-authentication-configs/export b/gcloud/alpha/network-security/backend-authentication-configs/export index bd16e4d77..9bdef48d1 100644 --- a/gcloud/alpha/network-security/backend-authentication-configs/export +++ b/gcloud/alpha/network-security/backend-authentication-configs/export @@ -75,7 +75,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-security backend-authentication-configs export $ gcloud beta network-security backend-authentication-configs export diff --git a/gcloud/alpha/network-security/backend-authentication-configs/help b/gcloud/alpha/network-security/backend-authentication-configs/help index 9a6b72a22..50b34eebb 100644 --- a/gcloud/alpha/network-security/backend-authentication-configs/help +++ b/gcloud/alpha/network-security/backend-authentication-configs/help @@ -39,7 +39,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-security backend-authentication-configs $ gcloud beta network-security backend-authentication-configs diff --git a/gcloud/alpha/network-security/backend-authentication-configs/import b/gcloud/alpha/network-security/backend-authentication-configs/import index cc3ca8f6f..299ed0506 100644 --- a/gcloud/alpha/network-security/backend-authentication-configs/import +++ b/gcloud/alpha/network-security/backend-authentication-configs/import @@ -81,7 +81,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-security backend-authentication-configs import $ gcloud beta network-security backend-authentication-configs import diff --git a/gcloud/alpha/network-security/backend-authentication-configs/list b/gcloud/alpha/network-security/backend-authentication-configs/list index 78a1cdadb..b5f0c2059 100644 --- a/gcloud/alpha/network-security/backend-authentication-configs/list +++ b/gcloud/alpha/network-security/backend-authentication-configs/list @@ -84,7 +84,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-security backend-authentication-configs list $ gcloud beta network-security backend-authentication-configs list diff --git a/gcloud/alpha/network-security/org-address-groups/create b/gcloud/alpha/network-security/org-address-groups/create index fc1d30cf3..886f5436c 100644 --- a/gcloud/alpha/network-security/org-address-groups/create +++ b/gcloud/alpha/network-security/org-address-groups/create @@ -6,7 +6,8 @@ SYNOPSIS gcloud alpha network-security org-address-groups create (ADDRESS_GROUP : --location=LOCATION --organization=ORGANIZATION) --capacity=CAPACITY --type=TYPE [--async] [--description=DESCRIPTION] - [--items=[ITEMS,...]] [--labels=[KEY=VALUE,...]] [GCLOUD_WIDE_FLAG ...] + [--items=[ITEMS,...]] [--labels=[KEY=VALUE,...]] + [--purpose=[PURPOSE,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Create a new address group with the given name. @@ -73,6 +74,10 @@ OPTIONAL FLAGS --labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to add. + --purpose=[PURPOSE,...] + List of Address Group purposes. PURPOSE must be one of: cloud-armor, + default. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/network-security/org-address-groups/update b/gcloud/alpha/network-security/org-address-groups/update index 56154b1ec..87845ed5e 100644 --- a/gcloud/alpha/network-security/org-address-groups/update +++ b/gcloud/alpha/network-security/org-address-groups/update @@ -6,7 +6,7 @@ SYNOPSIS gcloud alpha network-security org-address-groups update (ADDRESS_GROUP : --location=LOCATION --organization=ORGANIZATION) [--async] [--description=DESCRIPTION] [--items=[ITEMS,...]] - [--update-labels=[KEY=VALUE,...]] + [--purpose=[PURPOSE,...]] [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -63,6 +63,10 @@ FLAGS --items=[ITEMS,...] Items of the address group. + --purpose=[PURPOSE,...] + List of Address Group purposes. PURPOSE must be one of: cloud-armor, + default. + --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. diff --git a/gcloud/alpha/run/deploy b/gcloud/alpha/run/deploy index 95bd595e8..4b60c818d 100644 --- a/gcloud/alpha/run/deploy +++ b/gcloud/alpha/run/deploy @@ -32,6 +32,7 @@ SYNOPSIS --args=[ARG,...] --[no-]automatic-updates --clear-volume-mounts --cpu=CPU --depends-on=[CONTAINER,...] --gpu=GPU --liveness-probe=[KEY=VALUE,...] --memory=MEMORY --port=PORT + --readiness-probe=[KEY=VALUE,...] --remove-volume-mount=[MOUNT_PATH,...] --startup-probe=[KEY=VALUE,...] --[no-]use-http2 --base-image=BASE_IMAGE @@ -497,6 +498,23 @@ FLAGS to the previous container port, this will also update the probe port. + --readiness-probe=[KEY=VALUE,...] + Comma separated settings for readiness probe in the form KEY=VALUE. + Each key stands for a field of the probe described in + https://cloud.google.com/run/docs/reference/rest/v1/Container#Probe. + Currently supported keys are: timeoutSeconds, periodSeconds, + failureThreshold, successThreshold, httpGet.port, httpGet.path, + grpc.port, grpc.service. + + For example, to set a probe with 10s timeout and HTTP probe + requests sent to 8080 port of the container: + + $ --readiness-probe=timeoutSeconds=10,httpGet.port=8080 + + To remove existing probe: + + $ --readiness-probe="" + --remove-volume-mount=[MOUNT_PATH,...] Removes the volume mounted at the specified path from the current container. diff --git a/gcloud/alpha/run/multi-region-services/update b/gcloud/alpha/run/multi-region-services/update index 1d838a15b..6248bc767 100644 --- a/gcloud/alpha/run/multi-region-services/update +++ b/gcloud/alpha/run/multi-region-services/update @@ -34,6 +34,7 @@ SYNOPSIS --args=[ARG,...] --clear-volume-mounts --command=[COMMAND,...] --cpu=CPU --depends-on=[CONTAINER,...] --gpu=GPU --image=IMAGE --liveness-probe=[KEY=VALUE,...] --memory=MEMORY --port=PORT + --readiness-probe=[KEY=VALUE,...] --remove-volume-mount=[MOUNT_PATH,...] --startup-probe=[KEY=VALUE,...] --[no-]use-http2 --clear-env-vars | --env-vars-file=FILE_PATH | --set-env-vars=[KEY=VALUE,...] @@ -419,6 +420,23 @@ FLAGS to the previous container port, this will also update the probe port. + --readiness-probe=[KEY=VALUE,...] + Comma separated settings for readiness probe in the form KEY=VALUE. + Each key stands for a field of the probe described in + https://cloud.google.com/run/docs/reference/rest/v1/Container#Probe. + Currently supported keys are: timeoutSeconds, periodSeconds, + failureThreshold, successThreshold, httpGet.port, httpGet.path, + grpc.port, grpc.service. + + For example, to set a probe with 10s timeout and HTTP probe + requests sent to 8080 port of the container: + + $ --readiness-probe=timeoutSeconds=10,httpGet.port=8080 + + To remove existing probe: + + $ --readiness-probe="" + --remove-volume-mount=[MOUNT_PATH,...] Removes the volume mounted at the specified path from the current container. diff --git a/gcloud/alpha/run/services/update b/gcloud/alpha/run/services/update index a520748a5..ac47938a9 100644 --- a/gcloud/alpha/run/services/update +++ b/gcloud/alpha/run/services/update @@ -32,6 +32,7 @@ SYNOPSIS --args=[ARG,...] --clear-volume-mounts --command=[COMMAND,...] --cpu=CPU --depends-on=[CONTAINER,...] --gpu=GPU --image=IMAGE --liveness-probe=[KEY=VALUE,...] --memory=MEMORY --port=PORT + --readiness-probe=[KEY=VALUE,...] --remove-volume-mount=[MOUNT_PATH,...] --startup-probe=[KEY=VALUE,...] --[no-]use-http2 --clear-env-vars | --env-vars-file=FILE_PATH | --set-env-vars=[KEY=VALUE,...] @@ -463,6 +464,23 @@ FLAGS to the previous container port, this will also update the probe port. + --readiness-probe=[KEY=VALUE,...] + Comma separated settings for readiness probe in the form KEY=VALUE. + Each key stands for a field of the probe described in + https://cloud.google.com/run/docs/reference/rest/v1/Container#Probe. + Currently supported keys are: timeoutSeconds, periodSeconds, + failureThreshold, successThreshold, httpGet.port, httpGet.path, + grpc.port, grpc.service. + + For example, to set a probe with 10s timeout and HTTP probe + requests sent to 8080 port of the container: + + $ --readiness-probe=timeoutSeconds=10,httpGet.port=8080 + + To remove existing probe: + + $ --readiness-probe="" + --remove-volume-mount=[MOUNT_PATH,...] Removes the volume mounted at the specified path from the current container. diff --git a/gcloud/alpha/run/worker-pools/delete b/gcloud/alpha/run/worker-pools/delete index d21197e62..7cfd42a80 100644 --- a/gcloud/alpha/run/worker-pools/delete +++ b/gcloud/alpha/run/worker-pools/delete @@ -65,5 +65,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta run worker-pools delete diff --git a/gcloud/alpha/run/worker-pools/deploy b/gcloud/alpha/run/worker-pools/deploy index 934850e78..27f249e54 100644 --- a/gcloud/alpha/run/worker-pools/deploy +++ b/gcloud/alpha/run/worker-pools/deploy @@ -493,5 +493,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta run worker-pools deploy diff --git a/gcloud/alpha/run/worker-pools/describe b/gcloud/alpha/run/worker-pools/describe index f9c2a88bf..7462210b3 100644 --- a/gcloud/alpha/run/worker-pools/describe +++ b/gcloud/alpha/run/worker-pools/describe @@ -62,5 +62,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta run worker-pools describe diff --git a/gcloud/alpha/run/worker-pools/help b/gcloud/alpha/run/worker-pools/help index 429d29f14..251f0d699 100644 --- a/gcloud/alpha/run/worker-pools/help +++ b/gcloud/alpha/run/worker-pools/help @@ -57,5 +57,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta run worker-pools diff --git a/gcloud/alpha/run/worker-pools/list b/gcloud/alpha/run/worker-pools/list index 4ec136730..a8ee75930 100644 --- a/gcloud/alpha/run/worker-pools/list +++ b/gcloud/alpha/run/worker-pools/list @@ -63,5 +63,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta run worker-pools list diff --git a/gcloud/alpha/run/worker-pools/replace b/gcloud/alpha/run/worker-pools/replace index 8b7ed0c74..7b8eeb4b1 100644 --- a/gcloud/alpha/run/worker-pools/replace +++ b/gcloud/alpha/run/worker-pools/replace @@ -42,5 +42,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta run worker-pools replace diff --git a/gcloud/alpha/run/worker-pools/revisions/delete b/gcloud/alpha/run/worker-pools/revisions/delete index 749a95eaa..12defa74a 100644 --- a/gcloud/alpha/run/worker-pools/revisions/delete +++ b/gcloud/alpha/run/worker-pools/revisions/delete @@ -77,5 +77,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta run worker-pools revisions delete diff --git a/gcloud/alpha/run/worker-pools/revisions/describe b/gcloud/alpha/run/worker-pools/revisions/describe index cbfff0209..59a244145 100644 --- a/gcloud/alpha/run/worker-pools/revisions/describe +++ b/gcloud/alpha/run/worker-pools/revisions/describe @@ -51,5 +51,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta run worker-pools revisions describe diff --git a/gcloud/alpha/run/worker-pools/revisions/help b/gcloud/alpha/run/worker-pools/revisions/help index 4c4e573d6..7be535f98 100644 --- a/gcloud/alpha/run/worker-pools/revisions/help +++ b/gcloud/alpha/run/worker-pools/revisions/help @@ -42,5 +42,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta run worker-pools revisions diff --git a/gcloud/alpha/run/worker-pools/revisions/list b/gcloud/alpha/run/worker-pools/revisions/list index 8c5ca480b..b049747fd 100644 --- a/gcloud/alpha/run/worker-pools/revisions/list +++ b/gcloud/alpha/run/worker-pools/revisions/list @@ -68,5 +68,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta run worker-pools revisions list diff --git a/gcloud/alpha/run/worker-pools/update b/gcloud/alpha/run/worker-pools/update index 3cfb3854c..c5b2185eb 100644 --- a/gcloud/alpha/run/worker-pools/update +++ b/gcloud/alpha/run/worker-pools/update @@ -470,5 +470,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta run worker-pools update diff --git a/gcloud/alpha/run/worker-pools/update-instance-split b/gcloud/alpha/run/worker-pools/update-instance-split index a865b859e..93df9fa4d 100644 --- a/gcloud/alpha/run/worker-pools/update-instance-split +++ b/gcloud/alpha/run/worker-pools/update-instance-split @@ -130,5 +130,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta run worker-pools update-instance-split diff --git a/gcloud/alpha/services/identity/create b/gcloud/alpha/services/identity/create index 832430a6e..ce913f5da 100644 --- a/gcloud/alpha/services/identity/create +++ b/gcloud/alpha/services/identity/create @@ -12,14 +12,23 @@ DESCRIPTION supported consumers are projects, folders, and organizations. EXAMPLES - To create a service identity for a project, folder, or organization, run: + To create a service identity for a project, run: $ gcloud alpha services identity create \ --service=example.googleapis.com --project=helloworld + + Using a project number: + $ gcloud alpha services identity create \ --service=example.googleapis.com --project=1234567890 + + To create a service identity for a folder, run: + $ gcloud alpha services identity create \ --service=example.googleapis.com --folder=1234567890 + + To create a service identity for an organization, run: + $ gcloud alpha services identity create \ --service=example.googleapis.com --organization=1234567890 diff --git a/gcloud/alpha/spanner/backups/create b/gcloud/alpha/spanner/backups/create index f0c403cda..70dc569d2 100644 --- a/gcloud/alpha/spanner/backups/create +++ b/gcloud/alpha/spanner/backups/create @@ -91,7 +91,7 @@ OPTIONAL FLAGS The encryption type of the backup. ENCRYPTION_TYPE must be one of: customer-managed-encryption - Use the provided Cloud KMS key for encryption. If this option is + Use the provided Cloud KMS key for encryption.If this option is selected, kms-key must be set. google-default-encryption Use Google default encryption. diff --git a/gcloud/alpha/spanner/cli b/gcloud/alpha/spanner/cli new file mode 100644 index 000000000..7a1d15b21 --- /dev/null +++ b/gcloud/alpha/spanner/cli @@ -0,0 +1,123 @@ +NAME + gcloud alpha spanner cli - an interactive shell for Spanner + +SYNOPSIS + gcloud alpha spanner cli (DATABASE : --instance=INSTANCE) + [--database-role=DATABASE_ROLE] [--delimiter=DELIMITER; default=";"] + [--execute=EXECUTE] [--host=HOST; default="localhost"] [--html] + [--idle-transaction-timeout=IDLE_TRANSACTION_TIMEOUT; default=60] + [--init-command=INIT_COMMAND] [--init-command-add=INIT_COMMAND_ADD] + [--port=PORT] [--prompt=PROMPT; default="spanner-cli> "] + [--skip-column-names] [--skip-system-command] [--source=SOURCE] + [--system-command=SYSTEM_COMMAND; default="ON"] [--table] [--tee=TEE] + [--xml] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) An interactive shell for Spanner. + +EXAMPLES + To start an interactive shell with your Spanner example database, run the + following command: + + $ gcloud alpha spanner cli example-database \ + --instance=example-instance + +POSITIONAL ARGUMENTS + Database resource - The Cloud Spanner database to use within the + interactive shell. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument database on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + DATABASE + ID of the database or fully qualified identifier for the database. + + To set the database attribute: + ▸ provide the argument database on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --instance=INSTANCE + The Cloud Spanner instance for the database. + + To set the instance attribute: + ▸ provide the argument database on the command line with a fully + specified name; + ▸ provide the argument --instance on the command line; + ▸ set the property spanner/instance. + +FLAGS + --database-role=DATABASE_ROLE + Database role user used to access the database. + + --delimiter=DELIMITER; default=";" + Set the statement delimiter. + + --execute=EXECUTE + Execute the statement and then exits. + + --host=HOST; default="localhost" + Host on which Spanner server is located. + + --html + Show output in HTML format. + + --idle-transaction-timeout=IDLE_TRANSACTION_TIMEOUT; default=60 + Set the idle transaction timeout. The default timeout is 60 seconds. + + --init-command=INIT_COMMAND + SQL statement to execute after startup. + + --init-command-add=INIT_COMMAND_ADD + Additional SQL statement to execute after startup. + + --port=PORT + Port number that gcloud uses to connect to Spanner. + + --prompt=PROMPT; default="spanner-cli> " + Set the prompt to the specified format. + + --skip-column-names + Do not show column names in output. + + --skip-system-command + Do not allow system command. + + --source=SOURCE + Execute the statement from a file and then exits. + + --system-command=SYSTEM_COMMAND; default="ON" + Enable or disable system commands. Default: ON. SYSTEM_COMMAND must be + one of: ON, OFF. + + --table + Show output in table format. + + --tee=TEE + Append a copy of the output to a named file. + + --xml + Show output in XML format. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/spanner/help b/gcloud/alpha/spanner/help index 97c746095..a9d408827 100644 --- a/gcloud/alpha/spanner/help +++ b/gcloud/alpha/spanner/help @@ -2,7 +2,7 @@ NAME gcloud alpha spanner - command groups for Cloud Spanner SYNOPSIS - gcloud alpha spanner GROUP [GCLOUD_WIDE_FLAG ...] + gcloud alpha spanner GROUP | COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Command groups for Cloud Spanner. @@ -45,6 +45,12 @@ GROUPS samples (ALPHA) Cloud Spanner sample apps. +COMMANDS + COMMAND is one of the following: + + cli + (ALPHA) An interactive shell for Spanner. + NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct diff --git a/gcloud/alpha/storage/batch-operations/jobs/create b/gcloud/alpha/storage/batch-operations/jobs/create index 826946735..e7388e747 100644 --- a/gcloud/alpha/storage/batch-operations/jobs/create +++ b/gcloud/alpha/storage/batch-operations/jobs/create @@ -109,8 +109,10 @@ REQUIRED FLAGS custom time for Cloud Storage objects in RFC 3339 format, specify the key-value pair Custom-Time={VALUE}. To set custom metadata on objects, specify key-value pairs {CUSTOM-KEY}:{VALUE}. Note that all - predefined keys are case-insensitive. Multiple key-value pairs can be - specified by separating them with commas. For example, + predefined keys (e.g. Content-Disposition) are case-insensitive. Any + other key that is not specified above will be treated as a custom + key. Multiple key-value pairs can be specified by separating them + with commas. For example, --put-metadata=Content-Disposition=inline,Content-Encoding=gzip --rewrite-object=KEY=VALUE,[KEY=VALUE,...] diff --git a/gcloud/alpha/storage/insights/dataset-configs/create b/gcloud/alpha/storage/insights/dataset-configs/create index 279633f3a..c856e778d 100644 --- a/gcloud/alpha/storage/insights/dataset-configs/create +++ b/gcloud/alpha/storage/insights/dataset-configs/create @@ -6,7 +6,10 @@ SYNOPSIS gcloud alpha storage insights dataset-configs create DATASET_CONFIG_NAME --location=LOCATION --organization=SOURCE_ORG_NUMBER --retention-period-days=RETENTION_DAYS - (--source-projects=[SOURCE_PROJECT_NUMBERS,...] + (--enable-organization-scope + | --source-folders=[SOURCE_FOLDER_NUMBERS,...] + | --source-folders-file=SOURCE_FOLDER_NUMBERS_IN_FILE + | --source-projects=[SOURCE_PROJECT_NUMBERS,...] | --source-projects-file=SOURCE_PROJECT_NUMBERS_IN_FILE) [--auto-add-new-buckets] [--description=DESCRIPTION] [--identity=IDENTITY_TYPE; default="IDENTITY_TYPE_PER_CONFIG"] @@ -22,17 +25,17 @@ DESCRIPTION (ALPHA) Create a new dataset config for Insights. EXAMPLES - To create a dataset config with config name as "my-config" in location + To create a dataset config with config name as "my_config" in location "us-central1" and project numbers "123456" and "456789" belonging to organization number "54321": - $ gcloud alpha storage insights dataset-configs create my-config \ + $ gcloud alpha storage insights dataset-configs create my_config \ --location=us-central1 --source-projects=123456,456789 \ --organization=54321 --retention-period-days=1 To create a dataset config that automatically adds new buckets into config: - $ gcloud alpha storage insights dataset-configs create my-config \ + $ gcloud alpha storage insights dataset-configs create my_config \ --location=us-central1 --source-projects=123456,456789 \ --organization=54321 --auto-add-new-buckets \ --retention-period-days=1 @@ -51,10 +54,26 @@ REQUIRED FLAGS --retention-period-days=RETENTION_DAYS Provide retention period for the config. - List of source options currently supported are source projects. + List of source options either source projects or source folders or enable + organization scope. Refer Dataset Configuration Properties + (https://cloud.google.com/storage/docs/insights/datasets#dataset-config) + for more details. Exactly one of these must be specified: + --enable-organization-scope + If passed, the dataset config will be enabled on the organization. + + List of source folder IDs or the file containing list of folder IDs. + + At most one of these can be specified: + + --source-folders=[SOURCE_FOLDER_NUMBERS,...] + List of source folder IDs. + + --source-folders-file=SOURCE_FOLDER_NUMBERS_IN_FILE + CSV formatted file containing source folder IDs, one per line. + List of source project numbers or the file containing list of project numbers. diff --git a/gcloud/alpha/storage/insights/dataset-configs/create-link b/gcloud/alpha/storage/insights/dataset-configs/create-link index fdcb52934..366fbfe5d 100644 --- a/gcloud/alpha/storage/insights/dataset-configs/create-link +++ b/gcloud/alpha/storage/insights/dataset-configs/create-link @@ -12,15 +12,15 @@ DESCRIPTION EXAMPLES To create a link to the customer BigQuery instance for config name: - "my-config" in location "us-central1": + "my_config" in location "us-central1": $ gcloud alpha storage insights dataset-configs create-link \ - my-config --location=us-central1 + my_config --location=us-central1 To create a link for the same dataset config with fully specified name: $ gcloud alpha storage insights dataset-configs create-link \ - projects/foo/locations/us-central1/datasetConfigs/my-config + projects/foo/locations/us-central1/datasetConfigs/my_config POSITIONAL ARGUMENTS Dataset config resource - The Dataset config to create link. The arguments diff --git a/gcloud/alpha/storage/insights/dataset-configs/delete b/gcloud/alpha/storage/insights/dataset-configs/delete index 358e20650..9883f48b1 100644 --- a/gcloud/alpha/storage/insights/dataset-configs/delete +++ b/gcloud/alpha/storage/insights/dataset-configs/delete @@ -11,24 +11,24 @@ DESCRIPTION (ALPHA) Delete an Insights dataset config. EXAMPLES - To delete a dataset config with config name "my-config" in location + To delete a dataset config with config name "my_config" in location "us-central1": - $ gcloud alpha storage insights dataset-configs delete my-config \ + $ gcloud alpha storage insights dataset-configs delete my_config \ --location=us-central1 To delete the same dataset config with fully specified name: - $gcloud alpha storage insights dataset-configs delete projects/foo/locations/us-central1/datasetConfigs/my-config + $gcloud alpha storage insights dataset-configs delete projects/foo/locations/us-central1/datasetConfigs/my_config To delete the same dataset config and unlink it from the BigQuery instance: - $ gcloud alpha storage insights dataset-configs delete my-config \ + $ gcloud alpha storage insights dataset-configs delete my_config \ --location=us-central1 --auto-delete-link To delete the same dataset config without taking user consent: - $ gcloud alpha storage insights dataset-configs delete my-config \ + $ gcloud alpha storage insights dataset-configs delete my_config \ --location=us-central1 --auto-delete-link --force POSITIONAL ARGUMENTS diff --git a/gcloud/alpha/storage/insights/dataset-configs/delete-link b/gcloud/alpha/storage/insights/dataset-configs/delete-link index e015ce150..52641fa9d 100644 --- a/gcloud/alpha/storage/insights/dataset-configs/delete-link +++ b/gcloud/alpha/storage/insights/dataset-configs/delete-link @@ -10,16 +10,16 @@ DESCRIPTION (ALPHA) Delete a link to a BigQuery instance. EXAMPLES - To unlink a dataset config with config name "my-config" in location + To unlink a dataset config with config name "my_config" in location "us-central1": $ gcloud alpha storage insights dataset-configs delete-link \ - my-config --location=us-central1 + my_config --location=us-central1 To delete a link for the same dataset config with fully specified name: $ gcloud alpha storage insights dataset-configs delete-link \ - projects/foo/locations/us-central1/datasetConfigs/my-config + projects/foo/locations/us-central1/datasetConfigs/my_config POSITIONAL ARGUMENTS Dataset config resource - The Dataset config to delete link. The arguments diff --git a/gcloud/alpha/storage/insights/dataset-configs/describe b/gcloud/alpha/storage/insights/dataset-configs/describe index 4d5aaecd5..e6c6dec95 100644 --- a/gcloud/alpha/storage/insights/dataset-configs/describe +++ b/gcloud/alpha/storage/insights/dataset-configs/describe @@ -10,16 +10,16 @@ DESCRIPTION (ALPHA) Describe the Insights dataset config. EXAMPLES - To describe a dataset config with config name "my-config" in location + To describe a dataset config with config name "my_config" in location "us-central1": - $ gcloud alpha storage insights dataset-configs describe my-config \ + $ gcloud alpha storage insights dataset-configs describe my_config \ --location=us-central1 To describe the same dataset config with fully specified name: $ gcloud alpha storage insights dataset-configs describe \ - projects/foo/locations/us-central1/datasetConfigs/my-config + projects/foo/locations/us-central1/datasetConfigs/my_config POSITIONAL ARGUMENTS Dataset config resource - The Dataset config to describe. The arguments in diff --git a/gcloud/alpha/storage/insights/dataset-configs/update b/gcloud/alpha/storage/insights/dataset-configs/update index ca44bb6b4..36fa4b981 100644 --- a/gcloud/alpha/storage/insights/dataset-configs/update +++ b/gcloud/alpha/storage/insights/dataset-configs/update @@ -4,29 +4,42 @@ NAME SYNOPSIS gcloud alpha storage insights dataset-configs update - (DATASET_CONFIG : --location=LOCATION) [--description=DESCRIPTION] - [--retention-period-days=RETENTION_DAYS] [GCLOUD_WIDE_FLAG ...] + (DATASET_CONFIG : --location=LOCATION) + [--auto-add-new-buckets=AUTO_ADD_NEW_BUCKETS] + [--description=DESCRIPTION] [--retention-period-days=RETENTION_DAYS] + [--enable-organization-scope + | --source-folders=[SOURCE_FOLDER_NUMBERS,...] + | --source-folders-file=SOURCE_FOLDER_NUMBERS_IN_FILE + | --source-projects=[SOURCE_PROJECT_NUMBERS,...] + | --source-projects-file=SOURCE_PROJECT_NUMBERS_IN_FILE] + [--exclude-bucket-names=[BUCKETS_NAMES,...] + --exclude-bucket-prefix-regexes=[BUCKETS_REGEXES,...] + | --include-bucket-names=[BUCKETS_NAMES,...] + --include-bucket-prefix-regexes=[BUCKETS_REGEXES,...]] + [--exclude-source-locations=[LIST_OF_SOURCE_LOCATIONS,...] + | --include-source-locations=[LIST_OF_SOURCE_LOCATIONS,...]] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Update a dataset config for Insights. EXAMPLES - To update the description for a dataset config "my-config" in location + To update the description for a dataset config "my_config" in location "us-central1": - $ gcloud alpha storage insights dataset-configs update my-config \ + $ gcloud alpha storage insights dataset-configs update my_config \ --location=us-central1 \ --description="a user provided description" To update the same dataset config with fully specified name: $ gcloud alpha storage insights dataset-configs update \ - projects/foo/locations/us-central1/datasetConfigs/my-config + projects/foo/locations/us-central1/datasetConfigs/my_config - To update the retention period days for the dataset config "my-config" in + To update the retention period days for the dataset config "my_config" in location "us-central1": - $ gcloud alpha storage insights dataset-configs update my-config \ + $ gcloud alpha storage insights dataset-configs update my_config \ --location=us-central1 --retention-period-days=20 POSITIONAL ARGUMENTS @@ -62,12 +75,88 @@ POSITIONAL ARGUMENTS ▸ provide the argument --location on the command line. FLAGS + --auto-add-new-buckets=AUTO_ADD_NEW_BUCKETS + Automatically include any new buckets created if they satisfy criteria + defined in config settings. AUTO_ADD_NEW_BUCKETS must be one of: true, + false. + --description=DESCRIPTION Description for dataset config. --retention-period-days=RETENTION_DAYS Provide retention period for the config. + List of source options either source projects or source folders or enable + organization scope. Refer Dataset Configuration Properties + (https://cloud.google.com/storage/docs/insights/datasets#dataset-config) + for more details. + + At most one of these can be specified: + + --enable-organization-scope + If passed, the dataset config will be enabled on the organization. + + List of source folder IDs or the file containing list of folder IDs. + + At most one of these can be specified: + + --source-folders=[SOURCE_FOLDER_NUMBERS,...] + List of source folder IDs. + + --source-folders-file=SOURCE_FOLDER_NUMBERS_IN_FILE + CSV formatted file containing source folder IDs, one per line. + + List of source project numbers or the file containing list of project + numbers. + + At most one of these can be specified: + + --source-projects=[SOURCE_PROJECT_NUMBERS,...] + List of source project numbers. + + --source-projects-file=SOURCE_PROJECT_NUMBERS_IN_FILE + CSV formatted file containing source project numbers, one per line. + + Specify the list of buckets to be included or excluded, both a list of + bucket names and prefix regexes can be specified for either include or + exclude buckets. + + At most one of these can be specified: + + Specify the list of buckets to be excluded. + + --exclude-bucket-names=[BUCKETS_NAMES,...] + List of bucket names to be excluded. + + --exclude-bucket-prefix-regexes=[BUCKETS_REGEXES,...] + List of bucket prefix regexes to be excluded. Allowed regex + patterns are similar to those for the + --include-bucket-prefix-regexes flag. + + Specify the list of buckets to be included. + + --include-bucket-names=[BUCKETS_NAMES,...] + List of bucket names be included. + + --include-bucket-prefix-regexes=[BUCKETS_REGEXES,...] + List of bucket prefix regexes to be included. The dataset config + will include all the buckets that match with the prefix regex. + Examples of allowed prefix regex patterns can be testbucket*, + testbucket.*foo, testb.+foo* . It should follow syntax specified in + google/re2 on GitHub. + + Specify the list of locations for source projects to be included or + excluded from available locations + (https://cloud.google.com/storage/docs/locations#available-locations). + + At most one of these can be specified: + + --exclude-source-locations=[LIST_OF_SOURCE_LOCATIONS,...] + List of locations for projects to be excluded. + + --include-source-locations=[LIST_OF_SOURCE_LOCATIONS,...] + List of locations for projects to be included. + 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/api-gateway/api-configs/create b/gcloud/api-gateway/api-configs/create index 7bce25e59..c9694d626 100644 --- a/gcloud/api-gateway/api-configs/create +++ b/gcloud/api-gateway/api-configs/create @@ -67,7 +67,7 @@ REQUIRED FLAGS listed. --openapi-spec=[FILE,...] - The OpenAPI v2 specifications containing service configuration + The OpenAPI specifications containing service configuration information, and API specification for the gateway. OPTIONAL FLAGS diff --git a/gcloud/beta/ai/endpoints/list b/gcloud/beta/ai/endpoints/list index 44b9472b0..319e6bcaf 100644 --- a/gcloud/beta/ai/endpoints/list +++ b/gcloud/beta/ai/endpoints/list @@ -2,10 +2,10 @@ NAME gcloud beta ai endpoints list - list existing Vertex AI endpoints SYNOPSIS - gcloud beta ai endpoints list [--list-model-garden-endpoints-only] - [--region=REGION] [--filter=EXPRESSION] [--limit=LIMIT] - [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] - [GCLOUD_WIDE_FLAG ...] + gcloud beta ai endpoints list [--gdc-zone=GDC_ZONE] + [--list-model-garden-endpoints-only] [--region=REGION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] EXAMPLES To list the endpoints under project example in region us-central1, run: @@ -20,6 +20,9 @@ EXAMPLES --region=us-central1 --list-model-garden-endpoints-only FLAGS + --gdc-zone=GDC_ZONE + The name of the GDC zone. If set, the endpoint is for GDCc. + --list-model-garden-endpoints-only Whether to only list endpoints related to Model Garden. diff --git a/gcloud/beta/alloydb/clusters/upgrade b/gcloud/beta/alloydb/clusters/upgrade index c6ba2b5c7..c2d1f0929 100644 --- a/gcloud/beta/alloydb/clusters/upgrade +++ b/gcloud/beta/alloydb/clusters/upgrade @@ -26,7 +26,7 @@ REQUIRED FLAGS --version=VERSION Target database version for the upgrade. VERSION must be one of: - POSTGRES_14, POSTGRES_15, POSTGRES_16. + POSTGRES_14, POSTGRES_15, POSTGRES_16, POSTGRES_17. OPTIONAL FLAGS --async diff --git a/gcloud/beta/alloydb/instances/create b/gcloud/beta/alloydb/instances/create index 508407a01..d52974d9e 100644 --- a/gcloud/beta/alloydb/instances/create +++ b/gcloud/beta/alloydb/instances/create @@ -162,7 +162,9 @@ OPTIONAL FLAGS n2-highmem-64, n2-highmem-96, n2-highmem-128, c4a-highmem-1, c4a-highmem-4-lssd, c4a-highmem-8-lssd, c4a-highmem-16-lssd, c4a-highmem-32-lssd, c4a-highmem-48-lssd, c4a-highmem-64-lssd, - c4a-highmem-72-lssd. + c4a-highmem-72-lssd, z3-highmem-14-standardlssd, + z3-highmem-22-standardlssd, z3-highmem-44-standardlssd, + z3-highmem-88-standardlssd. --[no-]observability-config-enabled Enable enhanced query insights feature. Use diff --git a/gcloud/beta/alloydb/instances/update b/gcloud/beta/alloydb/instances/update index da48f8fcd..7bdb0361f 100644 --- a/gcloud/beta/alloydb/instances/update +++ b/gcloud/beta/alloydb/instances/update @@ -148,7 +148,9 @@ OPTIONAL FLAGS n2-highmem-64, n2-highmem-96, n2-highmem-128, c4a-highmem-1, c4a-highmem-4-lssd, c4a-highmem-8-lssd, c4a-highmem-16-lssd, c4a-highmem-32-lssd, c4a-highmem-48-lssd, c4a-highmem-64-lssd, - c4a-highmem-72-lssd. + c4a-highmem-72-lssd, z3-highmem-14-standardlssd, + z3-highmem-22-standardlssd, z3-highmem-44-standardlssd, + z3-highmem-88-standardlssd. --[no-]observability-config-enabled Enable enhanced query insights feature. Use diff --git a/gcloud/beta/api-gateway/api-configs/create b/gcloud/beta/api-gateway/api-configs/create index ac377011e..2b1c5e7d8 100644 --- a/gcloud/beta/api-gateway/api-configs/create +++ b/gcloud/beta/api-gateway/api-configs/create @@ -67,7 +67,7 @@ REQUIRED FLAGS listed. --openapi-spec=[FILE,...] - The OpenAPI v2 specifications containing service configuration + The OpenAPI specifications containing service configuration information, and API specification for the gateway. OPTIONAL FLAGS diff --git a/gcloud/beta/compute/disks/update b/gcloud/beta/compute/disks/update index 9de04acdc..82830edf8 100644 --- a/gcloud/beta/compute/disks/update +++ b/gcloud/beta/compute/disks/update @@ -6,6 +6,9 @@ SYNOPSIS [--provisioned-iops=PROVISIONED_IOPS] [--provisioned-throughput=PROVISIONED_THROUGHPUT] [--size=SIZE] [--update-labels=[KEY=VALUE,...]] + [--append-licenses=LICENSE,[LICENSE,...] + --remove-licenses=LICENSE,[LICENSE,...] + --replace-license=LICENSE,LICENSE] [--clear-architecture | --update-architecture=UPDATE_ARCHITECTURE] [--clear-labels | --remove-labels=[KEY,...]] [--clear-user-licenses | --update-user-licenses=[LICENSE,...]] @@ -35,6 +38,27 @@ EXAMPLES $ gcloud beta compute disks describe example-disk \ --format="default(labels)" + To append licenses to the disk, run: + + $ gcloud beta compute disks update example-disk \ + --zone=us-central1-a \ + --append-licenses=projects/license-project/global/licenses/\ + license-1,projects/license-project/global/licenses/license-2 + + To remove licenses from the disk, run: + + $ gcloud beta compute disks update example-disk \ + --zone=us-central1-a \ + --replace-licenses=projects/license-project/global/licenses/\ + license-1,projects/license-project/global/licenses/license-2 + + To replace a license on the disk, run: + + $ gcloud beta compute disks update example-disk \ + --zone=us-central1-a \ + --replace-license=projects/license-project/global/licenses/\ + old-license,projects/license-project/global/licenses/new-license + POSITIONAL ARGUMENTS DISK_NAME Name of the disk to update. @@ -71,6 +95,23 @@ FLAGS contain only hyphens (-), underscores (_), lowercase characters, and numbers. + --append-licenses=LICENSE,[LICENSE,...] + "A list of license URIs or license codes. These licenses will be + appended to the existing licenses on the disk. Provided licenses can be + either license URIs or license codes but not a mix of both. + + --remove-licenses=LICENSE,[LICENSE,...] + A list of license URIs or license codes. If present in the set of + existing licenses, these licenses will be removed. If not present, this + is a no-op. Provided licenses can be either license URIs or license + codes but not a mix of both. + + --replace-license=LICENSE,LICENSE + A list of license URIs or license codes. The first license is the + license to be replaced and the second license is the replacement + license. Provided licenses can be either license URIs or license codes + but not a mix of both. + At most one of these can be specified: --clear-architecture diff --git a/gcloud/beta/compute/reservations/update b/gcloud/beta/compute/reservations/update index 41ee0e9a6..f2b81da02 100644 --- a/gcloud/beta/compute/reservations/update +++ b/gcloud/beta/compute/reservations/update @@ -58,10 +58,10 @@ FLAGS with. You must list the projects using project IDs or project numbers. --[no-]enable-emergent-maintenance - The emergent maintenance flag for the reservation, which enrolls all - the underlying vms, hosts and SB infrastructure to receive emergent - maintenance notifications in advance. Use --enable-emergent-maintenance - to enable and --no-enable-emergent-maintenance to disable. + Enables the reservation to receive notifications when urgent + maintenance for a GPU VM starts after the VM encounters a host error. + Use --enable-emergent-maintenance to enable and + --no-enable-emergent-maintenance to disable. --remove-share-with=PROJECT,[PROJECT,...] A list of specific projects to remove from the list of projects that diff --git a/gcloud/beta/dataproc/clusters/create b/gcloud/beta/dataproc/clusters/create index b6147fd7b..52a508c8e 100644 --- a/gcloud/beta/dataproc/clusters/create +++ b/gcloud/beta/dataproc/clusters/create @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud beta dataproc clusters create (CLUSTER : --region=REGION) [--async] [--autoscaling-policy=AUTOSCALING_POLICY] [--bucket=BUCKET] - [--cluster-type=TYPE] + [--cluster-type=TYPE] [--delete-max-idle=DELETE_MAX_IDLE] [--driver-pool-accelerator=[type=TYPE,[count=COUNT],...]] [--driver-pool-boot-disk-size=DRIVER_POOL_BOOT_DISK_SIZE] [--driver-pool-boot-disk-type=DRIVER_POOL_BOOT_DISK_TYPE] @@ -43,7 +43,8 @@ SYNOPSIS [--secondary-worker-standard-capacity-base=SECONDARY_WORKER_STANDARD_CAPACITY_BASE] [--secondary-worker-standard-capacity-percent-above-base=SECONDARY_WORKER_STANDARD_CAPACITY_PERCENT_ABOVE_BASE] [--shielded-integrity-monitoring] [--shielded-secure-boot] - [--shielded-vtpm] [--temp-bucket=TEMP_BUCKET] [--tier=TIER] + [--shielded-vtpm] [--stop-max-idle=STOP_MAX_IDLE] + [--temp-bucket=TEMP_BUCKET] [--tier=TIER] [--worker-accelerator=[type=TYPE,[count=COUNT],...]] [--worker-boot-disk-provisioned-iops=WORKER_BOOT_DISK_PROVISIONED_IOPS] [--worker-boot-disk-provisioned-throughput=WORKER_BOOT_DISK_PROVISIONED_THROUGHPUT] @@ -54,9 +55,7 @@ SYNOPSIS [--dataproc-metastore=DATAPROC_METASTORE | --bigquery-metastore --bigquery-metastore-database-location=BIGQUERY_METASTORE_DATABASE_LOCATION --bigquery-metastore-project-id=BIGQUERY_METASTORE_PROJECT_ID] [--delete-expiration-time=DELETE_EXPIRATION_TIME - | --delete-max-age=DELETE_MAX_AGE | --expiration-time=EXPIRATION_TIME - | --max-age=MAX_AGE] - [--delete-max-idle=DELETE_MAX_IDLE | --max-idle=MAX_IDLE] + | --delete-max-age=DELETE_MAX_AGE] [--gce-pd-kms-key=GCE_PD_KMS_KEY : --gce-pd-kms-key-keyring=GCE_PD_KMS_KEY_KEYRING --gce-pd-kms-key-location=GCE_PD_KMS_KEY_LOCATION @@ -77,6 +76,8 @@ SYNOPSIS --num-secondary-workers=NUM_SECONDARY_WORKERS --num-workers=NUM_WORKERS --secondary-worker-type=TYPE; default="preemptible"] + [--stop-expiration-time=STOP_EXPIRATION_TIME + | --stop-max-age=STOP_MAX_AGE] [--worker-machine-type=WORKER_MACHINE_TYPE | --worker-machine-types=type=MACHINE_TYPE[, type=MACHINE_TYPE...][,rank=RANK]] [GCLOUD_WIDE_FLAG ...] @@ -146,6 +147,11 @@ FLAGS The type of cluster. TYPE must be one of: standard, single-node, zero-scale. + --delete-max-idle=DELETE_MAX_IDLE + The duration after the last job completes to auto-delete the cluster, + such as "2h" or "1d". See $ gcloud topic datetimes for information on + duration formats. + --driver-pool-accelerator=[type=TYPE,[count=COUNT],...] Attaches accelerators, such as GPUs, to the driver-pool instance(s). @@ -418,6 +424,11 @@ FLAGS security operations, such as remote attestation, encryption, and sealing of keys. + --stop-max-idle=STOP_MAX_IDLE + The duration after the last job completes to auto-stop the cluster, + such as "2h" or "1d". See $ gcloud topic datetimes for information on + duration formats. + --temp-bucket=TEMP_BUCKET The Google Cloud Storage bucket to use by default to store ephemeral cluster and jobs data, such as Spark and MapReduce history files. @@ -517,28 +528,6 @@ FLAGS as "2h" or "1d". See $ gcloud topic datetimes for information on duration formats. - --expiration-time=EXPIRATION_TIME - The time when the cluster will be auto-deleted, such as - "2017-08-29T18:52:51.142Z." See $ gcloud topic datetimes for - information on time formats. - - --max-age=MAX_AGE - The lifespan of the cluster, with auto-deletion upon completion, such - as "2h" or "1d". See $ gcloud topic datetimes for information on - duration formats. - - At most one of these can be specified: - - --delete-max-idle=DELETE_MAX_IDLE - The duration after the last job completes to auto-delete the cluster, - such as "2h" or "1d". See $ gcloud topic datetimes for information on - duration formats. - - --max-idle=MAX_IDLE - The duration after the last job completes to autto-delete the - cluster, such as "2h" or "1d". See $ gcloud topic datetimes for - information on duration formats. - Key resource - The Cloud KMS (Key Management Service) cryptokey that will be used to protect the cluster. The 'Compute Engine Service Agent' service account must hold permission 'Cloud KMS CryptoKey Encrypter/Decrypter'. @@ -945,6 +934,18 @@ FLAGS The type of the secondary worker group. TYPE must be one of: preemptible, non-preemptible, spot. + At most one of these can be specified: + + --stop-expiration-time=STOP_EXPIRATION_TIME + The time when the cluster will be auto-stopped, such as + "2017-08-29T18:52:51.142Z." See $ gcloud topic datetimes for + information on time formats. + + --stop-max-age=STOP_MAX_AGE + The lifespan of the cluster, with auto-stop upon completion, such as + "2h" or "1d". See $ gcloud topic datetimes for information on + duration formats. + At most one of these can be specified: --worker-machine-type=WORKER_MACHINE_TYPE diff --git a/gcloud/beta/dataproc/clusters/update b/gcloud/beta/dataproc/clusters/update index 5e032cc9e..8694f9ba0 100644 --- a/gcloud/beta/dataproc/clusters/update +++ b/gcloud/beta/dataproc/clusters/update @@ -11,11 +11,12 @@ SYNOPSIS [--autoscaling-policy=AUTOSCALING_POLICY | --disable-autoscaling] [--clear-labels | --remove-labels=[KEY,...]] [--delete-expiration-time=DELETE_EXPIRATION_TIME - | --delete-max-age=DELETE_MAX_AGE | --no-delete-max-age - | --expiration-time=EXPIRATION_TIME | --max-age=MAX_AGE - | --no-max-age] - [--delete-max-idle=DELETE_MAX_IDLE | --no-delete-max-idle - | --max-idle=MAX_IDLE | --no-max-idle] [GCLOUD_WIDE_FLAG ...] + | --delete-max-age=DELETE_MAX_AGE | --no-delete-max-age] + [--delete-max-idle=DELETE_MAX_IDLE | --no-delete-max-idle] + [--stop-expiration-time=STOP_EXPIRATION_TIME + | --stop-max-age=STOP_MAX_AGE | --no-stop-max-age] + [--stop-max-idle=STOP_MAX_IDLE | --no-stop-max-idle] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Update the number of worker nodes and/or the labels in a cluster. @@ -182,20 +183,6 @@ FLAGS Cancels the cluster auto-deletion by maximum cluster age (configured by --delete-max-age or --delete-expiration-time flags) - --expiration-time=EXPIRATION_TIME - The time when the cluster will be auto-deleted, such as - "2017-08-29T18:52:51.142Z". See $ gcloud topic datetimes for - information on time formats. - - --max-age=MAX_AGE - The lifespan of the cluster, with auto-deletion upon completion, "2h" - or "1d". See $ gcloud topic datetimes for information on duration - formats. - - --no-max-age - Cancels the cluster auto-deletion by maximum cluster age (configured - by --max-age or --expiration-time flags) - At most one of these can be specified: --delete-max-idle=DELETE_MAX_IDLE @@ -207,14 +194,32 @@ FLAGS Cancels the cluster auto-deletion by cluster idle duration (configured by --delete-max-idle flag) - --max-idle=MAX_IDLE - The duration after the last job completes to auto-delete the cluster, + At most one of these can be specified: + + --stop-expiration-time=STOP_EXPIRATION_TIME + The time when the cluster will be auto-stopped, such as + "2017-08-29T18:52:51.142Z". See $ gcloud topic datetimes for + information on time formats. + + --stop-max-age=STOP_MAX_AGE + The lifespan of the cluster, with auto-stop upon completion, such as + "2h" or "1d". See $ gcloud topic datetimes for information on + duration formats. + + --no-stop-max-age + Cancels the cluster auto-stop by maximum cluster age (configured by + --stop-max-age or --stop-expiration-time flags) + + At most one of these can be specified: + + --stop-max-idle=STOP_MAX_IDLE + The duration after the last job completes to auto-stop the cluster, such as "2h" or "1d". See $ gcloud topic datetimes for information on duration formats. - --no-max-idle - Cancels the cluster auto-deletion by cluster idle duration - (configured by --max-idle flag) + --no-stop-max-idle + Cancels the cluster auto-stop by cluster idle duration (configured by + --stop-max-idle flag) GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/iam/policy-bindings/create b/gcloud/beta/iam/policy-bindings/create index 3a121b4e2..09734371b 100644 --- a/gcloud/beta/iam/policy-bindings/create +++ b/gcloud/beta/iam/policy-bindings/create @@ -5,9 +5,7 @@ SYNOPSIS gcloud beta iam policy-bindings create (POLICY_BINDING : --folder=FOLDER --location=LOCATION --organization=ORGANIZATION) - --policy=POLICY - (--target-principal-set=TARGET_PRINCIPAL_SET - | --target-resource=TARGET_RESOURCE) + --policy=POLICY --target-principal-set=TARGET_PRINCIPAL_SET [--annotations=[ANNOTATIONS,...]] [--async] [--display-name=DISPLAY_NAME] [--etag=ETAG] [--policy-kind=POLICY_KIND] [--condition-description=CONDITION_DESCRIPTION @@ -133,17 +131,6 @@ REQUIRED FLAGS ◇ Workload Identity Pool: //iam.googleapis.com/projects/PROJECT_NUMBER/locations/LOCATION/workloadIdentityPools/WORKLOAD_POOL_ID - --target-resource=TARGET_RESOURCE - Full Resource Name used for access policy bindings Examples: - - ▹ Organization: - //cloudresourcemanager.googleapis.com/organizations/ORGANIZATION_ID - ▹ Folder: - //cloudresourcemanager.googleapis.com/folders/FOLDER_ID - ▹ Project: - ▪ //cloudresourcemanager.googleapis.com/projects/PROJECT_NUMBER - ▪ //cloudresourcemanager.googleapis.com/projects/PROJECT_ID - OPTIONAL FLAGS --annotations=[ANNOTATIONS,...] User-defined annotations. See https://google.aip.dev/148#annotations diff --git a/gcloud/beta/memorystore/instances/create b/gcloud/beta/memorystore/instances/create index 32a317fdb..63dd53547 100644 --- a/gcloud/beta/memorystore/instances/create +++ b/gcloud/beta/memorystore/instances/create @@ -14,6 +14,7 @@ SYNOPSIS [--psc-auto-connections=[network=NETWORK], [port=PORT],[projectId=PROJECTID]] [--replica-count=REPLICA_COUNT] [--request-id=REQUEST_ID] [--shard-count=SHARD_COUNT] + [--simulate-maintenance-event] [--transit-encryption-mode=TRANSIT_ENCRYPTION_MODE] [--aof-config-append-fsync=AOF_CONFIG_APPEND_FSYNC --persistence-config-mode=PERSISTENCE_CONFIG_MODE @@ -25,6 +26,7 @@ SYNOPSIS [--cross-instance-replication-config-role=CROSS_INSTANCE_REPLICATION_CONFIG_ROLE : --cross-instance-replication-config-secondary-instances=[instance=INSTANCE] --primary-instance=PRIMARY_INSTANCE] [--gcs-source-uris=[GCS_SOURCE_URIS,...] | --managed-backup-source=MANAGED_BACKUP_SOURCE] + [--kms-key=KMS_KEY : --key-ring=KEY_RING] [--zone-distribution-config=ZONE_DISTRIBUTION_CONFIG --zone-distribution-config-mode=ZONE_DISTRIBUTION_CONFIG_MODE] [GCLOUD_WIDE_FLAG ...] @@ -190,9 +192,9 @@ FLAGS --labels=path_to_file.(yaml|json) --location=LOCATION - For resources [instance], provides fallback value for resource location - attribute. When the resource's full URI path is not provided, location - will fallback to this flag value. + For resources [instance, cryptoKey], provides fallback value for + resource location attribute. When the resource's full URI path is not + provided, location will fallback to this flag value. Maintenance policy per instance. @@ -318,6 +320,11 @@ FLAGS --shard-count=SHARD_COUNT Number of shards for the instance. + Arguments for the simulate maintenance event. + + --simulate-maintenance-event + Simulate a maintenance event. + --transit-encryption-mode=TRANSIT_ENCRYPTION_MODE In-transit encryption mode of the instance. TRANSIT_ENCRYPTION_MODE must be one of: @@ -513,6 +520,42 @@ FLAGS In this case, it assumes the backup is under memorystore.googleapis.com. + Arguments for the kms key. + + CryptoKey resource - The KMS key used to encrypt the at-rest data of the + cluster. 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 --kms-key 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 --kms-key on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --kms-key=KMS_KEY + ID of the cryptoKey or fully qualified identifier for the + cryptoKey. + + To set the crypto-key attribute: + ▫ provide the argument --kms-key on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --key-ring=KEY_RING + The keyRing id of the cryptoKey resource. + + To set the key-ring attribute: + ▫ provide the argument --kms-key on the command line with a fully + specified name; + ▫ provide the argument --key-ring on the command line. + Zone distribution configuration for allocation of instance resources. --zone-distribution-config=ZONE_DISTRIBUTION_CONFIG diff --git a/gcloud/beta/memorystore/instances/update b/gcloud/beta/memorystore/instances/update index 77b4782b6..861b3ada5 100644 --- a/gcloud/beta/memorystore/instances/update +++ b/gcloud/beta/memorystore/instances/update @@ -9,6 +9,7 @@ SYNOPSIS [--location=LOCATION] [--mode=MODE] [--node-type=NODE_TYPE] [--[no-]ondemand-maintenance] [--replica-count=REPLICA_COUNT] [--request-id=REQUEST_ID] [--shard-count=SHARD_COUNT] + [--[no-]simulate-maintenance-event] [--aof-config-append-fsync=AOF_CONFIG_APPEND_FSYNC --clear-persistence-config --persistence-config-mode=PERSISTENCE_CONFIG_MODE @@ -33,6 +34,7 @@ SYNOPSIS | --update-engine-configs=[UPDATE_ENGINE_CONFIGS,...] --clear-engine-configs | --remove-engine-configs=REMOVE_ENGINE_CONFIGS] + [--key-ring=KEY_RING --clear-kms-key | --kms-key=KMS_KEY] [--labels=[LABELS,...] | --update-labels=[UPDATE_LABELS,...] --clear-labels | --remove-labels=REMOVE_LABELS] [GCLOUD_WIDE_FLAG ...] @@ -105,9 +107,9 @@ FLAGS Engine version of the instance. --location=LOCATION - For resources [instance], provides fallback value for resource location - attribute. When the resource's full URI path is not provided, location - will fallback to this flag value. + For resources [instance, cryptoKey], provides fallback value for + resource location attribute. When the resource's full URI path is not + provided, location will fallback to this flag value. --mode=MODE The mode config for the instance. MODE must be one of: @@ -162,6 +164,12 @@ FLAGS --shard-count=SHARD_COUNT Number of shards for the instance. + Arguments for the simulate maintenance event. + + --[no-]simulate-maintenance-event + Simulate a maintenance event. Use --simulate-maintenance-event to + enable and --no-simulate-maintenance-event to disable. + Represents persistence configuration for a instance. Configuration for AOF based persistence. @@ -770,6 +778,54 @@ FLAGS --remove-engine-configs=path_to_file.(yaml|json) + Arguments for the kms key. + + All arguments needed to update kms_key. + + --key-ring=KEY_RING + The keyRing id of the cryptoKey resource. + + To set the key-ring attribute: + ▫ provide the argument --current on the command line with a fully + specified name; + ▫ provide the argument --key-ring on the command line. + + Update kms_key. + + At most one of these can be specified: + + --clear-kms-key + Clear kms_key value and set to null. + + CryptoKey resource - Set kms_key to new value. + + The KMS key used to encrypt the at-rest data of the cluster. 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 --kms-key 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 --kms-key on the command line with a fully + specified name; + ◇ provide the argument --location on the command line. + + To set the key-ring attribute: + ◇ provide the argument --kms-key on the command line with a fully + specified name; + ◇ provide the argument --key-ring on the command line. + + --kms-key=KMS_KEY + ID of the cryptoKey or fully qualified identifier for the + cryptoKey. + + To set the crypto-key attribute: + ▹ provide the argument --kms-key on the command line. + Update labels. At most one of these can be specified: diff --git a/gcloud/beta/metastore/federations/create b/gcloud/beta/metastore/federations/create index e15f47212..cb7deb26e 100644 --- a/gcloud/beta/metastore/federations/create +++ b/gcloud/beta/metastore/federations/create @@ -6,7 +6,8 @@ SYNOPSIS gcloud beta metastore federations create (FEDERATION : --location=LOCATION) --backends=RANK=BACKEND [--async] [--hive-metastore-version=HIVE_METASTORE_VERSION] - [--labels=[KEY=VALUE,...]] [GCLOUD_WIDE_FLAG ...] + [--labels=[KEY=VALUE,...]] [--tags=[KEY=VALUE,...]] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Create a new Dataproc Metastore federation with the given name and @@ -93,6 +94,9 @@ OPTIONAL FLAGS contain only hyphens (-), underscores (_), lowercase characters, and numbers. + --tags=[KEY=VALUE,...] + List of tag KEY=VALUE pairs to add. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/beta/metastore/services/create b/gcloud/beta/metastore/services/create index 48ce47263..89dc72e2a 100644 --- a/gcloud/beta/metastore/services/create +++ b/gcloud/beta/metastore/services/create @@ -10,6 +10,7 @@ SYNOPSIS [--hive-metastore-version=HIVE_METASTORE_VERSION] [--labels=[KEY=VALUE,...]] [--port=PORT; default=9083] [--release-channel=RELEASE_CHANNEL; default="stable"] + [--tags=[KEY=VALUE,...]] [--auxiliary-versions=[AUXILIARY_VERSIONS,...] | --auxiliary-versions-from-file=AUXILIARY_VERSIONS_FROM_FILE] [--consumer-subnetworks=[CONSUMER_SUBNETWORKS,...] | --network=NETWORK @@ -169,6 +170,9 @@ FLAGS The STABLE release channel contains features that are considered stable and have been validated for production use. + --tags=[KEY=VALUE,...] + List of tag KEY=VALUE pairs to add. + Auxiliary versions configuration for the Dataproc Metastore service. When specified, a secondary Hive metastore service is created along with the primary service. diff --git a/gcloud/beta/netapp/volumes/replications/establish-peering b/gcloud/beta/netapp/volumes/replications/establish-peering index 1f4e93c4e..6ee3433ea 100644 --- a/gcloud/beta/netapp/volumes/replications/establish-peering +++ b/gcloud/beta/netapp/volumes/replications/establish-peering @@ -78,7 +78,8 @@ OPTIONAL FLAGS complete. --peer-ip-addresses=PEER_IP_ADDRESS,[...] - List of ip addresses to be used for peering. + List of ip addresses to be used for peering. This is required for + cluster peering, not required for svm peering. Volume resource - The Volume that the Replication is based on This represents a Cloud resource. (NOTE) Some attributes are not given diff --git a/gcloud/beta/network-security/backend-authentication-configs/create b/gcloud/beta/network-security/backend-authentication-configs/create index 147821604..566ee03c9 100644 --- a/gcloud/beta/network-security/backend-authentication-configs/create +++ b/gcloud/beta/network-security/backend-authentication-configs/create @@ -87,8 +87,10 @@ API REFERENCE for this API can be found at: https://cloud.google.com/networking 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 network-security backend-authentication-configs create $ gcloud alpha network-security backend-authentication-configs create diff --git a/gcloud/beta/network-security/backend-authentication-configs/delete b/gcloud/beta/network-security/backend-authentication-configs/delete index 53d1ffcd6..6f872a411 100644 --- a/gcloud/beta/network-security/backend-authentication-configs/delete +++ b/gcloud/beta/network-security/backend-authentication-configs/delete @@ -72,8 +72,10 @@ API REFERENCE for this API can be found at: https://cloud.google.com/networking 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 network-security backend-authentication-configs delete $ gcloud alpha network-security backend-authentication-configs delete diff --git a/gcloud/beta/network-security/backend-authentication-configs/describe b/gcloud/beta/network-security/backend-authentication-configs/describe index 33a2d7757..76a243d98 100644 --- a/gcloud/beta/network-security/backend-authentication-configs/describe +++ b/gcloud/beta/network-security/backend-authentication-configs/describe @@ -63,8 +63,10 @@ API REFERENCE for this API can be found at: https://cloud.google.com/networking 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 network-security backend-authentication-configs describe $ gcloud alpha network-security backend-authentication-configs \ describe diff --git a/gcloud/beta/network-security/backend-authentication-configs/export b/gcloud/beta/network-security/backend-authentication-configs/export index ceb2b1b60..1451d18fc 100644 --- a/gcloud/beta/network-security/backend-authentication-configs/export +++ b/gcloud/beta/network-security/backend-authentication-configs/export @@ -72,8 +72,10 @@ API REFERENCE for this API can be found at: https://cloud.google.com/networking 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 network-security backend-authentication-configs export $ gcloud alpha network-security backend-authentication-configs export diff --git a/gcloud/beta/network-security/backend-authentication-configs/help b/gcloud/beta/network-security/backend-authentication-configs/help index 1fa0dbc6d..811cd980c 100644 --- a/gcloud/beta/network-security/backend-authentication-configs/help +++ b/gcloud/beta/network-security/backend-authentication-configs/help @@ -36,8 +36,10 @@ COMMANDS (BETA) List BackendAuthenticationConfigs. 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 network-security backend-authentication-configs $ gcloud alpha network-security backend-authentication-configs diff --git a/gcloud/beta/network-security/backend-authentication-configs/import b/gcloud/beta/network-security/backend-authentication-configs/import index bcc91264f..1de71f274 100644 --- a/gcloud/beta/network-security/backend-authentication-configs/import +++ b/gcloud/beta/network-security/backend-authentication-configs/import @@ -78,8 +78,10 @@ API REFERENCE for this API can be found at: https://cloud.google.com/networking 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 network-security backend-authentication-configs import $ gcloud alpha network-security backend-authentication-configs import diff --git a/gcloud/beta/network-security/backend-authentication-configs/list b/gcloud/beta/network-security/backend-authentication-configs/list index 77a2bf6db..b74d309be 100644 --- a/gcloud/beta/network-security/backend-authentication-configs/list +++ b/gcloud/beta/network-security/backend-authentication-configs/list @@ -81,8 +81,10 @@ API REFERENCE for this API can be found at: https://cloud.google.com/networking 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 network-security backend-authentication-configs list $ gcloud alpha network-security backend-authentication-configs list diff --git a/gcloud/beta/network-security/org-address-groups/create b/gcloud/beta/network-security/org-address-groups/create index df99291c9..4edff4d4e 100644 --- a/gcloud/beta/network-security/org-address-groups/create +++ b/gcloud/beta/network-security/org-address-groups/create @@ -6,7 +6,8 @@ SYNOPSIS gcloud beta network-security org-address-groups create (ADDRESS_GROUP : --location=LOCATION --organization=ORGANIZATION) --capacity=CAPACITY --type=TYPE [--async] [--description=DESCRIPTION] - [--items=[ITEMS,...]] [--labels=[KEY=VALUE,...]] [GCLOUD_WIDE_FLAG ...] + [--items=[ITEMS,...]] [--labels=[KEY=VALUE,...]] + [--purpose=[PURPOSE,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Create a new address group with the given name. @@ -73,6 +74,10 @@ OPTIONAL FLAGS --labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to add. + --purpose=[PURPOSE,...] + List of Address Group purposes. PURPOSE must be one of: cloud-armor, + default. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/beta/network-security/org-address-groups/update b/gcloud/beta/network-security/org-address-groups/update index d6e0fbb3a..cd225d08b 100644 --- a/gcloud/beta/network-security/org-address-groups/update +++ b/gcloud/beta/network-security/org-address-groups/update @@ -6,7 +6,7 @@ SYNOPSIS gcloud beta network-security org-address-groups update (ADDRESS_GROUP : --location=LOCATION --organization=ORGANIZATION) [--async] [--description=DESCRIPTION] [--items=[ITEMS,...]] - [--update-labels=[KEY=VALUE,...]] + [--purpose=[PURPOSE,...]] [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -63,6 +63,10 @@ FLAGS --items=[ITEMS,...] Items of the address group. + --purpose=[PURPOSE,...] + List of Address Group purposes. PURPOSE must be one of: cloud-armor, + default. + --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. diff --git a/gcloud/beta/quotas/adjuster/settings/describe b/gcloud/beta/quotas/adjuster/settings/describe index 1f0b81d2c..86be1cc55 100644 --- a/gcloud/beta/quotas/adjuster/settings/describe +++ b/gcloud/beta/quotas/adjuster/settings/describe @@ -1,22 +1,36 @@ NAME gcloud beta quotas adjuster settings describe - gets details of the - QuotaAdjusterSettings for a project + QuotaAdjusterSettings for a resource container SYNOPSIS gcloud beta quotas adjuster settings describe - --project=PROJECT_ID_OR_NUMBER [GCLOUD_WIDE_FLAG ...] + (--folder=FOLDER_ID | --organization=ORGANIZATION_ID + | --project=PROJECT_ID_OR_NUMBER) [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) This command gets the QuotaAdjusterSettings for a project. + (BETA) This command gets the QuotaAdjusterSettings for a resource + container. EXAMPLES - To get the QuotaAdjusterSettings for container 'projects/12321', run: + To get the QuotaAdjusterSettings for 'projects/12321', run: $ gcloud beta quotas adjuster settings describe --project=12321 + To get the QuotaAdjusterSettings for 'folders/123', run: + + $ gcloud beta quotas adjuster settings describe --folder=123 + REQUIRED FLAGS - --project=PROJECT_ID_OR_NUMBER - Project of the container id. + Exactly one of these must be specified: + + --folder=FOLDER_ID + Folder of the container id. + + --organization=ORGANIZATION_ID + Organization of the container id. + + --project=PROJECT_ID_OR_NUMBER + Project of the container id. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/quotas/adjuster/settings/help b/gcloud/beta/quotas/adjuster/settings/help index 6aff46f4c..b7d148f72 100644 --- a/gcloud/beta/quotas/adjuster/settings/help +++ b/gcloud/beta/quotas/adjuster/settings/help @@ -18,10 +18,11 @@ COMMANDS COMMAND is one of the following: describe - (BETA) Gets details of the QuotaAdjusterSettings for a project. + (BETA) Gets details of the QuotaAdjusterSettings for a resource + container. update - (BETA) Update the QuotaAdjusterSettings of a project. + (BETA) Update the QuotaAdjusterSettings of a resource container. NOTES This command is currently in beta and might change without notice. diff --git a/gcloud/beta/quotas/adjuster/settings/update b/gcloud/beta/quotas/adjuster/settings/update index 13124a9be..c2ab2d723 100644 --- a/gcloud/beta/quotas/adjuster/settings/update +++ b/gcloud/beta/quotas/adjuster/settings/update @@ -1,13 +1,15 @@ NAME gcloud beta quotas adjuster settings update - update the - QuotaAdjusterSettings of a project + QuotaAdjusterSettings of a resource container SYNOPSIS gcloud beta quotas adjuster settings update --enablement=ENABLEMENT - --project=PROJECT_ID_OR_NUMBER [--validate-only] [GCLOUD_WIDE_FLAG ...] + (--folder=FOLDER_ID | --organization=ORGANIZATION_ID + | --project=PROJECT_ID_OR_NUMBER) [--validate-only] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) This command updates the enablement state of a project. + (BETA) This command updates the enablement state of a resource container. EXAMPLES To update QuotaAdjusterSettings for projects/12321, run: @@ -15,13 +17,26 @@ EXAMPLES $ gcloud beta quotas adjuster settings update --enablement=enabled \ --project=12321 + To update QuotaAdjusterSettings for folders/123, run: + + $ gcloud beta quotas adjuster settings update \ + --enablement=inherited --folder=123 + REQUIRED FLAGS --enablement=ENABLEMENT Enablement state of the QuotaAdjusterSettings. ENABLEMENT must be one - of: enabled, disabled. + of: enabled, disabled, inherited. - --project=PROJECT_ID_OR_NUMBER - Project of the container id. + Exactly one of these must be specified: + + --folder=FOLDER_ID + Folder of the container id. + + --organization=ORGANIZATION_ID + Organization of the container id. + + --project=PROJECT_ID_OR_NUMBER + Project of the container id. OPTIONAL FLAGS --validate-only diff --git a/gcloud/beta/run/deploy b/gcloud/beta/run/deploy index 8ed5cc9ff..2c67fdcd4 100644 --- a/gcloud/beta/run/deploy +++ b/gcloud/beta/run/deploy @@ -11,7 +11,7 @@ SYNOPSIS [--execution-environment=EXECUTION_ENVIRONMENT] [--gpu-type=GPU_TYPE] [--[no-]gpu-zonal-redundancy] [--[no-]iap] [--ingress=INGRESS; default="all"] [--[no-]invoker-iam-check] - [--max-instances=MAX_INSTANCES] [--mesh=MESH] [--min=MIN] + [--max=MAX] [--max-instances=MAX_INSTANCES] [--mesh=MESH] [--min=MIN] [--min-instances=MIN_INSTANCES] [--region=REGION] [--regions=REGIONS] [--remove-containers=[CONTAINER,...]] [--revision-suffix=REVISION_SUFFIX] [--scaling=SCALING] @@ -219,6 +219,12 @@ FLAGS Use --invoker-iam-check to enable and --no-invoker-iam-check to disable. + --max=MAX + The maximum number of container instances to run for this Service. This + instance limit will be divided among all Revisions receiving a + percentage of traffic and can be modified without deploying a new + Revision. + --max-instances=MAX_INSTANCES The maximum number of container instances for this Revision to run or 'default' to remove. This setting is immutably set on each new Revision diff --git a/gcloud/beta/run/help b/gcloud/beta/run/help index 9f84fcf01..1241b2fa5 100644 --- a/gcloud/beta/run/help +++ b/gcloud/beta/run/help @@ -41,6 +41,9 @@ GROUPS services (BETA) View and manage your Cloud Run services. + worker-pools + (BETA) View and manage your Cloud Run worker pools. + COMMANDS COMMAND is one of the following: diff --git a/gcloud/beta/run/multi-region-services/update b/gcloud/beta/run/multi-region-services/update index 76a2a9269..801436edc 100644 --- a/gcloud/beta/run/multi-region-services/update +++ b/gcloud/beta/run/multi-region-services/update @@ -13,7 +13,7 @@ SYNOPSIS [--execution-environment=EXECUTION_ENVIRONMENT] [--gpu-type=GPU_TYPE] [--[no-]gpu-zonal-redundancy] [--[no-]iap] [--ingress=INGRESS; default="all"] [--[no-]invoker-iam-check] - [--max-instances=MAX_INSTANCES] [--mesh=MESH] [--min=MIN] + [--max=MAX] [--max-instances=MAX_INSTANCES] [--mesh=MESH] [--min=MIN] [--min-instances=MIN_INSTANCES] [--region=REGION] [--remove-containers=[CONTAINER,...]] [--revision-suffix=REVISION_SUFFIX] [--scaling=SCALING] @@ -189,6 +189,12 @@ FLAGS Use --invoker-iam-check to enable and --no-invoker-iam-check to disable. + --max=MAX + The maximum number of container instances to run for this Service. This + instance limit will be divided among all Revisions receiving a + percentage of traffic and can be modified without deploying a new + Revision. + --max-instances=MAX_INSTANCES The maximum number of container instances for this Revision to run or 'default' to remove. This setting is immutably set on each new Revision diff --git a/gcloud/beta/run/services/update b/gcloud/beta/run/services/update index 3a52e0434..e79a3421a 100644 --- a/gcloud/beta/run/services/update +++ b/gcloud/beta/run/services/update @@ -11,7 +11,7 @@ SYNOPSIS [--execution-environment=EXECUTION_ENVIRONMENT] [--gpu-type=GPU_TYPE] [--[no-]gpu-zonal-redundancy] [--[no-]iap] [--ingress=INGRESS; default="all"] [--[no-]invoker-iam-check] - [--max-instances=MAX_INSTANCES] [--mesh=MESH] [--min=MIN] + [--max=MAX] [--max-instances=MAX_INSTANCES] [--mesh=MESH] [--min=MIN] [--min-instances=MIN_INSTANCES] [--region=REGION] [--remove-containers=[CONTAINER,...]] [--revision-suffix=REVISION_SUFFIX] [--scaling=SCALING] @@ -187,6 +187,12 @@ FLAGS Use --invoker-iam-check to enable and --no-invoker-iam-check to disable. + --max=MAX + The maximum number of container instances to run for this Service. This + instance limit will be divided among all Revisions receiving a + percentage of traffic and can be modified without deploying a new + Revision. + --max-instances=MAX_INSTANCES The maximum number of container instances for this Revision to run or 'default' to remove. This setting is immutably set on each new Revision diff --git a/gcloud/beta/run/worker-pools/delete b/gcloud/beta/run/worker-pools/delete new file mode 100644 index 000000000..ff777c3a9 --- /dev/null +++ b/gcloud/beta/run/worker-pools/delete @@ -0,0 +1,69 @@ +NAME + gcloud beta run worker-pools delete - delete a worker-pool + +SYNOPSIS + gcloud beta run worker-pools delete (WORKER_POOL : --region=REGION) + [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Delete a worker-pool. + +EXAMPLES + To delete a worker-pool: + + $ gcloud beta run worker-pools delete + +POSITIONAL ARGUMENTS + WorkerPool resource - WorkerPool 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 WORKER_POOL 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. + + WORKER_POOL + ID of the WorkerPool or fully qualified identifier for the + WorkerPool. + + To set the worker-pool attribute: + ▸ provide the argument WORKER_POOL 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 WorkerPool. Overrides the default run/region + property value for this command invocation. + + To set the region attribute: + ▸ provide the argument WORKER_POOL on the command line with a fully + specified name; + ▸ provide the argument --region on the command line; + ▸ set the property run/region; + ▸ specify the region from an interactive prompt. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha run worker-pools delete + diff --git a/gcloud/beta/run/worker-pools/deploy b/gcloud/beta/run/worker-pools/deploy new file mode 100644 index 000000000..2e59b3eb0 --- /dev/null +++ b/gcloud/beta/run/worker-pools/deploy @@ -0,0 +1,467 @@ +NAME + gcloud beta run worker-pools deploy - create or update a Cloud Run + worker-pool + +SYNOPSIS + gcloud beta run worker-pools deploy [[WORKER_POOL] --region=REGION] + [--async] [--breakglass=JUSTIFICATION] [--container=CONTAINER] + [--description=DESCRIPTION] [--mesh=MESH] [--no-promote] + [--remove-containers=[CONTAINER,...]] + [--revision-suffix=REVISION_SUFFIX] [--scaling=SCALING] + [--service-account=SERVICE_ACCOUNT] [--vpc-egress=VPC_EGRESS] + [--add-cloudsql-instances=[CLOUDSQL-INSTANCES,...] + | --clear-cloudsql-instances + | --remove-cloudsql-instances=[CLOUDSQL-INSTANCES,...] + | --set-cloudsql-instances=[CLOUDSQL-INSTANCES,...]] + [--add-volume=[KEY=VALUE,...] + --clear-volumes --remove-volume=[VOLUME,...]] + [--add-volume-mount=[volume=NAME,mount-path=MOUNT_PATH,...] + --args=[ARG,...] --clear-volume-mounts --command=[COMMAND,...] + --cpu=CPU --depends-on=[CONTAINER,...] --memory=MEMORY + --remove-volume-mount=[MOUNT_PATH,...] --clear-env-vars + | --env-vars-file=FILE_PATH | --set-env-vars=[KEY=VALUE,...] + | --remove-env-vars=[KEY,...] + --update-env-vars=[KEY=VALUE,...] --clear-secrets + | --set-secrets=[KEY=VALUE,...] | --remove-secrets=[KEY,...] + --update-secrets=[KEY=VALUE,...] --image=IMAGE | --source=SOURCE] + [--binary-authorization=POLICY | --clear-binary-authorization] + [--clear-encryption-key-shutdown-hours + | --encryption-key-shutdown-hours=ENCRYPTION_KEY_SHUTDOWN_HOURS] + [--clear-key | --key=KEY] + [--clear-labels | --remove-labels=[KEY,...] --labels=[KEY=VALUE,...] + | --update-labels=[KEY=VALUE,...]] + [--clear-network + | --network=NETWORK --subnet=SUBNET --clear-network-tags + | --network-tags=[TAG,...]] + [--clear-post-key-revocation-action-type + | --post-key-revocation-action-type=POST_KEY_REVOCATION_ACTION_TYPE] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Creates or updates a Cloud Run worker-pool. + +EXAMPLES + To deploy a container to the worker-pool my-backend on Cloud Run: + + $ gcloud beta run worker-pools deploy my-backend \ + --image=us-docker.pkg.dev/project/image + + You may also omit the worker-pool name. Then a prompt will be displayed + with a suggested default value: + + $ gcloud beta run worker-pools deploy \ + --image=us-docker.pkg.dev/project/image + +POSITIONAL ARGUMENTS + WorkerPool resource - WorkerPool to deploy to. 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 WORKER_POOL on the command line with a fully + specified name; + ◆ specify the workerpool name from an interactive prompt with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + [WORKER_POOL] + ID of the WorkerPool or fully qualified identifier for the + WorkerPool. + + To set the worker-pool attribute: + ▸ provide the argument WORKER_POOL on the command line; + ▸ specify the workerpool name from an interactive prompt. + + --region=REGION + The Cloud region for the WorkerPool. Overrides the default run/region + property value for this command invocation. + + To set the region attribute: + ▸ provide the argument WORKER_POOL on the command line with a fully + specified name; + ▸ specify the workerpool name from an interactive prompt with a + fully specified name; + ▸ provide the argument --region on the command line; + ▸ set the property run/region; + ▸ specify the region from an interactive prompt. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --breakglass=JUSTIFICATION + Justification to bypass Binary Authorization policy constraints and + allow the operation. See + https://cloud.google.com/binary-authorization/docs/using-breakglass for + more information. Next update or deploy command will automatically + clear existing breakglass justification. + + --container=CONTAINER + Specifies a container by name. Flags following --container will apply + to the specified container. + + Flags that are not container-specific must be specified before + --container. + + --description=DESCRIPTION + Provides an optional, human-readable description of the service. + + --mesh=MESH + Enables Cloud Service Mesh using the specified mesh resource name. Mesh + resource name must be in the format of + projects/PROJECT/locations/global/meshes/MESH_NAME or MESH_NAME. Will + default to the current project if only MESH_NAME is provided. + + --no-promote + True to avoid assign instances to the worker revision being deployed. + Setting this flag assigns any instances assigned to the LATEST revision + to the specific revision bound to LATEST before the deployment. The + effect is that the revision being deployed will not receive instance + split. + + After a deployment with this flag the LATEST revision will not receive + instances on future deployments. To restore assinging instances to the + LATEST revision by default, run the gcloud run workers + update-instance-split command with --to-latest. + + --remove-containers=[CONTAINER,...] + List of containers to remove. + + --revision-suffix=REVISION_SUFFIX + Specify the suffix of the revision name. Revision names always start + with the service name automatically. For example, specifying + [--revision-suffix=v1] for a service named 'helloworld', would lead to + a revision named 'helloworld-v1'. Set empty string to clear the suffix + and resume server-assigned naming. + + --scaling=SCALING + The scaling mode to use for this resource. Flag value should be a + positive integer to configure manual scaling with the given integer as + a fixed instance count. + + --service-account=SERVICE_ACCOUNT + the email address of an IAM service account associated with the + revision of the service. The service account represents the identity of + the running revision, and determines what permissions the revision has. + + --vpc-egress=VPC_EGRESS + Specify which of the outbound traffic to send through Direct VPC egress + or the VPC connector for this resource. This resource must have Direct + VPC egress enabled or a VPC connector to set this flag. VPC_EGRESS must + be one of: + + all + (DEPRECATED) Sends all outbound traffic through Direct VPC egress + or the VPC connector. Provides the same functionality as + 'all-traffic'. Prefer to use 'all-traffic' instead. + all-traffic + Sends all outbound traffic through Direct VPC egress or the VPC + connector. + private-ranges-only + Default option. Sends outbound traffic to private IP addresses (RFC + 1918 and Private Google Access IPs) through Direct VPC egress or + the VPC connector. + + Traffic to other Cloud Run services might require additional + configuration. See + https://cloud.google.com/run/docs/securing/private-networking#send_requests_to_other_services_and_services + for more information. + + These flags modify the Cloud SQL instances this WorkerPool connects to. + You can specify a name of a Cloud SQL instance if it's in the same project + and region as your Cloud Run worker pool; otherwise specify + :: for the instance. + + At most one of these can be specified: + + --add-cloudsql-instances=[CLOUDSQL-INSTANCES,...] + Append the given values to the current Cloud SQL instances. + + --clear-cloudsql-instances + Empty the current Cloud SQL instances. + + --remove-cloudsql-instances=[CLOUDSQL-INSTANCES,...] + Remove the given values from the current Cloud SQL instances. + + --set-cloudsql-instances=[CLOUDSQL-INSTANCES,...] + Completely replace the current Cloud SQL instances with the given + values. + + --add-volume=[KEY=VALUE,...] + Adds a volume to the Cloud Run resource. To add more than one volume, + specify this flag multiple times. Volumes must have a name and type + key. Only certain values are supported for type. Depending on the + provided type, other keys will be required. The following types are + supported with the specified additional keys: + + cloud-storage: A volume representing a Cloud Storage bucket. This + volume type is mounted using Cloud Storage FUSE. See + https://cloud.google.com/storage/docs/gcs-fuse for the details and + limitations of this filesystem. Additional keys: + ◆ bucket: (required) the name of the bucket to use as the source of + this volume + ◆ readonly: (optional) A boolean. If true, this volume will be + read-only from all mounts. + ◆ mount-options: (optional) A list of flags to pass to GCSFuse. Flags + should be specified without leading dashes and separated by + semicolons. + + in-memory: An ephemeral volume that stores data in the instance's + memory. With this type of volume, data is not shared between instances + and all data will be lost when the instance it is on is terminated. + Additional keys: + ◆ size-limit: (optional) A quantity representing the maximum amount + of memory allocated to this volume, such as "512Mi" or "3G". Data + stored in an in-memory volume consumes the memory allocation of the + container that wrote the data. If size-limit is not specified, the + maximum size will be half the total memory limit of all containers. + + nfs: Represents a volume backed by an NFS server. Additional keys: + ◆ location: (required) The location of the NFS Server, in the form + SERVER:/PATH + ◆ readonly: (optional) A boolean. If true, this volume will be + read-only from all mounts. + + --clear-volumes + Remove all existing volumes from the Cloud Run resource, including + volumes mounted as secrets + + --remove-volume=[VOLUME,...] + Removes volumes from the Cloud Run resource. + + Container Flags + + The following flags apply to the container. + + --add-volume-mount=[volume=NAME,mount-path=MOUNT_PATH,...] + Adds a mount to the current container. Must contain the keys + volume=NAME and mount-path=/PATH where NAME is the name of a volume + on this resource and PATH is the path within the container's + filesystem to mount this volume. + + --args=[ARG,...] + Comma-separated arguments passed to the command run by the + container image. If not specified and no '--command' is provided, + the container image's default Cmd is used. Otherwise, if not + specified, no arguments are passed. To reset this field to its + default, pass an empty string. + + --clear-volume-mounts + Remove all existing mounts from the current container. + + --command=[COMMAND,...] + Entrypoint for the container image. If not specified, the container + image's default Entrypoint is run. To reset this field to its + default, pass an empty string. + + --cpu=CPU + Set a CPU limit in Kubernetes cpu units. + + Cloud Run supports values fractional values below 1, 1, 2, 4, and + 8. Some CPU values requires a minimum Memory --memory value. + + --depends-on=[CONTAINER,...] + List of container dependencies to add to the current container. + + --memory=MEMORY + Set a memory limit. Ex: 1024Mi, 4Gi. + + --remove-volume-mount=[MOUNT_PATH,...] + Removes the volume mounted at the specified path from the current + container. + + At most one of these can be specified: + + --clear-env-vars + Remove all environment variables. + + --env-vars-file=FILE_PATH + Path to a local YAML file with definitions for all environment + variables. All existing environment variables will be removed + before the new environment variables are added. Example YAML + content: + + KEY_1: "value1" + KEY_2: "value 2" + + --set-env-vars=[KEY=VALUE,...] + List of key-value pairs to set as environment variables. All + existing environment variables will be removed first. + + Only --update-env-vars and --remove-env-vars can be used together. + If both are specified, --remove-env-vars will be applied first. + + --remove-env-vars=[KEY,...] + List of environment variables to be removed. + + --update-env-vars=[KEY=VALUE,...] + List of key-value pairs to set as environment variables. + + Specify secrets to provide as environment variables. For example: + '--set-secrets=ENV=mysecret:latest,OTHER_ENV=othersecret:1' will + create an environment variable named ENV whose value is the latest + version of secret 'mysecret' and an environment variable OTHER_ENV + whose value is version of 1 of secret 'othersecret'. + + At most one of these can be specified: + + --clear-secrets + Remove all secrets. + + --set-secrets=[KEY=VALUE,...] + List of key-value pairs to set as secrets. All existing secrets + will be removed first. + + Only --update-secrets and --remove-secrets can be used together. If + both are specified, --remove-secrets will be applied first. + + --remove-secrets=[KEY,...] + List of secrets to be removed. + + --update-secrets=[KEY=VALUE,...] + List of key-value pairs to set as secrets. + + At most one of these can be specified: + + --image=IMAGE + Name of the container image to deploy (e.g. + us-docker.pkg.dev/cloudrun/container/hello:latest). + + --source=SOURCE + The location of the source to build. If a Dockerfile is present + in the source code directory, it will be built using that + Dockerfile, otherwise it will use Google Cloud buildpacks. See + https://cloud.google.com/run/docs/deploying-source-code for more + details. The location can be a directory on a local disk or a + gzipped archive file (.tar.gz) in Google Cloud Storage. If the + source is a local directory, this command skips the files + specified in the --ignore-file. If --ignore-file is not + specified, use .gcloudignore file. If a .gcloudignore file is + absent and a .gitignore file is present in the local source + directory, gcloud will use a generated Git-compatible + .gcloudignore file that respects your .gitignored files. The + global .gitignore is not respected. For more information on + .gcloudignore, see gcloud topic gcloudignore. + + At most one of these can be specified: + + --binary-authorization=POLICY + Binary Authorization policy to check against. This must be set to + "default". + + --clear-binary-authorization + Remove any previously set Binary Authorization policy. + + At most one of these can be specified: + + --clear-encryption-key-shutdown-hours + Remove any previously set CMEK key shutdown hours setting. + + --encryption-key-shutdown-hours=ENCRYPTION_KEY_SHUTDOWN_HOURS + The number of hours to wait before an automatic shutdown server after + CMEK key revocation is detected. + + At most one of these can be specified: + + --clear-key + Remove any previously set CMEK key reference. + + --key=KEY + CMEK key reference to encrypt the container with. + + At most one of these can be specified: + + --clear-labels + Remove all labels. If --update-labels is also specified then + --clear-labels is applied first. + + For example, to remove all labels: + + $ gcloud beta run worker-pools deploy --clear-labels + + To remove all existing labels and create two new labels, foo and baz: + + $ gcloud beta run worker-pools deploy --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. + + At most one of these can be specified: + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + An alias to --update-labels. + + --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. + + At most one of these can be specified: + + --clear-network + Disconnect this Cloud Run worker from the VPC network it is connected + to. + + Direct VPC egress setting flags group. + + --network=NETWORK + The VPC network that the Cloud Run worker will be able to send + traffic to. If --subnet is also specified, subnet must be a + subnetwork of the network specified by this --network flag. To + clear existing VPC network settings, use --clear-network. + + --subnet=SUBNET + The VPC subnetwork that the Cloud Run worker will get IPs from. The + subnetwork must be /26 or larger. If --network is also specified, + subnet must be a subnetwork of the network specified by the + --network flag. If --network is not specified, network will be + looked up from this subnetwork. To clear existing VPC network + settings, use --clear-network. + + At most one of these can be specified: + + --clear-network-tags + Clears all existing Compute Engine tags from the Cloud Run + worker. + + --network-tags=[TAG,...] + Applies the given Compute Engine tags (comma separated) to the + Cloud Run worker. To clear existing tags, use + --clear-network-tags. + + At most one of these can be specified: + + --clear-post-key-revocation-action-type + Remove any previously set post CMEK key revocation action type. + + --post-key-revocation-action-type=POST_KEY_REVOCATION_ACTION_TYPE + Action type after CMEK key revocation. + POST_KEY_REVOCATION_ACTION_TYPE must be one of: + + prevent-new + No new instances will be started after CMEK key revocation. + shut-down + No new instances will be started and the existing instances will + be shut down after CMEK key revocation. + +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 run worker-pools deploy + diff --git a/gcloud/beta/run/worker-pools/describe b/gcloud/beta/run/worker-pools/describe new file mode 100644 index 000000000..b56969dbc --- /dev/null +++ b/gcloud/beta/run/worker-pools/describe @@ -0,0 +1,66 @@ +NAME + gcloud beta run worker-pools describe - obtain details about a given + worker-pool + +SYNOPSIS + gcloud beta run worker-pools describe WORKER_POOL [--region=REGION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Obtain details about a given worker-pool. + +EXAMPLES + To obtain details about a given worker-pool: + + $ gcloud beta run worker-pools describe + + To get those details in the YAML format: + + $ gcloud beta run worker-pools describe \ + --format=yaml + + To get them in YAML format suited to export (omitting metadata specific to + this deployment and status info): + + $ gcloud beta run worker-pools describe \ + --format=export + +POSITIONAL ARGUMENTS + WorkerPool resource - WorkerPool to describe. This represents a Cloud + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument WORKER_POOL 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. + + WORKER_POOL + ID of the WorkerPool or fully qualified identifier for the + WorkerPool. + + To set the worker-pool attribute: + ▸ provide the argument WORKER_POOL on the command line. + +FLAGS + --region=REGION + Region in which the resource can be found. Alternatively, set the + property [run/region]. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha run worker-pools describe + diff --git a/gcloud/beta/run/worker-pools/help b/gcloud/beta/run/worker-pools/help new file mode 100644 index 000000000..f8b1cddec --- /dev/null +++ b/gcloud/beta/run/worker-pools/help @@ -0,0 +1,58 @@ +NAME + gcloud beta run worker-pools - view and manage your Cloud Run worker pools + +SYNOPSIS + gcloud beta run worker-pools GROUP | COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) This set of commands can be used to view and manage your Cloud Run + worker pools. + +EXAMPLES + To list your existing worker-pools, run: + + $ gcloud beta run worker-pools list + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + revisions + (BETA) View and manage your Cloud Run WorkerPools revisions. + +COMMANDS + COMMAND is one of the following: + + delete + (BETA) Delete a worker-pool. + + deploy + (BETA) Create or update a Cloud Run worker-pool. + + describe + (BETA) Obtain details about a given worker-pool. + + list + (BETA) List available worker-pools. + + replace + (BETA) Create or replace a worker-pool from a YAML worker-pool + specification. + + update + (BETA) Update Cloud Run environment variables and other configuration + settings. + + update-instance-split + (BETA) Adjust the instance assignments for a Cloud Run worker-pool. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha run worker-pools + diff --git a/gcloud/beta/run/worker-pools/list b/gcloud/beta/run/worker-pools/list new file mode 100644 index 000000000..689e297af --- /dev/null +++ b/gcloud/beta/run/worker-pools/list @@ -0,0 +1,67 @@ +NAME + gcloud beta run worker-pools list - list available worker-pools + +SYNOPSIS + gcloud beta run worker-pools list [--region=REGION] [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) List available worker-pools. + +EXAMPLES + To list available worker-pools: + + $ gcloud beta run worker-pools list + +FLAGS + --region=REGION + Region in which the resource can be found. Alternatively, set the + property [run/region]. + +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. This + variant is also available: + + $ gcloud alpha run worker-pools list + diff --git a/gcloud/beta/run/worker-pools/replace b/gcloud/beta/run/worker-pools/replace new file mode 100644 index 000000000..de3158a05 --- /dev/null +++ b/gcloud/beta/run/worker-pools/replace @@ -0,0 +1,46 @@ +NAME + gcloud beta run worker-pools replace - create or replace a worker-pool from + a YAML worker-pool specification + +SYNOPSIS + gcloud beta run worker-pools replace FILE [--async] [--dry-run] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Creates or replaces a worker-pool from a YAML worker-pool + specification. + +EXAMPLES + To replace the specification for a worker-pool defined in + my-worker-pool.yaml + + $ gcloud beta run worker-pools replace my-worker-pool.yaml + +POSITIONAL ARGUMENTS + FILE + The absolute path to the YAML file with a Cloud Run worker-pool + definition for the worker-pool to update or create. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --dry-run + If set to true, only validates the configuration. The configuration + will not be applied. + +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 run worker-pools replace + diff --git a/gcloud/beta/run/worker-pools/revisions/delete b/gcloud/beta/run/worker-pools/revisions/delete new file mode 100644 index 000000000..f8a35cb7f --- /dev/null +++ b/gcloud/beta/run/worker-pools/revisions/delete @@ -0,0 +1,81 @@ +NAME + gcloud beta run worker-pools revisions delete - delete a worker pool + revision + +SYNOPSIS + gcloud beta run worker-pools revisions delete + (WORKER_POOL_REVISION : --region=REGION --worker-pool=WORKER_POOL) + [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Delete a worker pool revision. + +EXAMPLES + To delete a revision rev1 of a worker pool worker1 in us-central1: + + $ gcloud beta run worker-pools revisions delete rev1 \ + --region=us-central1 --workerpool=worker1 + +POSITIONAL ARGUMENTS + WorkerPoolRevision resource - Worker pool revision 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 WORKER_POOL_REVISION 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. + + WORKER_POOL_REVISION + ID of the WorkerPoolRevision or fully qualified identifier for the + WorkerPoolRevision. + + To set the revision attribute: + ▸ provide the argument WORKER_POOL_REVISION 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 WorkerPoolRevision. Overrides the default + run/region property value for this command invocation. + + To set the region attribute: + ▸ provide the argument WORKER_POOL_REVISION on the command line + with a fully specified name; + ▸ provide the argument --region on the command line; + ▸ set the property run/region; + ▸ specify the region from an interactive prompt. + + --worker-pool=WORKER_POOL + WorkerPool for the WorkerPoolRevision. + + To set the worker-pool attribute: + ▸ provide the argument WORKER_POOL_REVISION on the command line + with a fully specified name; + ▸ provide the argument --worker-pool on the command line; + ▸ specify the workerpool name from an interactive prompt. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha run worker-pools revisions delete + diff --git a/gcloud/beta/run/worker-pools/revisions/describe b/gcloud/beta/run/worker-pools/revisions/describe new file mode 100644 index 000000000..519a1a292 --- /dev/null +++ b/gcloud/beta/run/worker-pools/revisions/describe @@ -0,0 +1,55 @@ +NAME + gcloud beta run worker-pools revisions describe - obtain details about a + given worker pool revision + +SYNOPSIS + gcloud beta run worker-pools revisions describe WORKER_POOL_REVISION + [--region=REGION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Obtain details about a given worker pool revision. + +EXAMPLES + To describe a revision rev.1 of a worker pool worker1 in us-central1: + + $ gcloud beta run worker-pools revisions describe rev.1 \ + --region=us-central1 --workerpool=worker1 + +POSITIONAL ARGUMENTS + Revision resource - Worker pool revision to describe. This represents a + Cloud resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument WORKER_POOL_REVISION 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. + + WORKER_POOL_REVISION + ID of the revision or fully qualified identifier for the revision. + + To set the revision attribute: + ▸ provide the argument WORKER_POOL_REVISION on the command line. + +FLAGS + --region=REGION + Region in which the resource can be found. Alternatively, set the + property [run/region]. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha run worker-pools revisions describe + diff --git a/gcloud/beta/run/worker-pools/revisions/help b/gcloud/beta/run/worker-pools/revisions/help new file mode 100644 index 000000000..ef000317d --- /dev/null +++ b/gcloud/beta/run/worker-pools/revisions/help @@ -0,0 +1,39 @@ +NAME + gcloud beta run worker-pools revisions - view and manage your Cloud Run + WorkerPools revisions + +SYNOPSIS + gcloud beta run worker-pools revisions COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) This set of commands can be used to view and manage your existing + Cloud Run WorkerPools revisions. + +EXAMPLES + To list your existing worker pools revisions, run: + + $ gcloud beta run worker-pools revisions list + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + delete + (BETA) Delete a worker pool revision. + + describe + (BETA) Obtain details about a given worker pool revision. + + list + (BETA) List available worker pool revisions. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha run worker-pools revisions + diff --git a/gcloud/beta/run/worker-pools/revisions/list b/gcloud/beta/run/worker-pools/revisions/list new file mode 100644 index 000000000..c2db75907 --- /dev/null +++ b/gcloud/beta/run/worker-pools/revisions/list @@ -0,0 +1,72 @@ +NAME + gcloud beta run worker-pools revisions list - list available worker pool + revisions + +SYNOPSIS + gcloud beta run worker-pools revisions list [--region=REGION] + [--worker-pool=WORKER_POOL] [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) List available worker pool revisions. + +EXAMPLES + To list all revisions in a worker pool foo: + + $ gcloud beta run worker-pools revisions list --worker-pool=foo + +FLAGS + --region=REGION + Region in which the resource can be found. Alternatively, set the + property [run/region]. + + --worker-pool=WORKER_POOL + Limit matched revisions to the given worker. + +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. This + variant is also available: + + $ gcloud alpha run worker-pools revisions list + diff --git a/gcloud/beta/run/worker-pools/update b/gcloud/beta/run/worker-pools/update new file mode 100644 index 000000000..fa93ef852 --- /dev/null +++ b/gcloud/beta/run/worker-pools/update @@ -0,0 +1,444 @@ +NAME + gcloud beta run worker-pools update - update Cloud Run environment + variables and other configuration settings + +SYNOPSIS + gcloud beta run worker-pools update [[WORKER_POOL] --region=REGION] + [--async] [--breakglass=JUSTIFICATION] [--container=CONTAINER] + [--description=DESCRIPTION] [--mesh=MESH] [--no-promote] + [--remove-containers=[CONTAINER,...]] + [--revision-suffix=REVISION_SUFFIX] [--scaling=SCALING] + [--service-account=SERVICE_ACCOUNT] [--vpc-egress=VPC_EGRESS] + [--add-cloudsql-instances=[CLOUDSQL-INSTANCES,...] + | --clear-cloudsql-instances + | --remove-cloudsql-instances=[CLOUDSQL-INSTANCES,...] + | --set-cloudsql-instances=[CLOUDSQL-INSTANCES,...]] + [--add-volume=[KEY=VALUE,...] + --clear-volumes --remove-volume=[VOLUME,...]] + [--add-volume-mount=[volume=NAME,mount-path=MOUNT_PATH,...] + --args=[ARG,...] --clear-volume-mounts --command=[COMMAND,...] + --cpu=CPU --depends-on=[CONTAINER,...] --image=IMAGE --memory=MEMORY + --remove-volume-mount=[MOUNT_PATH,...] --clear-env-vars + | --env-vars-file=FILE_PATH | --set-env-vars=[KEY=VALUE,...] + | --remove-env-vars=[KEY,...] + --update-env-vars=[KEY=VALUE,...] --clear-secrets + | --set-secrets=[KEY=VALUE,...] + | --remove-secrets=[KEY,...] --update-secrets=[KEY=VALUE,...]] + [--binary-authorization=POLICY | --clear-binary-authorization] + [--clear-encryption-key-shutdown-hours + | --encryption-key-shutdown-hours=ENCRYPTION_KEY_SHUTDOWN_HOURS] + [--clear-key | --key=KEY] + [--clear-labels | --remove-labels=[KEY,...] --labels=[KEY=VALUE,...] + | --update-labels=[KEY=VALUE,...]] + [--clear-network + | --network=NETWORK --subnet=SUBNET --clear-network-tags + | --network-tags=[TAG,...]] + [--clear-post-key-revocation-action-type + | --post-key-revocation-action-type=POST_KEY_REVOCATION_ACTION_TYPE] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Update Cloud Run environment variables and other configuration + settings. + +EXAMPLES + To update one or more env vars: + + $ gcloud beta run worker-pools update myworkerpool \ + --update-env-vars=KEY1=VALUE1,KEY2=VALUE2 + +POSITIONAL ARGUMENTS + WorkerPool resource - WorkerPool to update the configuration 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 WORKER_POOL on the command line with a fully + specified name; + ◆ specify the workerpool name from an interactive prompt with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + [WORKER_POOL] + ID of the WorkerPool or fully qualified identifier for the + WorkerPool. + + To set the worker-pool attribute: + ▸ provide the argument WORKER_POOL on the command line; + ▸ specify the workerpool name from an interactive prompt. + + --region=REGION + The Cloud region for the WorkerPool. Overrides the default run/region + property value for this command invocation. + + To set the region attribute: + ▸ provide the argument WORKER_POOL on the command line with a fully + specified name; + ▸ specify the workerpool name from an interactive prompt with a + fully specified name; + ▸ provide the argument --region on the command line; + ▸ set the property run/region; + ▸ specify the region from an interactive prompt. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --breakglass=JUSTIFICATION + Justification to bypass Binary Authorization policy constraints and + allow the operation. See + https://cloud.google.com/binary-authorization/docs/using-breakglass for + more information. Next update or deploy command will automatically + clear existing breakglass justification. + + --container=CONTAINER + Specifies a container by name. Flags following --container will apply + to the specified container. + + Flags that are not container-specific must be specified before + --container. + + --description=DESCRIPTION + Provides an optional, human-readable description of the service. + + --mesh=MESH + Enables Cloud Service Mesh using the specified mesh resource name. Mesh + resource name must be in the format of + projects/PROJECT/locations/global/meshes/MESH_NAME or MESH_NAME. Will + default to the current project if only MESH_NAME is provided. + + --no-promote + True to avoid assign instances to the worker revision being deployed. + Setting this flag assigns any instances assigned to the LATEST revision + to the specific revision bound to LATEST before the deployment. The + effect is that the revision being deployed will not receive instance + split. + + After a deployment with this flag the LATEST revision will not receive + instances on future deployments. To restore assinging instances to the + LATEST revision by default, run the gcloud run workers + update-instance-split command with --to-latest. + + --remove-containers=[CONTAINER,...] + List of containers to remove. + + --revision-suffix=REVISION_SUFFIX + Specify the suffix of the revision name. Revision names always start + with the service name automatically. For example, specifying + [--revision-suffix=v1] for a service named 'helloworld', would lead to + a revision named 'helloworld-v1'. Set empty string to clear the suffix + and resume server-assigned naming. + + --scaling=SCALING + The scaling mode to use for this resource. Flag value should be a + positive integer to configure manual scaling with the given integer as + a fixed instance count. + + --service-account=SERVICE_ACCOUNT + the email address of an IAM service account associated with the + revision of the service. The service account represents the identity of + the running revision, and determines what permissions the revision has. + + --vpc-egress=VPC_EGRESS + Specify which of the outbound traffic to send through Direct VPC egress + or the VPC connector for this resource. This resource must have Direct + VPC egress enabled or a VPC connector to set this flag. VPC_EGRESS must + be one of: + + all + (DEPRECATED) Sends all outbound traffic through Direct VPC egress + or the VPC connector. Provides the same functionality as + 'all-traffic'. Prefer to use 'all-traffic' instead. + all-traffic + Sends all outbound traffic through Direct VPC egress or the VPC + connector. + private-ranges-only + Default option. Sends outbound traffic to private IP addresses (RFC + 1918 and Private Google Access IPs) through Direct VPC egress or + the VPC connector. + + Traffic to other Cloud Run services might require additional + configuration. See + https://cloud.google.com/run/docs/securing/private-networking#send_requests_to_other_services_and_services + for more information. + + These flags modify the Cloud SQL instances this WorkerPool connects to. + You can specify a name of a Cloud SQL instance if it's in the same project + and region as your Cloud Run worker pool; otherwise specify + :: for the instance. + + At most one of these can be specified: + + --add-cloudsql-instances=[CLOUDSQL-INSTANCES,...] + Append the given values to the current Cloud SQL instances. + + --clear-cloudsql-instances + Empty the current Cloud SQL instances. + + --remove-cloudsql-instances=[CLOUDSQL-INSTANCES,...] + Remove the given values from the current Cloud SQL instances. + + --set-cloudsql-instances=[CLOUDSQL-INSTANCES,...] + Completely replace the current Cloud SQL instances with the given + values. + + --add-volume=[KEY=VALUE,...] + Adds a volume to the Cloud Run resource. To add more than one volume, + specify this flag multiple times. Volumes must have a name and type + key. Only certain values are supported for type. Depending on the + provided type, other keys will be required. The following types are + supported with the specified additional keys: + + cloud-storage: A volume representing a Cloud Storage bucket. This + volume type is mounted using Cloud Storage FUSE. See + https://cloud.google.com/storage/docs/gcs-fuse for the details and + limitations of this filesystem. Additional keys: + ◆ bucket: (required) the name of the bucket to use as the source of + this volume + ◆ readonly: (optional) A boolean. If true, this volume will be + read-only from all mounts. + ◆ mount-options: (optional) A list of flags to pass to GCSFuse. Flags + should be specified without leading dashes and separated by + semicolons. + + in-memory: An ephemeral volume that stores data in the instance's + memory. With this type of volume, data is not shared between instances + and all data will be lost when the instance it is on is terminated. + Additional keys: + ◆ size-limit: (optional) A quantity representing the maximum amount + of memory allocated to this volume, such as "512Mi" or "3G". Data + stored in an in-memory volume consumes the memory allocation of the + container that wrote the data. If size-limit is not specified, the + maximum size will be half the total memory limit of all containers. + + nfs: Represents a volume backed by an NFS server. Additional keys: + ◆ location: (required) The location of the NFS Server, in the form + SERVER:/PATH + ◆ readonly: (optional) A boolean. If true, this volume will be + read-only from all mounts. + + --clear-volumes + Remove all existing volumes from the Cloud Run resource, including + volumes mounted as secrets + + --remove-volume=[VOLUME,...] + Removes volumes from the Cloud Run resource. + + Container Flags + + The following flags apply to the container. + + --add-volume-mount=[volume=NAME,mount-path=MOUNT_PATH,...] + Adds a mount to the current container. Must contain the keys + volume=NAME and mount-path=/PATH where NAME is the name of a volume + on this resource and PATH is the path within the container's + filesystem to mount this volume. + + --args=[ARG,...] + Comma-separated arguments passed to the command run by the + container image. If not specified and no '--command' is provided, + the container image's default Cmd is used. Otherwise, if not + specified, no arguments are passed. To reset this field to its + default, pass an empty string. + + --clear-volume-mounts + Remove all existing mounts from the current container. + + --command=[COMMAND,...] + Entrypoint for the container image. If not specified, the container + image's default Entrypoint is run. To reset this field to its + default, pass an empty string. + + --cpu=CPU + Set a CPU limit in Kubernetes cpu units. + + Cloud Run supports values fractional values below 1, 1, 2, 4, and + 8. Some CPU values requires a minimum Memory --memory value. + + --depends-on=[CONTAINER,...] + List of container dependencies to add to the current container. + + --image=IMAGE + Name of the container image to deploy (e.g. + us-docker.pkg.dev/cloudrun/container/hello:latest). + + --memory=MEMORY + Set a memory limit. Ex: 1024Mi, 4Gi. + + --remove-volume-mount=[MOUNT_PATH,...] + Removes the volume mounted at the specified path from the current + container. + + At most one of these can be specified: + + --clear-env-vars + Remove all environment variables. + + --env-vars-file=FILE_PATH + Path to a local YAML file with definitions for all environment + variables. All existing environment variables will be removed + before the new environment variables are added. Example YAML + content: + + KEY_1: "value1" + KEY_2: "value 2" + + --set-env-vars=[KEY=VALUE,...] + List of key-value pairs to set as environment variables. All + existing environment variables will be removed first. + + Only --update-env-vars and --remove-env-vars can be used together. + If both are specified, --remove-env-vars will be applied first. + + --remove-env-vars=[KEY,...] + List of environment variables to be removed. + + --update-env-vars=[KEY=VALUE,...] + List of key-value pairs to set as environment variables. + + Specify secrets to provide as environment variables. For example: + '--set-secrets=ENV=mysecret:latest,OTHER_ENV=othersecret:1' will + create an environment variable named ENV whose value is the latest + version of secret 'mysecret' and an environment variable OTHER_ENV + whose value is version of 1 of secret 'othersecret'. + + At most one of these can be specified: + + --clear-secrets + Remove all secrets. + + --set-secrets=[KEY=VALUE,...] + List of key-value pairs to set as secrets. All existing secrets + will be removed first. + + Only --update-secrets and --remove-secrets can be used together. If + both are specified, --remove-secrets will be applied first. + + --remove-secrets=[KEY,...] + List of secrets to be removed. + + --update-secrets=[KEY=VALUE,...] + List of key-value pairs to set as secrets. + + At most one of these can be specified: + + --binary-authorization=POLICY + Binary Authorization policy to check against. This must be set to + "default". + + --clear-binary-authorization + Remove any previously set Binary Authorization policy. + + At most one of these can be specified: + + --clear-encryption-key-shutdown-hours + Remove any previously set CMEK key shutdown hours setting. + + --encryption-key-shutdown-hours=ENCRYPTION_KEY_SHUTDOWN_HOURS + The number of hours to wait before an automatic shutdown server after + CMEK key revocation is detected. + + At most one of these can be specified: + + --clear-key + Remove any previously set CMEK key reference. + + --key=KEY + CMEK key reference to encrypt the container with. + + At most one of these can be specified: + + --clear-labels + Remove all labels. If --update-labels is also specified then + --clear-labels is applied first. + + For example, to remove all labels: + + $ gcloud beta run worker-pools update --clear-labels + + To remove all existing labels and create two new labels, foo and baz: + + $ gcloud beta run worker-pools 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. + + At most one of these can be specified: + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + An alias to --update-labels. + + --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. + + At most one of these can be specified: + + --clear-network + Disconnect this Cloud Run worker from the VPC network it is connected + to. + + Direct VPC egress setting flags group. + + --network=NETWORK + The VPC network that the Cloud Run worker will be able to send + traffic to. If --subnet is also specified, subnet must be a + subnetwork of the network specified by this --network flag. To + clear existing VPC network settings, use --clear-network. + + --subnet=SUBNET + The VPC subnetwork that the Cloud Run worker will get IPs from. The + subnetwork must be /26 or larger. If --network is also specified, + subnet must be a subnetwork of the network specified by the + --network flag. If --network is not specified, network will be + looked up from this subnetwork. To clear existing VPC network + settings, use --clear-network. + + At most one of these can be specified: + + --clear-network-tags + Clears all existing Compute Engine tags from the Cloud Run + worker. + + --network-tags=[TAG,...] + Applies the given Compute Engine tags (comma separated) to the + Cloud Run worker. To clear existing tags, use + --clear-network-tags. + + At most one of these can be specified: + + --clear-post-key-revocation-action-type + Remove any previously set post CMEK key revocation action type. + + --post-key-revocation-action-type=POST_KEY_REVOCATION_ACTION_TYPE + Action type after CMEK key revocation. + POST_KEY_REVOCATION_ACTION_TYPE must be one of: + + prevent-new + No new instances will be started after CMEK key revocation. + shut-down + No new instances will be started and the existing instances will + be shut down after CMEK key revocation. + +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 run worker-pools update + diff --git a/gcloud/beta/run/worker-pools/update-instance-split b/gcloud/beta/run/worker-pools/update-instance-split new file mode 100644 index 000000000..684015bfd --- /dev/null +++ b/gcloud/beta/run/worker-pools/update-instance-split @@ -0,0 +1,134 @@ +NAME + gcloud beta run worker-pools update-instance-split - adjust the instance + assignments for a Cloud Run worker-pool + +SYNOPSIS + gcloud beta run worker-pools update-instance-split + [[WORKER_POOL] --region=REGION] [--async] [--breakglass=JUSTIFICATION] + [--to-latest | --to-revisions=[REVISION-NAME=PERCENTAGE,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Adjust the instance assignments for a Cloud Run worker-pool. + +EXAMPLES + To assign 10% of instances to revision my-worker-pool-s5sxn and 90% of + instances to revision my-worker-pool-cp9kw run: + + $ gcloud beta run worker-pools update-instance-split \ + my-worker-pool \ + --to-revisions=my-worker-pool-s5sxn=10,my-worker-pool-cp9kw=90 + + To increase the instances to revision my-worker-pool-s5sxn to 20% and by + reducing the instances to revision my-worker-pool-cp9kw to 80% run: + + $ gcloud beta run worker-pools update-instance-split \ + my-worker-pool --to-revisions=my-worker-pool-s5sxn=20 + + To rollback to revision my-worker-pool-cp9kw run: + + $ gcloud beta run worker-pools update-instance-split \ + my-worker-pool --to-revisions=my-worker-pool-cp9kw=100 + + To assign 100% of instances to the current or future LATEST revision run: + + $ gcloud beta run worker-pools update-instance-split \ + my-worker-pool --to-latest + + You can also refer to the current or future LATEST revision in + --to-revisions by the string "LATEST". For example, to set 10% of instances + to always float to the latest revision: + + $ gcloud beta run worker-pools update-instance-split \ + my-worker-pool --to-revisions=LATEST=10 + +POSITIONAL ARGUMENTS + WorkerPool resource - WorkerPool to update instance split 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 WORKER_POOL on the command line with a fully + specified name; + ◆ specify the workerpool name from an interactive prompt with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + [WORKER_POOL] + ID of the WorkerPool or fully qualified identifier for the + WorkerPool. + + To set the worker-pool attribute: + ▸ provide the argument WORKER_POOL on the command line; + ▸ specify the workerpool name from an interactive prompt. + + --region=REGION + The Cloud region for the WorkerPool. Overrides the default run/region + property value for this command invocation. + + To set the region attribute: + ▸ provide the argument WORKER_POOL on the command line with a fully + specified name; + ▸ specify the workerpool name from an interactive prompt with a + fully specified name; + ▸ provide the argument --region on the command line; + ▸ set the property run/region; + ▸ specify the region from an interactive prompt. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --breakglass=JUSTIFICATION + Justification to bypass Binary Authorization policy constraints and + allow the operation. See + https://cloud.google.com/binary-authorization/docs/using-breakglass for + more information. Next update or deploy command will automatically + clear existing breakglass justification. + + At most one of these can be specified: + + --to-latest + True to assign 100 percent of instances to the 'latest' revision of + this service. Note that when a new revision is created, it will + become the 'latest' and instances will be fully assigned to it unless + configured otherwise using --[no-]promote flag. Defaults to False. + Synonymous with '--to-revisions=LATEST=100'. + + --to-revisions=[REVISION-NAME=PERCENTAGE,...] + Comma separated list of instance assignments in the form + REVISION-NAME=PERCENTAGE. REVISION-NAME must be the name for a + revision for the worker as returned by 'gcloud run workers revisions + list --worker=WORKER' . PERCENTAGE must be an integer percentage + between 0 and 100 inclusive. Ex worker-nw9hs=10,worker-nw9hs=20 Up to + 100 percent of instances may be assigned. If the total of 100 percent + of instances is assigned, the Worker instance split is updated as + specified. If under 100 percent of instance split is assigned, the + Worker instance split is updated as specified for revisions with + assignments and instance split is scaled up or down proportionally as + needed for revision that are currently serving workload but that do + not have new assignments. For example assume revision-1 is serving 40 + percent of workload and revision-2 is serving 60 percent. If + revision-1 is assigned 45 percent of instances and no assignment is + made for revision-2, the worker is updated with revsion-1 assigned 45 + percent of instances and revision-2 scaled down to 55 percent. You + can use "LATEST" as a special revision name to always put the given + percentage of instance split on the latest ready revision. + +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 run worker-pools update-instance-split + diff --git a/gcloud/beta/services/identity/create b/gcloud/beta/services/identity/create index 97806be29..7122d7a71 100644 --- a/gcloud/beta/services/identity/create +++ b/gcloud/beta/services/identity/create @@ -12,14 +12,23 @@ DESCRIPTION supported consumers are projects, folders, and organizations. EXAMPLES - To create a service identity for a project, folder, or organization, run: + To create a service identity for a project, run: $ gcloud beta services identity create \ --service=example.googleapis.com --project=helloworld + + Using a project number: + $ gcloud beta services identity create \ --service=example.googleapis.com --project=1234567890 + + To create a service identity for a folder, run: + $ gcloud beta services identity create \ --service=example.googleapis.com --folder=1234567890 + + To create a service identity for an organization, run: + $ gcloud beta services identity create \ --service=example.googleapis.com --organization=1234567890 diff --git a/gcloud/beta/spanner/backups/create b/gcloud/beta/spanner/backups/create index e97187c6b..294befd5e 100644 --- a/gcloud/beta/spanner/backups/create +++ b/gcloud/beta/spanner/backups/create @@ -91,7 +91,7 @@ OPTIONAL FLAGS The encryption type of the backup. ENCRYPTION_TYPE must be one of: customer-managed-encryption - Use the provided Cloud KMS key for encryption. If this option is + Use the provided Cloud KMS key for encryption.If this option is selected, kms-key must be set. google-default-encryption Use Google default encryption. diff --git a/gcloud/compute/disks/update b/gcloud/compute/disks/update index e8a05edea..903b19baa 100644 --- a/gcloud/compute/disks/update +++ b/gcloud/compute/disks/update @@ -6,6 +6,9 @@ SYNOPSIS [--provisioned-iops=PROVISIONED_IOPS] [--provisioned-throughput=PROVISIONED_THROUGHPUT] [--size=SIZE] [--update-labels=[KEY=VALUE,...]] + [--append-licenses=LICENSE,[LICENSE,...] + --remove-licenses=LICENSE,[LICENSE,...] + --replace-license=LICENSE,LICENSE] [--clear-architecture | --update-architecture=UPDATE_ARCHITECTURE] [--clear-labels | --remove-labels=[KEY,...]] [--region=REGION | --zone=ZONE] [GCLOUD_WIDE_FLAG ...] @@ -32,6 +35,24 @@ EXAMPLES $ gcloud compute disks describe example-disk \ --format="default(labels)" + To append licenses to the disk, run: + + $ gcloud compute disks update example-disk --zone=us-central1-a \ + --append-licenses=projects/license-project/global/licenses/\ + license-1,projects/license-project/global/licenses/license-2 + + To remove licenses from the disk, run: + + $ gcloud compute disks update example-disk --zone=us-central1-a \ + --replace-licenses=projects/license-project/global/licenses/\ + license-1,projects/license-project/global/licenses/license-2 + + To replace a license on the disk, run: + + $ gcloud compute disks update example-disk --zone=us-central1-a \ + --replace-license=projects/license-project/global/licenses/\ + old-license,projects/license-project/global/licenses/new-license + POSITIONAL ARGUMENTS DISK_NAME Name of the disk to update. @@ -68,6 +89,23 @@ FLAGS contain only hyphens (-), underscores (_), lowercase characters, and numbers. + --append-licenses=LICENSE,[LICENSE,...] + "A list of license URIs or license codes. These licenses will be + appended to the existing licenses on the disk. Provided licenses can be + either license URIs or license codes but not a mix of both. + + --remove-licenses=LICENSE,[LICENSE,...] + A list of license URIs or license codes. If present in the set of + existing licenses, these licenses will be removed. If not present, this + is a no-op. Provided licenses can be either license URIs or license + codes but not a mix of both. + + --replace-license=LICENSE,LICENSE + A list of license URIs or license codes. The first license is the + license to be replaced and the second license is the replacement + license. Provided licenses can be either license URIs or license codes + but not a mix of both. + At most one of these can be specified: --clear-architecture diff --git a/gcloud/compute/reservations/update b/gcloud/compute/reservations/update index 7c2c393ad..e7f60828a 100644 --- a/gcloud/compute/reservations/update +++ b/gcloud/compute/reservations/update @@ -4,6 +4,7 @@ NAME SYNOPSIS gcloud compute reservations update RESERVATION [--add-share-with=PROJECT,[PROJECT,...]] + [--[no-]enable-emergent-maintenance] [--remove-share-with=PROJECT,[PROJECT,...]] [--reservation-sharing-policy=RESERVATION_SHARING_POLICY] [--vm-count=VM_COUNT] [--zone=ZONE] [GCLOUD_WIDE_FLAG ...] @@ -44,6 +45,12 @@ FLAGS specify a comma-separated list of projects to share the reservation with. You must list the projects using project IDs or project numbers. + --[no-]enable-emergent-maintenance + Enables the reservation to receive notifications when urgent + maintenance for a GPU VM starts after the VM encounters a host error. + Use --enable-emergent-maintenance to enable and + --no-enable-emergent-maintenance to disable. + --remove-share-with=PROJECT,[PROJECT,...] A list of specific projects to remove from the list of projects that this reservation is shared with. List must contain project IDs or diff --git a/gcloud/dataproc/clusters/create b/gcloud/dataproc/clusters/create index 98e0fd2b4..4a6c2eef1 100644 --- a/gcloud/dataproc/clusters/create +++ b/gcloud/dataproc/clusters/create @@ -7,6 +7,7 @@ SYNOPSIS [--async] [--autoscaling-policy=AUTOSCALING_POLICY] [--bucket=BUCKET] [--cluster-type=TYPE] [--confidential-compute] [--dataproc-metastore=DATAPROC_METASTORE] + [--delete-max-idle=DELETE_MAX_IDLE] [--driver-pool-accelerator=[type=TYPE,[count=COUNT],...]] [--driver-pool-boot-disk-size=DRIVER_POOL_BOOT_DISK_SIZE] [--driver-pool-boot-disk-type=DRIVER_POOL_BOOT_DISK_TYPE] @@ -45,7 +46,8 @@ SYNOPSIS [--secondary-worker-standard-capacity-base=SECONDARY_WORKER_STANDARD_CAPACITY_BASE] [--secondary-worker-standard-capacity-percent-above-base=SECONDARY_WORKER_STANDARD_CAPACITY_PERCENT_ABOVE_BASE] [--shielded-integrity-monitoring] [--shielded-secure-boot] - [--shielded-vtpm] [--temp-bucket=TEMP_BUCKET] [--tier=TIER] + [--shielded-vtpm] [--stop-max-idle=STOP_MAX_IDLE] + [--temp-bucket=TEMP_BUCKET] [--tier=TIER] [--worker-accelerator=[type=TYPE,[count=COUNT],...]] [--worker-boot-disk-provisioned-iops=WORKER_BOOT_DISK_PROVISIONED_IOPS] [--worker-boot-disk-provisioned-throughput=WORKER_BOOT_DISK_PROVISIONED_THROUGHPUT] @@ -54,9 +56,7 @@ SYNOPSIS [--worker-local-ssd-interface=WORKER_LOCAL_SSD_INTERFACE] [--worker-min-cpu-platform=PLATFORM] [--zone=ZONE, -z ZONE] [--delete-expiration-time=DELETE_EXPIRATION_TIME - | --delete-max-age=DELETE_MAX_AGE | --expiration-time=EXPIRATION_TIME - | --max-age=MAX_AGE] - [--delete-max-idle=DELETE_MAX_IDLE | --max-idle=MAX_IDLE] + | --delete-max-age=DELETE_MAX_AGE] [--gce-pd-kms-key=GCE_PD_KMS_KEY : --gce-pd-kms-key-keyring=GCE_PD_KMS_KEY_KEYRING --gce-pd-kms-key-location=GCE_PD_KMS_KEY_LOCATION @@ -82,6 +82,8 @@ SYNOPSIS --num-secondary-workers=NUM_SECONDARY_WORKERS --num-workers=NUM_WORKERS --secondary-worker-type=TYPE; default="preemptible"] + [--stop-expiration-time=STOP_EXPIRATION_TIME + | --stop-max-age=STOP_MAX_AGE] [--worker-machine-type=WORKER_MACHINE_TYPE | --worker-machine-types=type=MACHINE_TYPE[, type=MACHINE_TYPE...][,rank=RANK]] [GCLOUD_WIDE_FLAG ...] @@ -174,6 +176,11 @@ FLAGS external metastore in the format: "projects/{project-id}/locations/{region}/services/{service-name}". + --delete-max-idle=DELETE_MAX_IDLE + The duration after the last job completes to auto-delete the cluster, + such as "2h" or "1d". See $ gcloud topic datetimes for information on + duration formats. + --driver-pool-accelerator=[type=TYPE,[count=COUNT],...] Attaches accelerators, such as GPUs, to the driver-pool instance(s). @@ -446,6 +453,11 @@ FLAGS security operations, such as remote attestation, encryption, and sealing of keys. + --stop-max-idle=STOP_MAX_IDLE + The duration after the last job completes to auto-stop the cluster, + such as "2h" or "1d". See $ gcloud topic datetimes for information on + duration formats. + --temp-bucket=TEMP_BUCKET The Google Cloud Storage bucket to use by default to store ephemeral cluster and jobs data, such as Spark and MapReduce history files. @@ -525,28 +537,6 @@ FLAGS as "2h" or "1d". See $ gcloud topic datetimes for information on duration formats. - --expiration-time=EXPIRATION_TIME - The time when the cluster will be auto-deleted, such as - "2017-08-29T18:52:51.142Z." See $ gcloud topic datetimes for - information on time formats. - - --max-age=MAX_AGE - The lifespan of the cluster, with auto-deletion upon completion, such - as "2h" or "1d". See $ gcloud topic datetimes for information on - duration formats. - - At most one of these can be specified: - - --delete-max-idle=DELETE_MAX_IDLE - The duration after the last job completes to auto-delete the cluster, - such as "2h" or "1d". See $ gcloud topic datetimes for information on - duration formats. - - --max-idle=MAX_IDLE - The duration after the last job completes to autto-delete the - cluster, such as "2h" or "1d". See $ gcloud topic datetimes for - information on duration formats. - Key resource - The Cloud KMS (Key Management Service) cryptokey that will be used to protect the cluster. The 'Compute Engine Service Agent' service account must hold permission 'Cloud KMS CryptoKey Encrypter/Decrypter'. @@ -1013,6 +1003,18 @@ FLAGS The type of the secondary worker group. TYPE must be one of: preemptible, non-preemptible, spot. + At most one of these can be specified: + + --stop-expiration-time=STOP_EXPIRATION_TIME + The time when the cluster will be auto-stopped, such as + "2017-08-29T18:52:51.142Z." See $ gcloud topic datetimes for + information on time formats. + + --stop-max-age=STOP_MAX_AGE + The lifespan of the cluster, with auto-stop upon completion, such as + "2h" or "1d". See $ gcloud topic datetimes for information on + duration formats. + At most one of these can be specified: --worker-machine-type=WORKER_MACHINE_TYPE diff --git a/gcloud/dataproc/clusters/update b/gcloud/dataproc/clusters/update index 24c5880cf..a06f438c4 100644 --- a/gcloud/dataproc/clusters/update +++ b/gcloud/dataproc/clusters/update @@ -11,11 +11,12 @@ SYNOPSIS [--autoscaling-policy=AUTOSCALING_POLICY | --disable-autoscaling] [--clear-labels | --remove-labels=[KEY,...]] [--delete-expiration-time=DELETE_EXPIRATION_TIME - | --delete-max-age=DELETE_MAX_AGE | --no-delete-max-age - | --expiration-time=EXPIRATION_TIME | --max-age=MAX_AGE - | --no-max-age] - [--delete-max-idle=DELETE_MAX_IDLE | --no-delete-max-idle - | --max-idle=MAX_IDLE | --no-max-idle] [GCLOUD_WIDE_FLAG ...] + | --delete-max-age=DELETE_MAX_AGE | --no-delete-max-age] + [--delete-max-idle=DELETE_MAX_IDLE | --no-delete-max-idle] + [--stop-expiration-time=STOP_EXPIRATION_TIME + | --stop-max-age=STOP_MAX_AGE | --no-stop-max-age] + [--stop-max-idle=STOP_MAX_IDLE | --no-stop-max-idle] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION Update the number of worker nodes and/or the labels in a cluster. @@ -182,20 +183,6 @@ FLAGS Cancels the cluster auto-deletion by maximum cluster age (configured by --delete-max-age or --delete-expiration-time flags) - --expiration-time=EXPIRATION_TIME - The time when the cluster will be auto-deleted, such as - "2017-08-29T18:52:51.142Z". See $ gcloud topic datetimes for - information on time formats. - - --max-age=MAX_AGE - The lifespan of the cluster, with auto-deletion upon completion, "2h" - or "1d". See $ gcloud topic datetimes for information on duration - formats. - - --no-max-age - Cancels the cluster auto-deletion by maximum cluster age (configured - by --max-age or --expiration-time flags) - At most one of these can be specified: --delete-max-idle=DELETE_MAX_IDLE @@ -207,14 +194,32 @@ FLAGS Cancels the cluster auto-deletion by cluster idle duration (configured by --delete-max-idle flag) - --max-idle=MAX_IDLE - The duration after the last job completes to auto-delete the cluster, + At most one of these can be specified: + + --stop-expiration-time=STOP_EXPIRATION_TIME + The time when the cluster will be auto-stopped, such as + "2017-08-29T18:52:51.142Z". See $ gcloud topic datetimes for + information on time formats. + + --stop-max-age=STOP_MAX_AGE + The lifespan of the cluster, with auto-stop upon completion, such as + "2h" or "1d". See $ gcloud topic datetimes for information on + duration formats. + + --no-stop-max-age + Cancels the cluster auto-stop by maximum cluster age (configured by + --stop-max-age or --stop-expiration-time flags) + + At most one of these can be specified: + + --stop-max-idle=STOP_MAX_IDLE + The duration after the last job completes to auto-stop the cluster, such as "2h" or "1d". See $ gcloud topic datetimes for information on duration formats. - --no-max-idle - Cancels the cluster auto-deletion by cluster idle duration - (configured by --max-idle flag) + --no-stop-max-idle + Cancels the cluster auto-stop by cluster idle duration (configured by + --stop-max-idle flag) GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/memorystore/instances/create b/gcloud/memorystore/instances/create index 65246720d..8c11f3747 100644 --- a/gcloud/memorystore/instances/create +++ b/gcloud/memorystore/instances/create @@ -14,6 +14,7 @@ SYNOPSIS [--psc-auto-connections=[network=NETWORK], [port=PORT],[projectId=PROJECTID]] [--replica-count=REPLICA_COUNT] [--request-id=REQUEST_ID] [--shard-count=SHARD_COUNT] + [--simulate-maintenance-event] [--transit-encryption-mode=TRANSIT_ENCRYPTION_MODE] [--aof-config-append-fsync=AOF_CONFIG_APPEND_FSYNC --persistence-config-mode=PERSISTENCE_CONFIG_MODE @@ -25,6 +26,7 @@ SYNOPSIS [--cross-instance-replication-config-role=CROSS_INSTANCE_REPLICATION_CONFIG_ROLE : --cross-instance-replication-config-secondary-instances=[instance=INSTANCE] --primary-instance=PRIMARY_INSTANCE] [--gcs-source-uris=[GCS_SOURCE_URIS,...] | --managed-backup-source=MANAGED_BACKUP_SOURCE] + [--kms-key=KMS_KEY : --key-ring=KEY_RING] [--zone-distribution-config=ZONE_DISTRIBUTION_CONFIG --zone-distribution-config-mode=ZONE_DISTRIBUTION_CONFIG_MODE] [GCLOUD_WIDE_FLAG ...] @@ -190,9 +192,9 @@ FLAGS --labels=path_to_file.(yaml|json) --location=LOCATION - For resources [instance], provides fallback value for resource location - attribute. When the resource's full URI path is not provided, location - will fallback to this flag value. + For resources [instance, cryptoKey], provides fallback value for + resource location attribute. When the resource's full URI path is not + provided, location will fallback to this flag value. Maintenance policy per instance. @@ -318,6 +320,11 @@ FLAGS --shard-count=SHARD_COUNT Number of shards for the instance. + Arguments for the simulate maintenance event. + + --simulate-maintenance-event + Simulate a maintenance event. + --transit-encryption-mode=TRANSIT_ENCRYPTION_MODE In-transit encryption mode of the instance. TRANSIT_ENCRYPTION_MODE must be one of: @@ -513,6 +520,42 @@ FLAGS In this case, it assumes the backup is under memorystore.googleapis.com. + Arguments for the kms key. + + CryptoKey resource - The KMS key used to encrypt the at-rest data of the + cluster. 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 --kms-key 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 --kms-key on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --kms-key=KMS_KEY + ID of the cryptoKey or fully qualified identifier for the + cryptoKey. + + To set the crypto-key attribute: + ▫ provide the argument --kms-key on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --key-ring=KEY_RING + The keyRing id of the cryptoKey resource. + + To set the key-ring attribute: + ▫ provide the argument --kms-key on the command line with a fully + specified name; + ▫ provide the argument --key-ring on the command line. + Zone distribution configuration for allocation of instance resources. --zone-distribution-config=ZONE_DISTRIBUTION_CONFIG diff --git a/gcloud/memorystore/instances/update b/gcloud/memorystore/instances/update index 699d3daba..fe60b44a7 100644 --- a/gcloud/memorystore/instances/update +++ b/gcloud/memorystore/instances/update @@ -9,6 +9,7 @@ SYNOPSIS [--location=LOCATION] [--mode=MODE] [--node-type=NODE_TYPE] [--[no-]ondemand-maintenance] [--replica-count=REPLICA_COUNT] [--request-id=REQUEST_ID] [--shard-count=SHARD_COUNT] + [--[no-]simulate-maintenance-event] [--aof-config-append-fsync=AOF_CONFIG_APPEND_FSYNC --clear-persistence-config --persistence-config-mode=PERSISTENCE_CONFIG_MODE @@ -33,6 +34,7 @@ SYNOPSIS | --update-engine-configs=[UPDATE_ENGINE_CONFIGS,...] --clear-engine-configs | --remove-engine-configs=REMOVE_ENGINE_CONFIGS] + [--key-ring=KEY_RING --clear-kms-key | --kms-key=KMS_KEY] [--labels=[LABELS,...] | --update-labels=[UPDATE_LABELS,...] --clear-labels | --remove-labels=REMOVE_LABELS] [GCLOUD_WIDE_FLAG ...] @@ -105,9 +107,9 @@ FLAGS Engine version of the instance. --location=LOCATION - For resources [instance], provides fallback value for resource location - attribute. When the resource's full URI path is not provided, location - will fallback to this flag value. + For resources [instance, cryptoKey], provides fallback value for + resource location attribute. When the resource's full URI path is not + provided, location will fallback to this flag value. --mode=MODE The mode config for the instance. MODE must be one of: @@ -162,6 +164,12 @@ FLAGS --shard-count=SHARD_COUNT Number of shards for the instance. + Arguments for the simulate maintenance event. + + --[no-]simulate-maintenance-event + Simulate a maintenance event. Use --simulate-maintenance-event to + enable and --no-simulate-maintenance-event to disable. + Represents persistence configuration for a instance. Configuration for AOF based persistence. @@ -770,6 +778,54 @@ FLAGS --remove-engine-configs=path_to_file.(yaml|json) + Arguments for the kms key. + + All arguments needed to update kms_key. + + --key-ring=KEY_RING + The keyRing id of the cryptoKey resource. + + To set the key-ring attribute: + ▫ provide the argument --current on the command line with a fully + specified name; + ▫ provide the argument --key-ring on the command line. + + Update kms_key. + + At most one of these can be specified: + + --clear-kms-key + Clear kms_key value and set to null. + + CryptoKey resource - Set kms_key to new value. + + The KMS key used to encrypt the at-rest data of the cluster. 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 --kms-key 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 --kms-key on the command line with a fully + specified name; + ◇ provide the argument --location on the command line. + + To set the key-ring attribute: + ◇ provide the argument --kms-key on the command line with a fully + specified name; + ◇ provide the argument --key-ring on the command line. + + --kms-key=KMS_KEY + ID of the cryptoKey or fully qualified identifier for the + cryptoKey. + + To set the crypto-key attribute: + ▹ provide the argument --kms-key on the command line. + Update labels. At most one of these can be specified: diff --git a/gcloud/metastore/federations/create b/gcloud/metastore/federations/create index 11f6ddb43..53789287d 100644 --- a/gcloud/metastore/federations/create +++ b/gcloud/metastore/federations/create @@ -6,7 +6,8 @@ SYNOPSIS gcloud metastore federations create (FEDERATION : --location=LOCATION) --backends=RANK=BACKEND [--async] [--hive-metastore-version=HIVE_METASTORE_VERSION] - [--labels=[KEY=VALUE,...]] [GCLOUD_WIDE_FLAG ...] + [--labels=[KEY=VALUE,...]] [--tags=[KEY=VALUE,...]] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION Create a new Dataproc Metastore federation with the given name and @@ -93,6 +94,9 @@ OPTIONAL FLAGS contain only hyphens (-), underscores (_), lowercase characters, and numbers. + --tags=[KEY=VALUE,...] + List of tag KEY=VALUE pairs to add. + 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/metastore/services/create b/gcloud/metastore/services/create index 058fad29e..0232ba772 100644 --- a/gcloud/metastore/services/create +++ b/gcloud/metastore/services/create @@ -10,6 +10,7 @@ SYNOPSIS [--hive-metastore-version=HIVE_METASTORE_VERSION] [--labels=[KEY=VALUE,...]] [--port=PORT; default=9083] [--release-channel=RELEASE_CHANNEL; default="stable"] + [--tags=[KEY=VALUE,...]] [--auxiliary-versions=[AUXILIARY_VERSIONS,...] | --auxiliary-versions-from-file=AUXILIARY_VERSIONS_FROM_FILE] [--consumer-subnetworks=[CONSUMER_SUBNETWORKS,...] | --network=NETWORK @@ -174,6 +175,9 @@ FLAGS The STABLE release channel contains features that are considered stable and have been validated for production use. + --tags=[KEY=VALUE,...] + List of tag KEY=VALUE pairs to add. + Auxiliary versions configuration for the Dataproc Metastore service. When specified, a secondary Hive metastore service is created along with the primary service. diff --git a/gcloud/migration/vms/image-imports/create b/gcloud/migration/vms/image-imports/create index 996f56b57..3d9e89a47 100644 --- a/gcloud/migration/vms/image-imports/create +++ b/gcloud/migration/vms/image-imports/create @@ -10,8 +10,11 @@ SYNOPSIS [--image-name=IMAGE_NAME] [--kms-key=KMS_KEY] [--labels=[KEY=VALUE,...]] [--single-region-storage] [--target-project=TARGET_PROJECT] - [--skip-os-adaptation | --boot-conversion=BOOT_CONVERSION - --generalize --license-type=LICENSE_TYPE] [GCLOUD_WIDE_FLAG ...] + [--skip-os-adaptation | --adaptation-modifiers=ADAPTATION_MODIFIERS + --boot-conversion=BOOT_CONVERSION --generalize + --license-type=LICENSE_TYPE + --rootfs-uuid=ROOTFS_UUID --suppress-package-installation-failure] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION gcloud migration vms image-imports create imports images such as VMWare @@ -108,6 +111,11 @@ OPTIONAL FLAGS --skip-os-adaptation If true, skip OS adaptation. Default false. + --adaptation-modifiers=ADAPTATION_MODIFIERS + A map of flags to pass to the OS adaptation process. The actual value + depends on the modifier and can also be empty. e.g. + --adaptation-modifiers=flag1=value1,flag2 + --boot-conversion=BOOT_CONVERSION This property will trigger an internal process which will convert the image from using the existing boot option to another. The size of the @@ -130,6 +138,13 @@ OPTIONAL FLAGS compute-engine-license-type-default, compute-engine-license-type-payg. + --rootfs-uuid=ROOTFS_UUID + Identifies the file system to adapt. + + --suppress-package-installation-failure + If true, suppress package installation failure and continue with a + warning. + 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/migration/vms/machine-image-imports/create b/gcloud/migration/vms/machine-image-imports/create index a12f414ed..73bc56f03 100644 --- a/gcloud/migration/vms/machine-image-imports/create +++ b/gcloud/migration/vms/machine-image-imports/create @@ -15,8 +15,11 @@ SYNOPSIS [--target-project=TARGET_PROJECT] [--enable-integrity-monitoring --enable-vtpm --secure-boot=SECURE_BOOT] [--scopes=[SCOPES,...] --service-account=SERVICE_ACCOUNT] - [--skip-os-adaptation | --boot-conversion=BOOT_CONVERSION - --generalize --license-type=LICENSE_TYPE] [GCLOUD_WIDE_FLAG ...] + [--skip-os-adaptation | --adaptation-modifiers=ADAPTATION_MODIFIERS + --boot-conversion=BOOT_CONVERSION --generalize + --license-type=LICENSE_TYPE + --rootfs-uuid=ROOTFS_UUID --suppress-package-installation-failure] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION gcloud migration vms machine-image-imports create Imports machine images @@ -157,6 +160,11 @@ OPTIONAL FLAGS --skip-os-adaptation If true, skip OS adaptation. Default false. + --adaptation-modifiers=ADAPTATION_MODIFIERS + A map of flags to pass to the OS adaptation process. The actual value + depends on the modifier and can also be empty. e.g. + --adaptation-modifiers=flag1=value1,flag2 + --boot-conversion=BOOT_CONVERSION This property will trigger an internal process which will convert the image from using the existing boot option to another. The size of the @@ -177,6 +185,13 @@ OPTIONAL FLAGS compute-engine-license-type-default, compute-engine-license-type-payg. + --rootfs-uuid=ROOTFS_UUID + Identifies the file system to adapt. + + --suppress-package-installation-failure + If true, suppress package installation failure and continue with a + warning. + 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/create b/gcloud/netapp/volumes/create index a1f0cd4a3..9ebd7bd07 100644 --- a/gcloud/netapp/volumes/create +++ b/gcloud/netapp/volumes/create @@ -19,13 +19,10 @@ SYNOPSIS [kerberos-5p-read-write=KERBEROS-5P-READ-WRITE], [nfsv3=NFSV3],[nfsv4=NFSV4]] [--hybrid-replication-parameters=[cluster-location=CLUSTER-LOCATION], - [description=DESCRIPTION], - [hybrid-replication-type=HYBRID-REPLICATION-TYPE],[labels=LABELS], - [large-volume-constituent-count=LARGE-VOLUME-CONSTITUENT-COUNT], + [description=DESCRIPTION],[labels=LABELS], [peer-cluster-name=PEER-CLUSTER-NAME], [peer-ip-addresses=PEER-IP-ADDRESSES],[peer-svm-name=PEER-SVM-NAME], - [peer-volume-name=PEER-VOLUME-NAME],[replication=REPLICATION], - [replication-schedule=REPLICATION-SCHEDULE]] + [peer-volume-name=PEER-VOLUME-NAME],[replication=REPLICATION]] [--labels=[KEY=VALUE,...]] [--large-capacity=LARGE_CAPACITY] [--multiple-endpoints=MULTIPLE_ENDPOINTS] [--restricted-actions=RESTRICTED_ACTION,[...]] @@ -172,7 +169,7 @@ OPTIONAL FLAGS kerberos-5p-read-only=KERBEROS_5P_READ_ONLY, kerberos-5p-read-write=KERBEROS_5P_READ_WRITE - --hybrid-replication-parameters=[cluster-location=CLUSTER-LOCATION],[description=DESCRIPTION],[hybrid-replication-type=HYBRID-REPLICATION-TYPE],[labels=LABELS],[large-volume-constituent-count=LARGE-VOLUME-CONSTITUENT-COUNT],[peer-cluster-name=PEER-CLUSTER-NAME],[peer-ip-addresses=PEER-IP-ADDRESSES],[peer-svm-name=PEER-SVM-NAME],[peer-volume-name=PEER-VOLUME-NAME],[replication=REPLICATION],[replication-schedule=REPLICATION-SCHEDULE] + --hybrid-replication-parameters=[cluster-location=CLUSTER-LOCATION],[description=DESCRIPTION],[labels=LABELS],[peer-cluster-name=PEER-CLUSTER-NAME],[peer-ip-addresses=PEER-IP-ADDRESSES],[peer-svm-name=PEER-SVM-NAME],[peer-volume-name=PEER-VOLUME-NAME],[replication=REPLICATION] Hybrid Replication Parameters contains hybrid replication parameters on a volume. diff --git a/gcloud/netapp/volumes/replications/establish-peering b/gcloud/netapp/volumes/replications/establish-peering index 47168759a..0e4e32eb9 100644 --- a/gcloud/netapp/volumes/replications/establish-peering +++ b/gcloud/netapp/volumes/replications/establish-peering @@ -78,7 +78,8 @@ OPTIONAL FLAGS complete. --peer-ip-addresses=PEER_IP_ADDRESS,[...] - List of ip addresses to be used for peering. + List of ip addresses to be used for peering. This is required for + cluster peering, not required for svm peering. Volume resource - The Volume that the Replication is based on This represents a Cloud resource. (NOTE) Some attributes are not given diff --git a/gcloud/network-security/backend-authentication-configs/create b/gcloud/network-security/backend-authentication-configs/create new file mode 100644 index 000000000..48521944f --- /dev/null +++ b/gcloud/network-security/backend-authentication-configs/create @@ -0,0 +1,95 @@ +NAME + gcloud network-security backend-authentication-configs create - create a + BackendAuthenticationConfig + +SYNOPSIS + gcloud network-security backend-authentication-configs create + (BACKEND_AUTHENTICATION_CONFIG : --location=LOCATION) [--async] + [--client-certificate=CLIENT_CERTIFICATE] [--description=DESCRIPTION] + [--labels=[KEY=VALUE,...]] [--trust-config=TRUST_CONFIG] + [--well-known-roots=WELL_KNOWN_ROOTS] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create a new BackendAuthenticationConfig. + +EXAMPLES + To create a config named backend-authentication-config, run: + + $ gcloud network-security backend-authentication-configs create \ + backend-authentication-config \ + --trust-config=projects/my-project/locations/global/\ + trustConfigs/my-trust-config --location=global + +POSITIONAL ARGUMENTS + Backend authentication config resource - Realm to be created. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument backend_authentication_config on the command + line with a fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + BACKEND_AUTHENTICATION_CONFIG + ID of the backend authentication config or fully qualified identifier + for the backend authentication config. + + To set the backend_authentication_config attribute: + ▸ provide the argument backend_authentication_config 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 Id. + + To set the location attribute: + ▸ provide the argument backend_authentication_config on the command + line with a fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --client-certificate=CLIENT_CERTIFICATE + ID of certificate resource. + + --description=DESCRIPTION + Description of the backend authentication config. + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + --trust-config=TRUST_CONFIG + ID of trust config resource. + + --well-known-roots=WELL_KNOWN_ROOTS + Indicates whether the load balancer should trust backend server + certificates. WELL_KNOWN_ROOTS must be one of: none, public-roots. + +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 networksecurity/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + These variants are also available: + + $ gcloud alpha network-security backend-authentication-configs create + + $ gcloud beta network-security backend-authentication-configs create + diff --git a/gcloud/network-security/backend-authentication-configs/delete b/gcloud/network-security/backend-authentication-configs/delete new file mode 100644 index 000000000..d21fbfe29 --- /dev/null +++ b/gcloud/network-security/backend-authentication-configs/delete @@ -0,0 +1,80 @@ +NAME + gcloud network-security backend-authentication-configs delete - delete + BackendAuthenticationConfig + +SYNOPSIS + gcloud network-security backend-authentication-configs delete + (BACKEND_AUTHENTICATION_CONFIG : --location=LOCATION) [--async] + [--etag=ETAG] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete the specified BackendAuthenticationConfig. + +EXAMPLES + To delete a BackendAuthenticationConfig called + 'my-backend-authentication-config', run: + + $ gcloud network-security backend-authentication-configs delete \ + my-backend-authentication-config --location=global + +POSITIONAL ARGUMENTS + Backend authentication config resource - Name of the + BackendAuthenticationConfig 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 backend_authentication_config on the command + line with a fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + BACKEND_AUTHENTICATION_CONFIG + ID of the backend authentication config or fully qualified identifier + for the backend authentication config. + + To set the backend_authentication_config attribute: + ▸ provide the argument backend_authentication_config 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 Id. + + To set the location attribute: + ▸ provide the argument backend_authentication_config on the command + line with a fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --etag=ETAG + The entity-tag of the BackendAuthenticationConfig. + +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 networksecurity/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + These variants are also available: + + $ gcloud alpha network-security backend-authentication-configs delete + + $ gcloud beta network-security backend-authentication-configs delete + diff --git a/gcloud/network-security/backend-authentication-configs/describe b/gcloud/network-security/backend-authentication-configs/describe new file mode 100644 index 000000000..fb022c665 --- /dev/null +++ b/gcloud/network-security/backend-authentication-configs/describe @@ -0,0 +1,73 @@ +NAME + gcloud network-security backend-authentication-configs describe - describe + BackendAuthenticationConfig + +SYNOPSIS + gcloud network-security backend-authentication-configs describe + (BACKEND_AUTHENTICATION_CONFIG : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe the specified BackendAuthenticationConfig. + +EXAMPLES + To describe a BackendAuthenticationConfig called + 'my-backend-authentication-config', run: + + $ gcloud network-security backend-authentication-configs describe \ + my-backend-authentication-config --location=global + +POSITIONAL ARGUMENTS + Backend authentication config resource - The BackendAuthenticationConfig + you want to describe. The arguments in this group can be used to specify + the attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument backend_authentication_config on the command + line with a fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + BACKEND_AUTHENTICATION_CONFIG + ID of the backend authentication config or fully qualified identifier + for the backend authentication config. + + To set the backend_authentication_config attribute: + ▸ provide the argument backend_authentication_config 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 Id. + + To set the location attribute: + ▸ provide the argument backend_authentication_config on the command + line with a fully specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networksecurity/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + These variants are also available: + + $ gcloud alpha network-security backend-authentication-configs \ + describe + + $ gcloud beta network-security backend-authentication-configs \ + describe + diff --git a/gcloud/network-security/backend-authentication-configs/export b/gcloud/network-security/backend-authentication-configs/export new file mode 100644 index 000000000..cf1a05b6a --- /dev/null +++ b/gcloud/network-security/backend-authentication-configs/export @@ -0,0 +1,80 @@ +NAME + gcloud network-security backend-authentication-configs export - export + BackendAuthenticationConfig + +SYNOPSIS + gcloud network-security backend-authentication-configs export + (BACKEND_AUTHENTICATION_CONFIG : --location=LOCATION) + [--destination=DESTINATION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Export a BackendAuthenticationConfig. + +EXAMPLES + To export a BackendAuthenticationConfig, run: + + $ gcloud network-security backend-authentication-configs export \ + my-backend-authentication-config \ + --destination=my-backend-authentication-config.yaml \ + --location=global + +POSITIONAL ARGUMENTS + Backend authentication config resource - Name of the + BackendAuthenticationConfig to export. 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 backend_authentication_config on the command + line with a fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + BACKEND_AUTHENTICATION_CONFIG + ID of the backend authentication config or fully qualified identifier + for the backend authentication config. + + To set the backend_authentication_config attribute: + ▸ provide the argument backend_authentication_config 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 Id. + + To set the location attribute: + ▸ provide the argument backend_authentication_config on the command + line with a fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --destination=DESTINATION + Path to a YAML file where the configuration will be exported. The + exported data will not contain any output-only fields. Alternatively, + you may omit this flag to write to standard output. For a schema + describing the export/import format, see + $CLOUDSDKROOT/lib/googlecloudsdk/schemas/... + +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 networksecurity/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + These variants are also available: + + $ gcloud alpha network-security backend-authentication-configs export + + $ gcloud beta network-security backend-authentication-configs export + diff --git a/gcloud/network-security/backend-authentication-configs/help b/gcloud/network-security/backend-authentication-configs/help new file mode 100644 index 000000000..473ab6c72 --- /dev/null +++ b/gcloud/network-security/backend-authentication-configs/help @@ -0,0 +1,44 @@ +NAME + gcloud network-security backend-authentication-configs - manage Network + Security BackendAuthenticationConfigs + +SYNOPSIS + gcloud network-security backend-authentication-configs COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Network Security BackendAuthenticationConfigs. + +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 BackendAuthenticationConfig. + + delete + Delete BackendAuthenticationConfig. + + describe + Describe BackendAuthenticationConfig. + + export + Export BackendAuthenticationConfig. + + import + Import BackendAuthenticationConfigs. + + list + List BackendAuthenticationConfigs. + +NOTES + These variants are also available: + + $ gcloud alpha network-security backend-authentication-configs + + $ gcloud beta network-security backend-authentication-configs + diff --git a/gcloud/network-security/backend-authentication-configs/import b/gcloud/network-security/backend-authentication-configs/import new file mode 100644 index 000000000..4e3229ebe --- /dev/null +++ b/gcloud/network-security/backend-authentication-configs/import @@ -0,0 +1,86 @@ +NAME + gcloud network-security backend-authentication-configs import - import + BackendAuthenticationConfigs + +SYNOPSIS + gcloud network-security backend-authentication-configs import + (BACKEND_AUTHENTICATION_CONFIG : --location=LOCATION) [--async] + [--source=SOURCE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Import a BackendAuthenticationConfigs. + +EXAMPLES + To import a BackendAuthenticationConfigs from a YAML file, run: + + $ gcloud network-security backend-authentication-configs import \ + my-backend-authentication-config \ + --source=my-backend-authentication-config.yaml --location=global + +POSITIONAL ARGUMENTS + Backend authentication config resource - Name of the + BackendAuthenticationConfigs to import. 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 backend_authentication_config on the command + line with a fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + BACKEND_AUTHENTICATION_CONFIG + ID of the backend authentication config or fully qualified identifier + for the backend authentication config. + + To set the backend_authentication_config attribute: + ▸ provide the argument backend_authentication_config 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 Id. + + To set the location attribute: + ▸ provide the argument backend_authentication_config on the command + line with a fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --source=SOURCE + Path to a YAML file containing the configuration export data. The YAML + file must not contain any output-only fields. Alternatively, you may + omit this flag to read from standard input. For a schema describing the + export/import format, see: $CLOUDSDKROOT/lib/googlecloudsdk/schemas/... + + $CLOUDSDKROOT is can be obtained with the following command: + + $ gcloud info --format='value(installation.sdk_root)' + +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 networksecurity/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + These variants are also available: + + $ gcloud alpha network-security backend-authentication-configs import + + $ gcloud beta network-security backend-authentication-configs import + diff --git a/gcloud/network-security/backend-authentication-configs/list b/gcloud/network-security/backend-authentication-configs/list new file mode 100644 index 000000000..f890f1db4 --- /dev/null +++ b/gcloud/network-security/backend-authentication-configs/list @@ -0,0 +1,89 @@ +NAME + gcloud network-security backend-authentication-configs list - list + BackendAuthenticationConfigs + +SYNOPSIS + gcloud network-security backend-authentication-configs list + [--location=LOCATION] [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List all BackendAuthenticationConfigs in the current project. + +EXAMPLES + To list BackendAuthenticationConfigs in the current project, run: + + $ gcloud network-security backend-authentication-configs list + +FLAGS + Location resource - The location of the BackendAuthenticationConfigs to + display. This represents a Cloud resource. (NOTE) Some attributes are not + given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ if left empty, will use the wildcard '-' to list all locations 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; + ▸ if left empty, will use the wildcard '-' to list all locations. + +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. + +API REFERENCE + This command uses the networksecurity/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + These variants are also available: + + $ gcloud alpha network-security backend-authentication-configs list + + $ gcloud beta network-security backend-authentication-configs list + diff --git a/gcloud/network-security/help b/gcloud/network-security/help index b35bd4166..de2a82514 100644 --- a/gcloud/network-security/help +++ b/gcloud/network-security/help @@ -21,6 +21,9 @@ GROUPS authorization-policies Manage Network Security AuthorizationPolicies. + backend-authentication-configs + Manage Network Security BackendAuthenticationConfigs. + client-tls-policies Manage Network Security ClientTlsPolicies. diff --git a/gcloud/privateca/subordinates/update b/gcloud/privateca/subordinates/update index cb4794d39..703c1f5ff 100644 --- a/gcloud/privateca/subordinates/update +++ b/gcloud/privateca/subordinates/update @@ -63,7 +63,8 @@ POSITIONAL ARGUMENTS FLAGS --pem-chain=PEM_CHAIN A file containing a list of PEM-encoded certificates that represent the - issuing chain of this CA. + issuing chain of this CA. Please note that the certificate + corresponding to this specific CA should be excluded. --update-labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to update. If a label exists, its value diff --git a/gcloud/spanner/backups/create b/gcloud/spanner/backups/create index f7a98152e..3574613a1 100644 --- a/gcloud/spanner/backups/create +++ b/gcloud/spanner/backups/create @@ -90,7 +90,7 @@ OPTIONAL FLAGS The encryption type of the backup. ENCRYPTION_TYPE must be one of: customer-managed-encryption - Use the provided Cloud KMS key for encryption. If this option is + Use the provided Cloud KMS key for encryption.If this option is selected, kms-key must be set. google-default-encryption Use Google default encryption. diff --git a/gcloud/storage/batch-operations/jobs/create b/gcloud/storage/batch-operations/jobs/create index ca096c4e8..6c684a16f 100644 --- a/gcloud/storage/batch-operations/jobs/create +++ b/gcloud/storage/batch-operations/jobs/create @@ -108,8 +108,10 @@ REQUIRED FLAGS custom time for Cloud Storage objects in RFC 3339 format, specify the key-value pair Custom-Time={VALUE}. To set custom metadata on objects, specify key-value pairs {CUSTOM-KEY}:{VALUE}. Note that all - predefined keys are case-insensitive. Multiple key-value pairs can be - specified by separating them with commas. For example, + predefined keys (e.g. Content-Disposition) are case-insensitive. Any + other key that is not specified above will be treated as a custom + key. Multiple key-value pairs can be specified by separating them + with commas. For example, --put-metadata=Content-Disposition=inline,Content-Encoding=gzip --rewrite-object=KEY=VALUE,[KEY=VALUE,...]