diff --git a/gcloud/_version b/gcloud/_version index 332cb3d18..afd3c2fc9 100644 --- a/gcloud/_version +++ b/gcloud/_version @@ -1,8 +1,8 @@ -Google Cloud SDK 483.0.0 -alpha 2024.06.28 -beta 2024.06.28 -bq 2.1.6 +Google Cloud SDK 484.0.0 +alpha 2024.07.12 +beta 2024.07.12 +bq 2.1.7 bundled-python3-unix 3.11.8 -core 2024.06.28 +core 2024.07.12 gcloud-crc32c 1.0.0 gsutil 5.30 diff --git a/gcloud/alloydb/clusters/create b/gcloud/alloydb/clusters/create index 15ce55926..30ec843e2 100644 --- a/gcloud/alloydb/clusters/create +++ b/gcloud/alloydb/clusters/create @@ -67,8 +67,8 @@ OPTIONAL FLAGS --network=NETWORK Network in the current project that the instance will be part of. To specify using a network with a shared VPC, use the full URL of the - network. For an example host project, 'testproject', and shared - network, 'testsharednetwork', this would be of the + network. For an example host project, testproject, and shared network, + testsharednetwork, this would be of the form:--network=projects/testproject/global/networks/testsharednetwork Continuous Backup configuration. If unspecified, continuous backups are @@ -154,9 +154,9 @@ OPTIONAL FLAGS in this group are specified. --automated-backup-window=TIMEOUT_PERIOD - The length of the time window beginning at start time during which - a backup can be taken. If a backup does not succeed within this - time window, it will be canceled and considered failed. The backup + Length of the time window beginning at start time during which a + backup can be taken. If a backup does not succeed within this time + window, it will be canceled and considered failed. The backup window must be at least 5 minutes long. There is no upper bound on the window. If not set, it will default to 1 hour. diff --git a/gcloud/alloydb/clusters/restore b/gcloud/alloydb/clusters/restore index 87a78e04e..bc0887b1c 100644 --- a/gcloud/alloydb/clusters/restore +++ b/gcloud/alloydb/clusters/restore @@ -87,8 +87,8 @@ OPTIONAL FLAGS --network=NETWORK Network in the current project that the instance will be part of. To specify using a network with a shared VPC, use the full URL of the - network. For an example host project, 'testproject', and shared - network, 'testsharednetwork', this would be of the + network. For an example host project, testproject, and shared network, + testsharednetwork, this would be of the form:--network=projects/testproject/global/networks/testsharednetwork Key resource - The Cloud KMS (Key Management Service) cryptokey that will diff --git a/gcloud/alloydb/clusters/update b/gcloud/alloydb/clusters/update index d6c271a70..abd54d750 100644 --- a/gcloud/alloydb/clusters/update +++ b/gcloud/alloydb/clusters/update @@ -70,9 +70,9 @@ OPTIONAL FLAGS (e.g., --automated-backup-start-times=01:00,13:00) --automated-backup-window=TIMEOUT_PERIOD - The length of the time window beginning at start time during which - a backup can be taken. If a backup does not succeed within this - time window, it will be canceled and considered failed. The backup + Length of the time window beginning at start time during which a + backup can be taken. If a backup does not succeed within this time + window, it will be canceled and considered failed. The backup window must be at least 5 minutes long. There is no upper bound on the window. If not set, it will default to 1 hour. diff --git a/gcloud/alpha/alloydb/clusters/create b/gcloud/alpha/alloydb/clusters/create index 5fa176e05..dde684128 100644 --- a/gcloud/alpha/alloydb/clusters/create +++ b/gcloud/alpha/alloydb/clusters/create @@ -68,8 +68,8 @@ OPTIONAL FLAGS --network=NETWORK Network in the current project that the instance will be part of. To specify using a network with a shared VPC, use the full URL of the - network. For an example host project, 'testproject', and shared - network, 'testsharednetwork', this would be of the + network. For an example host project, testproject, and shared network, + testsharednetwork, this would be of the form:--network=projects/testproject/global/networks/testsharednetwork --subscription-type=SUBSCRIPTION_TYPE @@ -159,9 +159,9 @@ OPTIONAL FLAGS in this group are specified. --automated-backup-window=TIMEOUT_PERIOD - The length of the time window beginning at start time during which - a backup can be taken. If a backup does not succeed within this - time window, it will be canceled and considered failed. The backup + Length of the time window beginning at start time during which a + backup can be taken. If a backup does not succeed within this time + window, it will be canceled and considered failed. The backup window must be at least 5 minutes long. There is no upper bound on the window. If not set, it will default to 1 hour. diff --git a/gcloud/alpha/alloydb/clusters/restore b/gcloud/alpha/alloydb/clusters/restore index c9c581202..a1a856e1a 100644 --- a/gcloud/alpha/alloydb/clusters/restore +++ b/gcloud/alpha/alloydb/clusters/restore @@ -87,8 +87,8 @@ OPTIONAL FLAGS --network=NETWORK Network in the current project that the instance will be part of. To specify using a network with a shared VPC, use the full URL of the - network. For an example host project, 'testproject', and shared - network, 'testsharednetwork', this would be of the + network. For an example host project, testproject, and shared network, + testsharednetwork, this would be of the form:--network=projects/testproject/global/networks/testsharednetwork Key resource - The Cloud KMS (Key Management Service) cryptokey that will diff --git a/gcloud/alpha/alloydb/clusters/update b/gcloud/alpha/alloydb/clusters/update index 3883b8387..65efa926d 100644 --- a/gcloud/alpha/alloydb/clusters/update +++ b/gcloud/alpha/alloydb/clusters/update @@ -75,9 +75,9 @@ OPTIONAL FLAGS (e.g., --automated-backup-start-times=01:00,13:00) --automated-backup-window=TIMEOUT_PERIOD - The length of the time window beginning at start time during which - a backup can be taken. If a backup does not succeed within this - time window, it will be canceled and considered failed. The backup + Length of the time window beginning at start time during which a + backup can be taken. If a backup does not succeed within this time + window, it will be canceled and considered failed. The backup window must be at least 5 minutes long. There is no upper bound on the window. If not set, it will default to 1 hour. diff --git a/gcloud/alpha/alloydb/instances/restart b/gcloud/alpha/alloydb/instances/restart index 503bd08b3..949053fc1 100644 --- a/gcloud/alpha/alloydb/instances/restart +++ b/gcloud/alpha/alloydb/instances/restart @@ -4,7 +4,8 @@ NAME SYNOPSIS gcloud alpha alloydb instances restart INSTANCE --cluster=CLUSTER - --region=REGION [--async] [GCLOUD_WIDE_FLAG ...] + --region=REGION [--async] [--node-ids=[NODE_IDS,...]] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Restarts an AlloyDB instance within a given cluster. @@ -32,6 +33,10 @@ OPTIONAL FLAGS Return immediately, without waiting for the operation in progress to complete. + --node-ids=[NODE_IDS,...] + Comma-separated list of node IDs. Only supported for read pool + instances. (e.g., --node-ids=node-1,node-2,node-3) + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/asset/analyze-org-policy-governed-resources b/gcloud/alpha/asset/analyze-org-policy-governed-resources deleted file mode 100644 index cf6aad3c7..000000000 --- a/gcloud/alpha/asset/analyze-org-policy-governed-resources +++ /dev/null @@ -1,81 +0,0 @@ -NAME - gcloud alpha asset analyze-org-policy-governed-resources - analyze - organization policies governed resources under a scope - -SYNOPSIS - gcloud alpha asset analyze-org-policy-governed-resources - --constraint=CONSTRAINT --scope=SCOPE [--filter=EXPRESSION] - [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Analyze organization policies governed resources under a scope. - -EXAMPLES - To list 10 resources governed by a constraint in an organization, run: - - $ gcloud alpha asset analyze-org-policy-governed-resources \ - --scope=organizations/YOUR_ORG_ID \ - --constraint=YOUR_CONSTRAINT_NAME --limit=10 - -REQUIRED FLAGS - --constraint=CONSTRAINT - The name of the constraint to analyze organization policies for. The - response only contains analyzed organization policies for the provided - constraint. - - Examples: - - ◆ ``organizations/{ORGANIZATION_NUMBER}/customConstraints/{CUSTOM_CONSTRAINT_NAME} - for a user-defined custom constraint. - - --scope=SCOPE - Scope can only be an organization for now. The analysis is limited to - the Cloud org policies and resources within this scope. The caller must - be granted the cloudasset.assets.searchAllResources permission on the - desired scope. - - The allowed values are: - - ◆ organizations/{ORGANIZATION_NUMBER} (e.g. organizations/123456) - -LIST COMMAND FLAGS - --filter=EXPRESSION - Apply a Boolean filter EXPRESSION to each resource item to be listed. - If the expression evaluates True, then that item is listed. For more - details and examples of filter expressions, run $ gcloud topic filters. - This flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --limit=LIMIT - Maximum number of resources to list. The default is unlimited. This - flag interacts with other flags that are applied in this order: - --flatten, --sort-by, --filter, --limit. - - --page-size=PAGE_SIZE - Some services group resource list output into pages. This flag - specifies the maximum number of resources per page. The default is - determined by the service if it supports paging, otherwise it is - unlimited (no paging). Paging may be applied before or after --filter - and --limit depending on the service. - - --sort-by=[FIELD,...] - Comma-separated list of resource field key names to sort by. The - default order is ascending. Prefix a field with ``~'' for descending - order on that field. This flag interacts with other flags that are - applied in this order: --flatten, --sort-by, --filter, --limit. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -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/asset/help b/gcloud/alpha/asset/help index c0479efa2..ac367b718 100644 --- a/gcloud/alpha/asset/help +++ b/gcloud/alpha/asset/help @@ -41,9 +41,6 @@ COMMANDS (ALPHA) Analyze organization policies governed containers under a scope. - analyze-org-policy-governed-resources - (ALPHA) Analyze organization policies governed resources under a scope. - export (ALPHA) Export the cloud assets to Google Cloud Storage/BigQuery. diff --git a/gcloud/alpha/bigtable/backups/update b/gcloud/alpha/bigtable/backups/update index 3ad12b22a..77988a690 100644 --- a/gcloud/alpha/bigtable/backups/update +++ b/gcloud/alpha/bigtable/backups/update @@ -5,8 +5,8 @@ NAME SYNOPSIS gcloud alpha bigtable backups update (BACKUP : --cluster=CLUSTER --instance=INSTANCE) - (--expiration-date=EXPIRATION_DATE - | --retention-period=RETENTION_PERIOD) [GCLOUD_WIDE_FLAG ...] + [--expiration-date=EXPIRATION_DATE + | --retention-period=RETENTION_PERIOD] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Update a backup, only supported for the following fields: @@ -58,8 +58,8 @@ POSITIONAL ARGUMENTS specified name; ▸ provide the argument --instance on the command line. -REQUIRED FLAGS - Exactly one of these must be specified: +FLAGS + At most one of these can be specified: --expiration-date=EXPIRATION_DATE Absolute expiration time of the backup; must be at least 6 hours and diff --git a/gcloud/alpha/builds/worker-pools/create b/gcloud/alpha/builds/worker-pools/create index bc36128db..fae6a9a01 100644 --- a/gcloud/alpha/builds/worker-pools/create +++ b/gcloud/alpha/builds/worker-pools/create @@ -3,8 +3,8 @@ NAME Cloud Build SYNOPSIS - gcloud alpha builds worker-pools create WORKER_POOL --region=REGION - [--generation=GENERATION; default=1] + gcloud alpha builds worker-pools create WORKER_POOL + [--generation=GENERATION; default=1] [--region=REGION] [--config-from-file=CONFIG_FROM_FILE | --disable-public-ip-address --network-attachment=NETWORK_ATTACHMENT --route-all-traffic | --peered-network=PEERED_NETWORK @@ -50,15 +50,14 @@ POSITIONAL ARGUMENTS Unique identifier for the worker pool to create. This value should be 1-63 characters, and valid characters are [a-z][0-9]- -REQUIRED FLAGS +FLAGS + --generation=GENERATION; default=1 + Generation of the worker pool. + --region=REGION Cloud region where the worker pool is created. See https://cloud.google.com/build/docs/locations for available locations. -OPTIONAL FLAGS - --generation=GENERATION; default=1 - Generation of the worker pool. - At most one of these can be specified: --config-from-file=CONFIG_FROM_FILE diff --git a/gcloud/alpha/builds/worker-pools/delete b/gcloud/alpha/builds/worker-pools/delete index 987eaa0e6..95472957f 100644 --- a/gcloud/alpha/builds/worker-pools/delete +++ b/gcloud/alpha/builds/worker-pools/delete @@ -3,8 +3,9 @@ NAME Google Cloud Build SYNOPSIS - gcloud alpha builds worker-pools delete WORKER_POOL --region=REGION - [--generation=GENERATION; default=1] [GCLOUD_WIDE_FLAG ...] + gcloud alpha builds worker-pools delete WORKER_POOL + [--generation=GENERATION; default=1] [--region=REGION] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Delete a private worker pool from Google Cloud Build. @@ -18,14 +19,13 @@ POSITIONAL ARGUMENTS WORKER_POOL The ID of the worker pool to delete. -REQUIRED FLAGS - --region=REGION - The Cloud region where the worker pool is. - -OPTIONAL FLAGS +FLAGS --generation=GENERATION; default=1 Generation of the worker pool. + --region=REGION + The Cloud region where the worker pool is. + 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/builds/worker-pools/describe b/gcloud/alpha/builds/worker-pools/describe index 7225ca764..1ced533f7 100644 --- a/gcloud/alpha/builds/worker-pools/describe +++ b/gcloud/alpha/builds/worker-pools/describe @@ -3,8 +3,9 @@ NAME Cloud Build SYNOPSIS - gcloud alpha builds worker-pools describe WORKER_POOL --region=REGION - [--generation=GENERATION; default=1] [GCLOUD_WIDE_FLAG ...] + gcloud alpha builds worker-pools describe WORKER_POOL + [--generation=GENERATION; default=1] [--region=REGION] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Describe a worker pool used by Cloud Build. @@ -19,14 +20,13 @@ POSITIONAL ARGUMENTS WORKER_POOL The ID of the worker pool to describe. -REQUIRED FLAGS - --region=REGION - The Cloud region where the worker pool is. - -OPTIONAL FLAGS +FLAGS --generation=GENERATION; default=1 Generation of the worker pool. + --region=REGION + The Cloud region where the worker pool is. + 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/builds/worker-pools/list b/gcloud/alpha/builds/worker-pools/list index dbb848a72..56fbfd111 100644 --- a/gcloud/alpha/builds/worker-pools/list +++ b/gcloud/alpha/builds/worker-pools/list @@ -3,9 +3,9 @@ NAME Cloud project SYNOPSIS - gcloud alpha builds worker-pools list --region=REGION - [--generation=GENERATION; default=1] [--filter=EXPRESSION] - [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + gcloud alpha builds worker-pools list [--generation=GENERATION; default=1] + [--region=REGION] [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -16,14 +16,13 @@ EXAMPLES $ gcloud alpha builds worker-pools list --region=us-central1 -REQUIRED FLAGS - --region=REGION - The Cloud region to list worker pools in. - FLAGS --generation=GENERATION; default=1 Generation of the worker pool. + --region=REGION + The Cloud region to list worker pools in. + LIST COMMAND FLAGS --filter=EXPRESSION Apply a Boolean filter EXPRESSION to each resource item to be listed. diff --git a/gcloud/alpha/builds/worker-pools/update b/gcloud/alpha/builds/worker-pools/update index f263bd431..ceecea577 100644 --- a/gcloud/alpha/builds/worker-pools/update +++ b/gcloud/alpha/builds/worker-pools/update @@ -3,11 +3,12 @@ NAME Cloud Build SYNOPSIS - gcloud alpha builds worker-pools update WORKER_POOL --region=REGION + gcloud alpha builds worker-pools update WORKER_POOL (--config-from-file=CONFIG_FROM_FILE | --[no-]public-egress --worker-disk-size=WORKER_DISK_SIZE --worker-machine-type=WORKER_MACHINE_TYPE) - [--generation=GENERATION; default=1] [GCLOUD_WIDE_FLAG ...] + [--generation=GENERATION; default=1] [--region=REGION] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Update a private pool used by Cloud Build. @@ -25,10 +26,6 @@ POSITIONAL ARGUMENTS 1-63 characters, and valid characters are [a-z][0-9]- REQUIRED FLAGS - --region=REGION - Cloud region where the worker pool is updated. See - https://cloud.google.com/build/docs/locations for available locations. - Exactly one of these must be specified: --config-from-file=CONFIG_FROM_FILE @@ -67,6 +64,10 @@ OPTIONAL FLAGS --generation=GENERATION; default=1 Generation of the worker pool. + --region=REGION + Cloud region where the worker pool is updated. See + https://cloud.google.com/build/docs/locations for available locations. + 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/images/help b/gcloud/alpha/compute/images/help index ac169d0f2..4bbff5681 100644 --- a/gcloud/alpha/compute/images/help +++ b/gcloud/alpha/compute/images/help @@ -59,7 +59,7 @@ COMMANDS (ALPHA) Get the IAM policy for a Compute Engine image. import - (ALPHA) Import an image into Compute Engine. + (ALPHA) (DEPRECATED) Import an image into Compute Engine. list (ALPHA) List Google Compute Engine images. diff --git a/gcloud/alpha/compute/images/import b/gcloud/alpha/compute/images/import index 052f08b5b..5298f2c74 100644 --- a/gcloud/alpha/compute/images/import +++ b/gcloud/alpha/compute/images/import @@ -20,11 +20,12 @@ SYNOPSIS [--data-disk | --byol --os=OS] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) gcloud alpha compute images import imports Virtual Disk images, - such as VMWare VMDK files and VHD files, into Compute Engine. + (ALPHA) (DEPRECATED) This command is being deprecated. Instead, use the + gcloud migration vms image-imports command. For more information, see + https://cloud.google.com/migrate/virtual-machines/docs/5.0/migrate/image_import. - NOTE: It is recommended to use the new Image Import. Run "gcloud alpha - migration vms image-imports --help" for details. + gcloud alpha compute images import imports Virtual Disk images, such as + VMWare VMDK files and VHD files, into Compute Engine. Importing images involves four steps: ▪ Upload the virtual disk file to Cloud Storage. diff --git a/gcloud/alpha/compute/instance-templates/create b/gcloud/alpha/compute/instance-templates/create index eec9089a7..ea8adcae6 100644 --- a/gcloud/alpha/compute/instance-templates/create +++ b/gcloud/alpha/compute/instance-templates/create @@ -56,7 +56,7 @@ SYNOPSIS [--source-instance-zone=SOURCE_INSTANCE_ZONE] [--stack-type=STACK_TYPE] [--subnet=SUBNET] [--subnet-region=SUBNET_REGION] [--tags=TAG,[TAG,...]] [--termination-time=TERMINATION_TIME] - [--threads-per-core=THREADS_PER_CORE] + [--threads-per-core=THREADS_PER_CORE] [--turbo-mode=TURBO_MODE] [--visible-core-count=VISIBLE_CORE_COUNT] [--address=ADDRESS | --no-address] [--boot-disk-kms-key=BOOT_DISK_KMS_KEY @@ -978,6 +978,9 @@ FLAGS For more information about configuring SMT, see: https://cloud.google.com/compute/docs/instances/configuring-simultaneous-multithreading. + --turbo-mode=TURBO_MODE + Specifies the turbo frequency of the instance. + --visible-core-count=VISIBLE_CORE_COUNT The number of physical cores to expose to the instance's guest operating system. The number of virtual CPUs visible to the instance's diff --git a/gcloud/alpha/compute/instances/bulk/create b/gcloud/alpha/compute/instances/bulk/create index 060b13912..3f1bc0b67 100644 --- a/gcloud/alpha/compute/instances/bulk/create +++ b/gcloud/alpha/compute/instances/bulk/create @@ -49,7 +49,7 @@ SYNOPSIS [--stack-type=STACK_TYPE] [--subnet=SUBNET] [--tags=TAG,[TAG,...]] [--target-distribution-shape=SHAPE] [--termination-time=TERMINATION_TIME] - [--threads-per-core=THREADS_PER_CORE] + [--threads-per-core=THREADS_PER_CORE] [--turbo-mode=TURBO_MODE] [--visible-core-count=VISIBLE_CORE_COUNT] [--boot-disk-kms-key=BOOT_DISK_KMS_KEY : --boot-disk-kms-keyring=BOOT_DISK_KMS_KEYRING @@ -868,6 +868,9 @@ OPTIONAL FLAGS For more information about configuring SMT, see: https://cloud.google.com/compute/docs/instances/configuring-simultaneous-multithreading. + --turbo-mode=TURBO_MODE + Specifies the turbo frequency of the instance. + --visible-core-count=VISIBLE_CORE_COUNT The number of physical cores to expose to the instance's guest operating system. The number of virtual CPUs visible to the instance's diff --git a/gcloud/alpha/compute/instances/create b/gcloud/alpha/compute/instances/create index 8700037f0..0249d25c2 100644 --- a/gcloud/alpha/compute/instances/create +++ b/gcloud/alpha/compute/instances/create @@ -65,7 +65,7 @@ SYNOPSIS [--source-machine-image-csek-key-file=FILE] [--stack-type=STACK_TYPE] [--subnet=SUBNET] [--tags=TAG,[TAG,...]] [--termination-time=TERMINATION_TIME] - [--threads-per-core=THREADS_PER_CORE] + [--threads-per-core=THREADS_PER_CORE] [--turbo-mode=TURBO_MODE] [--visible-core-count=VISIBLE_CORE_COUNT] [--zone=ZONE] [--address=ADDRESS | --no-address] [--boot-disk-kms-key=BOOT_DISK_KMS_KEY @@ -997,6 +997,9 @@ FLAGS For more information about configuring SMT, see: https://cloud.google.com/compute/docs/instances/configuring-simultaneous-multithreading. + --turbo-mode=TURBO_MODE + Specifies the turbo frequency of the instance. + --visible-core-count=VISIBLE_CORE_COUNT The number of physical cores to expose to the instance's guest operating system. The number of virtual CPUs visible to the instance's diff --git a/gcloud/alpha/compute/queued-resources/create b/gcloud/alpha/compute/queued-resources/create index 9b4e1a0e8..e28ac8e87 100644 --- a/gcloud/alpha/compute/queued-resources/create +++ b/gcloud/alpha/compute/queued-resources/create @@ -49,7 +49,7 @@ SYNOPSIS [--stack-type=STACK_TYPE] [--subnet=SUBNET] [--tags=TAG,[TAG,...]] [--target-distribution-shape=SHAPE] [--termination-time=TERMINATION_TIME] - [--threads-per-core=THREADS_PER_CORE] + [--threads-per-core=THREADS_PER_CORE] [--turbo-mode=TURBO_MODE] [--visible-core-count=VISIBLE_CORE_COUNT] [--zone=ZONE] [--boot-disk-kms-key=BOOT_DISK_KMS_KEY : --boot-disk-kms-keyring=BOOT_DISK_KMS_KEYRING @@ -841,6 +841,9 @@ OPTIONAL FLAGS For more information about configuring SMT, see: https://cloud.google.com/compute/docs/instances/configuring-simultaneous-multithreading. + --turbo-mode=TURBO_MODE + Specifies the turbo frequency of the instance. + --visible-core-count=VISIBLE_CORE_COUNT The number of physical cores to expose to the instance's guest operating system. The number of virtual CPUs visible to the instance's diff --git a/gcloud/alpha/compute/routers/add-route-policy-term b/gcloud/alpha/compute/routers/add-route-policy-term new file mode 100644 index 000000000..c63060dee --- /dev/null +++ b/gcloud/alpha/compute/routers/add-route-policy-term @@ -0,0 +1,68 @@ +NAME + gcloud alpha compute routers add-route-policy-term - adds a new term to an + existing route policy of a Comute Engine router + +SYNOPSIS + gcloud alpha compute routers add-route-policy-term NAME + --actions=[ACTION;...] --match=MATCH --policy-name=POLICY_NAME + --priority=PRIORITY [--region=REGION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) gcloud alpha compute routers add-route-policy-term adds a term to a + route policy. + +POSITIONAL ARGUMENTS + NAME + Name of the router to update. + +REQUIRED FLAGS + --actions=[ACTION;...] + Semicolon separated CEL expressions for the actions to take when the + rule matches. + + --match=MATCH + CEL expression for matching a route. + + --policy-name=POLICY_NAME + Name of the route policy to which to add the term. + + --priority=PRIORITY + Order of the term within the policy. + +OPTIONAL FLAGS + --region=REGION + Region of the router to update. If not specified, you might be prompted + to select a region (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/region property: + + $ gcloud config set compute/region REGION + + A list of regions can be fetched by running: + + $ gcloud compute regions list + + To unset the property, run: + + $ gcloud config unset compute/region + + Alternatively, the region can be stored in the environment variable + CLOUDSDK_COMPUTE_REGION. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta compute routers add-route-policy-term + diff --git a/gcloud/alpha/compute/routers/help b/gcloud/alpha/compute/routers/help index 0b17d9c35..6f803e6ba 100644 --- a/gcloud/alpha/compute/routers/help +++ b/gcloud/alpha/compute/routers/help @@ -38,6 +38,10 @@ COMMANDS add-route-policy (ALPHA) Add an empty route policy to a Compute Engine router. + add-route-policy-term + (ALPHA) Adds a new term to an existing route policy of a Comute Engine + router. + create (ALPHA) Create a Compute Engine router. @@ -81,6 +85,9 @@ COMMANDS remove-route-policy (ALPHA) Remove a route policy from a Compute Engine router. + remove-route-policy-term + (ALPHA) Remove a route policy term of a Compute Engine router. + update (ALPHA) Update a Compute Engine router. @@ -90,6 +97,10 @@ COMMANDS update-interface (ALPHA) Update an interface on a Compute Engine router. + update-route-policy-term + (ALPHA) Updates a term of an existing route policy of a Comute Engine + router. + upload-route-policy (ALPHA) Upload a route policy into a Compute Engine router. diff --git a/gcloud/alpha/compute/routers/remove-route-policy-term b/gcloud/alpha/compute/routers/remove-route-policy-term new file mode 100644 index 000000000..dd1bf1b65 --- /dev/null +++ b/gcloud/alpha/compute/routers/remove-route-policy-term @@ -0,0 +1,62 @@ +NAME + gcloud alpha compute routers remove-route-policy-term - remove a route + policy term of a Compute Engine router + +SYNOPSIS + gcloud alpha compute routers remove-route-policy-term NAME + --policy-name=POLICY_NAME --priority=PRIORITY [--region=REGION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) gcloud alpha compute routers remove-route-policy-term removes a + term of a route policy. + +POSITIONAL ARGUMENTS + NAME + Name of the router to remove a route policy term from. + +REQUIRED FLAGS + --policy-name=POLICY_NAME + Name of the route policy from which the term should be removed. + + --priority=PRIORITY + Order of the term within the policy. + +OPTIONAL FLAGS + --region=REGION + Region of the router to remove a route policy term from. If not + specified, you might be prompted to select a region (interactive mode + only). + + To avoid prompting when this flag is omitted, you can set the + compute/region property: + + $ gcloud config set compute/region REGION + + A list of regions can be fetched by running: + + $ gcloud compute regions list + + To unset the property, run: + + $ gcloud config unset compute/region + + Alternatively, the region can be stored in the environment variable + CLOUDSDK_COMPUTE_REGION. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta compute routers remove-route-policy-term + diff --git a/gcloud/alpha/compute/routers/update-route-policy-term b/gcloud/alpha/compute/routers/update-route-policy-term new file mode 100644 index 000000000..d8d5e1776 --- /dev/null +++ b/gcloud/alpha/compute/routers/update-route-policy-term @@ -0,0 +1,82 @@ +NAME + gcloud alpha compute routers update-route-policy-term - updates a term of + an existing route policy of a Comute Engine router + +SYNOPSIS + gcloud alpha compute routers update-route-policy-term NAME + --actions=[ACTION;...] --match=MATCH --policy-name=POLICY_NAME + --priority=PRIORITY [--region=REGION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Updates a term of an existing route policy of a Comute Engine + router. + + gcloud alpha compute routers update-route-policy-term updates a term of a + route policy. + + For an example, refer to the EXAMPLES section below. + +EXAMPLES + To update a term of a route policy, run: + + $ gcloud alpha compute routers update-route-policy-term \ + example-router --region=router-region \ + --policy-name=example-policy-name --priority=128 \ + --match="destination == '192.168.0.0/24'" \ + --actions="med.set(12345);asPath.prependSequence([1, 2])" + +POSITIONAL ARGUMENTS + NAME + Name of the router to update. + +REQUIRED FLAGS + --actions=[ACTION;...] + Semicolon separated CEL expressions for the actions to take when the + rule matches. + + --match=MATCH + CEL expression for matching a route. + + --policy-name=POLICY_NAME + Name of the route policy to which the term should be updated. + + --priority=PRIORITY + Order of the term within the policy. + +OPTIONAL FLAGS + --region=REGION + Region of the router to update. If not specified, you might be prompted + to select a region (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/region property: + + $ gcloud config set compute/region REGION + + A list of regions can be fetched by running: + + $ gcloud compute regions list + + To unset the property, run: + + $ gcloud config unset compute/region + + Alternatively, the region can be stored in the environment variable + CLOUDSDK_COMPUTE_REGION. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta compute routers update-route-policy-term + diff --git a/gcloud/alpha/compute/tpus/queued-resources/create b/gcloud/alpha/compute/tpus/queued-resources/create index f382d0602..701f3a4c6 100644 --- a/gcloud/alpha/compute/tpus/queued-resources/create +++ b/gcloud/alpha/compute/tpus/queued-resources/create @@ -102,7 +102,7 @@ REQUIRED FLAGS in this group are specified. --type=TYPE - Type of TPU. TYPE must be one of: v2, v3, v4, v5litepod, v5p. + Type of TPU. TYPE must be one of: v2, v3, v4, v5litepod, v5p, v6e. This flag argument must be specified if any of the other arguments in this group are specified. diff --git a/gcloud/alpha/compute/tpus/reservations/list b/gcloud/alpha/compute/tpus/reservations/list index 87dae4eb2..e8eff7950 100644 --- a/gcloud/alpha/compute/tpus/reservations/list +++ b/gcloud/alpha/compute/tpus/reservations/list @@ -20,9 +20,9 @@ FLAGS Location resource - Zone of the Reservation. To find a list of zones available for Cloud TPUs in your project, run - gcloud alpha compute tpus reservations locations list. This represents a - Cloud resource. (NOTE) Some attributes are not given arguments in this - group but can be set in other ways. + gcloud alpha compute tpus locations list. 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 --zone on the command line with a fully diff --git a/gcloud/alpha/compute/tpus/tpu-vm/create b/gcloud/alpha/compute/tpus/tpu-vm/create index b2767fa36..2c9bd405b 100644 --- a/gcloud/alpha/compute/tpus/tpu-vm/create +++ b/gcloud/alpha/compute/tpus/tpu-vm/create @@ -233,7 +233,7 @@ OPTIONAL FLAGS in this group are specified. --type=TYPE - Type of TPU. TYPE must be one of: v2, v3, v4, v5litepod, v5p. + Type of TPU. TYPE must be one of: v2, v3, v4, v5litepod, v5p, v6e. This flag argument must be specified if any of the other arguments in this group are specified. diff --git a/gcloud/alpha/container/clusters/create b/gcloud/alpha/container/clusters/create index 26d97ff14..88f1ff1a3 100644 --- a/gcloud/alpha/container/clusters/create +++ b/gcloud/alpha/container/clusters/create @@ -40,7 +40,8 @@ SYNOPSIS [--enable-logging-monitoring-system-only] [--enable-managed-prometheus] [--enable-master-global-access] [--enable-multi-networking] [--enable-nested-virtualization] [--enable-network-policy] - [--enable-pod-security-policy] [--enable-secret-manager] + [--enable-pod-security-policy] [--enable-ray-cluster-logging] + [--enable-ray-cluster-monitoring] [--enable-secret-manager] [--enable-service-externalips] [--enable-shielded-nodes] [--enable-stackdriver-kubernetes] [--enable-vertical-pod-autoscaling] [--fleet-project=PROJECT_ID_OR_NUMBER] [--gateway-api=GATEWAY_API] @@ -205,7 +206,7 @@ FLAGS ADDON must be one of: HttpLoadBalancing, HorizontalPodAutoscaling, KubernetesDashboard, NetworkPolicy, NodeLocalDNS, ConfigConnector, GcePersistentDiskCsiDriver, GcpFilestoreCsiDriver, BackupRestore, - GcsFuseCsiDriver, Istio, CloudBuild, CloudRun. + GcsFuseCsiDriver, RayOperator, Istio, CloudBuild, CloudRun. --allow-route-overlap Allows the provided cluster CIDRs to overlap with existing routes that @@ -652,6 +653,12 @@ FLAGS API objects. For more information, see https://cloud.google.com/kubernetes-engine/docs/how-to/pod-security-policies. + --enable-ray-cluster-logging + Enable automatic log processing sidecar for Ray clusters. + + --enable-ray-cluster-monitoring + Enable automatic metrics collection for Ray clusters. + --enable-secret-manager Enables the Secret Manager CSI driver provider component. See https://secrets-store-csi-driver.sigs.k8s.io/introduction @@ -923,7 +930,7 @@ FLAGS Set the components that have monitoring enabled. Valid component values are: SYSTEM, WORKLOAD (Deprecated), NONE, API_SERVER, CONTROLLER_MANAGER, SCHEDULER, DAEMONSET, DEPLOYMENT, HPA, POD, - STATEFULSET, STORAGE + STATEFULSET, STORAGE, CADVISOR, KUBELET, DCGM For more information, see https://cloud.google.com/stackdriver/docs/solutions/gke/installing#available-metrics diff --git a/gcloud/alpha/container/clusters/create-auto b/gcloud/alpha/container/clusters/create-auto index 7c2a3ec88..aca913116 100644 --- a/gcloud/alpha/container/clusters/create-auto +++ b/gcloud/alpha/container/clusters/create-auto @@ -17,14 +17,15 @@ SYNOPSIS [--enable-backup-restore] [--enable-cilium-clusterwide-network-policy] [--enable-fleet] [--enable-google-cloud-access] [--enable-kubernetes-unstable-apis=API,[API,...]] - [--enable-master-global-access] [--enable-secret-manager] - [--fleet-project=PROJECT_ID_OR_NUMBER] [--labels=[KEY=VALUE,...]] - [--logging=[COMPONENT,...]] [--monitoring=[COMPONENT,...]] - [--network=NETWORK] [--private-endpoint-subnetwork=NAME] - [--release-channel=[CHANNEL]] [--security-group=SECURITY_GROUP] - [--security-posture=SECURITY_POSTURE] [--services-ipv4-cidr=CIDR] - [--services-secondary-range-name=NAME] [--subnetwork=SUBNETWORK] - [--workload-policies=WORKLOAD_POLICIES] + [--enable-master-global-access] [--enable-ray-cluster-logging] + [--enable-ray-cluster-monitoring] [--enable-ray-operator] + [--enable-secret-manager] [--fleet-project=PROJECT_ID_OR_NUMBER] + [--labels=[KEY=VALUE,...]] [--logging=[COMPONENT,...]] + [--monitoring=[COMPONENT,...]] [--network=NETWORK] + [--private-endpoint-subnetwork=NAME] [--release-channel=[CHANNEL]] + [--security-group=SECURITY_GROUP] [--security-posture=SECURITY_POSTURE] + [--services-ipv4-cidr=CIDR] [--services-secondary-range-name=NAME] + [--subnetwork=SUBNETWORK] [--workload-policies=WORKLOAD_POLICIES] [--workload-vulnerability-scanning=WORKLOAD_VULNERABILITY_SCANNING] [--additive-vpc-scope-dns-domain=ADDITIVE_VPC_SCOPE_DNS_DOMAIN | --disable-additive-vpc-scope] @@ -243,6 +244,15 @@ FLAGS endpoint from any Google Cloud region or on-premises environment regardless of the private cluster's region. + --enable-ray-cluster-logging + Enable automatic log processing sidecar for Ray clusters. + + --enable-ray-cluster-monitoring + Enable automatic metrics collection for Ray clusters. + + --enable-ray-operator + Enable the Ray Operator GKE add-on. This add-on is disabled by default. + --enable-secret-manager Enables the Secret Manager CSI driver provider component. See https://secrets-store-csi-driver.sigs.k8s.io/introduction @@ -291,7 +301,7 @@ FLAGS Set the components that have monitoring enabled. Valid component values are: SYSTEM, WORKLOAD (Deprecated), NONE, API_SERVER, CONTROLLER_MANAGER, SCHEDULER, DAEMONSET, DEPLOYMENT, HPA, POD, - STATEFULSET, STORAGE + STATEFULSET, STORAGE, CADVISOR, KUBELET, DCGM For more information, see https://cloud.google.com/stackdriver/docs/solutions/gke/installing#available-metrics @@ -299,7 +309,7 @@ FLAGS Examples: $ gcloud alpha container clusters create-auto \ - --monitoring=SYSTEM,API_SERVER,POD + --monitoring=SYSTEM,API_SERVER,POD,DCGM $ gcloud alpha container clusters create-auto --monitoring=SYSTEM --network=NETWORK diff --git a/gcloud/alpha/container/clusters/update b/gcloud/alpha/container/clusters/update index 56a0a3d01..f79a4f440 100644 --- a/gcloud/alpha/container/clusters/update +++ b/gcloud/alpha/container/clusters/update @@ -25,9 +25,10 @@ SYNOPSIS | --enable-master-authorized-networks | --enable-master-global-access | --enable-multi-networking | --enable-network-policy | --enable-pod-security-policy | --enable-private-endpoint - | --enable-secret-manager | --enable-service-externalips - | --enable-shielded-nodes | --enable-stackdriver-kubernetes - | --enable-vertical-pod-autoscaling + | --[no-]enable-ray-cluster-logging + | --[no-]enable-ray-cluster-monitoring | --enable-secret-manager + | --enable-service-externalips | --enable-shielded-nodes + | --enable-stackdriver-kubernetes | --enable-vertical-pod-autoscaling | --fleet-project=PROJECT_ID_OR_NUMBER | --gateway-api=GATEWAY_API | --generate-password | --identity-provider=IDENTITY_PROVIDER | --in-transit-encryption=IN_TRANSIT_ENCRYPTION @@ -413,6 +414,16 @@ REQUIRED FLAGS Enables cluster's control plane to be accessible using private IP address only. + --[no-]enable-ray-cluster-logging + Enable automatic log processing sidecar for Ray clusters. Use + --enable-ray-cluster-logging to enable and + --no-enable-ray-cluster-logging to disable. + + --[no-]enable-ray-cluster-monitoring + Enable automatic metrics collection for Ray clusters. Use + --enable-ray-cluster-monitoring to enable and + --no-enable-ray-cluster-monitoring to disable. + --enable-secret-manager Enables the Secret Manager CSI driver provider component. See https://secrets-store-csi-driver.sigs.k8s.io/introduction @@ -1355,7 +1366,7 @@ REQUIRED FLAGS Set the components that have monitoring enabled. Valid component values are: SYSTEM, WORKLOAD (Deprecated), NONE, API_SERVER, CONTROLLER_MANAGER, SCHEDULER, DAEMONSET, DEPLOYMENT, HPA, POD, - STATEFULSET, STORAGE + STATEFULSET, STORAGE, CADVISOR, KUBELET, DCGM For more information, see https://cloud.google.com/stackdriver/docs/solutions/gke/installing#available-metrics diff --git a/gcloud/alpha/container/fleet/mesh/debug/proxy-config b/gcloud/alpha/container/fleet/mesh/debug/proxy-config index 52eee7c23..d069d94d5 100644 --- a/gcloud/alpha/container/fleet/mesh/debug/proxy-config +++ b/gcloud/alpha/container/fleet/mesh/debug/proxy-config @@ -5,7 +5,7 @@ NAME SYNOPSIS gcloud alpha container fleet mesh debug proxy-config POD_NAME_NAMESPACE --type=TYPE (--membership=MEMBERSHIP : --location=LOCATION) - [GCLOUD_WIDE_FLAG ...] + [--output=OUTPUT] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Retrieve a configuration summary for a given Envoy instance. @@ -17,6 +17,7 @@ EXAMPLES --project=projectId --membership=membershipId --location=us-central1 + --ouput=yaml POSITIONAL ARGUMENTS POD_NAME_NAMESPACE @@ -69,6 +70,10 @@ REQUIRED FLAGS ▸ provide the argument --location on the command line; ▸ set the property gkehub/location. +OPTIONAL FLAGS + --output=OUTPUT + Output format. OUTPUT must be one of: json, yaml. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/container/fleet/mesh/update b/gcloud/alpha/container/fleet/mesh/update index 286153925..b340c077c 100644 --- a/gcloud/alpha/container/fleet/mesh/update +++ b/gcloud/alpha/container/fleet/mesh/update @@ -5,8 +5,9 @@ NAME SYNOPSIS gcloud alpha container fleet mesh update (--fleet-default-member-config=FLEET_DEFAULT_MEMBER_CONFIG - | [(--control-plane=CONTROL_PLANE - --management=MANAGEMENT --origin=ORIGIN) : --membership=MEMBERSHIP + | [(--origin=ORIGIN --config-api=CONFIG_API + | --control-plane=CONTROL_PLANE + | --management=MANAGEMENT) : --membership=MEMBERSHIP | [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]]) [GCLOUD_WIDE_FLAG ...] @@ -33,61 +34,69 @@ REQUIRED FLAGS $ gcloud alpha container fleet mesh update \ --fleet-default-member-config=/path/to/service-mesh.yaml - At least one of these must be specified: + Component options - --control-plane=CONTROL_PLANE - (DEPRECATED) Control plane management to update to. + At least one of these must be specified: - The --control-plane flag is now deprecated. Please use --management - instead. See - https://cloud.google.com/service-mesh/docs/managed/provision-managed-anthos-service-mesh. - CONTROL_PLANE must be one of: automatic, manual. + --origin=ORIGIN + Changing the origin of the membership. ORIGIN must be (only one + value is supported): fleet. - --management=MANAGEMENT - The management mode to update to. MANAGEMENT must be one of: - automatic, manual. + At most one of these can be specified: - --origin=ORIGIN - Changing the origin of the membership. ORIGIN must be (only one - value is supported): fleet. + --config-api=CONFIG_API + The API to use for mesh configuration. CONFIG_API must be one + of: istio, gateway. - At most one of these can be specified: + --control-plane=CONTROL_PLANE + (DEPRECATED) Control plane management to update to. - --membership=MEMBERSHIP - (DEPRECATED) Membership name to update. + The --control-plane flag is now deprecated. Please use + --management instead. See + https://cloud.google.com/service-mesh/docs/managed/provision-managed-anthos-service-mesh. + CONTROL_PLANE must be one of: automatic, manual. - The --membership flag is now deprecated. Please use --memberships - instead. + --management=MANAGEMENT + The management mode to update to. MANAGEMENT must be one of: + automatic, manual. - Membership resource - The group of arguments defining one or more - memberships. 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. + At most one of these can be specified: - To set the project attribute: - ▫ provide the argument --memberships on the command line with a - fully specified name; - ▫ provide the argument --project on the command line; - ▫ set the property core/project. + --membership=MEMBERSHIP + (DEPRECATED) Membership name to update. - --memberships=[MEMBERSHIPS,...] - IDs of the memberships or fully qualified identifiers for the - memberships. + The --membership flag is now deprecated. Please use --memberships + instead. - To set the memberships attribute: - ◇ provide the argument --memberships on the command line. + Membership resource - The group of arguments defining one or more + memberships. 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. - This flag argument must be specified if any of the other - arguments in this group are specified. + To set the project attribute: + ◇ provide the argument --memberships on the command line with a + fully specified name; + ◇ provide the argument --project on the command line; + ◇ set the property core/project. - --location=LOCATION - Location for the memberships. + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. - To set the location attribute: - ◇ provide the argument --memberships on the command line with a - fully specified name; - ◇ provide the argument --location on the command line; - ◇ set the property gkehub/location. + To set the memberships attribute: + ▹ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ▹ provide the argument --memberships on the command line with + a fully specified name; + ▹ provide the argument --location on the command line; + ▹ set the property gkehub/location. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/container/fleet/scopes/help b/gcloud/alpha/container/fleet/scopes/help index 51246b9e2..3f3b0469f 100644 --- a/gcloud/alpha/container/fleet/scopes/help +++ b/gcloud/alpha/container/fleet/scopes/help @@ -48,6 +48,11 @@ COMMANDS (ALPHA) List fleet scopes in a project permitted to be viewed by the caller. + list-app-operator-bindings + (ALPHA) List app operator principals corresponding to a fleet scope and + their roles based on project-level IAM bindings, fleet scope-level IAM + bindings, and fleet scope RBAC role bindings. + list-memberships (ALPHA) List memberships bound to a fleet scope. diff --git a/gcloud/alpha/container/fleet/scopes/list-app-operator-bindings b/gcloud/alpha/container/fleet/scopes/list-app-operator-bindings new file mode 100644 index 000000000..f7b37b924 --- /dev/null +++ b/gcloud/alpha/container/fleet/scopes/list-app-operator-bindings @@ -0,0 +1,106 @@ +NAME + gcloud alpha container fleet scopes list-app-operator-bindings - list app + operator principals corresponding to a fleet scope and their roles + based on project-level IAM bindings, fleet scope-level IAM bindings, + and fleet scope RBAC role bindings + +SYNOPSIS + gcloud alpha container fleet scopes list-app-operator-bindings SCOPE + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) This command lists bindings corresponding to a fleet scope. The + bindings, which consist of an app operator principal and a role, grant + permissions required for an app operator, including usage of fleet scopes, + connect gateway, logging, and metrics. The overarching principal role + (view/edit/admin, or custom) is determined by (1) the fleet scope RBAC role + (view, edit, or admin), (2) the fleet scope-level IAM role + (roles/gkehub.scopeViewer, roles/gkehub.scopeEditor, or + roles/gkehub.scopeAdmin), (3) the project-level IAM role + (roles/gkehub.scopeViewerProjectLevel, or + roles/gkehub.scopeEditorProjectLevel), and (4) the conditional log view + access role for the scope bucket. + + This command can fail for the following reasons: + ▪ The scope specified does not exist. + ▪ The user does not have access to the specified scope. + +EXAMPLES + The following command lists app operator principals corresponding to SCOPE + under PROJECT_ID, their roles, and role details (fleet scope RBAC role, + fleet scope-level IAM role, project-level IAM role, and log view access): + + $ gcloud alpha container fleet scopes list-app-operator-bindings \ + --scope=SCOPE --project=PROJECT_ID + +POSITIONAL ARGUMENTS + Scope resource - The group of arguments defining the Fleet Scope. This + represents a Cloud resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument SCOPE on the command line with a fully specified + name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument SCOPE on the command line with a fully specified + name; + ◆ global is the only supported location. + + This must be specified. + + SCOPE + ID of the scope or fully qualified identifier for the scope. + + To set the scope attribute: + ▸ provide the argument SCOPE on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in 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/container/hub/mesh/debug/proxy-config b/gcloud/alpha/container/hub/mesh/debug/proxy-config index e32a2e028..d5a9827db 100644 --- a/gcloud/alpha/container/hub/mesh/debug/proxy-config +++ b/gcloud/alpha/container/hub/mesh/debug/proxy-config @@ -5,7 +5,7 @@ NAME SYNOPSIS gcloud alpha container hub mesh debug proxy-config POD_NAME_NAMESPACE --type=TYPE (--membership=MEMBERSHIP : --location=LOCATION) - [GCLOUD_WIDE_FLAG ...] + [--output=OUTPUT] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Retrieve a configuration summary for a given Envoy instance. @@ -17,6 +17,7 @@ EXAMPLES --project=projectId --membership=membershipId --location=us-central1 + --ouput=yaml POSITIONAL ARGUMENTS POD_NAME_NAMESPACE @@ -69,6 +70,10 @@ REQUIRED FLAGS ▸ provide the argument --location on the command line; ▸ set the property gkehub/location. +OPTIONAL FLAGS + --output=OUTPUT + Output format. OUTPUT must be one of: json, yaml. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/container/hub/mesh/update b/gcloud/alpha/container/hub/mesh/update index d7bd2d26c..f292cf7cd 100644 --- a/gcloud/alpha/container/hub/mesh/update +++ b/gcloud/alpha/container/hub/mesh/update @@ -5,8 +5,9 @@ NAME SYNOPSIS gcloud alpha container hub mesh update (--fleet-default-member-config=FLEET_DEFAULT_MEMBER_CONFIG - | [(--control-plane=CONTROL_PLANE - --management=MANAGEMENT --origin=ORIGIN) : --membership=MEMBERSHIP + | [(--origin=ORIGIN --config-api=CONFIG_API + | --control-plane=CONTROL_PLANE + | --management=MANAGEMENT) : --membership=MEMBERSHIP | [--memberships=[MEMBERSHIPS,...] : --location=LOCATION]]) [GCLOUD_WIDE_FLAG ...] @@ -33,61 +34,69 @@ REQUIRED FLAGS $ gcloud alpha container hub mesh update \ --fleet-default-member-config=/path/to/service-mesh.yaml - At least one of these must be specified: + Component options - --control-plane=CONTROL_PLANE - (DEPRECATED) Control plane management to update to. + At least one of these must be specified: - The --control-plane flag is now deprecated. Please use --management - instead. See - https://cloud.google.com/service-mesh/docs/managed/provision-managed-anthos-service-mesh. - CONTROL_PLANE must be one of: automatic, manual. + --origin=ORIGIN + Changing the origin of the membership. ORIGIN must be (only one + value is supported): fleet. - --management=MANAGEMENT - The management mode to update to. MANAGEMENT must be one of: - automatic, manual. + At most one of these can be specified: - --origin=ORIGIN - Changing the origin of the membership. ORIGIN must be (only one - value is supported): fleet. + --config-api=CONFIG_API + The API to use for mesh configuration. CONFIG_API must be one + of: istio, gateway. - At most one of these can be specified: + --control-plane=CONTROL_PLANE + (DEPRECATED) Control plane management to update to. - --membership=MEMBERSHIP - (DEPRECATED) Membership name to update. + The --control-plane flag is now deprecated. Please use + --management instead. See + https://cloud.google.com/service-mesh/docs/managed/provision-managed-anthos-service-mesh. + CONTROL_PLANE must be one of: automatic, manual. - The --membership flag is now deprecated. Please use --memberships - instead. + --management=MANAGEMENT + The management mode to update to. MANAGEMENT must be one of: + automatic, manual. - Membership resource - The group of arguments defining one or more - memberships. 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. + At most one of these can be specified: - To set the project attribute: - ▫ provide the argument --memberships on the command line with a - fully specified name; - ▫ provide the argument --project on the command line; - ▫ set the property core/project. + --membership=MEMBERSHIP + (DEPRECATED) Membership name to update. - --memberships=[MEMBERSHIPS,...] - IDs of the memberships or fully qualified identifiers for the - memberships. + The --membership flag is now deprecated. Please use --memberships + instead. - To set the memberships attribute: - ◇ provide the argument --memberships on the command line. + Membership resource - The group of arguments defining one or more + memberships. 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. - This flag argument must be specified if any of the other - arguments in this group are specified. + To set the project attribute: + ◇ provide the argument --memberships on the command line with a + fully specified name; + ◇ provide the argument --project on the command line; + ◇ set the property core/project. - --location=LOCATION - Location for the memberships. + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. - To set the location attribute: - ◇ provide the argument --memberships on the command line with a - fully specified name; - ◇ provide the argument --location on the command line; - ◇ set the property gkehub/location. + To set the memberships attribute: + ▹ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ▹ provide the argument --memberships on the command line with + a fully specified name; + ▹ provide the argument --location on the command line; + ▹ set the property gkehub/location. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/container/hub/scopes/help b/gcloud/alpha/container/hub/scopes/help index 2db98f69d..6b25f33fc 100644 --- a/gcloud/alpha/container/hub/scopes/help +++ b/gcloud/alpha/container/hub/scopes/help @@ -48,6 +48,11 @@ COMMANDS (ALPHA) List fleet scopes in a project permitted to be viewed by the caller. + list-app-operator-bindings + (ALPHA) List app operator principals corresponding to a fleet scope and + their roles based on project-level IAM bindings, fleet scope-level IAM + bindings, and fleet scope RBAC role bindings. + list-memberships (ALPHA) List memberships bound to a fleet scope. diff --git a/gcloud/alpha/container/hub/scopes/list-app-operator-bindings b/gcloud/alpha/container/hub/scopes/list-app-operator-bindings new file mode 100644 index 000000000..2ecd6f332 --- /dev/null +++ b/gcloud/alpha/container/hub/scopes/list-app-operator-bindings @@ -0,0 +1,106 @@ +NAME + gcloud alpha container hub scopes list-app-operator-bindings - list app + operator principals corresponding to a fleet scope and their roles + based on project-level IAM bindings, fleet scope-level IAM bindings, + and fleet scope RBAC role bindings + +SYNOPSIS + gcloud alpha container hub scopes list-app-operator-bindings SCOPE + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) This command lists bindings corresponding to a fleet scope. The + bindings, which consist of an app operator principal and a role, grant + permissions required for an app operator, including usage of fleet scopes, + connect gateway, logging, and metrics. The overarching principal role + (view/edit/admin, or custom) is determined by (1) the fleet scope RBAC role + (view, edit, or admin), (2) the fleet scope-level IAM role + (roles/gkehub.scopeViewer, roles/gkehub.scopeEditor, or + roles/gkehub.scopeAdmin), (3) the project-level IAM role + (roles/gkehub.scopeViewerProjectLevel, or + roles/gkehub.scopeEditorProjectLevel), and (4) the conditional log view + access role for the scope bucket. + + This command can fail for the following reasons: + ▪ The scope specified does not exist. + ▪ The user does not have access to the specified scope. + +EXAMPLES + The following command lists app operator principals corresponding to SCOPE + under PROJECT_ID, their roles, and role details (fleet scope RBAC role, + fleet scope-level IAM role, project-level IAM role, and log view access): + + $ gcloud alpha container hub scopes list-app-operator-bindings \ + --scope=SCOPE --project=PROJECT_ID + +POSITIONAL ARGUMENTS + Scope resource - The group of arguments defining the Fleet Scope. This + represents a Cloud resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument SCOPE on the command line with a fully specified + name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument SCOPE on the command line with a fully specified + name; + ◆ global is the only supported location. + + This must be specified. + + SCOPE + ID of the scope or fully qualified identifier for the scope. + + To set the scope attribute: + ▸ provide the argument SCOPE on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in 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/edge-cloud/container/clusters/create b/gcloud/alpha/edge-cloud/container/clusters/create index 16bc51827..bd40b08ac 100644 --- a/gcloud/alpha/edge-cloud/container/clusters/create +++ b/gcloud/alpha/edge-cloud/container/clusters/create @@ -21,6 +21,7 @@ SYNOPSIS [--maintenance-window-end=MAINTENANCE_WINDOW_END] [--maintenance-window-recurrence=MAINTENANCE_WINDOW_RECURRENCE] [--maintenance-window-start=MAINTENANCE_WINDOW_START] + [--offline-reboot-ttl=OFFLINE_REBOOT_TTL] [--release-channel=RELEASE_CHANNEL; default="RELEASE_CHANNEL_UNSPECIFIED"] [--services-ipv4-cidr=SERVICES_IPV4_CIDR; default="10.96.0.0/12"] @@ -235,6 +236,14 @@ FLAGS (https://www.ietf.org/rfc/rfc3339.txt) format. E.g. "2021-01-01T00:00:00Z" or "2021-01-01T00:00:00-05:00" + --offline-reboot-ttl=OFFLINE_REBOOT_TTL + Specifies the maximum duration a node can reboot offline (without + connection to Google) and then rejoin its cluster to resume its + designated workloads. This duration is relative to the machine's most + recent connection to Google. The maximum allowed duration is 7 days. To + disallow offline reboot, set the duration to "PT0S". The parameter + should be an ISO 8601 duration string, for example, "P1DT1H2M3S". + --release-channel=RELEASE_CHANNEL; default="RELEASE_CHANNEL_UNSPECIFIED" Release channel a cluster is subscribed to. It supports two values, NONE and REGULAR. NONE is used to opt out of any release channel. diff --git a/gcloud/alpha/edge-cloud/container/clusters/update b/gcloud/alpha/edge-cloud/container/clusters/update index 8c22f5e33..6b736e119 100644 --- a/gcloud/alpha/edge-cloud/container/clusters/update +++ b/gcloud/alpha/edge-cloud/container/clusters/update @@ -5,6 +5,7 @@ NAME SYNOPSIS gcloud alpha edge-cloud container clusters update (CLUSTER : --location=LOCATION) [--async] + [--offline-reboot-ttl=OFFLINE_REBOOT_TTL] [--release-channel=RELEASE_CHANNEL] [--clear-maintenance-window | --remove-maintenance-exclusion-window=REMOVE_MAINTENANCE_EXCLUSION_WINDOW | --add-maintenance-exclusion-end=ADD_MAINTENANCE_EXCLUSION_END --add-maintenance-exclusion-name=ADD_MAINTENANCE_EXCLUSION_NAME --add-maintenance-exclusion-start=ADD_MAINTENANCE_EXCLUSION_START | --maintenance-window-end=MAINTENANCE_WINDOW_END --maintenance-window-recurrence=MAINTENANCE_WINDOW_RECURRENCE --maintenance-window-start=MAINTENANCE_WINDOW_START] @@ -58,6 +59,14 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + --offline-reboot-ttl=OFFLINE_REBOOT_TTL + Specifies the maximum duration a node can reboot offline (without + connection to Google) and then rejoin its cluster to resume its + designated workloads. This duration is relative to the machine's most + recent connection to Google. The maximum allowed duration is 7 days. If + left unspecified, the default 0 means not allowed. The parameter should + be an ISO 8601 duration string, for example, "P1DT1H2M3S". + --release-channel=RELEASE_CHANNEL Release channel a cluster is subscribed to. It supports two values, NONE and REGULAR. NONE is used to opt out of any release channel. diff --git a/gcloud/alpha/healthcare/datasets/create b/gcloud/alpha/healthcare/datasets/create index 7d80ef001..6b7e2ea67 100644 --- a/gcloud/alpha/healthcare/datasets/create +++ b/gcloud/alpha/healthcare/datasets/create @@ -64,8 +64,6 @@ FLAGS used to secure this dataset. The format is projects/{projectId}/locations/{locationId}/keyRings/{keyRingId}/cryptoKeys/{keyId}. - Note: This feature is available upon request. - --time-zone=TIME_ZONE Default timezone used by this dataset. diff --git a/gcloud/alpha/migration/vms/machine-image-imports/create b/gcloud/alpha/migration/vms/machine-image-imports/create index 7527761e3..9e7a3b8af 100644 --- a/gcloud/alpha/migration/vms/machine-image-imports/create +++ b/gcloud/alpha/migration/vms/machine-image-imports/create @@ -8,6 +8,8 @@ SYNOPSIS [--additional-licenses=[ADDITIONAL_LICENSES,...]] [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] [--machine-image-name=MACHINE_IMAGE_NAME] [--machine-type=MACHINE_TYPE] + [--network-interface=[network=NETWORK], + [networkTier=NETWORKTIER],[subnetwork=SUBNETWORK]] [--single-region-storage] [--tags=[TAGS,...]] [--target-project=TARGET_PROJECT] [--enable-integrity-monitoring --enable-vtpm --secure-boot=SECURE_BOOT] @@ -93,6 +95,15 @@ OPTIONAL FLAGS service will choose a relevant machine type series based on the information from the source image. + --network-interface=[network=NETWORK],[networkTier=NETWORKTIER],[subnetwork=SUBNETWORK] + The network interface to use for the instance created by the machine + image. This is a dicionary with the following keys: + ◆ network: The network to use for this network interface. + ◆ subnetwork: The subnetwork to use for this network interface. + ◆ network-tier: The network tier to use for this network interface. + This argument can be specified multiple times in case of multiple + nics. + --single-region-storage If true, the location of the imported machine image will be the region of the import job. Otherwise the closest multi-region is selected. diff --git a/gcloud/alpha/ml/speech/recognizers/create b/gcloud/alpha/ml/speech/recognizers/create index 57106936f..9dbe4c032 100644 --- a/gcloud/alpha/ml/speech/recognizers/create +++ b/gcloud/alpha/ml/speech/recognizers/create @@ -5,18 +5,15 @@ NAME SYNOPSIS gcloud alpha ml speech recognizers create (RECOGNIZER : --location=LOCATION) --language-codes=[LANGUAGE_CODE,...] - --model=MODEL [--async] [--audio-channel-count=AUDIO_CHANNEL_COUNT] - [--display-name=DISPLAY_NAME] - [--enable-automatic-punctuation=ENABLE_AUTOMATIC_PUNCTUATION] - [--enable-spoken-emojis=ENABLE_SPOKEN_EMOJIS] - [--enable-spoken-punctuation=ENABLE_SPOKEN_PUNCTUATION] - [--enable-word-confidence=ENABLE_WORD_CONFIDENCE] - [--enable-word-time-offsets=ENABLE_WORD_TIME_OFFSETS] - [--encoding=ENCODING] [--max-alternatives=MAX_ALTERNATIVES] - [--max-speaker-count=MAX_SPEAKER_COUNT] - [--min-speaker-count=MIN_SPEAKER_COUNT] - [--profanity-filter=PROFANITY_FILTER] [--sample-rate=SAMPLE_RATE] - [--separate-channel-recognition] [GCLOUD_WIDE_FLAG ...] + --model=MODEL [--async] [--display-name=DISPLAY_NAME] + [--audio-channel-count=AUDIO_CHANNEL_COUNT + --encoding=ENCODING --sample-rate=SAMPLE_RATE] + [--enable-automatic-punctuation --enable-spoken-emojis + --enable-spoken-punctuation --enable-word-confidence + --enable-word-time-offsets --max-alternatives=MAX_ALTERNATIVES + --profanity-filter --separate-channel-recognition + --max-speaker-count=MAX_SPEAKER_COUNT + --min-speaker-count=MIN_SPEAKER_COUNT] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Create a speech-to-text recognizer. @@ -59,62 +56,83 @@ REQUIRED FLAGS using more than one language code. --model=MODEL - latest_long or latest_short + Which model to use for recognition requests. Select the model best + suited to your domain to get best results. Guidance for choosing which + model to use can be found in the Transcription Models Documentation + (https://cloud.google.com/speech-to-text/v2/docs/transcription-model) + and the models supported in each region can be found in the Table Of + Supported Models + (https://cloud.google.com/speech-to-text/v2/docs/speech-to-text-supported-languages). OPTIONAL FLAGS --async Return immediately, without waiting for the operation in progress to complete. The default is False. - --audio-channel-count=AUDIO_CHANNEL_COUNT - Number of channels present in the audio data sent for recognition. - Supported for LINEAR16, MULAW, ALAW. - --display-name=DISPLAY_NAME Name of this recognizer as it appears in UIs. - --enable-automatic-punctuation=ENABLE_AUTOMATIC_PUNCTUATION - If true, adds punctuation to recognition result hypotheses. + Encoding format - --enable-spoken-emojis=ENABLE_SPOKEN_EMOJIS - If true, adds spoken emoji formatting. + --audio-channel-count=AUDIO_CHANNEL_COUNT + Number of channels present in the audio data sent for recognition. + Required if --encoding flag is specified and is not AUTO. - --enable-spoken-punctuation=ENABLE_SPOKEN_PUNCTUATION - If true, replaces spoken punctuation with the corresponding symbols in - the request. + --encoding=ENCODING + Encoding format of the provided audio. For headerless formats, must + be set to LINEAR16, MULAW, or ALAW. For other formats, set to AUTO. + Overrides the recognizer configuration if present, else uses + recognizer encoding. - --enable-word-confidence=ENABLE_WORD_CONFIDENCE - If true, the top result includes a list of words and the confidence for - those words. + --sample-rate=SAMPLE_RATE + Sample rate in Hertz of the audio data sent for recognition. Required + if --encoding flag is specified and is not AUTO. - --enable-word-time-offsets=ENABLE_WORD_TIME_OFFSETS - If true, the top result includes a list of words and their timestamps. + ASR Features - --encoding=ENCODING - Encoding format of the provided audio. For headerless formats, must be - set to LINEAR16, MULAW, or ALAW. For other formats, set to AUTO. + --enable-automatic-punctuation + If true, adds punctuation to recognition result hypotheses. - --max-alternatives=MAX_ALTERNATIVES - Maximum number of recognition hypotheses to be returned. Valid values - are 1-30. + --enable-spoken-emojis + If true, adds spoken emoji formatting. - --max-speaker-count=MAX_SPEAKER_COUNT - Maximum number of speakers in the conversation. + --enable-spoken-punctuation + If true, replaces spoken punctuation with the corresponding symbols + in the request. - --min-speaker-count=MIN_SPEAKER_COUNT - Minimum number of speakers in the conversation. + --enable-word-confidence + If true, the top result includes a list of words and the confidence + for those words. - --profanity-filter=PROFANITY_FILTER - If true, the server will censor profanities. + --enable-word-time-offsets + If true, the top result includes a list of words and their + timestamps. - --sample-rate=SAMPLE_RATE - Sample rate in Hertz of the audio data sent for recognition. Required - if using explicit decoding. + --max-alternatives=MAX_ALTERNATIVES + Maximum number of recognition hypotheses to be returned. Valid values + are 1-30. - --separate-channel-recognition - Mode for recognizing multi-channel audio using Separate Channel - Recognition. When set to true, the service will recognize each channel - independently. + --profanity-filter + If true, the server will censor profanities. + + --separate-channel-recognition + Mode for recognizing multi-channel audio using Separate Channel + Recognition. When set to true, the service will recognize each + channel independently. + + Speaker Diarization + + --max-speaker-count=MAX_SPEAKER_COUNT + Maximum number of speakers in the conversation. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --min-speaker-count=MIN_SPEAKER_COUNT + Minimum number of speakers in the conversation. + + This flag argument must be specified if any of the other arguments + in this group are specified. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/ml/speech/recognizers/help b/gcloud/alpha/ml/speech/recognizers/help index d3e1e2f80..9bac52dcd 100644 --- a/gcloud/alpha/ml/speech/recognizers/help +++ b/gcloud/alpha/ml/speech/recognizers/help @@ -28,6 +28,14 @@ COMMANDS list (ALPHA) List Speech-to-text recognizers. + run-batch + (ALPHA) Get transcripts of long (more than 60 seconds) audio from a + gcloud uri. + + run-short + (ALPHA) Get transcripts of short (less than 60 seconds) audio from an + audio file. + update (ALPHA) Update a Speech-to-text recognizer. diff --git a/gcloud/alpha/ml/speech/recognizers/run-batch b/gcloud/alpha/ml/speech/recognizers/run-batch new file mode 100644 index 000000000..b7a2e9f44 --- /dev/null +++ b/gcloud/alpha/ml/speech/recognizers/run-batch @@ -0,0 +1,170 @@ +NAME + gcloud alpha ml speech recognizers run-batch - get transcripts of long + (more than 60 seconds) audio from a gcloud uri + +SYNOPSIS + gcloud alpha ml speech recognizers run-batch + (RECOGNIZER : --location=LOCATION) --audio=AUDIO [--async] + [--hints=[HINTS,...]] [--language-codes=[LANGUAGE_CODE,...]] + [--model=MODEL] + [--audio-channel-count=AUDIO_CHANNEL_COUNT + --encoding=ENCODING --sample-rate=SAMPLE_RATE] + [--[no-]enable-automatic-punctuation --[no-]enable-spoken-emojis + --[no-]enable-spoken-punctuation --[no-]enable-word-confidence + --[no-]enable-word-time-offsets --max-alternatives=MAX_ALTERNATIVES + --[no-]profanity-filter --[no-]separate-channel-recognition + --max-speaker-count=MAX_SPEAKER_COUNT + --min-speaker-count=MIN_SPEAKER_COUNT] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Get transcripts of long (more than 60 seconds) audio from a gcloud + uri. + +POSITIONAL ARGUMENTS + Recognizer resource - recognizer. 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 recognizer on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + RECOGNIZER + ID of the recognizer or fully qualified identifier for the + recognizer. + + To set the recognizer attribute: + ▸ provide the argument recognizer on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location of the recognizer. + + To set the location attribute: + ▸ provide the argument recognizer on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + --audio=AUDIO + Location of the audio file to transcribe. Must be a audio data bytes, + local file, or Google Cloud Storage URL (in the format + gs://bucket/object). + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. The default is False. + + --hints=[HINTS,...] + A list of strings containing word and phrase "hints" so that the ' + 'speech recognition is more likely to recognize them. This can be ' + 'used to improve the accuracy for specific words and phrases, ' 'for + example, if specific commands are typically spoken by ' 'the user. This + can also be used to add additional words to the ' 'vocabulary of the + recognizer. ' 'See https://cloud.google.com/speech/limits#content. + + --language-codes=[LANGUAGE_CODE,...] + Language code is one of en-US, en-GB, fr-FR. Check documentation + (https://cloud.google.com/speech-to-text/docs/multiple-languages) for + using more than one language code. + + --model=MODEL + Which model to use for recognition requests. Select the model best + suited to your domain to get best results. Guidance for choosing which + model to use can be found in the Transcription Models Documentation + (https://cloud.google.com/speech-to-text/v2/docs/transcription-model) + and the models supported in each region can be found in the Table Of + Supported Models + (https://cloud.google.com/speech-to-text/v2/docs/speech-to-text-supported-languages). + + Encoding format + + --audio-channel-count=AUDIO_CHANNEL_COUNT + Number of channels present in the audio data sent for recognition. + Required if --encoding flag is specified and is not AUTO. + + --encoding=ENCODING + Encoding format of the provided audio. For headerless formats, must + be set to LINEAR16, MULAW, or ALAW. For other formats, set to AUTO. + Overrides the recognizer configuration if present, else uses + recognizer encoding. + + --sample-rate=SAMPLE_RATE + Sample rate in Hertz of the audio data sent for recognition. Required + if --encoding flag is specified and is not AUTO. + + ASR Features + + --[no-]enable-automatic-punctuation + If true, adds punctuation to recognition result hypotheses. Use + --enable-automatic-punctuation to enable and + --no-enable-automatic-punctuation to disable. + + --[no-]enable-spoken-emojis + If true, adds spoken emoji formatting. Use --enable-spoken-emojis to + enable and --no-enable-spoken-emojis to disable. + + --[no-]enable-spoken-punctuation + If true, replaces spoken punctuation with the corresponding symbols + in the request. Use --enable-spoken-punctuation to enable and + --no-enable-spoken-punctuation to disable. + + --[no-]enable-word-confidence + If true, the top result includes a list of words and the confidence + for those words. Use --enable-word-confidence to enable and + --no-enable-word-confidence to disable. + + --[no-]enable-word-time-offsets + If true, the top result includes a list of words and their + timestamps. Use --enable-word-time-offsets to enable and + --no-enable-word-time-offsets to disable. + + --max-alternatives=MAX_ALTERNATIVES + Maximum number of recognition hypotheses to be returned. Valid values + are 1-30. + + --[no-]profanity-filter + If true, the server will censor profanities. Use --profanity-filter + to enable and --no-profanity-filter to disable. + + --[no-]separate-channel-recognition + Mode for recognizing multi-channel audio using Separate Channel + Recognition. When set to true, the service will recognize each + channel independently. Use --separate-channel-recognition to enable + and --no-separate-channel-recognition to disable. + + Speaker Diarization + + --max-speaker-count=MAX_SPEAKER_COUNT + Maximum number of speakers in the conversation. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --min-speaker-count=MIN_SPEAKER_COUNT + Minimum number of speakers in the conversation. + + This flag argument must be specified if any of the other arguments + in this group are specified. + +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/ml/speech/recognizers/run-short b/gcloud/alpha/ml/speech/recognizers/run-short new file mode 100644 index 000000000..ea40debb6 --- /dev/null +++ b/gcloud/alpha/ml/speech/recognizers/run-short @@ -0,0 +1,165 @@ +NAME + gcloud alpha ml speech recognizers run-short - get transcripts of short + (less than 60 seconds) audio from an audio file + +SYNOPSIS + gcloud alpha ml speech recognizers run-short + (RECOGNIZER : --location=LOCATION) --audio=AUDIO [--hints=[HINTS,...]] + [--language-codes=[LANGUAGE_CODE,...]] [--model=MODEL] + [--audio-channel-count=AUDIO_CHANNEL_COUNT + --encoding=ENCODING --sample-rate=SAMPLE_RATE] + [--[no-]enable-automatic-punctuation --[no-]enable-spoken-emojis + --[no-]enable-spoken-punctuation --[no-]enable-word-confidence + --[no-]enable-word-time-offsets --max-alternatives=MAX_ALTERNATIVES + --[no-]profanity-filter --[no-]separate-channel-recognition + --max-speaker-count=MAX_SPEAKER_COUNT + --min-speaker-count=MIN_SPEAKER_COUNT] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Get transcripts of short (less than 60 seconds) audio from an audio + file. + +POSITIONAL ARGUMENTS + Recognizer resource - recognizer. 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 recognizer on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + RECOGNIZER + ID of the recognizer or fully qualified identifier for the + recognizer. + + To set the recognizer attribute: + ▸ provide the argument recognizer on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location of the recognizer. + + To set the location attribute: + ▸ provide the argument recognizer on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + --audio=AUDIO + Location of the audio file to transcribe. Must be a audio data bytes, + local file, or Google Cloud Storage URL (in the format + gs://bucket/object). + +OPTIONAL FLAGS + --hints=[HINTS,...] + A list of strings containing word and phrase "hints" so that the ' + 'speech recognition is more likely to recognize them. This can be ' + 'used to improve the accuracy for specific words and phrases, ' 'for + example, if specific commands are typically spoken by ' 'the user. This + can also be used to add additional words to the ' 'vocabulary of the + recognizer. ' 'See https://cloud.google.com/speech/limits#content. + + --language-codes=[LANGUAGE_CODE,...] + Language code is one of en-US, en-GB, fr-FR. Check documentation + (https://cloud.google.com/speech-to-text/docs/multiple-languages) for + using more than one language code. + + --model=MODEL + Which model to use for recognition requests. Select the model best + suited to your domain to get best results. Guidance for choosing which + model to use can be found in the Transcription Models Documentation + (https://cloud.google.com/speech-to-text/v2/docs/transcription-model) + and the models supported in each region can be found in the Table Of + Supported Models + (https://cloud.google.com/speech-to-text/v2/docs/speech-to-text-supported-languages). + + Encoding format + + --audio-channel-count=AUDIO_CHANNEL_COUNT + Number of channels present in the audio data sent for recognition. + Required if --encoding flag is specified and is not AUTO. + + --encoding=ENCODING + Encoding format of the provided audio. For headerless formats, must + be set to LINEAR16, MULAW, or ALAW. For other formats, set to AUTO. + Overrides the recognizer configuration if present, else uses + recognizer encoding. + + --sample-rate=SAMPLE_RATE + Sample rate in Hertz of the audio data sent for recognition. Required + if --encoding flag is specified and is not AUTO. + + ASR Features + + --[no-]enable-automatic-punctuation + If true, adds punctuation to recognition result hypotheses. Use + --enable-automatic-punctuation to enable and + --no-enable-automatic-punctuation to disable. + + --[no-]enable-spoken-emojis + If true, adds spoken emoji formatting. Use --enable-spoken-emojis to + enable and --no-enable-spoken-emojis to disable. + + --[no-]enable-spoken-punctuation + If true, replaces spoken punctuation with the corresponding symbols + in the request. Use --enable-spoken-punctuation to enable and + --no-enable-spoken-punctuation to disable. + + --[no-]enable-word-confidence + If true, the top result includes a list of words and the confidence + for those words. Use --enable-word-confidence to enable and + --no-enable-word-confidence to disable. + + --[no-]enable-word-time-offsets + If true, the top result includes a list of words and their + timestamps. Use --enable-word-time-offsets to enable and + --no-enable-word-time-offsets to disable. + + --max-alternatives=MAX_ALTERNATIVES + Maximum number of recognition hypotheses to be returned. Valid values + are 1-30. + + --[no-]profanity-filter + If true, the server will censor profanities. Use --profanity-filter + to enable and --no-profanity-filter to disable. + + --[no-]separate-channel-recognition + Mode for recognizing multi-channel audio using Separate Channel + Recognition. When set to true, the service will recognize each + channel independently. Use --separate-channel-recognition to enable + and --no-separate-channel-recognition to disable. + + Speaker Diarization + + --max-speaker-count=MAX_SPEAKER_COUNT + Maximum number of speakers in the conversation. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --min-speaker-count=MIN_SPEAKER_COUNT + Minimum number of speakers in the conversation. + + This flag argument must be specified if any of the other arguments + in this group are specified. + +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/ml/speech/recognizers/update b/gcloud/alpha/ml/speech/recognizers/update index b26844a6b..5c50d360f 100644 --- a/gcloud/alpha/ml/speech/recognizers/update +++ b/gcloud/alpha/ml/speech/recognizers/update @@ -5,19 +5,16 @@ NAME SYNOPSIS gcloud alpha ml speech recognizers update (RECOGNIZER : --location=LOCATION) [--async] - [--audio-channel-count=AUDIO_CHANNEL_COUNT] - [--display-name=DISPLAY_NAME] - [--enable-automatic-punctuation=ENABLE_AUTOMATIC_PUNCTUATION] - [--enable-spoken-emojis=ENABLE_SPOKEN_EMOJIS] - [--enable-spoken-punctuation=ENABLE_SPOKEN_PUNCTUATION] - [--enable-word-confidence=ENABLE_WORD_CONFIDENCE] - [--enable-word-time-offsets=ENABLE_WORD_TIME_OFFSETS] - [--encoding=ENCODING] [--language-codes=[LANGUAGE_CODE,...]] - [--max-alternatives=MAX_ALTERNATIVES] - [--max-speaker-count=MAX_SPEAKER_COUNT] - [--min-speaker-count=MIN_SPEAKER_COUNT] [--model=MODEL] - [--profanity-filter=PROFANITY_FILTER] [--sample-rate=SAMPLE_RATE] - [--[no-]separate-channel-recognition] [GCLOUD_WIDE_FLAG ...] + [--display-name=DISPLAY_NAME] [--language-codes=[LANGUAGE_CODE,...]] + [--model=MODEL] + [--audio-channel-count=AUDIO_CHANNEL_COUNT + --encoding=ENCODING --sample-rate=SAMPLE_RATE] + [--[no-]enable-automatic-punctuation --[no-]enable-spoken-emojis + --[no-]enable-spoken-punctuation --[no-]enable-word-confidence + --[no-]enable-word-time-offsets --max-alternatives=MAX_ALTERNATIVES + --[no-]profanity-filter --[no-]separate-channel-recognition + --max-speaker-count=MAX_SPEAKER_COUNT + --min-speaker-count=MIN_SPEAKER_COUNT] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Update a Speech-to-text recognizer. @@ -58,64 +55,92 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. The default is False. - --audio-channel-count=AUDIO_CHANNEL_COUNT - Number of channels present in the audio data sent for recognition. - Supported for LINEAR16, MULAW, ALAW. - --display-name=DISPLAY_NAME Name of this recognizer as it appears in UIs. - --enable-automatic-punctuation=ENABLE_AUTOMATIC_PUNCTUATION - If true, adds punctuation to recognition result hypotheses. - - --enable-spoken-emojis=ENABLE_SPOKEN_EMOJIS - If true, adds spoken emoji formatting. - - --enable-spoken-punctuation=ENABLE_SPOKEN_PUNCTUATION - If true, replaces spoken punctuation with the corresponding symbols in - the request. - - --enable-word-confidence=ENABLE_WORD_CONFIDENCE - If true, the top result includes a list of words and the confidence for - those words. - - --enable-word-time-offsets=ENABLE_WORD_TIME_OFFSETS - If true, the top result includes a list of words and their timestamps. - - --encoding=ENCODING - Encoding format of the provided audio. For headerless formats, must be - set to LINEAR16, MULAW, or ALAW. For other formats, set to AUTO. - --language-codes=[LANGUAGE_CODE,...] Language code is one of en-US, en-GB, fr-FR. Check documentation (https://cloud.google.com/speech-to-text/docs/multiple-languages) for using more than one language code. - --max-alternatives=MAX_ALTERNATIVES - Maximum number of recognition hypotheses to be returned. Valid values - are 1-30. - - --max-speaker-count=MAX_SPEAKER_COUNT - Maximum number of speakers in the conversation. - - --min-speaker-count=MIN_SPEAKER_COUNT - Minimum number of speakers in the conversation. - --model=MODEL - latest_long or latest_short + Which model to use for recognition requests. Select the model best + suited to your domain to get best results. Guidance for choosing which + model to use can be found in the Transcription Models Documentation + (https://cloud.google.com/speech-to-text/v2/docs/transcription-model) + and the models supported in each region can be found in the Table Of + Supported Models + (https://cloud.google.com/speech-to-text/v2/docs/speech-to-text-supported-languages). - --profanity-filter=PROFANITY_FILTER - If true, the server will censor profanities. + Encoding format - --sample-rate=SAMPLE_RATE - Sample rate in Hertz of the audio data sent for recognition. Required - if using explicit decoding. + --audio-channel-count=AUDIO_CHANNEL_COUNT + Number of channels present in the audio data sent for recognition. + Required if --encoding flag is specified and is not AUTO. - --[no-]separate-channel-recognition - Mode for recognizing multi-channel audio using Separate Channel - Recognition. When set to true, the service will recognize each channel - independently. Use --separate-channel-recognition to enable and - --no-separate-channel-recognition to disable. + --encoding=ENCODING + Encoding format of the provided audio. For headerless formats, must + be set to LINEAR16, MULAW, or ALAW. For other formats, set to AUTO. + Overrides the recognizer configuration if present, else uses + recognizer encoding. + + --sample-rate=SAMPLE_RATE + Sample rate in Hertz of the audio data sent for recognition. Required + if --encoding flag is specified and is not AUTO. + + ASR Features + + --[no-]enable-automatic-punctuation + If true, adds punctuation to recognition result hypotheses. Use + --enable-automatic-punctuation to enable and + --no-enable-automatic-punctuation to disable. + + --[no-]enable-spoken-emojis + If true, adds spoken emoji formatting. Use --enable-spoken-emojis to + enable and --no-enable-spoken-emojis to disable. + + --[no-]enable-spoken-punctuation + If true, replaces spoken punctuation with the corresponding symbols + in the request. Use --enable-spoken-punctuation to enable and + --no-enable-spoken-punctuation to disable. + + --[no-]enable-word-confidence + If true, the top result includes a list of words and the confidence + for those words. Use --enable-word-confidence to enable and + --no-enable-word-confidence to disable. + + --[no-]enable-word-time-offsets + If true, the top result includes a list of words and their + timestamps. Use --enable-word-time-offsets to enable and + --no-enable-word-time-offsets to disable. + + --max-alternatives=MAX_ALTERNATIVES + Maximum number of recognition hypotheses to be returned. Valid values + are 1-30. + + --[no-]profanity-filter + If true, the server will censor profanities. Use --profanity-filter + to enable and --no-profanity-filter to disable. + + --[no-]separate-channel-recognition + Mode for recognizing multi-channel audio using Separate Channel + Recognition. When set to true, the service will recognize each + channel independently. Use --separate-channel-recognition to enable + and --no-separate-channel-recognition to disable. + + Speaker Diarization + + --max-speaker-count=MAX_SPEAKER_COUNT + Maximum number of speakers in the conversation. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --min-speaker-count=MIN_SPEAKER_COUNT + Minimum number of speakers in the conversation. + + This flag argument must be specified if any of the other arguments + in this group are specified. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/pam/check-onboarding-status b/gcloud/alpha/pam/check-onboarding-status index bb6790f8a..12f23d497 100644 --- a/gcloud/alpha/pam/check-onboarding-status +++ b/gcloud/alpha/pam/check-onboarding-status @@ -86,7 +86,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the privilegedaccessmanager/v1alpha API. The full - documentation for this API can be found at: https://cloud.google.com/ + documentation for this API can be found at: + https://cloud.google.com/iam/docs/pam-overview NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/pam/entitlements/create b/gcloud/alpha/pam/entitlements/create index c9c8b8b94..d21223edf 100644 --- a/gcloud/alpha/pam/entitlements/create +++ b/gcloud/alpha/pam/entitlements/create @@ -115,7 +115,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the privilegedaccessmanager/v1alpha API. The full - documentation for this API can be found at: https://cloud.google.com/ + documentation for this API can be found at: + https://cloud.google.com/iam/docs/pam-overview NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/pam/entitlements/delete b/gcloud/alpha/pam/entitlements/delete index 0ed3e051c..b64828cee 100644 --- a/gcloud/alpha/pam/entitlements/delete +++ b/gcloud/alpha/pam/entitlements/delete @@ -107,7 +107,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the privilegedaccessmanager/v1alpha API. The full - documentation for this API can be found at: https://cloud.google.com/ + documentation for this API can be found at: + https://cloud.google.com/iam/docs/pam-overview NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/pam/entitlements/describe b/gcloud/alpha/pam/entitlements/describe index bba59d234..ca5c49124 100644 --- a/gcloud/alpha/pam/entitlements/describe +++ b/gcloud/alpha/pam/entitlements/describe @@ -98,7 +98,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the privilegedaccessmanager/v1alpha API. The full - documentation for this API can be found at: https://cloud.google.com/ + documentation for this API can be found at: + https://cloud.google.com/iam/docs/pam-overview NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/pam/entitlements/export b/gcloud/alpha/pam/entitlements/export index 39f63ca0d..fc8777650 100644 --- a/gcloud/alpha/pam/entitlements/export +++ b/gcloud/alpha/pam/entitlements/export @@ -111,7 +111,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the privilegedaccessmanager/v1alpha API. The full - documentation for this API can be found at: https://cloud.google.com/ + documentation for this API can be found at: + https://cloud.google.com/iam/docs/pam-overview NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/pam/entitlements/list b/gcloud/alpha/pam/entitlements/list index 742e4914d..9731a2aba 100644 --- a/gcloud/alpha/pam/entitlements/list +++ b/gcloud/alpha/pam/entitlements/list @@ -113,7 +113,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the privilegedaccessmanager/v1alpha API. The full - documentation for this API can be found at: https://cloud.google.com/ + documentation for this API can be found at: + https://cloud.google.com/iam/docs/pam-overview NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/pam/entitlements/search b/gcloud/alpha/pam/entitlements/search index cd8673eeb..7690b0eeb 100644 --- a/gcloud/alpha/pam/entitlements/search +++ b/gcloud/alpha/pam/entitlements/search @@ -143,7 +143,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the privilegedaccessmanager/v1alpha API. The full - documentation for this API can be found at: https://cloud.google.com/ + documentation for this API can be found at: + https://cloud.google.com/iam/docs/pam-overview NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/pam/entitlements/update b/gcloud/alpha/pam/entitlements/update index bc24e3967..4abe4e24b 100644 --- a/gcloud/alpha/pam/entitlements/update +++ b/gcloud/alpha/pam/entitlements/update @@ -114,7 +114,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the privilegedaccessmanager/v1alpha API. The full - documentation for this API can be found at: https://cloud.google.com/ + documentation for this API can be found at: + https://cloud.google.com/iam/docs/pam-overview NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/pam/grants/approve b/gcloud/alpha/pam/grants/approve index 9ed7cdb31..3259ffed7 100644 --- a/gcloud/alpha/pam/grants/approve +++ b/gcloud/alpha/pam/grants/approve @@ -94,7 +94,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the privilegedaccessmanager/v1alpha API. The full - documentation for this API can be found at: https://cloud.google.com/ + documentation for this API can be found at: + https://cloud.google.com/iam/docs/pam-overview NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/pam/grants/create b/gcloud/alpha/pam/grants/create index 90899b901..1402c50a8 100644 --- a/gcloud/alpha/pam/grants/create +++ b/gcloud/alpha/pam/grants/create @@ -101,7 +101,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the privilegedaccessmanager/v1alpha API. The full - documentation for this API can be found at: https://cloud.google.com/ + documentation for this API can be found at: + https://cloud.google.com/iam/docs/pam-overview NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/pam/grants/deny b/gcloud/alpha/pam/grants/deny index 79ac275ba..cf2619b2f 100644 --- a/gcloud/alpha/pam/grants/deny +++ b/gcloud/alpha/pam/grants/deny @@ -93,7 +93,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the privilegedaccessmanager/v1alpha API. The full - documentation for this API can be found at: https://cloud.google.com/ + documentation for this API can be found at: + https://cloud.google.com/iam/docs/pam-overview NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/pam/grants/describe b/gcloud/alpha/pam/grants/describe index 0bd49fd91..96243d05e 100644 --- a/gcloud/alpha/pam/grants/describe +++ b/gcloud/alpha/pam/grants/describe @@ -89,7 +89,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the privilegedaccessmanager/v1alpha API. The full - documentation for this API can be found at: https://cloud.google.com/ + documentation for this API can be found at: + https://cloud.google.com/iam/docs/pam-overview NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/pam/grants/list b/gcloud/alpha/pam/grants/list index 6c6d87475..a5b81b347 100644 --- a/gcloud/alpha/pam/grants/list +++ b/gcloud/alpha/pam/grants/list @@ -111,7 +111,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the privilegedaccessmanager/v1alpha API. The full - documentation for this API can be found at: https://cloud.google.com/ + documentation for this API can be found at: + https://cloud.google.com/iam/docs/pam-overview NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/pam/grants/revoke b/gcloud/alpha/pam/grants/revoke index 876029484..1037a6ad3 100644 --- a/gcloud/alpha/pam/grants/revoke +++ b/gcloud/alpha/pam/grants/revoke @@ -97,7 +97,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the privilegedaccessmanager/v1alpha API. The full - documentation for this API can be found at: https://cloud.google.com/ + documentation for this API can be found at: + https://cloud.google.com/iam/docs/pam-overview NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/pam/grants/search b/gcloud/alpha/pam/grants/search index 097c78ff7..30ebe52e7 100644 --- a/gcloud/alpha/pam/grants/search +++ b/gcloud/alpha/pam/grants/search @@ -132,7 +132,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the privilegedaccessmanager/v1alpha API. The full - documentation for this API can be found at: https://cloud.google.com/ + documentation for this API can be found at: + https://cloud.google.com/iam/docs/pam-overview NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/pam/operations/delete b/gcloud/alpha/pam/operations/delete index 6214b2f64..8b3ebbfde 100644 --- a/gcloud/alpha/pam/operations/delete +++ b/gcloud/alpha/pam/operations/delete @@ -82,7 +82,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the privilegedaccessmanager/v1alpha API. The full - documentation for this API can be found at: https://cloud.google.com/ + documentation for this API can be found at: + https://cloud.google.com/iam/docs/pam-overview NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/pam/operations/describe b/gcloud/alpha/pam/operations/describe index f4adc226e..2d9dead49 100644 --- a/gcloud/alpha/pam/operations/describe +++ b/gcloud/alpha/pam/operations/describe @@ -83,7 +83,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the privilegedaccessmanager/v1alpha API. The full - documentation for this API can be found at: https://cloud.google.com/ + documentation for this API can be found at: + https://cloud.google.com/iam/docs/pam-overview NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/pam/operations/list b/gcloud/alpha/pam/operations/list index afec02cf8..e6232e3fb 100644 --- a/gcloud/alpha/pam/operations/list +++ b/gcloud/alpha/pam/operations/list @@ -113,7 +113,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the privilegedaccessmanager/v1alpha API. The full - documentation for this API can be found at: https://cloud.google.com/ + documentation for this API can be found at: + https://cloud.google.com/iam/docs/pam-overview NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/pam/operations/wait b/gcloud/alpha/pam/operations/wait index 04a3eb80a..5a06839e1 100644 --- a/gcloud/alpha/pam/operations/wait +++ b/gcloud/alpha/pam/operations/wait @@ -82,7 +82,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the privilegedaccessmanager/v1alpha API. The full - documentation for this API can be found at: https://cloud.google.com/ + documentation for this API can be found at: + https://cloud.google.com/iam/docs/pam-overview NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/run/deploy b/gcloud/alpha/run/deploy index ef4d97f3c..84995d526 100644 --- a/gcloud/alpha/run/deploy +++ b/gcloud/alpha/run/deploy @@ -30,6 +30,7 @@ SYNOPSIS --execution-environment=EXECUTION_ENVIRONMENT --[no-]invoker-iam-check --max-surge=MAX_SURGE --remove-containers=[CONTAINER,...] --revision-suffix=REVISION_SUFFIX + --scaling-mode=SCALING_MODE --service-max-instances=SERVICE_MAX_INSTANCES --service-min-instances=SERVICE_MIN_INSTANCES --[no-]session-affinity --vpc-connector=VPC_CONNECTOR --vpc-egress=VPC_EGRESS @@ -480,7 +481,18 @@ FLAGS 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'. + to a revision named 'helloworld-v1'. Set empty string to clear the + suffix and resume server-assigned naming. + + --scaling-mode=SCALING_MODE + The scaling mode to use for this resource. SCALING_MODE must be one + of: + + automatic + The number of instances is scaled automatically based on the + usage metrics. + manual + The number of instances is fixed to a provided config value. --service-max-instances=SERVICE_MAX_INSTANCES The maximum number of container instances for this Service to run. diff --git a/gcloud/alpha/run/services/update b/gcloud/alpha/run/services/update index 4a92b0852..2d87ce72c 100644 --- a/gcloud/alpha/run/services/update +++ b/gcloud/alpha/run/services/update @@ -25,6 +25,7 @@ SYNOPSIS --execution-environment=EXECUTION_ENVIRONMENT --[no-]invoker-iam-check --max-surge=MAX_SURGE --remove-containers=[CONTAINER,...] --revision-suffix=REVISION_SUFFIX + --scaling-mode=SCALING_MODE --service-max-instances=SERVICE_MAX_INSTANCES --service-min-instances=SERVICE_MIN_INSTANCES --[no-]session-affinity --vpc-connector=VPC_CONNECTOR --vpc-egress=VPC_EGRESS @@ -366,7 +367,18 @@ FLAGS 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'. + to a revision named 'helloworld-v1'. Set empty string to clear the + suffix and resume server-assigned naming. + + --scaling-mode=SCALING_MODE + The scaling mode to use for this resource. SCALING_MODE must be one + of: + + automatic + The number of instances is scaled automatically based on the + usage metrics. + manual + The number of instances is fixed to a provided config value. --service-max-instances=SERVICE_MAX_INSTANCES The maximum number of container instances for this Service to run. diff --git a/gcloud/alpha/run/workers/deploy b/gcloud/alpha/run/workers/deploy index 7b8c64800..5790809fa 100644 --- a/gcloud/alpha/run/workers/deploy +++ b/gcloud/alpha/run/workers/deploy @@ -120,7 +120,8 @@ FLAGS 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'. + a revision named 'helloworld-v1'. Set empty string to clear the suffix + and resume server-assigned naming. --scaling-mode=SCALING_MODE The scaling mode to use for this resource. SCALING_MODE must be one of: diff --git a/gcloud/alpha/run/workers/update b/gcloud/alpha/run/workers/update index 7f74c783b..b1391f496 100644 --- a/gcloud/alpha/run/workers/update +++ b/gcloud/alpha/run/workers/update @@ -121,7 +121,8 @@ FLAGS 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'. + a revision named 'helloworld-v1'. Set empty string to clear the suffix + and resume server-assigned naming. --scaling-mode=SCALING_MODE The scaling mode to use for this resource. SCALING_MODE must be one of: diff --git a/gcloud/alpha/sql/instances/create b/gcloud/alpha/sql/instances/create index d158ff553..e37bd994f 100644 --- a/gcloud/alpha/sql/instances/create +++ b/gcloud/alpha/sql/instances/create @@ -21,6 +21,7 @@ SYNOPSIS [--deny-maintenance-period-start-date=DENY_MAINTENANCE_PERIOD_START_DATE] [--deny-maintenance-period-time=DENY_MAINTENANCE_PERIOD_TIME] [--edition=EDITION] [--enable-bin-log] [--enable-data-cache] + [--[no-]enable-dataplex-integration] [--[no-]enable-google-ml-integration] [--enable-google-private-path] [--enable-password-policy] [--enable-point-in-time-recovery] [--failover-replica-name=FAILOVER_REPLICA_NAME] @@ -239,6 +240,11 @@ FLAGS Enable use of data cache for accelerated read performance. This flag is only available for Enterprise_Plus edition instances. + --[no-]enable-dataplex-integration + Enable Dataplex integration for Google Cloud SQL. Use + --enable-dataplex-integration to enable and + --no-enable-dataplex-integration to disable. + --[no-]enable-google-ml-integration Enable Vertex AI integration for Google Cloud SQL. Currently, only PostgreSQL is supported. Use --enable-google-ml-integration to enable diff --git a/gcloud/alpha/sql/instances/patch b/gcloud/alpha/sql/instances/patch index b0480ef45..9687781e5 100644 --- a/gcloud/alpha/sql/instances/patch +++ b/gcloud/alpha/sql/instances/patch @@ -19,6 +19,7 @@ SYNOPSIS [--deny-maintenance-period-time=DENY_MAINTENANCE_PERIOD_TIME] [--diff] [--edition=EDITION] [--[no-]enable-bin-log] [--enable-data-cache] [--[no-]enable-database-replication] + [--[no-]enable-dataplex-integration] [--[no-]enable-google-ml-integration] [--[no-]enable-google-private-path] [--enable-password-policy] [--enable-point-in-time-recovery] @@ -191,6 +192,11 @@ FLAGS --enable-database-replication to enable and --no-enable-database-replication to disable. + --[no-]enable-dataplex-integration + Enable Dataplex integration for Google Cloud SQL. Use + --enable-dataplex-integration to enable and + --no-enable-dataplex-integration to disable. + --[no-]enable-google-ml-integration Enable Vertex AI integration for Google Cloud SQL. Currently, only PostgreSQL is supported. Use --enable-google-ml-integration to enable diff --git a/gcloud/artifacts/repositories/create b/gcloud/artifacts/repositories/create index fbcb8f57d..2dcd306bf 100644 --- a/gcloud/artifacts/repositories/create +++ b/gcloud/artifacts/repositories/create @@ -196,9 +196,9 @@ OPTIONAL FLAGS --upstream-policy-file=FILE (Virtual Repositories only) is the upstreams for the Virtual Repository. Example of the file contents: [ { "id": "test1", - "repository": "projects/p1/locations/us-central1/repository/repo1", + "repository": "projects/p1/locations/us-central1/repositories/repo1", "priority": 1 }, { "id": "test2", "repository": - "projects/p2/locations/us-west2/repository/repo2", "priority": 2 } ] + "projects/p2/locations/us-west2/repositories/repo2", "priority": 2 } ] --version-policy=VERSION_POLICY (Maven only) The package versions that the repository will store. diff --git a/gcloud/artifacts/repositories/update b/gcloud/artifacts/repositories/update index fd0fa47f6..85f350994 100644 --- a/gcloud/artifacts/repositories/update +++ b/gcloud/artifacts/repositories/update @@ -93,9 +93,9 @@ FLAGS --upstream-policy-file=FILE (Virtual Repositories only) is the upstreams for the Virtual Repository. Example of the file contents: [ { "id": "test1", - "repository": "projects/p1/locations/us-central1/repository/repo1", + "repository": "projects/p1/locations/us-central1/repositories/repo1", "priority": 1 }, { "id": "test2", "repository": - "projects/p2/locations/us-west2/repository/repo2", "priority": 2 } ] + "projects/p2/locations/us-west2/repositories/repo2", "priority": 2 } ] At most one of these can be specified: diff --git a/gcloud/beta/alloydb/clusters/create b/gcloud/beta/alloydb/clusters/create index 46d7f212b..d6edfa974 100644 --- a/gcloud/beta/alloydb/clusters/create +++ b/gcloud/beta/alloydb/clusters/create @@ -68,8 +68,8 @@ OPTIONAL FLAGS --network=NETWORK Network in the current project that the instance will be part of. To specify using a network with a shared VPC, use the full URL of the - network. For an example host project, 'testproject', and shared - network, 'testsharednetwork', this would be of the + network. For an example host project, testproject, and shared network, + testsharednetwork, this would be of the form:--network=projects/testproject/global/networks/testsharednetwork --subscription-type=SUBSCRIPTION_TYPE @@ -159,9 +159,9 @@ OPTIONAL FLAGS in this group are specified. --automated-backup-window=TIMEOUT_PERIOD - The length of the time window beginning at start time during which - a backup can be taken. If a backup does not succeed within this - time window, it will be canceled and considered failed. The backup + Length of the time window beginning at start time during which a + backup can be taken. If a backup does not succeed within this time + window, it will be canceled and considered failed. The backup window must be at least 5 minutes long. There is no upper bound on the window. If not set, it will default to 1 hour. diff --git a/gcloud/beta/alloydb/clusters/restore b/gcloud/beta/alloydb/clusters/restore index d134e6212..b77dbcf97 100644 --- a/gcloud/beta/alloydb/clusters/restore +++ b/gcloud/beta/alloydb/clusters/restore @@ -87,8 +87,8 @@ OPTIONAL FLAGS --network=NETWORK Network in the current project that the instance will be part of. To specify using a network with a shared VPC, use the full URL of the - network. For an example host project, 'testproject', and shared - network, 'testsharednetwork', this would be of the + network. For an example host project, testproject, and shared network, + testsharednetwork, this would be of the form:--network=projects/testproject/global/networks/testsharednetwork Key resource - The Cloud KMS (Key Management Service) cryptokey that will diff --git a/gcloud/beta/alloydb/clusters/update b/gcloud/beta/alloydb/clusters/update index 99de7aad6..a13ea68df 100644 --- a/gcloud/beta/alloydb/clusters/update +++ b/gcloud/beta/alloydb/clusters/update @@ -75,9 +75,9 @@ OPTIONAL FLAGS (e.g., --automated-backup-start-times=01:00,13:00) --automated-backup-window=TIMEOUT_PERIOD - The length of the time window beginning at start time during which - a backup can be taken. If a backup does not succeed within this - time window, it will be canceled and considered failed. The backup + Length of the time window beginning at start time during which a + backup can be taken. If a backup does not succeed within this time + window, it will be canceled and considered failed. The backup window must be at least 5 minutes long. There is no upper bound on the window. If not set, it will default to 1 hour. diff --git a/gcloud/beta/alloydb/instances/restart b/gcloud/beta/alloydb/instances/restart index 6d95546a4..5df29937f 100644 --- a/gcloud/beta/alloydb/instances/restart +++ b/gcloud/beta/alloydb/instances/restart @@ -4,7 +4,8 @@ NAME SYNOPSIS gcloud beta alloydb instances restart INSTANCE --cluster=CLUSTER - --region=REGION [--async] [GCLOUD_WIDE_FLAG ...] + --region=REGION [--async] [--node-ids=[NODE_IDS,...]] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Restarts an AlloyDB instance within a given cluster. @@ -32,6 +33,10 @@ OPTIONAL FLAGS Return immediately, without waiting for the operation in progress to complete. + --node-ids=[NODE_IDS,...] + Comma-separated list of node IDs. Only supported for read pool + instances. (e.g., --node-ids=node-1,node-2,node-3) + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/beta/bigtable/backups/update b/gcloud/beta/bigtable/backups/update index cc70b03d6..a2c332646 100644 --- a/gcloud/beta/bigtable/backups/update +++ b/gcloud/beta/bigtable/backups/update @@ -5,8 +5,8 @@ NAME SYNOPSIS gcloud beta bigtable backups update (BACKUP : --cluster=CLUSTER --instance=INSTANCE) - (--expiration-date=EXPIRATION_DATE - | --retention-period=RETENTION_PERIOD) [GCLOUD_WIDE_FLAG ...] + [--expiration-date=EXPIRATION_DATE + | --retention-period=RETENTION_PERIOD] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Update a backup, only supported for the following fields: @@ -58,8 +58,8 @@ POSITIONAL ARGUMENTS specified name; ▸ provide the argument --instance on the command line. -REQUIRED FLAGS - Exactly one of these must be specified: +FLAGS + At most one of these can be specified: --expiration-date=EXPIRATION_DATE Absolute expiration time of the backup; must be at least 6 hours and diff --git a/gcloud/beta/builds/worker-pools/create b/gcloud/beta/builds/worker-pools/create index 7a024897f..7d6353997 100644 --- a/gcloud/beta/builds/worker-pools/create +++ b/gcloud/beta/builds/worker-pools/create @@ -3,7 +3,7 @@ NAME Cloud Build SYNOPSIS - gcloud beta builds worker-pools create WORKER_POOL --region=REGION + gcloud beta builds worker-pools create WORKER_POOL [--region=REGION] [--config-from-file=CONFIG_FROM_FILE | --peered-network=PEERED_NETWORK --peered-network-ip-range=PEERED_NETWORK_IP_RANGE --no-public-egress --worker-disk-size=WORKER_DISK_SIZE @@ -33,12 +33,11 @@ POSITIONAL ARGUMENTS Unique identifier for the worker pool to create. This value should be 1-63 characters, and valid characters are [a-z][0-9]- -REQUIRED FLAGS +FLAGS --region=REGION Cloud region where the worker pool is created. See https://cloud.google.com/build/docs/locations for available locations. -OPTIONAL FLAGS At most one of these can be specified: --config-from-file=CONFIG_FROM_FILE diff --git a/gcloud/beta/builds/worker-pools/delete b/gcloud/beta/builds/worker-pools/delete index 428f17248..00b94a5af 100644 --- a/gcloud/beta/builds/worker-pools/delete +++ b/gcloud/beta/builds/worker-pools/delete @@ -3,7 +3,7 @@ NAME Cloud Build SYNOPSIS - gcloud beta builds worker-pools delete WORKER_POOL --region=REGION + gcloud beta builds worker-pools delete WORKER_POOL [--region=REGION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -18,7 +18,7 @@ POSITIONAL ARGUMENTS WORKER_POOL The ID of the worker pool to delete. -REQUIRED FLAGS +FLAGS --region=REGION The Cloud region where the worker pool is. diff --git a/gcloud/beta/builds/worker-pools/describe b/gcloud/beta/builds/worker-pools/describe index a71eca523..131a6c028 100644 --- a/gcloud/beta/builds/worker-pools/describe +++ b/gcloud/beta/builds/worker-pools/describe @@ -3,7 +3,7 @@ NAME Cloud Build SYNOPSIS - gcloud beta builds worker-pools describe WORKER_POOL --region=REGION + gcloud beta builds worker-pools describe WORKER_POOL [--region=REGION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -19,7 +19,7 @@ POSITIONAL ARGUMENTS WORKER_POOL The ID of the worker pool to describe. -REQUIRED FLAGS +FLAGS --region=REGION The Cloud region where the worker pool is. diff --git a/gcloud/beta/builds/worker-pools/list b/gcloud/beta/builds/worker-pools/list index a9337ec0a..796a3307d 100644 --- a/gcloud/beta/builds/worker-pools/list +++ b/gcloud/beta/builds/worker-pools/list @@ -3,9 +3,9 @@ NAME Cloud project SYNOPSIS - gcloud beta builds worker-pools list --region=REGION [--filter=EXPRESSION] - [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] - [GCLOUD_WIDE_FLAG ...] + gcloud beta builds worker-pools list [--region=REGION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) List all worker pools in a Google Cloud project. @@ -15,7 +15,7 @@ EXAMPLES $ gcloud beta builds worker-pools list --region=us-central1 -REQUIRED FLAGS +FLAGS --region=REGION The Cloud region to list worker pools in. diff --git a/gcloud/beta/builds/worker-pools/update b/gcloud/beta/builds/worker-pools/update index faed9f8b8..11a1fc919 100644 --- a/gcloud/beta/builds/worker-pools/update +++ b/gcloud/beta/builds/worker-pools/update @@ -3,10 +3,11 @@ NAME Build SYNOPSIS - gcloud beta builds worker-pools update WORKER_POOL --region=REGION + gcloud beta builds worker-pools update WORKER_POOL (--config-from-file=CONFIG_FROM_FILE | --[no-]public-egress --worker-disk-size=WORKER_DISK_SIZE - --worker-machine-type=WORKER_MACHINE_TYPE) [GCLOUD_WIDE_FLAG ...] + --worker-machine-type=WORKER_MACHINE_TYPE) [--region=REGION] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Update a worker pool used by Cloud Build. @@ -24,10 +25,6 @@ POSITIONAL ARGUMENTS 1-63 characters, and valid characters are [a-z][0-9]- REQUIRED FLAGS - --region=REGION - Cloud region where the worker pool is updated. See - https://cloud.google.com/build/docs/locations for available locations. - Exactly one of these must be specified: --config-from-file=CONFIG_FROM_FILE @@ -60,6 +57,11 @@ REQUIRED FLAGS If unspecified, Cloud Build uses a standard machine type. +OPTIONAL FLAGS + --region=REGION + Cloud region where the worker pool is updated. See + https://cloud.google.com/build/docs/locations for available locations. + 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/compute/commitments/create b/gcloud/beta/compute/commitments/create index bbc2e3e99..00f1a57cb 100644 --- a/gcloud/beta/compute/commitments/create +++ b/gcloud/beta/compute/commitments/create @@ -103,9 +103,10 @@ OPTIONAL FLAGS accelerator-optimized-a3, accelerator-optimized-a3-mega, compute-optimized, compute-optimized-c2d, compute-optimized-c3, compute-optimized-c3d, compute-optimized-h3, general-purpose, - general-purpose-e2, general-purpose-n2, general-purpose-n2d, - general-purpose-n4, general-purpose-t2d, graphics-optimized, - memory-optimized, memory-optimized-m3, storage-optimized-z3. + general-purpose-c4, general-purpose-e2, general-purpose-n2, + general-purpose-n2d, general-purpose-n4, general-purpose-t2d, + graphics-optimized, memory-optimized, memory-optimized-m3, + storage-optimized-z3. Manage the reservations to be created with the commitment. diff --git a/gcloud/beta/compute/images/help b/gcloud/beta/compute/images/help index 11e05f923..2e0930045 100644 --- a/gcloud/beta/compute/images/help +++ b/gcloud/beta/compute/images/help @@ -49,7 +49,7 @@ COMMANDS (BETA) Get the IAM policy for a Compute Engine image. import - (BETA) Import an image into Compute Engine. + (BETA) (DEPRECATED) Import an image into Compute Engine. list (BETA) List Google Compute Engine images. diff --git a/gcloud/beta/compute/images/import b/gcloud/beta/compute/images/import index 8ff44d81d..c9dda80e3 100644 --- a/gcloud/beta/compute/images/import +++ b/gcloud/beta/compute/images/import @@ -20,11 +20,12 @@ SYNOPSIS [--data-disk | --byol --os=OS] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) gcloud beta compute images import imports Virtual Disk images, such - as VMWare VMDK files and VHD files, into Compute Engine. + (BETA) (DEPRECATED) This command is being deprecated. Instead, use the + gcloud migration vms image-imports command. For more information, see + https://cloud.google.com/migrate/virtual-machines/docs/5.0/migrate/image_import. - NOTE: It is recommended to use the new Image Import. Run "gcloud alpha - migration vms image-imports --help" for details. + gcloud beta compute images import imports Virtual Disk images, such as + VMWare VMDK files and VHD files, into Compute Engine. Importing images involves four steps: ▪ Upload the virtual disk file to Cloud Storage. diff --git a/gcloud/beta/compute/routers/add-route-policy-term b/gcloud/beta/compute/routers/add-route-policy-term new file mode 100644 index 000000000..e3ce78fcb --- /dev/null +++ b/gcloud/beta/compute/routers/add-route-policy-term @@ -0,0 +1,66 @@ +NAME + gcloud beta compute routers add-route-policy-term - adds a new term to an + existing route policy of a Comute Engine router + +SYNOPSIS + gcloud beta compute routers add-route-policy-term NAME + --actions=[ACTION;...] --match=MATCH --policy-name=POLICY_NAME + --priority=PRIORITY [--region=REGION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) gcloud beta compute routers add-route-policy-term adds a term to a + route policy. + +POSITIONAL ARGUMENTS + NAME + Name of the router to update. + +REQUIRED FLAGS + --actions=[ACTION;...] + Semicolon separated CEL expressions for the actions to take when the + rule matches. + + --match=MATCH + CEL expression for matching a route. + + --policy-name=POLICY_NAME + Name of the route policy to which to add the term. + + --priority=PRIORITY + Order of the term within the policy. + +OPTIONAL FLAGS + --region=REGION + Region of the router to update. If not specified, you might be prompted + to select a region (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/region property: + + $ gcloud config set compute/region REGION + + A list of regions can be fetched by running: + + $ gcloud compute regions list + + To unset the property, run: + + $ gcloud config unset compute/region + + Alternatively, the region can be stored in the environment variable + CLOUDSDK_COMPUTE_REGION. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha compute routers add-route-policy-term + diff --git a/gcloud/beta/compute/routers/help b/gcloud/beta/compute/routers/help index 1ad0f8ef5..09dc61815 100644 --- a/gcloud/beta/compute/routers/help +++ b/gcloud/beta/compute/routers/help @@ -38,6 +38,10 @@ COMMANDS add-route-policy (BETA) Add an empty route policy to a Compute Engine router. + add-route-policy-term + (BETA) Adds a new term to an existing route policy of a Comute Engine + router. + create (BETA) Create a Compute Engine router. @@ -81,6 +85,9 @@ COMMANDS remove-route-policy (BETA) Remove a route policy from a Compute Engine router. + remove-route-policy-term + (BETA) Remove a route policy term of a Compute Engine router. + update (BETA) Update a Compute Engine router. @@ -90,6 +97,10 @@ COMMANDS update-interface (BETA) Update an interface on a Compute Engine router. + update-route-policy-term + (BETA) Updates a term of an existing route policy of a Comute Engine + router. + upload-route-policy (BETA) Upload a route policy into a Compute Engine router. diff --git a/gcloud/beta/compute/routers/remove-route-policy-term b/gcloud/beta/compute/routers/remove-route-policy-term new file mode 100644 index 000000000..0257f3f5b --- /dev/null +++ b/gcloud/beta/compute/routers/remove-route-policy-term @@ -0,0 +1,60 @@ +NAME + gcloud beta compute routers remove-route-policy-term - remove a route + policy term of a Compute Engine router + +SYNOPSIS + gcloud beta compute routers remove-route-policy-term NAME + --policy-name=POLICY_NAME --priority=PRIORITY [--region=REGION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) gcloud beta compute routers remove-route-policy-term removes a term + of a route policy. + +POSITIONAL ARGUMENTS + NAME + Name of the router to remove a route policy term from. + +REQUIRED FLAGS + --policy-name=POLICY_NAME + Name of the route policy from which the term should be removed. + + --priority=PRIORITY + Order of the term within the policy. + +OPTIONAL FLAGS + --region=REGION + Region of the router to remove a route policy term from. If not + specified, you might be prompted to select a region (interactive mode + only). + + To avoid prompting when this flag is omitted, you can set the + compute/region property: + + $ gcloud config set compute/region REGION + + A list of regions can be fetched by running: + + $ gcloud compute regions list + + To unset the property, run: + + $ gcloud config unset compute/region + + Alternatively, the region can be stored in the environment variable + CLOUDSDK_COMPUTE_REGION. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha compute routers remove-route-policy-term + diff --git a/gcloud/beta/compute/routers/update-route-policy-term b/gcloud/beta/compute/routers/update-route-policy-term new file mode 100644 index 000000000..54993ea37 --- /dev/null +++ b/gcloud/beta/compute/routers/update-route-policy-term @@ -0,0 +1,80 @@ +NAME + gcloud beta compute routers update-route-policy-term - updates a term of an + existing route policy of a Comute Engine router + +SYNOPSIS + gcloud beta compute routers update-route-policy-term NAME + --actions=[ACTION;...] --match=MATCH --policy-name=POLICY_NAME + --priority=PRIORITY [--region=REGION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Updates a term of an existing route policy of a Comute Engine + router. + + gcloud beta compute routers update-route-policy-term updates a term of a + route policy. + + For an example, refer to the EXAMPLES section below. + +EXAMPLES + To update a term of a route policy, run: + + $ gcloud beta compute routers update-route-policy-term \ + example-router --region=router-region \ + --policy-name=example-policy-name --priority=128 \ + --match="destination == '192.168.0.0/24'" \ + --actions="med.set(12345);asPath.prependSequence([1, 2])" + +POSITIONAL ARGUMENTS + NAME + Name of the router to update. + +REQUIRED FLAGS + --actions=[ACTION;...] + Semicolon separated CEL expressions for the actions to take when the + rule matches. + + --match=MATCH + CEL expression for matching a route. + + --policy-name=POLICY_NAME + Name of the route policy to which the term should be updated. + + --priority=PRIORITY + Order of the term within the policy. + +OPTIONAL FLAGS + --region=REGION + Region of the router to update. If not specified, you might be prompted + to select a region (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/region property: + + $ gcloud config set compute/region REGION + + A list of regions can be fetched by running: + + $ gcloud compute regions list + + To unset the property, run: + + $ gcloud config unset compute/region + + Alternatively, the region can be stored in the environment variable + CLOUDSDK_COMPUTE_REGION. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha compute routers update-route-policy-term + diff --git a/gcloud/beta/container/clusters/create b/gcloud/beta/container/clusters/create index 2f5ef50dd..aa1dd661f 100644 --- a/gcloud/beta/container/clusters/create +++ b/gcloud/beta/container/clusters/create @@ -40,7 +40,8 @@ SYNOPSIS [--enable-logging-monitoring-system-only] [--enable-managed-prometheus] [--enable-master-global-access] [--enable-multi-networking] [--enable-nested-virtualization] [--enable-network-policy] - [--enable-pod-security-policy] [--enable-secret-manager] + [--enable-pod-security-policy] [--enable-ray-cluster-logging] + [--enable-ray-cluster-monitoring] [--enable-secret-manager] [--enable-service-externalips] [--enable-shielded-nodes] [--enable-stackdriver-kubernetes] [--enable-vertical-pod-autoscaling] [--fleet-project=PROJECT_ID_OR_NUMBER] [--gateway-api=GATEWAY_API] @@ -201,7 +202,7 @@ FLAGS ADDON must be one of: HttpLoadBalancing, HorizontalPodAutoscaling, KubernetesDashboard, NetworkPolicy, NodeLocalDNS, ConfigConnector, GcePersistentDiskCsiDriver, GcpFilestoreCsiDriver, BackupRestore, - GcsFuseCsiDriver, Istio, CloudRun. + GcsFuseCsiDriver, RayOperator, Istio, CloudRun. --allow-route-overlap Allows the provided cluster CIDRs to overlap with existing routes that @@ -648,6 +649,12 @@ FLAGS API objects. For more information, see https://cloud.google.com/kubernetes-engine/docs/how-to/pod-security-policies. + --enable-ray-cluster-logging + Enable automatic log processing sidecar for Ray clusters. + + --enable-ray-cluster-monitoring + Enable automatic metrics collection for Ray clusters. + --enable-secret-manager Enables the Secret Manager CSI driver provider component. See https://secrets-store-csi-driver.sigs.k8s.io/introduction @@ -905,7 +912,7 @@ FLAGS Set the components that have monitoring enabled. Valid component values are: SYSTEM, WORKLOAD (Deprecated), NONE, API_SERVER, CONTROLLER_MANAGER, SCHEDULER, DAEMONSET, DEPLOYMENT, HPA, POD, - STATEFULSET, STORAGE + STATEFULSET, STORAGE, CADVISOR, KUBELET, DCGM For more information, see https://cloud.google.com/stackdriver/docs/solutions/gke/installing#available-metrics diff --git a/gcloud/beta/container/clusters/create-auto b/gcloud/beta/container/clusters/create-auto index 88aa7e282..48caaf07d 100644 --- a/gcloud/beta/container/clusters/create-auto +++ b/gcloud/beta/container/clusters/create-auto @@ -17,14 +17,15 @@ SYNOPSIS [--enable-backup-restore] [--enable-cilium-clusterwide-network-policy] [--enable-fleet] [--enable-google-cloud-access] [--enable-kubernetes-unstable-apis=API,[API,...]] - [--enable-master-global-access] [--enable-secret-manager] - [--fleet-project=PROJECT_ID_OR_NUMBER] [--labels=[KEY=VALUE,...]] - [--logging=[COMPONENT,...]] [--monitoring=[COMPONENT,...]] - [--network=NETWORK] [--private-endpoint-subnetwork=NAME] - [--release-channel=[CHANNEL]] [--security-group=SECURITY_GROUP] - [--security-posture=SECURITY_POSTURE] [--services-ipv4-cidr=CIDR] - [--services-secondary-range-name=NAME] [--subnetwork=SUBNETWORK] - [--workload-policies=WORKLOAD_POLICIES] + [--enable-master-global-access] [--enable-ray-cluster-logging] + [--enable-ray-cluster-monitoring] [--enable-ray-operator] + [--enable-secret-manager] [--fleet-project=PROJECT_ID_OR_NUMBER] + [--labels=[KEY=VALUE,...]] [--logging=[COMPONENT,...]] + [--monitoring=[COMPONENT,...]] [--network=NETWORK] + [--private-endpoint-subnetwork=NAME] [--release-channel=[CHANNEL]] + [--security-group=SECURITY_GROUP] [--security-posture=SECURITY_POSTURE] + [--services-ipv4-cidr=CIDR] [--services-secondary-range-name=NAME] + [--subnetwork=SUBNETWORK] [--workload-policies=WORKLOAD_POLICIES] [--workload-vulnerability-scanning=WORKLOAD_VULNERABILITY_SCANNING] [--additive-vpc-scope-dns-domain=ADDITIVE_VPC_SCOPE_DNS_DOMAIN | --disable-additive-vpc-scope] @@ -243,6 +244,15 @@ FLAGS endpoint from any Google Cloud region or on-premises environment regardless of the private cluster's region. + --enable-ray-cluster-logging + Enable automatic log processing sidecar for Ray clusters. + + --enable-ray-cluster-monitoring + Enable automatic metrics collection for Ray clusters. + + --enable-ray-operator + Enable the Ray Operator GKE add-on. This add-on is disabled by default. + --enable-secret-manager Enables the Secret Manager CSI driver provider component. See https://secrets-store-csi-driver.sigs.k8s.io/introduction @@ -291,7 +301,7 @@ FLAGS Set the components that have monitoring enabled. Valid component values are: SYSTEM, WORKLOAD (Deprecated), NONE, API_SERVER, CONTROLLER_MANAGER, SCHEDULER, DAEMONSET, DEPLOYMENT, HPA, POD, - STATEFULSET, STORAGE + STATEFULSET, STORAGE, CADVISOR, KUBELET, DCGM For more information, see https://cloud.google.com/stackdriver/docs/solutions/gke/installing#available-metrics @@ -299,7 +309,7 @@ FLAGS Examples: $ gcloud beta container clusters create-auto \ - --monitoring=SYSTEM,API_SERVER,POD + --monitoring=SYSTEM,API_SERVER,POD,DCGM $ gcloud beta container clusters create-auto --monitoring=SYSTEM --network=NETWORK diff --git a/gcloud/beta/container/clusters/update b/gcloud/beta/container/clusters/update index b5b0deb90..3c413eca7 100644 --- a/gcloud/beta/container/clusters/update +++ b/gcloud/beta/container/clusters/update @@ -25,9 +25,10 @@ SYNOPSIS | --enable-master-authorized-networks | --enable-master-global-access | --enable-multi-networking | --enable-network-policy | --enable-pod-security-policy | --enable-private-endpoint - | --enable-secret-manager | --enable-service-externalips - | --enable-shielded-nodes | --enable-stackdriver-kubernetes - | --enable-vertical-pod-autoscaling + | --[no-]enable-ray-cluster-logging + | --[no-]enable-ray-cluster-monitoring | --enable-secret-manager + | --enable-service-externalips | --enable-shielded-nodes + | --enable-stackdriver-kubernetes | --enable-vertical-pod-autoscaling | --fleet-project=PROJECT_ID_OR_NUMBER | --gateway-api=GATEWAY_API | --generate-password | --identity-provider=IDENTITY_PROVIDER | --in-transit-encryption=IN_TRANSIT_ENCRYPTION @@ -412,6 +413,16 @@ REQUIRED FLAGS Enables cluster's control plane to be accessible using private IP address only. + --[no-]enable-ray-cluster-logging + Enable automatic log processing sidecar for Ray clusters. Use + --enable-ray-cluster-logging to enable and + --no-enable-ray-cluster-logging to disable. + + --[no-]enable-ray-cluster-monitoring + Enable automatic metrics collection for Ray clusters. Use + --enable-ray-cluster-monitoring to enable and + --no-enable-ray-cluster-monitoring to disable. + --enable-secret-manager Enables the Secret Manager CSI driver provider component. See https://secrets-store-csi-driver.sigs.k8s.io/introduction @@ -1344,7 +1355,7 @@ REQUIRED FLAGS Set the components that have monitoring enabled. Valid component values are: SYSTEM, WORKLOAD (Deprecated), NONE, API_SERVER, CONTROLLER_MANAGER, SCHEDULER, DAEMONSET, DEPLOYMENT, HPA, POD, - STATEFULSET, STORAGE + STATEFULSET, STORAGE, CADVISOR, KUBELET, DCGM For more information, see https://cloud.google.com/stackdriver/docs/solutions/gke/installing#available-metrics diff --git a/gcloud/beta/container/fleet/mesh/debug/proxy-config b/gcloud/beta/container/fleet/mesh/debug/proxy-config index c38acbcd4..a59182576 100644 --- a/gcloud/beta/container/fleet/mesh/debug/proxy-config +++ b/gcloud/beta/container/fleet/mesh/debug/proxy-config @@ -5,7 +5,7 @@ NAME SYNOPSIS gcloud beta container fleet mesh debug proxy-config POD_NAME_NAMESPACE --type=TYPE (--membership=MEMBERSHIP : --location=LOCATION) - [GCLOUD_WIDE_FLAG ...] + [--output=OUTPUT] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Retrieve a configuration summary for a given Envoy instance. @@ -17,6 +17,7 @@ EXAMPLES --project=projectId --membership=membershipId --location=us-central1 + --ouput=yaml POSITIONAL ARGUMENTS POD_NAME_NAMESPACE @@ -69,6 +70,10 @@ REQUIRED FLAGS ▸ provide the argument --location on the command line; ▸ set the property gkehub/location. +OPTIONAL FLAGS + --output=OUTPUT + Output format. OUTPUT must be one of: json, yaml. + 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/container/hub/mesh/debug/proxy-config b/gcloud/beta/container/hub/mesh/debug/proxy-config index 3876f4435..20fcec42f 100644 --- a/gcloud/beta/container/hub/mesh/debug/proxy-config +++ b/gcloud/beta/container/hub/mesh/debug/proxy-config @@ -5,7 +5,7 @@ NAME SYNOPSIS gcloud beta container hub mesh debug proxy-config POD_NAME_NAMESPACE --type=TYPE (--membership=MEMBERSHIP : --location=LOCATION) - [GCLOUD_WIDE_FLAG ...] + [--output=OUTPUT] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Retrieve a configuration summary for a given Envoy instance. @@ -17,6 +17,7 @@ EXAMPLES --project=projectId --membership=membershipId --location=us-central1 + --ouput=yaml POSITIONAL ARGUMENTS POD_NAME_NAMESPACE @@ -69,6 +70,10 @@ REQUIRED FLAGS ▸ provide the argument --location on the command line; ▸ set the property gkehub/location. +OPTIONAL FLAGS + --output=OUTPUT + Output format. OUTPUT must be one of: json, yaml. + 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/data-fusion/instances/create b/gcloud/beta/data-fusion/instances/create index c63f3c5dd..de86df3f8 100644 --- a/gcloud/beta/data-fusion/instances/create +++ b/gcloud/beta/data-fusion/instances/create @@ -8,6 +8,9 @@ SYNOPSIS [--enable_stackdriver_logging] [--enable_stackdriver_monitoring] [--labels=[KEY=VALUE,...]] [--options=[KEY=VALUE,...]] [--patch_revision=PATCH_REVISION] [--version=VERSION] [--zone=ZONE] + [--maintenance-window-end=MAINTENANCE_WINDOW_END + --maintenance-window-recurrence=MAINTENANCE_WINDOW_RECURRENCE + --maintenance-window-start=MAINTENANCE_WINDOW_START] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -99,6 +102,32 @@ FLAGS Compute Engine zone in which the instance will be created. Only needed for DEVELOPER edition. For example: --zone=us-central1-a. + Group of arguments for setting the maintenance window value. + + --maintenance-window-end=MAINTENANCE_WINDOW_END + The end time of the maintenance window. Only the time of the day is + used as a reference for an ending time of the window with a provided + recurrence. This will be used in conjunction with start time, and the + difference will determine the length of a single maintenance window. + This flag must be specified if any of the other arguments in this + group are specified. For example: + --maintenance_window_end=2024-01-02T01:00:00Z. See $ gcloud topic + datetimes for information on time formats. + + --maintenance-window-recurrence=MAINTENANCE_WINDOW_RECURRENCE + An RFC 5545 RRULE, specifying how the maintenance window will recur. + Only FREQ=WEEKLY format is supported. This flag must be specified if + any of the other arguments in this group are specified. For example: + --maintenance_window_recurrence="FREQ=WEEKLY;BYDAY=FR,SA,SU". + + --maintenance-window-start=MAINTENANCE_WINDOW_START + The start time of the maintenance window. Only the time of the day is + used as a reference for a starting time of the window with a provided + recurrence. This flag must be specified if any of the other arguments + in this group are specified. For example: + --maintenance_window_start=2024-01-01T01:00:00Z. See $ gcloud topic + datetimes for information on time formats. + 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/data-fusion/instances/update b/gcloud/beta/data-fusion/instances/update index 2b9c2f4c7..72bf82d95 100644 --- a/gcloud/beta/data-fusion/instances/update +++ b/gcloud/beta/data-fusion/instances/update @@ -7,7 +7,12 @@ SYNOPSIS [--async] [--enable_rbac] [--enable_stackdriver_logging] [--enable_stackdriver_monitoring] [--labels=[KEY=VALUE,...]] [--options=[KEY=VALUE,...]] [--patch_revision=PATCH_REVISION] - [--version=VERSION] [GCLOUD_WIDE_FLAG ...] + [--version=VERSION] + [--clear-maintenance-window + | --maintenance-window-end=MAINTENANCE_WINDOW_END + --maintenance-window-recurrence=MAINTENANCE_WINDOW_RECURRENCE + --maintenance-window-start=MAINTENANCE_WINDOW_START] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) If run asynchronously with --async, exits after printing an @@ -94,6 +99,38 @@ FLAGS --version=VERSION Version of Datafusion to update to. + At most one of these can be specified: + + --clear-maintenance-window + Clear the maintenance window for this Data Fusion instance. + + Group of arguments for setting the maintenance window value. + + --maintenance-window-end=MAINTENANCE_WINDOW_END + The end time of the maintenance window. Only the time of the day is + used as a reference for an ending time of the window with a + provided recurrence. This will be used in conjunction with start + time, and the difference will determine the length of a single + maintenance window. This flag must be specified if any of the other + arguments in this group are specified. For example: + --maintenance_window_end=2024-01-02T01:00:00Z. See $ gcloud topic + datetimes for information on time formats. + + --maintenance-window-recurrence=MAINTENANCE_WINDOW_RECURRENCE + An RFC 5545 RRULE, specifying how the maintenance window will + recur. Only FREQ=WEEKLY format is supported. This flag must be + specified if any of the other arguments in this group are + specified. For example: + --maintenance_window_recurrence="FREQ=WEEKLY;BYDAY=FR,SA,SU". + + --maintenance-window-start=MAINTENANCE_WINDOW_START + The start time of the maintenance window. Only the time of the day + is used as a reference for a starting time of the window with a + provided recurrence. This flag must be specified if any of the + other arguments in this group are specified. For example: + --maintenance_window_start=2024-01-01T01:00:00Z. See $ gcloud topic + datetimes for information on time formats. + 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/healthcare/datasets/create b/gcloud/beta/healthcare/datasets/create index 983e39e13..6bb0605f6 100644 --- a/gcloud/beta/healthcare/datasets/create +++ b/gcloud/beta/healthcare/datasets/create @@ -4,7 +4,8 @@ NAME SYNOPSIS gcloud beta healthcare datasets create (DATASET : --location=LOCATION) - [--async] [--time-zone=TIME_ZONE] [GCLOUD_WIDE_FLAG ...] + [--async] [--encryption-key=ENCRYPTION_KEY] [--time-zone=TIME_ZONE] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Create a new Cloud Healthcare API dataset @@ -56,6 +57,13 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + --encryption-key=ENCRYPTION_KEY + KMS encryption key that is used to secure this dataset and its + sub-resources. The key used for encryption and the dataset must be in + the same location. If empty, the default Google encryption key will be + used to secure this dataset. The format is + projects/{projectId}/locations/{locationId}/keyRings/{keyRingId}/cryptoKeys/{keyId}. + --time-zone=TIME_ZONE Default timezone used by this dataset. diff --git a/gcloud/beta/network-connectivity/regional-endpoints/create b/gcloud/beta/network-connectivity/regional-endpoints/create index b5688e2ff..5a6cc8fa1 100644 --- a/gcloud/beta/network-connectivity/regional-endpoints/create +++ b/gcloud/beta/network-connectivity/regional-endpoints/create @@ -18,7 +18,7 @@ EXAMPLES us-central1 targeting my-target-endpoint, run: $ gcloud beta network-connectivity regional-endpoints create \ - my-regional-endpoint --region=us-centeral1 \ + my-regional-endpoint --region=us-central1 \ [--network=my-network] [--subnetwork=my-subnet] \ --target-google-api=my-target-endpoint [--enable-global-access] diff --git a/gcloud/beta/network-connectivity/regional-endpoints/list b/gcloud/beta/network-connectivity/regional-endpoints/list index 7dbabde69..a9afa5de6 100644 --- a/gcloud/beta/network-connectivity/regional-endpoints/list +++ b/gcloud/beta/network-connectivity/regional-endpoints/list @@ -12,7 +12,7 @@ DESCRIPTION specified project. EXAMPLES - To list all regional endpoints in us-centeral1, run: + To list all regional endpoints in us-central1, run: $ gcloud beta network-connectivity regional-endpoints list \ --region=us-central1 [--project=my-project] diff --git a/gcloud/beta/pam/check-onboarding-status b/gcloud/beta/pam/check-onboarding-status index 555f21e32..0b11310d6 100644 --- a/gcloud/beta/pam/check-onboarding-status +++ b/gcloud/beta/pam/check-onboarding-status @@ -86,7 +86,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the privilegedaccessmanager/v1beta API. The full - documentation for this API can be found at: https://cloud.google.com/ + documentation for this API can be found at: + https://cloud.google.com/iam/docs/pam-overview NOTES This command is currently in beta and might change without notice. This diff --git a/gcloud/beta/pam/entitlements/create b/gcloud/beta/pam/entitlements/create index 9ebc05f73..8fa3c8584 100644 --- a/gcloud/beta/pam/entitlements/create +++ b/gcloud/beta/pam/entitlements/create @@ -115,7 +115,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the privilegedaccessmanager/v1beta API. The full - documentation for this API can be found at: https://cloud.google.com/ + documentation for this API can be found at: + https://cloud.google.com/iam/docs/pam-overview NOTES This command is currently in beta and might change without notice. This diff --git a/gcloud/beta/pam/entitlements/delete b/gcloud/beta/pam/entitlements/delete index 0a0088d9d..e8c184e6a 100644 --- a/gcloud/beta/pam/entitlements/delete +++ b/gcloud/beta/pam/entitlements/delete @@ -107,7 +107,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the privilegedaccessmanager/v1beta API. The full - documentation for this API can be found at: https://cloud.google.com/ + documentation for this API can be found at: + https://cloud.google.com/iam/docs/pam-overview NOTES This command is currently in beta and might change without notice. This diff --git a/gcloud/beta/pam/entitlements/describe b/gcloud/beta/pam/entitlements/describe index 8efa15332..0a3e43b90 100644 --- a/gcloud/beta/pam/entitlements/describe +++ b/gcloud/beta/pam/entitlements/describe @@ -98,7 +98,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the privilegedaccessmanager/v1beta API. The full - documentation for this API can be found at: https://cloud.google.com/ + documentation for this API can be found at: + https://cloud.google.com/iam/docs/pam-overview NOTES This command is currently in beta and might change without notice. This diff --git a/gcloud/beta/pam/entitlements/export b/gcloud/beta/pam/entitlements/export index e3f59504c..ae041d2e2 100644 --- a/gcloud/beta/pam/entitlements/export +++ b/gcloud/beta/pam/entitlements/export @@ -111,7 +111,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the privilegedaccessmanager/v1beta API. The full - documentation for this API can be found at: https://cloud.google.com/ + documentation for this API can be found at: + https://cloud.google.com/iam/docs/pam-overview NOTES This command is currently in beta and might change without notice. This diff --git a/gcloud/beta/pam/entitlements/list b/gcloud/beta/pam/entitlements/list index ef0a2cfc3..23f1c79fc 100644 --- a/gcloud/beta/pam/entitlements/list +++ b/gcloud/beta/pam/entitlements/list @@ -113,7 +113,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the privilegedaccessmanager/v1beta API. The full - documentation for this API can be found at: https://cloud.google.com/ + documentation for this API can be found at: + https://cloud.google.com/iam/docs/pam-overview NOTES This command is currently in beta and might change without notice. This diff --git a/gcloud/beta/pam/entitlements/search b/gcloud/beta/pam/entitlements/search index f208fa8db..69ce329a1 100644 --- a/gcloud/beta/pam/entitlements/search +++ b/gcloud/beta/pam/entitlements/search @@ -142,7 +142,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the privilegedaccessmanager/v1beta API. The full - documentation for this API can be found at: https://cloud.google.com/ + documentation for this API can be found at: + https://cloud.google.com/iam/docs/pam-overview NOTES This command is currently in beta and might change without notice. This diff --git a/gcloud/beta/pam/entitlements/update b/gcloud/beta/pam/entitlements/update index e41bf0026..d599cc49f 100644 --- a/gcloud/beta/pam/entitlements/update +++ b/gcloud/beta/pam/entitlements/update @@ -114,7 +114,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the privilegedaccessmanager/v1beta API. The full - documentation for this API can be found at: https://cloud.google.com/ + documentation for this API can be found at: + https://cloud.google.com/iam/docs/pam-overview NOTES This command is currently in beta and might change without notice. This diff --git a/gcloud/beta/pam/grants/approve b/gcloud/beta/pam/grants/approve index 5ea1b0422..b8ad57610 100644 --- a/gcloud/beta/pam/grants/approve +++ b/gcloud/beta/pam/grants/approve @@ -94,7 +94,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the privilegedaccessmanager/v1beta API. The full - documentation for this API can be found at: https://cloud.google.com/ + documentation for this API can be found at: + https://cloud.google.com/iam/docs/pam-overview NOTES This command is currently in beta and might change without notice. This diff --git a/gcloud/beta/pam/grants/create b/gcloud/beta/pam/grants/create index f52a3aef6..71762bb5f 100644 --- a/gcloud/beta/pam/grants/create +++ b/gcloud/beta/pam/grants/create @@ -101,7 +101,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the privilegedaccessmanager/v1beta API. The full - documentation for this API can be found at: https://cloud.google.com/ + documentation for this API can be found at: + https://cloud.google.com/iam/docs/pam-overview NOTES This command is currently in beta and might change without notice. This diff --git a/gcloud/beta/pam/grants/deny b/gcloud/beta/pam/grants/deny index 5eae112fd..7cbcf6a1a 100644 --- a/gcloud/beta/pam/grants/deny +++ b/gcloud/beta/pam/grants/deny @@ -93,7 +93,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the privilegedaccessmanager/v1beta API. The full - documentation for this API can be found at: https://cloud.google.com/ + documentation for this API can be found at: + https://cloud.google.com/iam/docs/pam-overview NOTES This command is currently in beta and might change without notice. This diff --git a/gcloud/beta/pam/grants/describe b/gcloud/beta/pam/grants/describe index 4cfc9e579..47706df27 100644 --- a/gcloud/beta/pam/grants/describe +++ b/gcloud/beta/pam/grants/describe @@ -89,7 +89,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the privilegedaccessmanager/v1beta API. The full - documentation for this API can be found at: https://cloud.google.com/ + documentation for this API can be found at: + https://cloud.google.com/iam/docs/pam-overview NOTES This command is currently in beta and might change without notice. This diff --git a/gcloud/beta/pam/grants/list b/gcloud/beta/pam/grants/list index 613513ab1..e86d2ffb4 100644 --- a/gcloud/beta/pam/grants/list +++ b/gcloud/beta/pam/grants/list @@ -111,7 +111,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the privilegedaccessmanager/v1beta API. The full - documentation for this API can be found at: https://cloud.google.com/ + documentation for this API can be found at: + https://cloud.google.com/iam/docs/pam-overview NOTES This command is currently in beta and might change without notice. This diff --git a/gcloud/beta/pam/grants/revoke b/gcloud/beta/pam/grants/revoke index 90ca71a98..b83109c39 100644 --- a/gcloud/beta/pam/grants/revoke +++ b/gcloud/beta/pam/grants/revoke @@ -97,7 +97,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the privilegedaccessmanager/v1beta API. The full - documentation for this API can be found at: https://cloud.google.com/ + documentation for this API can be found at: + https://cloud.google.com/iam/docs/pam-overview NOTES This command is currently in beta and might change without notice. This diff --git a/gcloud/beta/pam/grants/search b/gcloud/beta/pam/grants/search index c39858e97..86ba66df6 100644 --- a/gcloud/beta/pam/grants/search +++ b/gcloud/beta/pam/grants/search @@ -132,7 +132,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the privilegedaccessmanager/v1beta API. The full - documentation for this API can be found at: https://cloud.google.com/ + documentation for this API can be found at: + https://cloud.google.com/iam/docs/pam-overview NOTES This command is currently in beta and might change without notice. This diff --git a/gcloud/beta/pam/operations/delete b/gcloud/beta/pam/operations/delete index 547bd6892..6819ab26a 100644 --- a/gcloud/beta/pam/operations/delete +++ b/gcloud/beta/pam/operations/delete @@ -82,7 +82,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the privilegedaccessmanager/v1beta API. The full - documentation for this API can be found at: https://cloud.google.com/ + documentation for this API can be found at: + https://cloud.google.com/iam/docs/pam-overview NOTES This command is currently in beta and might change without notice. This diff --git a/gcloud/beta/pam/operations/describe b/gcloud/beta/pam/operations/describe index 3c2291f99..9a929eaba 100644 --- a/gcloud/beta/pam/operations/describe +++ b/gcloud/beta/pam/operations/describe @@ -83,7 +83,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the privilegedaccessmanager/v1beta API. The full - documentation for this API can be found at: https://cloud.google.com/ + documentation for this API can be found at: + https://cloud.google.com/iam/docs/pam-overview NOTES This command is currently in beta and might change without notice. This diff --git a/gcloud/beta/pam/operations/list b/gcloud/beta/pam/operations/list index 0e18feb4d..c561506cd 100644 --- a/gcloud/beta/pam/operations/list +++ b/gcloud/beta/pam/operations/list @@ -113,7 +113,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the privilegedaccessmanager/v1beta API. The full - documentation for this API can be found at: https://cloud.google.com/ + documentation for this API can be found at: + https://cloud.google.com/iam/docs/pam-overview NOTES This command is currently in beta and might change without notice. This diff --git a/gcloud/beta/pam/operations/wait b/gcloud/beta/pam/operations/wait index 8ff2f0f1e..610aa8b2b 100644 --- a/gcloud/beta/pam/operations/wait +++ b/gcloud/beta/pam/operations/wait @@ -82,7 +82,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the privilegedaccessmanager/v1beta API. The full - documentation for this API can be found at: https://cloud.google.com/ + documentation for this API can be found at: + https://cloud.google.com/iam/docs/pam-overview NOTES This command is currently in beta and might change without notice. This diff --git a/gcloud/beta/run/deploy b/gcloud/beta/run/deploy index a157c39b8..d1041f913 100644 --- a/gcloud/beta/run/deploy +++ b/gcloud/beta/run/deploy @@ -467,7 +467,8 @@ FLAGS 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'. + to a revision named 'helloworld-v1'. Set empty string to clear the + suffix and resume server-assigned naming. --service-min-instances=SERVICE_MIN_INSTANCES The minimum number of container instances for this Service to run or diff --git a/gcloud/beta/run/services/update b/gcloud/beta/run/services/update index aba39ee9d..a18c6f5dd 100644 --- a/gcloud/beta/run/services/update +++ b/gcloud/beta/run/services/update @@ -349,7 +349,8 @@ FLAGS 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'. + to a revision named 'helloworld-v1'. Set empty string to clear the + suffix and resume server-assigned naming. --service-min-instances=SERVICE_MIN_INSTANCES The minimum number of container instances for this Service to run or diff --git a/gcloud/beta/spanner/operations/list b/gcloud/beta/spanner/operations/list index 0e4d6e441..902c69f82 100644 --- a/gcloud/beta/spanner/operations/list +++ b/gcloud/beta/spanner/operations/list @@ -90,6 +90,10 @@ FLAGS database operations associated with the databases in the instance. When a database is specified (--database), the command would return database operations for the given database. + DATABASE_CHANGE_QUORUM + Database change quorum operations are returned for all databases in + the given instance (--instance only) or only those associated with + the given database (--database). DATABASE_CREATE Database create operations are returned for all databases in the given instance (--instance only) or only those associated with the diff --git a/gcloud/beta/sql/instances/create b/gcloud/beta/sql/instances/create index 1311157d6..731d5d978 100644 --- a/gcloud/beta/sql/instances/create +++ b/gcloud/beta/sql/instances/create @@ -21,6 +21,7 @@ SYNOPSIS [--deny-maintenance-period-start-date=DENY_MAINTENANCE_PERIOD_START_DATE] [--deny-maintenance-period-time=DENY_MAINTENANCE_PERIOD_TIME] [--edition=EDITION] [--enable-bin-log] [--enable-data-cache] + [--[no-]enable-dataplex-integration] [--[no-]enable-google-ml-integration] [--enable-google-private-path] [--enable-password-policy] [--enable-point-in-time-recovery] [--failover-replica-name=FAILOVER_REPLICA_NAME] @@ -239,6 +240,11 @@ FLAGS Enable use of data cache for accelerated read performance. This flag is only available for Enterprise_Plus edition instances. + --[no-]enable-dataplex-integration + Enable Dataplex integration for Google Cloud SQL. Use + --enable-dataplex-integration to enable and + --no-enable-dataplex-integration to disable. + --[no-]enable-google-ml-integration Enable Vertex AI integration for Google Cloud SQL. Currently, only PostgreSQL is supported. Use --enable-google-ml-integration to enable diff --git a/gcloud/beta/sql/instances/patch b/gcloud/beta/sql/instances/patch index faab99a03..5095af5b5 100644 --- a/gcloud/beta/sql/instances/patch +++ b/gcloud/beta/sql/instances/patch @@ -19,6 +19,7 @@ SYNOPSIS [--deny-maintenance-period-time=DENY_MAINTENANCE_PERIOD_TIME] [--diff] [--edition=EDITION] [--[no-]enable-bin-log] [--enable-data-cache] [--[no-]enable-database-replication] + [--[no-]enable-dataplex-integration] [--[no-]enable-google-ml-integration] [--[no-]enable-google-private-path] [--enable-password-policy] [--enable-point-in-time-recovery] @@ -191,6 +192,11 @@ FLAGS --enable-database-replication to enable and --no-enable-database-replication to disable. + --[no-]enable-dataplex-integration + Enable Dataplex integration for Google Cloud SQL. Use + --enable-dataplex-integration to enable and + --no-enable-dataplex-integration to disable. + --[no-]enable-google-ml-integration Enable Vertex AI integration for Google Cloud SQL. Currently, only PostgreSQL is supported. Use --enable-google-ml-integration to enable diff --git a/gcloud/bigtable/backups/update b/gcloud/bigtable/backups/update index c9c2d27f3..350971205 100644 --- a/gcloud/bigtable/backups/update +++ b/gcloud/bigtable/backups/update @@ -5,8 +5,8 @@ NAME SYNOPSIS gcloud bigtable backups update (BACKUP : --cluster=CLUSTER --instance=INSTANCE) - (--expiration-date=EXPIRATION_DATE - | --retention-period=RETENTION_PERIOD) [GCLOUD_WIDE_FLAG ...] + [--expiration-date=EXPIRATION_DATE + | --retention-period=RETENTION_PERIOD] [GCLOUD_WIDE_FLAG ...] DESCRIPTION Update a backup, only supported for the following fields: --expiration-date @@ -58,8 +58,8 @@ POSITIONAL ARGUMENTS specified name; ▸ provide the argument --instance on the command line. -REQUIRED FLAGS - Exactly one of these must be specified: +FLAGS + At most one of these can be specified: --expiration-date=EXPIRATION_DATE Absolute expiration time of the backup; must be at least 6 hours and diff --git a/gcloud/builds/worker-pools/create b/gcloud/builds/worker-pools/create index b573a2690..a4c83356b 100644 --- a/gcloud/builds/worker-pools/create +++ b/gcloud/builds/worker-pools/create @@ -3,7 +3,7 @@ NAME Cloud Build SYNOPSIS - gcloud builds worker-pools create WORKER_POOL --region=REGION + gcloud builds worker-pools create WORKER_POOL [--region=REGION] [--config-from-file=CONFIG_FROM_FILE | --worker-disk-size=WORKER_DISK_SIZE --worker-machine-type=WORKER_MACHINE_TYPE @@ -35,12 +35,11 @@ POSITIONAL ARGUMENTS Unique identifier for the worker pool to create. This value should be 1-63 characters, and valid characters are [a-z][0-9]- -REQUIRED FLAGS +FLAGS --region=REGION Cloud region where the worker pool is created. See https://cloud.google.com/build/docs/locations for available locations. -OPTIONAL FLAGS At most one of these can be specified: --config-from-file=CONFIG_FROM_FILE diff --git a/gcloud/builds/worker-pools/delete b/gcloud/builds/worker-pools/delete index 26fa5c8e9..d77ae5d67 100644 --- a/gcloud/builds/worker-pools/delete +++ b/gcloud/builds/worker-pools/delete @@ -2,7 +2,7 @@ NAME gcloud builds worker-pools delete - delete a worker pool from Cloud Build SYNOPSIS - gcloud builds worker-pools delete WORKER_POOL --region=REGION + gcloud builds worker-pools delete WORKER_POOL [--region=REGION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -17,7 +17,7 @@ POSITIONAL ARGUMENTS WORKER_POOL The ID of the worker pool to delete. -REQUIRED FLAGS +FLAGS --region=REGION The Cloud region where the worker pool is. diff --git a/gcloud/builds/worker-pools/describe b/gcloud/builds/worker-pools/describe index 11ce87e5a..32a7a7973 100644 --- a/gcloud/builds/worker-pools/describe +++ b/gcloud/builds/worker-pools/describe @@ -3,7 +3,7 @@ NAME Build SYNOPSIS - gcloud builds worker-pools describe WORKER_POOL --region=REGION + gcloud builds worker-pools describe WORKER_POOL [--region=REGION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -19,7 +19,7 @@ POSITIONAL ARGUMENTS WORKER_POOL The ID of the worker pool to describe. -REQUIRED FLAGS +FLAGS --region=REGION The Cloud region where the worker pool is. diff --git a/gcloud/builds/worker-pools/list b/gcloud/builds/worker-pools/list index 2360d780b..c8658239c 100644 --- a/gcloud/builds/worker-pools/list +++ b/gcloud/builds/worker-pools/list @@ -3,7 +3,7 @@ NAME project SYNOPSIS - gcloud builds worker-pools list --region=REGION [--filter=EXPRESSION] + gcloud builds worker-pools list [--region=REGION] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] @@ -15,7 +15,7 @@ EXAMPLES $ gcloud builds worker-pools list --region=us-central1 -REQUIRED FLAGS +FLAGS --region=REGION The Cloud region to list worker pools in. diff --git a/gcloud/builds/worker-pools/update b/gcloud/builds/worker-pools/update index 77bcc916b..0b05b6f58 100644 --- a/gcloud/builds/worker-pools/update +++ b/gcloud/builds/worker-pools/update @@ -3,10 +3,11 @@ NAME Build SYNOPSIS - gcloud builds worker-pools update WORKER_POOL --region=REGION + gcloud builds worker-pools update WORKER_POOL (--config-from-file=CONFIG_FROM_FILE | --[no-]public-egress --worker-disk-size=WORKER_DISK_SIZE - --worker-machine-type=WORKER_MACHINE_TYPE) [GCLOUD_WIDE_FLAG ...] + --worker-machine-type=WORKER_MACHINE_TYPE) [--region=REGION] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION Update a worker pool used by Cloud Build. @@ -24,10 +25,6 @@ POSITIONAL ARGUMENTS 1-63 characters, and valid characters are [a-z][0-9]- REQUIRED FLAGS - --region=REGION - Cloud region where the worker pool is updated. See - https://cloud.google.com/build/docs/locations for available locations. - Exactly one of these must be specified: --config-from-file=CONFIG_FROM_FILE @@ -60,6 +57,11 @@ REQUIRED FLAGS If unspecified, Cloud Build uses a standard machine type. +OPTIONAL FLAGS + --region=REGION + Cloud region where the worker pool is updated. See + https://cloud.google.com/build/docs/locations for available locations. + 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/compute/commitments/create b/gcloud/compute/commitments/create index ee40f3e8a..9afdbf5be 100644 --- a/gcloud/compute/commitments/create +++ b/gcloud/compute/commitments/create @@ -100,9 +100,10 @@ OPTIONAL FLAGS accelerator-optimized-a3, accelerator-optimized-a3-mega, compute-optimized, compute-optimized-c2d, compute-optimized-c3, compute-optimized-c3d, compute-optimized-h3, general-purpose, - general-purpose-e2, general-purpose-n2, general-purpose-n2d, - general-purpose-n4, general-purpose-t2d, graphics-optimized, - memory-optimized, memory-optimized-m3, storage-optimized-z3. + general-purpose-c4, general-purpose-e2, general-purpose-n2, + general-purpose-n2d, general-purpose-n4, general-purpose-t2d, + graphics-optimized, memory-optimized, memory-optimized-m3, + storage-optimized-z3. Manage the reservations to be created with the commitment. diff --git a/gcloud/compute/images/help b/gcloud/compute/images/help index 730e78f1d..be846830e 100644 --- a/gcloud/compute/images/help +++ b/gcloud/compute/images/help @@ -49,7 +49,7 @@ COMMANDS Get the IAM policy for a Compute Engine image. import - Import an image into Compute Engine. + (DEPRECATED) Import an image into Compute Engine. list List Google Compute Engine images. diff --git a/gcloud/compute/images/import b/gcloud/compute/images/import index 892b3bec8..377ae5545 100644 --- a/gcloud/compute/images/import +++ b/gcloud/compute/images/import @@ -20,12 +20,13 @@ SYNOPSIS [--data-disk | --byol --os=OS] [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) This command is being deprecated. Instead, use the gcloud + migration vms image-imports command. For more information, see + https://cloud.google.com/migrate/virtual-machines/docs/5.0/migrate/image_import. + gcloud compute images import imports Virtual Disk images, such as VMWare VMDK files and VHD files, into Compute Engine. - NOTE: It is recommended to use the new Image Import. Run "gcloud alpha - migration vms image-imports --help" for details. - Importing images involves four steps: ▪ Upload the virtual disk file to Cloud Storage. ▪ Import the image to Compute Engine. diff --git a/gcloud/compute/instances/ops-agents/policies/create b/gcloud/compute/instances/ops-agents/policies/create index 6559a7551..f0d583a0a 100644 --- a/gcloud/compute/instances/ops-agents/policies/create +++ b/gcloud/compute/instances/ops-agents/policies/create @@ -18,12 +18,7 @@ DESCRIPTION created policy. EXAMPLES - cat > config.yaml << EOF agentsRule: packageState: installed - version: latest - instanceFilter: inclusionLabels: - - labels: - env: prod - EOF $ gcloud compute instances ops-agents policies create agent-policy \ + To create a Google Cloud Observability agents policy, run: $ gcloud compute instances ops-agents policies create agent-policy \ --project=PROJECT --zone=ZONE --file=config.yaml POSITIONAL ARGUMENTS diff --git a/gcloud/compute/instances/ops-agents/policies/update b/gcloud/compute/instances/ops-agents/policies/update index ca4b7a891..11a97efe0 100644 --- a/gcloud/compute/instances/ops-agents/policies/update +++ b/gcloud/compute/instances/ops-agents/policies/update @@ -18,12 +18,7 @@ DESCRIPTION modified policy. EXAMPLES - cat > config.yaml << EOF agentsRule: packageState: installed - version: latest - instanceFilter: inclusionLabels: - - labels: - env: prod - EOF $ gcloud compute instances ops-agents policies update agent-policy \ + To update a Google Cloud Observability agents policy, run: $ gcloud compute instances ops-agents policies update agent-policy \ --project=PROJECT --zone=ZONE --file=config.yaml POSITIONAL ARGUMENTS diff --git a/gcloud/compute/security-policies/add-layer7-ddos-defense-threshold-config b/gcloud/compute/security-policies/add-layer7-ddos-defense-threshold-config index 5ddd117f0..085aa3655 100644 --- a/gcloud/compute/security-policies/add-layer7-ddos-defense-threshold-config +++ b/gcloud/compute/security-policies/add-layer7-ddos-defense-threshold-config @@ -10,6 +10,11 @@ SYNOPSIS [--auto-deploy-expiration-sec=AUTO_DEPLOY_EXPIRATION_SEC] [--auto-deploy-impacted-baseline-threshold=AUTO_DEPLOY_IMPACTED_BASELINE_THRESHOLD] [--auto-deploy-load-threshold=AUTO_DEPLOY_LOAD_THRESHOLD] + [--detection-absolute-qps=DETECTION_ABSOLUTE_QPS] + [--detection-load-threshold=DETECTION_LOAD_THRESHOLD] + [--detection-relative-to-baseline-qps=DETECTION_RELATIVE_TO_BASELINE_QPS] + [--traffic-granularity-configs=[type=TYPE[,value=VALUE][, + enableEachUniqueValue=ENABLE_EACH_UNIQUE_VALUE];...;...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -17,7 +22,7 @@ DESCRIPTION is used to add layer7 ddos defense threshold configs to security policies. EXAMPLES - To add a layer7 ddos defense threshold config, run the following command: + To add a layer7 ddos defense threshold config run the following command: $ gcloud compute security-policies \ add-layer7-ddos-defense-threshold-config NAME \ @@ -25,7 +30,11 @@ EXAMPLES --auto-deploy-load-threshold=0.7 \ --auto-deploy-confidence-threshold=0.8 \ --auto-deploy-impacted-baseline-threshold=0.1 \ - --auto-deploy-expiration-sec=4800 + --auto-deploy-expiration-sec=4800 \ + --detection-load-threshold=0.4 --detection-absolute-qps=1000 \ + --detection-relative-to-baseline-qps=2.0 \ + --traffic-granularity-configs=type=HTTP_HEADER_HOST,\ + value=www.my-test-host.com;type=HTTP_PATH,enableEachUniqueValue=true POSITIONAL ARGUMENTS NAME @@ -50,6 +59,21 @@ OPTIONAL FLAGS --auto-deploy-load-threshold=AUTO_DEPLOY_LOAD_THRESHOLD The threshold on backend's load, over which auto-deploy takes action. + --detection-absolute-qps=DETECTION_ABSOLUTE_QPS + The absolute QPS of the incoming traffic, over which adaptive + protection detects an attack. + + --detection-load-threshold=DETECTION_LOAD_THRESHOLD + The threshold on backend's load, over which adaptive protection detects + an attack. + + --detection-relative-to-baseline-qps=DETECTION_RELATIVE_TO_BASELINE_QPS + The QPS of the incoming traffic relative to the average baseline QPS, + over which adaptive protection detects an attack. + + --traffic-granularity-configs=[type=TYPE[,value=VALUE][,enableEachUniqueValue=ENABLE_EACH_UNIQUE_VALUE];...;...] + Specify up to 2 configs matching a specifc type/value of traffic. + 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/container/clusters/create b/gcloud/container/clusters/create index 8ff2f6266..d58a092d5 100644 --- a/gcloud/container/clusters/create +++ b/gcloud/container/clusters/create @@ -37,7 +37,8 @@ SYNOPSIS [--enable-l4-ilb-subsetting] [--enable-legacy-authorization] [--enable-managed-prometheus] [--enable-master-global-access] [--enable-multi-networking] [--enable-nested-virtualization] - [--enable-network-policy] [--enable-service-externalips] + [--enable-network-policy] [--enable-ray-cluster-logging] + [--enable-ray-cluster-monitoring] [--enable-service-externalips] [--enable-shielded-nodes] [--enable-stackdriver-kubernetes] [--enable-vertical-pod-autoscaling] [--fleet-project=PROJECT_ID_OR_NUMBER] [--gateway-api=GATEWAY_API] @@ -211,7 +212,7 @@ FLAGS ADDON must be one of: HttpLoadBalancing, HorizontalPodAutoscaling, KubernetesDashboard, NetworkPolicy, NodeLocalDNS, ConfigConnector, GcePersistentDiskCsiDriver, GcpFilestoreCsiDriver, BackupRestore, - GcsFuseCsiDriver, CloudRun. + GcsFuseCsiDriver, RayOperator, CloudRun. --async Return immediately, without waiting for the operation in progress to @@ -607,6 +608,12 @@ FLAGS first be enabled on the master by using --update-addons=NetworkPolicy=ENABLED flag. + --enable-ray-cluster-logging + Enable automatic log processing sidecar for Ray clusters. + + --enable-ray-cluster-monitoring + Enable automatic metrics collection for Ray clusters. + --enable-service-externalips Enables use of services with externalIPs field. @@ -833,7 +840,7 @@ FLAGS Set the components that have monitoring enabled. Valid component values are: SYSTEM, WORKLOAD (Deprecated), NONE, API_SERVER, CONTROLLER_MANAGER, SCHEDULER, DAEMONSET, DEPLOYMENT, HPA, POD, - STATEFULSET, STORAGE + STATEFULSET, STORAGE, CADVISOR, KUBELET, DCGM For more information, see https://cloud.google.com/stackdriver/docs/solutions/gke/installing#available-metrics diff --git a/gcloud/container/clusters/create-auto b/gcloud/container/clusters/create-auto index 082b02671..4e6e415b3 100644 --- a/gcloud/container/clusters/create-auto +++ b/gcloud/container/clusters/create-auto @@ -18,13 +18,15 @@ SYNOPSIS [--enable-backup-restore] [--enable-cilium-clusterwide-network-policy] [--enable-fleet] [--enable-google-cloud-access] [--enable-kubernetes-unstable-apis=API,[API,...]] - [--enable-master-global-access] [--fleet-project=PROJECT_ID_OR_NUMBER] - [--labels=[KEY=VALUE,...]] [--logging=[COMPONENT,...]] - [--monitoring=[COMPONENT,...]] [--network=NETWORK] - [--private-endpoint-subnetwork=NAME] [--release-channel=[CHANNEL]] - [--security-group=SECURITY_GROUP] [--security-posture=SECURITY_POSTURE] - [--services-ipv4-cidr=CIDR] [--services-secondary-range-name=NAME] - [--subnetwork=SUBNETWORK] [--workload-policies=WORKLOAD_POLICIES] + [--enable-master-global-access] [--enable-ray-cluster-logging] + [--enable-ray-cluster-monitoring] [--enable-ray-operator] + [--fleet-project=PROJECT_ID_OR_NUMBER] [--labels=[KEY=VALUE,...]] + [--logging=[COMPONENT,...]] [--monitoring=[COMPONENT,...]] + [--network=NETWORK] [--private-endpoint-subnetwork=NAME] + [--release-channel=[CHANNEL]] [--security-group=SECURITY_GROUP] + [--security-posture=SECURITY_POSTURE] [--services-ipv4-cidr=CIDR] + [--services-secondary-range-name=NAME] [--subnetwork=SUBNETWORK] + [--workload-policies=WORKLOAD_POLICIES] [--workload-vulnerability-scanning=WORKLOAD_VULNERABILITY_SCANNING] [--dataplane-v2-observability-mode=DATAPLANE_V2_OBSERVABILITY_MODE | --disable-dataplane-v2-flow-observability @@ -246,6 +248,15 @@ FLAGS endpoint from any Google Cloud region or on-premises environment regardless of the private cluster's region. + --enable-ray-cluster-logging + Enable automatic log processing sidecar for Ray clusters. + + --enable-ray-cluster-monitoring + Enable automatic metrics collection for Ray clusters. + + --enable-ray-operator + Enable the Ray Operator GKE add-on. This add-on is disabled by default. + --fleet-project=PROJECT_ID_OR_NUMBER Sets fleet host project for the cluster. If specified, the current cluster will be registered as a fleet membership under the fleet host @@ -285,7 +296,7 @@ FLAGS Set the components that have monitoring enabled. Valid component values are: SYSTEM, WORKLOAD (Deprecated), NONE, API_SERVER, CONTROLLER_MANAGER, SCHEDULER, DAEMONSET, DEPLOYMENT, HPA, POD, - STATEFULSET, STORAGE + STATEFULSET, STORAGE, CADVISOR, KUBELET, DCGM For more information, see https://cloud.google.com/stackdriver/docs/solutions/gke/installing#available-metrics @@ -293,7 +304,7 @@ FLAGS Examples: $ gcloud container clusters create-auto \ - --monitoring=SYSTEM,API_SERVER,POD + --monitoring=SYSTEM,API_SERVER,POD,DCGM $ gcloud container clusters create-auto --monitoring=SYSTEM --network=NETWORK diff --git a/gcloud/container/clusters/update b/gcloud/container/clusters/update index 598066cda..4abf9ce23 100644 --- a/gcloud/container/clusters/update +++ b/gcloud/container/clusters/update @@ -23,7 +23,8 @@ SYNOPSIS | --enable-l4-ilb-subsetting | --enable-legacy-authorization | --enable-master-authorized-networks | --enable-master-global-access | --enable-multi-networking | --enable-network-policy - | --enable-private-endpoint | --enable-service-externalips + | --enable-private-endpoint | --[no-]enable-ray-cluster-logging + | --[no-]enable-ray-cluster-monitoring | --enable-service-externalips | --enable-shielded-nodes | --enable-stackdriver-kubernetes | --enable-vertical-pod-autoscaling | --fleet-project=PROJECT_ID_OR_NUMBER | --gateway-api=GATEWAY_API @@ -374,6 +375,16 @@ REQUIRED FLAGS Enables cluster's control plane to be accessible using private IP address only. + --[no-]enable-ray-cluster-logging + Enable automatic log processing sidecar for Ray clusters. Use + --enable-ray-cluster-logging to enable and + --no-enable-ray-cluster-logging to disable. + + --[no-]enable-ray-cluster-monitoring + Enable automatic metrics collection for Ray clusters. Use + --enable-ray-cluster-monitoring to enable and + --no-enable-ray-cluster-monitoring to disable. + --enable-service-externalips Enables use of services with externalIPs field. @@ -1216,7 +1227,7 @@ REQUIRED FLAGS Set the components that have monitoring enabled. Valid component values are: SYSTEM, WORKLOAD (Deprecated), NONE, API_SERVER, CONTROLLER_MANAGER, SCHEDULER, DAEMONSET, DEPLOYMENT, HPA, POD, - STATEFULSET, STORAGE + STATEFULSET, STORAGE, CADVISOR, KUBELET, DCGM For more information, see https://cloud.google.com/stackdriver/docs/solutions/gke/installing#available-metrics diff --git a/gcloud/edge-cloud/container/clusters/create b/gcloud/edge-cloud/container/clusters/create index 0f5322f7d..81b224453 100644 --- a/gcloud/edge-cloud/container/clusters/create +++ b/gcloud/edge-cloud/container/clusters/create @@ -18,6 +18,7 @@ SYNOPSIS [--maintenance-window-end=MAINTENANCE_WINDOW_END] [--maintenance-window-recurrence=MAINTENANCE_WINDOW_RECURRENCE] [--maintenance-window-start=MAINTENANCE_WINDOW_START] + [--offline-reboot-ttl=OFFLINE_REBOOT_TTL] [--release-channel=RELEASE_CHANNEL; default="RELEASE_CHANNEL_UNSPECIFIED"] [--services-ipv4-cidr=SERVICES_IPV4_CIDR; default="10.96.0.0/12"] @@ -154,6 +155,14 @@ FLAGS (https://www.ietf.org/rfc/rfc3339.txt) format. E.g. "2021-01-01T00:00:00Z" or "2021-01-01T00:00:00-05:00" + --offline-reboot-ttl=OFFLINE_REBOOT_TTL + Specifies the maximum duration a node can reboot offline (without + connection to Google) and then rejoin its cluster to resume its + designated workloads. This duration is relative to the machine's most + recent connection to Google. The maximum allowed duration is 7 days. To + disallow offline reboot, set the duration to "PT0S". The parameter + should be an ISO 8601 duration string, for example, "P1DT1H2M3S". + --release-channel=RELEASE_CHANNEL; default="RELEASE_CHANNEL_UNSPECIFIED" Release channel a cluster is subscribed to. It supports two values, NONE and REGULAR. NONE is used to opt out of any release channel. diff --git a/gcloud/edge-cloud/container/clusters/update b/gcloud/edge-cloud/container/clusters/update index fb5f88fd6..ca35a4bf0 100644 --- a/gcloud/edge-cloud/container/clusters/update +++ b/gcloud/edge-cloud/container/clusters/update @@ -4,7 +4,8 @@ NAME SYNOPSIS gcloud edge-cloud container clusters update (CLUSTER : --location=LOCATION) - [--async] [--release-channel=RELEASE_CHANNEL] + [--async] [--offline-reboot-ttl=OFFLINE_REBOOT_TTL] + [--release-channel=RELEASE_CHANNEL] [--clear-maintenance-window | --remove-maintenance-exclusion-window=REMOVE_MAINTENANCE_EXCLUSION_WINDOW | --add-maintenance-exclusion-end=ADD_MAINTENANCE_EXCLUSION_END --add-maintenance-exclusion-name=ADD_MAINTENANCE_EXCLUSION_NAME --add-maintenance-exclusion-start=ADD_MAINTENANCE_EXCLUSION_START | --maintenance-window-end=MAINTENANCE_WINDOW_END --maintenance-window-recurrence=MAINTENANCE_WINDOW_RECURRENCE --maintenance-window-start=MAINTENANCE_WINDOW_START] [GCLOUD_WIDE_FLAG ...] @@ -57,6 +58,14 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + --offline-reboot-ttl=OFFLINE_REBOOT_TTL + Specifies the maximum duration a node can reboot offline (without + connection to Google) and then rejoin its cluster to resume its + designated workloads. This duration is relative to the machine's most + recent connection to Google. The maximum allowed duration is 7 days. If + left unspecified, the default 0 means not allowed. The parameter should + be an ISO 8601 duration string, for example, "P1DT1H2M3S". + --release-channel=RELEASE_CHANNEL Release channel a cluster is subscribed to. It supports two values, NONE and REGULAR. NONE is used to opt out of any release channel. diff --git a/gcloud/healthcare/datasets/create b/gcloud/healthcare/datasets/create index c590ba671..979358622 100644 --- a/gcloud/healthcare/datasets/create +++ b/gcloud/healthcare/datasets/create @@ -3,7 +3,8 @@ NAME SYNOPSIS gcloud healthcare datasets create (DATASET : --location=LOCATION) [--async] - [--time-zone=TIME_ZONE] [GCLOUD_WIDE_FLAG ...] + [--encryption-key=ENCRYPTION_KEY] [--time-zone=TIME_ZONE] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION Create a new Cloud Healthcare API dataset @@ -55,6 +56,13 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + --encryption-key=ENCRYPTION_KEY + KMS encryption key that is used to secure this dataset and its + sub-resources. The key used for encryption and the dataset must be in + the same location. If empty, the default Google encryption key will be + used to secure this dataset. The format is + projects/{projectId}/locations/{locationId}/keyRings/{keyRingId}/cryptoKeys/{keyId}. + --time-zone=TIME_ZONE Default timezone used by this dataset. diff --git a/gcloud/metastore/services/create b/gcloud/metastore/services/create index d51569ff0..b20a1a431 100644 --- a/gcloud/metastore/services/create +++ b/gcloud/metastore/services/create @@ -3,7 +3,8 @@ NAME SYNOPSIS gcloud metastore services create (SERVICE : --location=LOCATION) [--async] - [--data-catalog-sync] [--database-type=DATABASE_TYPE; default="mysql"] + [--autoscaling-enabled] [--data-catalog-sync] + [--database-type=DATABASE_TYPE; default="mysql"] [--deletion-protection] [--encryption-kms-key=ENCRYPTION_KMS_KEY] [--endpoint-protocol=ENDPOINT_PROTOCOL; default="thrift"] [--hive-metastore-version=HIVE_METASTORE_VERSION] @@ -16,7 +17,8 @@ SYNOPSIS [--hive-metastore-configs=[KEY=VALUE,...] | --hive-metastore-configs-from-file=HIVE_METASTORE_CONFIGS_FROM_FILE] [--instance-size=INSTANCE_SIZE | --scaling-factor=SCALING_FACTOR - | --tier=TIER] + | --tier=TIER | --max-scaling-factor=MAX_SCALING_FACTOR + --min-scaling-factor=MIN_SCALING_FACTOR] [--kerberos-principal=KERBEROS_PRINCIPAL --keytab=KEYTAB --krb5-config=KRB5_CONFIG] [--maintenance-window-day=MAINTENANCE_WINDOW_DAY @@ -85,6 +87,16 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + --autoscaling-enabled + A boolean flag to determine whether Dataproc Metastore autoscaling + should be enabled, false if unspecified. + + The default minimum and maximum scaling factors are 0.1 and 6.0, + respectively. + + The minimum and maximum scaling factors can be specified using + --min-scaling-factor and --max-scaling-factor. + --data-catalog-sync A boolean flag to determine whether Dataproc Metastore metadata sync to Data Catalog should be enabled, false if unspecified. Mutually @@ -287,6 +299,18 @@ FLAGS sufficient scalability for enterprise-level Dataproc Metastore workloads. + The autoscaling configuration of the Dataproc Metastore instance. + + --max-scaling-factor=MAX_SCALING_FACTOR + The maximum scaling factor allowed by the autoscaler. Can be one of + [0.1, 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8, 0.9, 1.0, 2.0, 3.0, 4.0, + 5.0, 6.0]. The default value is 6.0. + + --min-scaling-factor=MIN_SCALING_FACTOR + The minimum scaling factor allowed by the autoscaler. Can be one of + [0.1, 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8, 0.9, 1.0, 2.0, 3.0, 4.0, + 5.0, 6.0]. The default value is 0.1. + Information used to configure the Hive metastore service as a service principal in a Kerberos realm. diff --git a/gcloud/metastore/services/update b/gcloud/metastore/services/update index 00788f361..0b98362ca 100644 --- a/gcloud/metastore/services/update +++ b/gcloud/metastore/services/update @@ -3,12 +3,13 @@ NAME SYNOPSIS gcloud metastore services update (SERVICE : --location=LOCATION) [--async] - [--data-catalog-sync] [--deletion-protection] + [--autoscaling-enabled] [--data-catalog-sync] [--deletion-protection] [--endpoint-protocol=ENDPOINT_PROTOCOL] [--port=PORT] [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] [--instance-size=INSTANCE_SIZE | --scaling-factor=SCALING_FACTOR - | --tier=TIER] + | --tier=TIER | --max-scaling-factor=MAX_SCALING_FACTOR + --min-scaling-factor=MIN_SCALING_FACTOR] [--kerberos-principal=KERBEROS_PRINCIPAL --keytab=KEYTAB --krb5-config=KRB5_CONFIG] [--maintenance-window-day=MAINTENANCE_WINDOW_DAY @@ -76,6 +77,16 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + --autoscaling-enabled + A boolean flag to determine whether Dataproc Metastore autoscaling + should be enabled, false if unspecified. + + The default minimum and maximum scaling factors are 0.1 and 6.0, + respectively. + + The minimum and maximum scaling factors can be specified using + --min-scaling-factor and --max-scaling-factor. + --data-catalog-sync Boolean flag to determine whether or not Dataproc Metastore metadata sync to Data Catalog is enabled, false if unspecified. Mutually @@ -167,6 +178,18 @@ FLAGS sufficient scalability for enterprise-level Dataproc Metastore workloads. + The autoscaling configuration of the Dataproc Metastore instance. + + --max-scaling-factor=MAX_SCALING_FACTOR + The maximum scaling factor allowed by the autoscaler. Can be one of + [0.1, 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8, 0.9, 1.0, 2.0, 3.0, 4.0, + 5.0, 6.0]. The default value is 6.0. + + --min-scaling-factor=MIN_SCALING_FACTOR + The minimum scaling factor allowed by the autoscaler. Can be one of + [0.1, 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8, 0.9, 1.0, 2.0, 3.0, 4.0, + 5.0, 6.0]. The default value is 0.1. + Information used to configure the Hive metastore service as a service principal in a Kerberos realm. diff --git a/gcloud/network-connectivity/hubs/list-spokes b/gcloud/network-connectivity/hubs/list-spokes index b7f9b0a58..5a7b51106 100644 --- a/gcloud/network-connectivity/hubs/list-spokes +++ b/gcloud/network-connectivity/hubs/list-spokes @@ -13,7 +13,7 @@ DESCRIPTION EXAMPLES To list all spokes in the us-central1 region and the global location, run: - $ gcloud network-connectivity hubs list-spokes \ + $ gcloud network-connectivity hubs list-spokes HUB \ --spoke-locations=us-central1,global POSITIONAL ARGUMENTS diff --git a/gcloud/network-connectivity/regional-endpoints/create b/gcloud/network-connectivity/regional-endpoints/create index a78b5208c..362e01cbe 100644 --- a/gcloud/network-connectivity/regional-endpoints/create +++ b/gcloud/network-connectivity/regional-endpoints/create @@ -18,7 +18,7 @@ EXAMPLES us-central1 targeting my-target-endpoint, run: $ gcloud network-connectivity regional-endpoints create \ - my-regional-endpoint --region=us-centeral1 \ + my-regional-endpoint --region=us-central1 \ [--network=my-network] [--subnetwork=my-subnet] \ --target-google-api=my-target-endpoint [--enable-global-access] diff --git a/gcloud/network-connectivity/regional-endpoints/list b/gcloud/network-connectivity/regional-endpoints/list index 7be5f62a9..53c38c7e6 100644 --- a/gcloud/network-connectivity/regional-endpoints/list +++ b/gcloud/network-connectivity/regional-endpoints/list @@ -12,7 +12,7 @@ DESCRIPTION project. EXAMPLES - To list all regional endpoints in us-centeral1, run: + To list all regional endpoints in us-central1, run: $ gcloud network-connectivity regional-endpoints list \ --region=us-central1 [--project=my-project] diff --git a/gcloud/run/deploy b/gcloud/run/deploy index fa41c6aed..ecab887ae 100644 --- a/gcloud/run/deploy +++ b/gcloud/run/deploy @@ -437,7 +437,8 @@ FLAGS 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'. + to a revision named 'helloworld-v1'. Set empty string to clear the + suffix and resume server-assigned naming. --[no-]session-affinity Whether to enable session affinity for connections to the service. diff --git a/gcloud/run/services/update b/gcloud/run/services/update index 57de64c72..0f5f83195 100644 --- a/gcloud/run/services/update +++ b/gcloud/run/services/update @@ -319,7 +319,8 @@ FLAGS 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'. + to a revision named 'helloworld-v1'. Set empty string to clear the + suffix and resume server-assigned naming. --[no-]session-affinity Whether to enable session affinity for connections to the service. diff --git a/gcloud/spanner/operations/list b/gcloud/spanner/operations/list index 7f21e0826..0e4ca2690 100644 --- a/gcloud/spanner/operations/list +++ b/gcloud/spanner/operations/list @@ -74,6 +74,10 @@ FLAGS database operations associated with the databases in the instance. When a database is specified (--database), the command would return database operations for the given database. + DATABASE_CHANGE_QUORUM + Database change quorum operations are returned for all databases in + the given instance (--instance only) or only those associated with + the given database (--database). DATABASE_CREATE Database create operations are returned for all databases in the given instance (--instance only) or only those associated with the diff --git a/gcloud/sql/flags/list b/gcloud/sql/flags/list index 2dbbb9c17..e1ebc8697 100644 --- a/gcloud/sql/flags/list +++ b/gcloud/sql/flags/list @@ -18,13 +18,13 @@ FLAGS https://cloud.google.com/sql/docs/mysql/admin-api/rest/v1beta4/SqlDatabaseVersion. Apart from listed major versions, DATABASE_VERSION also accepts supported minor versions. DATABASE_VERSION must be one of: MYSQL_5_6, - MYSQL_5_7, MYSQL_8_0, POSTGRES_9_6, POSTGRES_10, POSTGRES_11, - POSTGRES_12, POSTGRES_13, POSTGRES_14, POSTGRES_15, POSTGRES_16, - SQLSERVER_2017_EXPRESS, SQLSERVER_2017_WEB, SQLSERVER_2017_STANDARD, - SQLSERVER_2017_ENTERPRISE, SQLSERVER_2019_EXPRESS, SQLSERVER_2019_WEB, - SQLSERVER_2019_STANDARD, SQLSERVER_2019_ENTERPRISE, - SQLSERVER_2022_EXPRESS, SQLSERVER_2022_WEB, SQLSERVER_2022_STANDARD, - SQLSERVER_2022_ENTERPRISE. + MYSQL_5_7, MYSQL_8_0, MYSQL_8_4, POSTGRES_9_6, POSTGRES_10, + POSTGRES_11, POSTGRES_12, POSTGRES_13, POSTGRES_14, POSTGRES_15, + POSTGRES_16, SQLSERVER_2017_EXPRESS, SQLSERVER_2017_WEB, + SQLSERVER_2017_STANDARD, SQLSERVER_2017_ENTERPRISE, + SQLSERVER_2019_EXPRESS, SQLSERVER_2019_WEB, SQLSERVER_2019_STANDARD, + SQLSERVER_2019_ENTERPRISE, SQLSERVER_2022_EXPRESS, SQLSERVER_2022_WEB, + SQLSERVER_2022_STANDARD, SQLSERVER_2022_ENTERPRISE. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/sql/instances/create b/gcloud/sql/instances/create index 673e663b5..191c322da 100644 --- a/gcloud/sql/instances/create +++ b/gcloud/sql/instances/create @@ -20,6 +20,7 @@ SYNOPSIS [--deny-maintenance-period-start-date=DENY_MAINTENANCE_PERIOD_START_DATE] [--deny-maintenance-period-time=DENY_MAINTENANCE_PERIOD_TIME] [--edition=EDITION] [--enable-bin-log] [--enable-data-cache] + [--[no-]enable-dataplex-integration] [--[no-]enable-google-ml-integration] [--enable-google-private-path] [--enable-password-policy] [--enable-point-in-time-recovery] [--failover-replica-name=FAILOVER_REPLICA_NAME] @@ -196,13 +197,13 @@ FLAGS https://cloud.google.com/sql/docs/mysql/admin-api/rest/v1beta4/SqlDatabaseVersion. Apart from listed major versions, DATABASE_VERSION also accepts supported minor versions. DATABASE_VERSION must be one of: MYSQL_5_6, - MYSQL_5_7, MYSQL_8_0, POSTGRES_9_6, POSTGRES_10, POSTGRES_11, - POSTGRES_12, POSTGRES_13, POSTGRES_14, POSTGRES_15, POSTGRES_16, - SQLSERVER_2017_EXPRESS, SQLSERVER_2017_WEB, SQLSERVER_2017_STANDARD, - SQLSERVER_2017_ENTERPRISE, SQLSERVER_2019_EXPRESS, SQLSERVER_2019_WEB, - SQLSERVER_2019_STANDARD, SQLSERVER_2019_ENTERPRISE, - SQLSERVER_2022_EXPRESS, SQLSERVER_2022_WEB, SQLSERVER_2022_STANDARD, - SQLSERVER_2022_ENTERPRISE. + MYSQL_5_7, MYSQL_8_0, MYSQL_8_4, POSTGRES_9_6, POSTGRES_10, + POSTGRES_11, POSTGRES_12, POSTGRES_13, POSTGRES_14, POSTGRES_15, + POSTGRES_16, SQLSERVER_2017_EXPRESS, SQLSERVER_2017_WEB, + SQLSERVER_2017_STANDARD, SQLSERVER_2017_ENTERPRISE, + SQLSERVER_2019_EXPRESS, SQLSERVER_2019_WEB, SQLSERVER_2019_STANDARD, + SQLSERVER_2019_ENTERPRISE, SQLSERVER_2022_EXPRESS, SQLSERVER_2022_WEB, + SQLSERVER_2022_STANDARD, SQLSERVER_2022_ENTERPRISE. --[no-]deletion-protection Enable deletion protection on a Cloud SQL instance. Use @@ -231,6 +232,11 @@ FLAGS Enable use of data cache for accelerated read performance. This flag is only available for Enterprise_Plus edition instances. + --[no-]enable-dataplex-integration + Enable Dataplex integration for Google Cloud SQL. Use + --enable-dataplex-integration to enable and + --no-enable-dataplex-integration to disable. + --[no-]enable-google-ml-integration Enable Vertex AI integration for Google Cloud SQL. Currently, only PostgreSQL is supported. Use --enable-google-ml-integration to enable diff --git a/gcloud/sql/instances/patch b/gcloud/sql/instances/patch index 03a92781c..1f7e6ffb7 100644 --- a/gcloud/sql/instances/patch +++ b/gcloud/sql/instances/patch @@ -15,6 +15,7 @@ SYNOPSIS [--deny-maintenance-period-time=DENY_MAINTENANCE_PERIOD_TIME] [--diff] [--edition=EDITION] [--[no-]enable-bin-log] [--enable-data-cache] [--[no-]enable-database-replication] + [--[no-]enable-dataplex-integration] [--[no-]enable-google-ml-integration] [--[no-]enable-google-private-path] [--enable-password-policy] [--enable-point-in-time-recovery] [--follow-gae-app=FOLLOW_GAE_APP] @@ -136,13 +137,13 @@ FLAGS https://cloud.google.com/sql/docs/mysql/admin-api/rest/v1beta4/SqlDatabaseVersion. Apart from listed major versions, DATABASE_VERSION also accepts supported minor versions. DATABASE_VERSION must be one of: MYSQL_5_6, - MYSQL_5_7, MYSQL_8_0, POSTGRES_9_6, POSTGRES_10, POSTGRES_11, - POSTGRES_12, POSTGRES_13, POSTGRES_14, POSTGRES_15, POSTGRES_16, - SQLSERVER_2017_EXPRESS, SQLSERVER_2017_WEB, SQLSERVER_2017_STANDARD, - SQLSERVER_2017_ENTERPRISE, SQLSERVER_2019_EXPRESS, SQLSERVER_2019_WEB, - SQLSERVER_2019_STANDARD, SQLSERVER_2019_ENTERPRISE, - SQLSERVER_2022_EXPRESS, SQLSERVER_2022_WEB, SQLSERVER_2022_STANDARD, - SQLSERVER_2022_ENTERPRISE. + MYSQL_5_7, MYSQL_8_0, MYSQL_8_4, POSTGRES_9_6, POSTGRES_10, + POSTGRES_11, POSTGRES_12, POSTGRES_13, POSTGRES_14, POSTGRES_15, + POSTGRES_16, SQLSERVER_2017_EXPRESS, SQLSERVER_2017_WEB, + SQLSERVER_2017_STANDARD, SQLSERVER_2017_ENTERPRISE, + SQLSERVER_2019_EXPRESS, SQLSERVER_2019_WEB, SQLSERVER_2019_STANDARD, + SQLSERVER_2019_ENTERPRISE, SQLSERVER_2022_EXPRESS, SQLSERVER_2022_WEB, + SQLSERVER_2022_STANDARD, SQLSERVER_2022_ENTERPRISE. --[no-]deletion-protection Enable deletion protection on a Cloud SQL instance. Use @@ -181,6 +182,11 @@ FLAGS --enable-database-replication to enable and --no-enable-database-replication to disable. + --[no-]enable-dataplex-integration + Enable Dataplex integration for Google Cloud SQL. Use + --enable-dataplex-integration to enable and + --no-enable-dataplex-integration to disable. + --[no-]enable-google-ml-integration Enable Vertex AI integration for Google Cloud SQL. Currently, only PostgreSQL is supported. Use --enable-google-ml-integration to enable