diff --git a/gcloud/_version b/gcloud/_version index 3e20a40ea..332cb3d18 100644 --- a/gcloud/_version +++ b/gcloud/_version @@ -1,8 +1,8 @@ -Google Cloud SDK 482.0.0 -alpha 2024.06.24 -beta 2024.06.24 +Google Cloud SDK 483.0.0 +alpha 2024.06.28 +beta 2024.06.28 bq 2.1.6 bundled-python3-unix 3.11.8 -core 2024.06.24 +core 2024.06.28 gcloud-crc32c 1.0.0 gsutil 5.30 diff --git a/gcloud/access-context-manager/help b/gcloud/access-context-manager/help index dc67d429c..7ceb52f95 100644 --- a/gcloud/access-context-manager/help +++ b/gcloud/access-context-manager/help @@ -30,6 +30,9 @@ GROUPS policies Manage Access Context Manager policies. + supported-services + Retrieve VPC Service Controls Supported Services. + NOTES These variants are also available: diff --git a/gcloud/access-context-manager/supported-services/describe b/gcloud/access-context-manager/supported-services/describe new file mode 100644 index 000000000..f8e8b58f0 --- /dev/null +++ b/gcloud/access-context-manager/supported-services/describe @@ -0,0 +1,51 @@ +NAME + gcloud access-context-manager supported-services describe - gets + information about a VPC Service Controls Supported Service + +SYNOPSIS + gcloud access-context-manager supported-services describe SERVICE_NAME + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Get service information allowed in an access policy object. + +EXAMPLES + To get VPC Service Controls support information for + bigquery.googleapis.com, run: + + $ gcloud access-context-manager supported-services describe \ + bigquery.googleapis.com + +POSITIONAL ARGUMENTS + Supported service resource - VPC Service Controls supported service. This + represents a Cloud resource. + + This must be specified. + + SERVICE_NAME + ID of the supported-service or fully qualified identifier for the + supported-service. + + To set the service_name attribute: + ▸ provide the argument service_name on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the accesscontextmanager/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/access-context-manager/docs/reference/rest/ + +NOTES + These variants are also available: + + $ gcloud alpha access-context-manager supported-services describe + + $ gcloud beta access-context-manager supported-services describe + diff --git a/gcloud/access-context-manager/supported-services/help b/gcloud/access-context-manager/supported-services/help new file mode 100644 index 000000000..e048e5766 --- /dev/null +++ b/gcloud/access-context-manager/supported-services/help @@ -0,0 +1,43 @@ +NAME + gcloud access-context-manager supported-services - retrieve VPC Service + Controls Supported Services + +SYNOPSIS + gcloud access-context-manager supported-services COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + The gcloud access-context-manager supported-services command group lets you + list VPC Service Controls supported services and its properties. + +EXAMPLES + To see all VPC Service Controls supported services: + + $ gcloud access-context-manager supported-services list + + To see support information about VPC Service Controls supported services: + + $ gcloud access-context-manager supported-services describe \ + SERVICE_NAME + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + Gets information about a VPC Service Controls Supported Service. + + list + Lists all VPC Service Controls supported services. + +NOTES + These variants are also available: + + $ gcloud alpha access-context-manager supported-services + + $ gcloud beta access-context-manager supported-services + diff --git a/gcloud/access-context-manager/supported-services/list b/gcloud/access-context-manager/supported-services/list new file mode 100644 index 000000000..9b7736797 --- /dev/null +++ b/gcloud/access-context-manager/supported-services/list @@ -0,0 +1,71 @@ +NAME + gcloud access-context-manager supported-services list - lists all VPC + Service Controls supported services + +SYNOPSIS + gcloud access-context-manager supported-services list [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Lists the services that VPC Service Controls supports. The services that + are in this list fully support VPC Service Controls or the integration of + this service with VPC Service Controls is in Preview stage + (https://cloud.google.com/products#product-launch-stages), or the service + integration is scheduled to be shut down and removed which is in + [Deprecation stage] + (https://cloud.google.com/products#product-launch-stages). Services that + aren't in this list don't support VPC Service Controls and aren't + guaranteed to function properly in a VPC Service Controls environment. + +EXAMPLES + To list VPC Service Controls supported services, run: + + $ gcloud access-context-manager supported-services list + + This command prints out a list of all supported services in a tabular form: + + NAME TITLE SERVICE_SUPPORT_STAGE AVAILABLE_ON_RESTRICTED_VIP KNOWN_LIMITATIONS + vpcsc_supported_service VPC-SC Supported API GA True False + +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 + These variants are also available: + + $ gcloud alpha access-context-manager supported-services list + + $ gcloud beta access-context-manager supported-services list + diff --git a/gcloud/alloydb/backups/create b/gcloud/alloydb/backups/create index d584b9520..a258f046b 100644 --- a/gcloud/alloydb/backups/create +++ b/gcloud/alloydb/backups/create @@ -18,17 +18,27 @@ EXAMPLES $ gcloud alloydb backups create my-backup --cluster=my-cluster \ --region=us-central1 + To create a new cross-region backup, run: + + $ gcloud alloydb backups create \ + projects/my-project/locations/us-west1/backups/my-backup \ + --cluster=my-cluster --region=us-central1 + POSITIONAL ARGUMENTS BACKUP - AlloyDB backup ID + The AlloyDB backup to create. This must either be the backup ID + (myBackup) or the full backup path + (projects/myProject/locations/us-central1/backups/myBackup). In the + first case, the project and location are assumed to be the same as the + cluster being backed up. The second form can be used to create + cross-region and cross-project backups. REQUIRED FLAGS --cluster=CLUSTER AlloyDB cluster ID --region=REGION - The region of the cluster to backup. Note: both the cluster and the - backup have to be in the same region. + The region of the cluster to backup. OPTIONAL FLAGS --async diff --git a/gcloud/alloydb/clusters/help b/gcloud/alloydb/clusters/help index b57dc181a..2d2fcf6c9 100644 --- a/gcloud/alloydb/clusters/help +++ b/gcloud/alloydb/clusters/help @@ -38,6 +38,9 @@ COMMANDS Restore an AlloyDB cluster from a given backup or a source cluster and a timestamp. + switchover + Switchover an AlloyDB SECONDARY cluster in a given project and region. + update Update an AlloyDB cluster within a given project and region. diff --git a/gcloud/alloydb/clusters/switchover b/gcloud/alloydb/clusters/switchover new file mode 100644 index 000000000..9409d24d8 --- /dev/null +++ b/gcloud/alloydb/clusters/switchover @@ -0,0 +1,45 @@ +NAME + gcloud alloydb clusters switchover - switchover an AlloyDB SECONDARY + cluster in a given project and region + +SYNOPSIS + gcloud alloydb clusters switchover CLUSTER --region=REGION [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Switchover an AlloyDB SECONDARY cluster in a given project and region. + +EXAMPLES + To switchover a cluster, run: + + $ gcloud alloydb clusters switchover my-cluster --region=us-central1 + +POSITIONAL ARGUMENTS + CLUSTER + AlloyDB cluster ID + +REQUIRED FLAGS + --region=REGION + Regional location (e.g. asia-east1, us-east1). See the full list of + regions at https://cloud.google.com/sql/docs/instance-locations. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha alloydb clusters switchover + + $ gcloud beta alloydb clusters switchover + diff --git a/gcloud/alpha/access-context-manager/help b/gcloud/alpha/access-context-manager/help index 23dd4e8b9..c9869eccd 100644 --- a/gcloud/alpha/access-context-manager/help +++ b/gcloud/alpha/access-context-manager/help @@ -34,7 +34,7 @@ GROUPS (ALPHA) Manage Access Context Manager policies. supported-services - (ALPHA) Retrieve VPC-SC Supported Services. + (ALPHA) Retrieve VPC Service Controls Supported Services. NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/access-context-manager/supported-services/describe b/gcloud/alpha/access-context-manager/supported-services/describe index bb71a3060..b4a37b91d 100644 --- a/gcloud/alpha/access-context-manager/supported-services/describe +++ b/gcloud/alpha/access-context-manager/supported-services/describe @@ -1,6 +1,6 @@ NAME - gcloud alpha access-context-manager supported-services describe - get a VPC - Service Controls Supported Service] + gcloud alpha access-context-manager supported-services describe - gets + information about a VPC Service Controls Supported Service SYNOPSIS gcloud alpha access-context-manager supported-services describe @@ -46,7 +46,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud access-context-manager supported-services describe $ gcloud beta access-context-manager supported-services describe diff --git a/gcloud/alpha/access-context-manager/supported-services/help b/gcloud/alpha/access-context-manager/supported-services/help index 88d3b2ed8..49dcb1506 100644 --- a/gcloud/alpha/access-context-manager/supported-services/help +++ b/gcloud/alpha/access-context-manager/supported-services/help @@ -1,6 +1,6 @@ NAME - gcloud alpha access-context-manager supported-services - retrieve VPC-SC - Supported Services + gcloud alpha access-context-manager supported-services - retrieve VPC + Service Controls Supported Services SYNOPSIS gcloud alpha access-context-manager supported-services COMMAND @@ -12,11 +12,11 @@ DESCRIPTION properties. EXAMPLES - To see all VPC-SC supportedservices: + To see all VPC Service Controls supported services: $ gcloud alpha access-context-manager supported-services list - To see support information about VPC-SC supported service: + To see support information about VPC Service Controls supported services: $ gcloud alpha access-context-manager supported-services describe \ SERVICE_NAME @@ -30,7 +30,8 @@ COMMANDS COMMAND is one of the following: describe - (ALPHA) Get a VPC Service Controls Supported Service]. + (ALPHA) Gets information about a VPC Service Controls Supported + Service. list (ALPHA) Lists all VPC Service Controls supported services. @@ -39,7 +40,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud access-context-manager supported-services $ gcloud beta access-context-manager supported-services diff --git a/gcloud/alpha/access-context-manager/supported-services/list b/gcloud/alpha/access-context-manager/supported-services/list index 72244106f..2129ef97d 100644 --- a/gcloud/alpha/access-context-manager/supported-services/list +++ b/gcloud/alpha/access-context-manager/supported-services/list @@ -9,8 +9,11 @@ SYNOPSIS DESCRIPTION (ALPHA) Lists the services that VPC Service Controls supports. The services - that are in this list either fully support VPC Service Controls or the - integration of this service with VPC Service Controls is in Preview stage + that are in this list fully support VPC Service Controls or the integration + of this service with VPC Service Controls is in Preview stage + (https://cloud.google.com/products#product-launch-stages), or the service + integration is scheduled to be shut down and removed which is in + [Deprecation stage] (https://cloud.google.com/products#product-launch-stages). Services that aren't in this list don't support VPC Service Controls and aren't guaranteed to function properly in a VPC Service Controls environment. @@ -22,8 +25,8 @@ EXAMPLES This command prints out a list of all supported services in a tabular form: - NAME TITLE SUPPORT_STAGE AVAILABLE_ON_RESTRICTED_VIP KNOWN_LIMITATIONS - vpcsc_supported_service VPC-SC Supported API GA True False + NAME TITLE SERVICE_SUPPORT_STAGE AVAILABLE_ON_RESTRICTED_VIP KNOWN_LIMITATIONS + vpcsc_supported_service VPC-SC Supported API GA True False LIST COMMAND FLAGS --filter=EXPRESSION @@ -63,7 +66,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud access-context-manager supported-services list $ gcloud beta access-context-manager supported-services list diff --git a/gcloud/alpha/alloydb/backups/create b/gcloud/alpha/alloydb/backups/create index d1980c450..2ffba44c5 100644 --- a/gcloud/alpha/alloydb/backups/create +++ b/gcloud/alpha/alloydb/backups/create @@ -18,17 +18,27 @@ EXAMPLES $ gcloud alpha alloydb backups create my-backup \ --cluster=my-cluster --region=us-central1 + To create a new cross-region backup, run: + + $ gcloud alpha alloydb backups create \ + projects/my-project/locations/us-west1/backups/my-backup \ + --cluster=my-cluster --region=us-central1 + POSITIONAL ARGUMENTS BACKUP - AlloyDB backup ID + The AlloyDB backup to create. This must either be the backup ID + (myBackup) or the full backup path + (projects/myProject/locations/us-central1/backups/myBackup). In the + first case, the project and location are assumed to be the same as the + cluster being backed up. The second form can be used to create + cross-region and cross-project backups. REQUIRED FLAGS --cluster=CLUSTER AlloyDB cluster ID --region=REGION - The region of the cluster to backup. Note: both the cluster and the - backup have to be in the same region. + The region of the cluster to backup. OPTIONAL FLAGS --async diff --git a/gcloud/alpha/alloydb/clusters/switchover b/gcloud/alpha/alloydb/clusters/switchover index 17e687534..84d8f4007 100644 --- a/gcloud/alpha/alloydb/clusters/switchover +++ b/gcloud/alpha/alloydb/clusters/switchover @@ -42,5 +42,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. These variants are also available: + + $ gcloud alloydb clusters switchover + + $ gcloud beta alloydb clusters switchover diff --git a/gcloud/alpha/alloydb/instances/create b/gcloud/alpha/alloydb/instances/create index 688371055..bbfff1bf1 100644 --- a/gcloud/alpha/alloydb/instances/create +++ b/gcloud/alpha/alloydb/instances/create @@ -14,6 +14,13 @@ SYNOPSIS [--insights-config-query-string-length=INSIGHTS_CONFIG_QUERY_STRING_LENGTH] [--[no-]insights-config-record-application-tags] [--[no-]insights-config-record-client-address] + [--[no-]observability-config-enabled] + [--observability-config-max-query-string-length=OBSERVABILITY_CONFIG_MAX_QUERY_STRING_LENGTH] + [--[no-]observability-config-preserve-comments] + [--observability-config-query-plans-per-minute=OBSERVABILITY_CONFIG_QUERY_PLANS_PER_MINUTE] + [--[no-]observability-config-record-application-tags] + [--[no-]observability-config-track-active-queries] + [--observability-config-track-wait-events] [--read-pool-node-count=READ_POOL_NODE_COUNT] [--[no-]require-connectors] [--ssl-mode=SSL_MODE; default="ENCRYPTED_ONLY"] [GCLOUD_WIDE_FLAG ...] @@ -132,6 +139,41 @@ OPTIONAL FLAGS Use --insights-config-record-client-address to enable and --no-insights-config-record-client-address to disable. + --[no-]observability-config-enabled + Enable enhanced query insights feature. Use + --observability-config-enabled to enable and + --no-observability-config-enabled to disable. + + --observability-config-max-query-string-length=OBSERVABILITY_CONFIG_MAX_QUERY_STRING_LENGTH + Query string length in bytes to be stored by the enhanced query + insights feature. Default length is 10k bytes. + + --[no-]observability-config-preserve-comments + Allow preservation of comments in query string recorded by the enhanced + query insights feature. + + Use --observability-config-preserve-comments to enable and + --no-observability-config-preserve-comments to disable. + + --observability-config-query-plans-per-minute=OBSERVABILITY_CONFIG_QUERY_PLANS_PER_MINUTE + Number of query plans to sample every minute. Default value is 200. + Allowed range: 0 to 200. + + --[no-]observability-config-record-application-tags + Allow application tags to be recorded by the enhanced query insights + feature. + + Use --observability-config-record-application-tags to enable and + --no-observability-config-record-application-tags to disable. + + --[no-]observability-config-track-active-queries + Track actively running queries. Use + --observability-config-track-active-queries to enable and + --no-observability-config-track-active-queries to disable. + + --observability-config-track-wait-events + Track wait events during query execution. + --read-pool-node-count=READ_POOL_NODE_COUNT Read capacity, i.e. number of nodes in a read pool instance. diff --git a/gcloud/alpha/alloydb/instances/update b/gcloud/alpha/alloydb/instances/update index 9ec1591ab..612bdeb1a 100644 --- a/gcloud/alpha/alloydb/instances/update +++ b/gcloud/alpha/alloydb/instances/update @@ -13,6 +13,13 @@ SYNOPSIS [--insights-config-query-string-length=INSIGHTS_CONFIG_QUERY_STRING_LENGTH] [--[no-]insights-config-record-application-tags] [--[no-]insights-config-record-client-address] + [--[no-]observability-config-enabled] + [--observability-config-max-query-string-length=OBSERVABILITY_CONFIG_MAX_QUERY_STRING_LENGTH] + [--[no-]observability-config-preserve-comments] + [--observability-config-query-plans-per-minute=OBSERVABILITY_CONFIG_QUERY_PLANS_PER_MINUTE] + [--[no-]observability-config-record-application-tags] + [--[no-]observability-config-track-active-queries] + [--observability-config-track-wait-events] [--read-pool-node-count=READ_POOL_NODE_COUNT] [--[no-]require-connectors] [--ssl-mode=SSL_MODE] [--update-mode=UPDATE_MODE] [GCLOUD_WIDE_FLAG ...] @@ -114,6 +121,41 @@ OPTIONAL FLAGS Use --insights-config-record-client-address to enable and --no-insights-config-record-client-address to disable. + --[no-]observability-config-enabled + Enable enhanced query insights feature. Use + --observability-config-enabled to enable and + --no-observability-config-enabled to disable. + + --observability-config-max-query-string-length=OBSERVABILITY_CONFIG_MAX_QUERY_STRING_LENGTH + Query string length in bytes to be stored by the enhanced query + insights feature. Default length is 10k bytes. + + --[no-]observability-config-preserve-comments + Allow preservation of comments in query string recorded by the enhanced + query insights feature. + + Use --observability-config-preserve-comments to enable and + --no-observability-config-preserve-comments to disable. + + --observability-config-query-plans-per-minute=OBSERVABILITY_CONFIG_QUERY_PLANS_PER_MINUTE + Number of query plans to sample every minute. Default value is 200. + Allowed range: 0 to 200. + + --[no-]observability-config-record-application-tags + Allow application tags to be recorded by the enhanced query insights + feature. + + Use --observability-config-record-application-tags to enable and + --no-observability-config-record-application-tags to disable. + + --[no-]observability-config-track-active-queries + Track actively running queries. Use + --observability-config-track-active-queries to enable and + --no-observability-config-track-active-queries to disable. + + --observability-config-track-wait-events + Track wait events during query execution. + --read-pool-node-count=READ_POOL_NODE_COUNT Read capacity, i.e. number of nodes in a read pool instance. diff --git a/gcloud/alpha/batch/help b/gcloud/alpha/batch/help index c6b1f31a5..faa62947f 100644 --- a/gcloud/alpha/batch/help +++ b/gcloud/alpha/batch/help @@ -26,6 +26,9 @@ GROUPS jobs (ALPHA) Manage Batch job resources. + resource-allowances + (ALPHA) Manage Batch resource allowance resources. + tasks (ALPHA) Manage Batch task resources. diff --git a/gcloud/alpha/batch/resource-allowances/create b/gcloud/alpha/batch/resource-allowances/create new file mode 100644 index 000000000..1aef5caa1 --- /dev/null +++ b/gcloud/alpha/batch/resource-allowances/create @@ -0,0 +1,73 @@ +NAME + gcloud alpha batch resource-allowances create - create a Batch resource + allowance + +SYNOPSIS + gcloud alpha batch resource-allowances create + [[RESOURCE_ALLOWANCE] --location=LOCATION] --config=CONFIG + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) This command creates a Batch resource allowance. + +EXAMPLES + The following command submit a resource allowance with config.json sample + config file projects/foo/locations/us-central1/resousrceAllowances/bar: + + $ gcloud alpha batch resource-allowances create \ + projects/foo/locations/us-central1/resousrceAllowances/bar \ + --config config.json + +POSITIONAL ARGUMENTS + ResourceAllowance resource - The Batch resource allowance resource. If + --location not specified,the current batch/location is used. 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 RESOURCE_ALLOWANCE on the command line with a + fully specified name; + ◆ resource allowance ID is optional and will be generated if not + specified with a fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + [RESOURCE_ALLOWANCE] + ID of the resourceAllowance or fully qualified identifier for the + resourceAllowance. + + To set the resource_allowance attribute: + ▸ provide the argument RESOURCE_ALLOWANCE on the command line; + ▸ resource allowance ID is optional and will be generated if not + specified. + + --location=LOCATION + Google Cloud location for the resourceAllowance. + + To set the location attribute: + ▸ provide the argument RESOURCE_ALLOWANCE on the command line with + a fully specified name; + ▸ resource allowance ID is optional and will be generated if not + specified with a fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property batch/location. + +REQUIRED FLAGS + --config=CONFIG + The config file of a resource allowance. + +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/batch/resource-allowances/delete b/gcloud/alpha/batch/resource-allowances/delete new file mode 100644 index 000000000..550d46ffd --- /dev/null +++ b/gcloud/alpha/batch/resource-allowances/delete @@ -0,0 +1,69 @@ +NAME + gcloud alpha batch resource-allowances delete - delete a Batch resource + allowance + +SYNOPSIS + gcloud alpha batch resource-allowances delete + (RESOURCE_ALLOWANCE : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) This command can fail for the following reasons: + ▪ The resource allowance specified does not exist. + ▪ The active account does not have permission to delete the given + resource allowance. + +EXAMPLES + To delete the resource allowance with name + projects/foo/locations/us-central1/resourceAllowances/bar, run: + + $ gcloud alpha batch resource-allowances delete \ + projects/foo/locations/us-central1/resourceAllowances/bar + +POSITIONAL ARGUMENTS + ResourceAllowance resource - The Batch resource allowance resource. If + --location not specified,the current batch/location is used. 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 RESOURCE_ALLOWANCE on the command line with a + fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + RESOURCE_ALLOWANCE + ID of the resourceAllowance or fully qualified identifier for the + resourceAllowance. + + To set the resource_allowance attribute: + ▸ provide the argument RESOURCE_ALLOWANCE on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Google Cloud location for the resourceAllowance. + + To set the location attribute: + ▸ provide the argument RESOURCE_ALLOWANCE on the command line with + a fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property batch/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/batch/resource-allowances/describe b/gcloud/alpha/batch/resource-allowances/describe new file mode 100644 index 000000000..4dc901a1b --- /dev/null +++ b/gcloud/alpha/batch/resource-allowances/describe @@ -0,0 +1,69 @@ +NAME + gcloud alpha batch resource-allowances describe - show details of a + resource allowance + +SYNOPSIS + gcloud alpha batch resource-allowances describe + (RESOURCE_ALLOWANCE : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) This command can fail for the following reasons: + ▪ The resource allowance specified does not exist. + ▪ The active account does not have permission to access the given + resource allowance. + +EXAMPLES + To print details of the resource allowance with name + projects/foo/locations/us-central1/resourceAllowances/bar, run: + + $ gcloud alpha batch resource-allowances describe \ + projects/foo/locations/us-central1/resourceAllowances/bar + +POSITIONAL ARGUMENTS + ResourceAllowance resource - The Batch resource allowance resource. If + --location not specified,the current batch/location is used. 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 RESOURCE_ALLOWANCE on the command line with a + fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + RESOURCE_ALLOWANCE + ID of the resourceAllowance or fully qualified identifier for the + resourceAllowance. + + To set the resource_allowance attribute: + ▸ provide the argument RESOURCE_ALLOWANCE on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Google Cloud location for the resourceAllowance. + + To set the location attribute: + ▸ provide the argument RESOURCE_ALLOWANCE on the command line with + a fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property batch/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/batch/resource-allowances/help b/gcloud/alpha/batch/resource-allowances/help new file mode 100644 index 000000000..89c4714ad --- /dev/null +++ b/gcloud/alpha/batch/resource-allowances/help @@ -0,0 +1,48 @@ +NAME + gcloud alpha batch resource-allowances - manage Batch resource allowance + resources + +SYNOPSIS + gcloud alpha batch resource-allowances COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) The gcloud batch resource allowances command group lets you create, + describe, list and delete Batch resource allowances. + + With Batch, you can utilize the fully managed service to schedule, queue, + and execute batch resource allowances on Google's infrastructure. + + For more information about Batch, see the Batch overview + (https://cloud.google.com/batch) and the Batch documentation + (https://cloud.google.com/batch/docs/). + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (ALPHA) Create a Batch resource allowance. + + delete + (ALPHA) Delete a Batch resource allowance. + + describe + (ALPHA) Show details of a resource allowance. + + list + (ALPHA) List resource allowances for a specified Batch + project/location. + + update + (ALPHA) Update a Batch resource allowance. + +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/batch/resource-allowances/list b/gcloud/alpha/batch/resource-allowances/list new file mode 100644 index 000000000..74e7379c8 --- /dev/null +++ b/gcloud/alpha/batch/resource-allowances/list @@ -0,0 +1,88 @@ +NAME + gcloud alpha batch resource-allowances list - list resource allowances for + a specified Batch project/location + +SYNOPSIS + gcloud alpha batch resource-allowances list [--location=LOCATION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) This command can fail for the following reasons: + ▪ The project/location specified do not exist. + ▪ The active account does not have permission to access the given + project/location. + +EXAMPLES + To print all the resource allowances under all available locations for the + default project, run: + + $ gcloud alpha batch resource-allowances list + + To print all the resource allowances under projects/location + projects/foo/locations/us-central1, run: + + $ gcloud alpha batch resource-allowances list --project=foo \ + --location=us-central1 + +FLAGS + Location resource - The Batch location resource. If you omit this flag, + the defaultlocation is used if you set the batch/location + property.Otherwise, omitting this flag lists jobs across all locations. + This represents a Cloud resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ set the property batch/location with a fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line; + ▸ set the property batch/location. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + +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/batch/resource-allowances/update b/gcloud/alpha/batch/resource-allowances/update new file mode 100644 index 000000000..7d93d04c1 --- /dev/null +++ b/gcloud/alpha/batch/resource-allowances/update @@ -0,0 +1,73 @@ +NAME + gcloud alpha batch resource-allowances update - update a Batch resource + allowance + +SYNOPSIS + gcloud alpha batch resource-allowances update + (RESOURCE_ALLOWANCE : --location=LOCATION) [--usage-limit=USAGE_LIMIT] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) This command updates a Batch resource allowance. + +EXAMPLES + The following command updates a resource allowance limit to 0 + projects/foo/locations/us-central1/resousrceAllowances/bar: + + $ gcloud alpha batch resource-allowances update \ + projects/foo/locations/us-central1/resousrceAllowances/bar \ + --usage-limit 0 + +POSITIONAL ARGUMENTS + ResourceAllowance resource - The Batch resource allowance resource. If + --location not specified,the current batch/location is used. 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 RESOURCE_ALLOWANCE on the command line with a + fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + RESOURCE_ALLOWANCE + ID of the resourceAllowance or fully qualified identifier for the + resourceAllowance. + + To set the resource_allowance attribute: + ▸ provide the argument RESOURCE_ALLOWANCE on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Google Cloud location for the resourceAllowance. + + To set the location attribute: + ▸ provide the argument RESOURCE_ALLOWANCE on the command line with + a fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property batch/location. + +FLAGS + --usage-limit=USAGE_LIMIT + Limit value of a UsageResourceAllowance within its one duration. Limit + cannot be a negative value. Default is 0. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/compute/backend-services/add-backend b/gcloud/alpha/compute/backend-services/add-backend index ab4514b8d..d0d6132ea 100644 --- a/gcloud/alpha/compute/backend-services/add-backend +++ b/gcloud/alpha/compute/backend-services/add-backend @@ -234,17 +234,18 @@ OPTIONAL FLAGS (https://cloud.google.com/load-balancing/docs/backend-service#balancing-mode-combos). --preference=PREFERENCE - Defines whether a backend should be fully utilized before sending - traffic to backends with default preference. This parameter cannot be - used with regional managed instance groups and when the endpoint type - of an attached network endpoint group is INTERNET_IP_PORT, - INTERNET_FQDN_PORT, or SERVERLESS. PREFERENCE must be one of: + This parameter specifies whether a backend should be fully utilized + before sending traffic to backends with the default preference. This + parameter cannot be used with regional managed instance groups and when + the endpoint type of an attached network endpoint group is + INTERNET_IP_PORT, INTERNET_FQDN_PORT, or SERVERLESS. PREFERENCE must be + one of: DEFAULT This is the default setting. If the designated preferred backends don't have enough capacity, backends in the default category are used. Traffic is distributed between default backends based on the - load balancing algorithm you use. + load balancing algorithm used. PREFERRED Backends with this preference setting are used up to their capacity diff --git a/gcloud/alpha/compute/backend-services/update-backend b/gcloud/alpha/compute/backend-services/update-backend index c94a379f3..a8f9b2c5d 100644 --- a/gcloud/alpha/compute/backend-services/update-backend +++ b/gcloud/alpha/compute/backend-services/update-backend @@ -203,17 +203,18 @@ OPTIONAL FLAGS (https://cloud.google.com/load-balancing/docs/backend-service#balancing-mode-combos). --preference=PREFERENCE - Defines whether a backend should be fully utilized before sending - traffic to backends with default preference. This parameter cannot be - used with regional managed instance groups and when the endpoint type - of an attached network endpoint group is INTERNET_IP_PORT, - INTERNET_FQDN_PORT, or SERVERLESS. PREFERENCE must be one of: + This parameter specifies whether a backend should be fully utilized + before sending traffic to backends with the default preference. This + parameter cannot be used with regional managed instance groups and when + the endpoint type of an attached network endpoint group is + INTERNET_IP_PORT, INTERNET_FQDN_PORT, or SERVERLESS. PREFERENCE must be + one of: DEFAULT This is the default setting. If the designated preferred backends don't have enough capacity, backends in the default category are used. Traffic is distributed between default backends based on the - load balancing algorithm you use. + load balancing algorithm used. PREFERRED Backends with this preference setting are used up to their capacity diff --git a/gcloud/alpha/compute/instances/create-with-container b/gcloud/alpha/compute/instances/create-with-container index 9714882dd..b548844cc 100644 --- a/gcloud/alpha/compute/instances/create-with-container +++ b/gcloud/alpha/compute/instances/create-with-container @@ -24,6 +24,7 @@ SYNOPSIS [--container-restart-policy=POLICY; default="always"] [--container-stdin] [--container-tty] [--create-disk=[PROPERTY=VALUE,...]] [--description=DESCRIPTION] + [--discard-local-ssds-at-termination-timestamp=DISCARD_LOCAL_SSDS_AT_TERMINATION_TIMESTAMP] [--disk=[auto-delete=AUTO-DELETE],[boot=BOOT],[device-name=DEVICE-NAME], [force-attach=FORCE-ATTACH],[mode=MODE],[name=NAME],[scope=SCOPE]] [--[no-]enable-nested-virtualization] @@ -39,7 +40,8 @@ SYNOPSIS [--local-ssd=[device-name=DEVICE-NAME], [interface=INTERFACE],[size=SIZE]] [--local-ssd-recovery-timeout=LOCAL_SSD_RECOVERY_TIMEOUT] - [--machine-type=MACHINE_TYPE] [--metadata=KEY=VALUE,[KEY=VALUE,...]] + [--machine-type=MACHINE_TYPE] [--max-run-duration=MAX_RUN_DURATION] + [--metadata=KEY=VALUE,[KEY=VALUE,...]] [--metadata-from-file=KEY=LOCAL_FILE_PATH,[...]] [--min-cpu-platform=PLATFORM] [--network=NETWORK] [--network-interface=[PROPERTY=VALUE,...]] @@ -53,6 +55,7 @@ SYNOPSIS [--shielded-integrity-monitoring] [--shielded-secure-boot] [--shielded-vtpm] [--source-instance-template=SOURCE_INSTANCE_TEMPLATE] [--stack-type=STACK_TYPE] [--subnet=SUBNET] [--tags=TAG,[TAG,...]] + [--termination-time=TERMINATION_TIME] [--threads-per-core=THREADS_PER_CORE] [--visible-core-count=VISIBLE_CORE_COUNT] [--zone=ZONE] [--address=ADDRESS | --no-address] @@ -398,6 +401,20 @@ FLAGS --description=DESCRIPTION Specifies a textual description of the instances. + --discard-local-ssds-at-termination-timestamp=DISCARD_LOCAL_SSDS_AT_TERMINATION_TIMESTAMP + Required to be set to true and only allowed for VMs that have one or + more local SSDs, use --instance-termination-action=STOP, and use either + --max-run-duration or --termination-time. + + This flag indicates the value that you want Compute Engine to use for + the --discard-local-ssd flag in the automatic gcloud compute instances + stop command. This flag only supports the true value, which discards + local SSD data when automatically stopping this VM during its + terminationTimestamp. + + For more information about the --discard-local-ssd flag, see + https://cloud.google.com/compute/docs/disks/local-ssd#stop_instance. + --disk=[auto-delete=AUTO-DELETE],[boot=BOOT],[device-name=DEVICE-NAME],[force-attach=FORCE-ATTACH],[mode=MODE],[name=NAME],[scope=SCOPE] Attaches an existing persistent disk to the instances. @@ -558,6 +575,28 @@ FLAGS available machine types, run 'gcloud compute machine-types list'. If unspecified, the default type is n1-standard-1. + --max-run-duration=MAX_RUN_DURATION + Limits how long this VM instance can run, specified as a duration + relative to the last time when the VM began running. Format the + duration, MAX_RUN_DURATION, as the number of days, hours, minutes, and + seconds followed by d, h, m, and s respectively. For example, specify + 30m for a duration of 30 minutes or specify 1d2h3m4s for a duration of + 1 day, 2 hours, 3 minutes, and 4 seconds. Alternatively, to specify a + timestamp, use --termination-time instead. + + If neither --max-run-duration nor --termination-time is specified + (default), the VM instance runs until prompted by a user action or + system event. If either is specified, the VM instance is scheduled to + be automatically terminated at the VM's termination timestamp + (terminationTimestamp) using the action specified by + --instance-termination-action. + + Note: The terminationTimestamp is removed whenever the VM is stopped or + suspended and redefined whenever the VM is rerun. For + --max-run-duration specifically, the terminationTimestamp is the sum of + MAX_RUN_DURATION and the time when the VM last entered the RUNNING + state, which changes whenever the VM is rerun. + --metadata=KEY=VALUE,[KEY=VALUE,...] Metadata to be made available to the guest operating system running on the instances. Each metadata entry is a key/value pair separated by an @@ -838,6 +877,25 @@ FLAGS $ gcloud compute instances list --filter='tags:tag1' + --termination-time=TERMINATION_TIME + Limits how long this VM instance can run, specified as a time. Format + the time, TERMINATION_TIME, as a RFC 3339 timestamp. For more + information, see https://tools.ietf.org/html/rfc3339. Alternatively, to + specify a duration, use --max-run-duration instead. + + If neither --termination-time nor --max-run-duration is specified + (default), the VM instance runs until prompted by a user action or + system event. If either is specified, the VM instance is scheduled to + be automatically terminated at the VM's termination timestamp + (terminationTimestamp) using the action specified by + --instance-termination-action. + + Note: The terminationTimestamp is removed whenever the VM is stopped or + suspended and redefined whenever the VM is rerun. For + --termination-time specifically, the terminationTimestamp remains the + same whenever the VM is rerun, but any requests to rerun the VM fail if + the specified timestamp is in the past. + --threads-per-core=THREADS_PER_CORE The number of visible threads per physical core. To disable simultaneous multithreading (SMT) set this to 1. Valid values are: 1 or diff --git a/gcloud/alpha/compute/instances/help b/gcloud/alpha/compute/instances/help index c67c70b1f..e54817e49 100644 --- a/gcloud/alpha/compute/instances/help +++ b/gcloud/alpha/compute/instances/help @@ -35,7 +35,7 @@ GROUPS interfaces. ops-agents - (ALPHA) Manage Operation Suite (Ops) agents for Compute Engine VM + (ALPHA) Manage Google Cloud Observability agents for Compute Engine VM instances. os-inventory diff --git a/gcloud/alpha/compute/instances/ops-agents/help b/gcloud/alpha/compute/instances/ops-agents/help index 40a3873c6..10e6d1fec 100644 --- a/gcloud/alpha/compute/instances/ops-agents/help +++ b/gcloud/alpha/compute/instances/ops-agents/help @@ -1,12 +1,12 @@ NAME - gcloud alpha compute instances ops-agents - manage Operation Suite (Ops) - agents for Compute Engine VM instances + gcloud alpha compute instances ops-agents - manage Google Cloud + Observability agents for Compute Engine VM instances SYNOPSIS gcloud alpha compute instances ops-agents GROUP [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Manage Operation Suite (Ops) agents for Compute Engine VM + (ALPHA) Manage Google Cloud Observability agents for Compute Engine VM instances. GCLOUD WIDE FLAGS @@ -18,7 +18,7 @@ GROUPS GROUP is one of the following: policies - (ALPHA) Manage Operation Suite (Ops) agents policies that install, + (ALPHA) Manage Google Cloud Observability agents policies that install, update, and uninstall agents for Compute Engine VM instances. NOTES diff --git a/gcloud/alpha/compute/instances/ops-agents/policies/create b/gcloud/alpha/compute/instances/ops-agents/policies/create index 353467e00..3aae555bc 100644 --- a/gcloud/alpha/compute/instances/ops-agents/policies/create +++ b/gcloud/alpha/compute/instances/ops-agents/policies/create @@ -346,7 +346,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud compute instances ops-agents policies create $ gcloud beta compute instances ops-agents policies create diff --git a/gcloud/alpha/compute/instances/ops-agents/policies/delete b/gcloud/alpha/compute/instances/ops-agents/policies/delete index 85f2691e7..e92542bf3 100644 --- a/gcloud/alpha/compute/instances/ops-agents/policies/delete +++ b/gcloud/alpha/compute/instances/ops-agents/policies/delete @@ -49,7 +49,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud compute instances ops-agents policies delete $ gcloud beta compute instances ops-agents policies delete diff --git a/gcloud/alpha/compute/instances/ops-agents/policies/describe b/gcloud/alpha/compute/instances/ops-agents/policies/describe index b5d93b089..1427469e5 100644 --- a/gcloud/alpha/compute/instances/ops-agents/policies/describe +++ b/gcloud/alpha/compute/instances/ops-agents/policies/describe @@ -65,7 +65,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud compute instances ops-agents policies describe $ gcloud beta compute instances ops-agents policies describe diff --git a/gcloud/alpha/compute/instances/ops-agents/policies/help b/gcloud/alpha/compute/instances/ops-agents/policies/help index aadb88102..9aedeee11 100644 --- a/gcloud/alpha/compute/instances/ops-agents/policies/help +++ b/gcloud/alpha/compute/instances/ops-agents/policies/help @@ -1,15 +1,15 @@ NAME - gcloud alpha compute instances ops-agents policies - manage Operation Suite - (Ops) agents policies that install, update, and uninstall agents for - Compute Engine VM instances + gcloud alpha compute instances ops-agents policies - manage Google Cloud + Observability agents policies that install, update, and uninstall + agents for Compute Engine VM instances SYNOPSIS gcloud alpha compute instances ops-agents policies COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Manage Operation Suite (Ops) agents policies that install, update, - and uninstall agents for Compute Engine VM instances. + (ALPHA) Manage Google Cloud Observability agents policies that install, + update, and uninstall agents for Compute Engine VM instances. GCLOUD WIDE FLAGS These flags are available to all commands: --help. diff --git a/gcloud/alpha/compute/instances/ops-agents/policies/list b/gcloud/alpha/compute/instances/ops-agents/policies/list index cb6208494..849d328f5 100644 --- a/gcloud/alpha/compute/instances/ops-agents/policies/list +++ b/gcloud/alpha/compute/instances/ops-agents/policies/list @@ -68,7 +68,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud compute instances ops-agents policies list $ gcloud beta compute instances ops-agents policies list diff --git a/gcloud/alpha/compute/instances/ops-agents/policies/update b/gcloud/alpha/compute/instances/ops-agents/policies/update index db64b95f3..f01ad4834 100644 --- a/gcloud/alpha/compute/instances/ops-agents/policies/update +++ b/gcloud/alpha/compute/instances/ops-agents/policies/update @@ -397,7 +397,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud compute instances ops-agents policies update $ gcloud beta compute instances ops-agents policies update diff --git a/gcloud/alpha/container/backup-restore/backup-plans/create b/gcloud/alpha/container/backup-restore/backup-plans/create index 436fe131b..53780aecf 100644 --- a/gcloud/alpha/container/backup-restore/backup-plans/create +++ b/gcloud/alpha/container/backup-restore/backup-plans/create @@ -26,7 +26,7 @@ EXAMPLES $ gcloud alpha container backup-restore backup-plans create \ my-backup-plan --project=my-project --location=us-central1 \ - --cluster=project/my-project/location/us-central1/clusters/\ + --cluster=projects/my-project/locations/us-central1/clusters/\ my-cluster --all-namespaces POSITIONAL ARGUMENTS diff --git a/gcloud/alpha/edge-cloud/networking/subnets/create b/gcloud/alpha/edge-cloud/networking/subnets/create index 3ab910af4..330a085e9 100644 --- a/gcloud/alpha/edge-cloud/networking/subnets/create +++ b/gcloud/alpha/edge-cloud/networking/subnets/create @@ -5,23 +5,24 @@ NAME SYNOPSIS gcloud alpha edge-cloud networking subnets create (SUBNET : --location=LOCATION --zone=ZONE) --network=NETWORK [--async] - [--description=DESCRIPTION] [--ipv4-range=[IPV4_RANGE,...]] - [--ipv6-range=[IPV6_RANGE,...]] [--labels=[KEY=VALUE,...]] - [--vlan-id=VLAN_ID] [GCLOUD_WIDE_FLAG ...] + [--bonding-type=BONDING_TYPE] [--description=DESCRIPTION] + [--ipv4-range=[IPV4_RANGE,...]] [--ipv6-range=[IPV6_RANGE,...]] + [--labels=[KEY=VALUE,...]] [--vlan-id=VLAN_ID] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Create a new Distributed Cloud Edge Network subnet. EXAMPLES - To create a Distributed Cloud Edge Network subnet called 'my-subnet' with - vlan id and owned ip ranges specified in the edge zone + To create a Distributed Cloud Edge Network subnet called my-subnet with + VLAN ID and owned ip ranges specified in the edge zone 'us-central1-edge-den1', run: $ gcloud alpha edge-cloud networking subnets create my-subnet \ --network=my-network --location=us-central1 \ --zone=us-central1-edge-den1 \ --ipv4-range=192.168.1.1/24,172.10.10.1/24 \ - --ipv6-range=2001:db8::1/64,4001:230::1/64 --vlan-id=100 + --ipv6-range=2001:db8::1/64,4001:230::1/64 --vlan-id=100 \ + --bonding-type=bonded POSITIONAL ARGUMENTS Subnet resource - Distributed Cloud Edge Network subnet to create. The @@ -71,6 +72,12 @@ OPTIONAL FLAGS Return immediately, without waiting for the operation in progress to complete. + --bonding-type=BONDING_TYPE + Whether or not the VLAN being created will be present on bonded or + non-bonded port types. If not specified, the VLAN will be created on + both port types by default. BONDING_TYPE must be one of: bonded, + bonding-type-unspecified, non-bonded. + --description=DESCRIPTION An optional, textual description for the subnet. @@ -91,7 +98,7 @@ OPTIONAL FLAGS numbers. --vlan-id=VLAN_ID - The ID of the vlan to tag the subnetwork. If not specified we assign + The ID of the VLAN to tag the subnetwork. If not specified we assign one automatically. GCLOUD WIDE FLAGS diff --git a/gcloud/alpha/firestore/databases/restore b/gcloud/alpha/firestore/databases/restore index c331c645c..b0595276f 100644 --- a/gcloud/alpha/firestore/databases/restore +++ b/gcloud/alpha/firestore/databases/restore @@ -14,13 +14,6 @@ EXAMPLES --source-backup=projects/PROJECT_ID/locations/LOCATION_ID/\ backups/BACKUP_ID --destination-database=DATABASE_ID - To restore a database from a database snapshot. - - $ gcloud alpha firestore databases restore \ - --source-database=SOURCE_DB \ - --snapshot-time=2023-05-26T10:20:00.00Z \ - --destination-database=DATABASE_ID - REQUIRED FLAGS --destination-database=DESTINATION_DATABASE Destination database to restore to. Destination database will be diff --git a/gcloud/alpha/functions/deploy b/gcloud/alpha/functions/deploy index 76db7e3da..7aa9dd8dd 100644 --- a/gcloud/alpha/functions/deploy +++ b/gcloud/alpha/functions/deploy @@ -17,6 +17,8 @@ SYNOPSIS [--trigger-location=TRIGGER_LOCATION] [--trigger-service-account=TRIGGER_SERVICE_ACCOUNT] [--update-labels=[KEY=VALUE,...]] + [--binary-authorization=BINARY_AUTHORIZATION + | --clear-binary-authorization] [--build-env-vars-file=FILE_PATH | --clear-build-env-vars | --set-build-env-vars=[KEY=VALUE,...] | --remove-build-env-vars=[KEY,...] @@ -311,6 +313,19 @@ FLAGS Label keys starting with deployment are reserved for use by deployment tools and cannot be specified manually. + At most one of these can be specified: + + --binary-authorization=BINARY_AUTHORIZATION + Name of the Binary Authorization policy that the function image + should be checked against when deploying to Cloud Run. + + Example: default + + The flag is only applicable to 2nd gen functions. + + --clear-binary-authorization + Clears the Binary Authorization policy field. + At most one of these can be specified: --build-env-vars-file=FILE_PATH diff --git a/gcloud/alpha/managed-kafka/topics/update b/gcloud/alpha/managed-kafka/topics/update index 284fe4d11..8cde320fd 100644 --- a/gcloud/alpha/managed-kafka/topics/update +++ b/gcloud/alpha/managed-kafka/topics/update @@ -5,7 +5,7 @@ NAME SYNOPSIS gcloud alpha managed-kafka topics update (TOPIC : --cluster=CLUSTER --location=LOCATION) - (--configs=[KEY=VALUE,...] --partitions=PARTITIONS) + (--partitions=PARTITIONS --clear-configs | --configs=[KEY=VALUE,...]) [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -62,20 +62,25 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS At least one of these must be specified: - --configs=[KEY=VALUE,...] - Configuration for the topic that are overridden from the cluster - defaults. The key of the map is a Kafka topic property name, for - example: cleanup.policy=compact,compression.type=producer. If you - provide a map with a key that already exists, only that configuration - is updated. If the map contains a key that does not exist, the entry - is appended to the topic configuration. - --partitions=PARTITIONS The number of partitions in a topic. You can increase the partition count for a topic, but you cannot decrease it. Increasing partitions for a topic that uses a key might change how messages are distributed. + At most one of these can be specified: + + --clear-configs + Remove all the configurations for the topic. + + --configs=[KEY=VALUE,...] + Configuration for the topic that are overridden from the cluster + defaults. The key of the map is a Kafka topic property name, for + example: cleanup.policy=compact,compression.type=producer. If you + provide a map with a key that already exists, only that + configuration is updated. If the map contains a key that does not + exist, the entry is appended to the topic configuration. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/metastore/services/create b/gcloud/alpha/metastore/services/create index 033fa0fd3..64e545fd0 100644 --- a/gcloud/alpha/metastore/services/create +++ b/gcloud/alpha/metastore/services/create @@ -24,6 +24,8 @@ SYNOPSIS --keytab=KEYTAB --krb5-config=KRB5_CONFIG] [--maintenance-window-day=MAINTENANCE_WINDOW_DAY --maintenance-window-hour=MAINTENANCE_WINDOW_HOUR] + [--read-only-regions=[READ_ONLY_REGIONS,...] + --read-write-regions=[READ_WRITE_REGIONS,...]] [--scheduled-backup-configs-from-file=SCHEDULED_BACKUP_CONFIGS_FROM_FILE | --enable-scheduled-backup --scheduled-backup-cron=SCHEDULED_BACKUP_CRON --scheduled-backup-location=SCHEDULED_BACKUP_LOCATION] [GCLOUD_WIDE_FLAG ...] @@ -358,6 +360,16 @@ FLAGS This flag argument must be specified if any of the other arguments in this group are specified. + Custom region configuration for the metastore service. + + --read-only-regions=[READ_ONLY_REGIONS,...] + The list of read-only regions where the metastore service runs in. + These regions should be part (or subset) of the multi-region. + + --read-write-regions=[READ_WRITE_REGIONS,...] + The list of read-write regions where the metastore service runs in. + These regions should be part (or subset) of the multi-region. + Scheduled backup configurations to enable a scheduled backup of the metastore service. diff --git a/gcloud/alpha/ml/speech/recognizers/create b/gcloud/alpha/ml/speech/recognizers/create index c799646d7..57106936f 100644 --- a/gcloud/alpha/ml/speech/recognizers/create +++ b/gcloud/alpha/ml/speech/recognizers/create @@ -12,10 +12,11 @@ SYNOPSIS [--enable-spoken-punctuation=ENABLE_SPOKEN_PUNCTUATION] [--enable-word-confidence=ENABLE_WORD_CONFIDENCE] [--enable-word-time-offsets=ENABLE_WORD_TIME_OFFSETS] - [--encoding=ENCODING] [--max-speaker-count=MAX_SPEAKER_COUNT] + [--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] - [GCLOUD_WIDE_FLAG ...] + [--separate-channel-recognition] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Create a speech-to-text recognizer. @@ -93,6 +94,10 @@ OPTIONAL FLAGS Encoding format of the provided audio. For headerless formats, must be set to LINEAR16, MULAW, or ALAW. For other formats, set to AUTO. + --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. @@ -106,6 +111,11 @@ OPTIONAL FLAGS Sample rate in Hertz of the audio data sent for recognition. Required if using explicit decoding. + --separate-channel-recognition + Mode for recognizing multi-channel audio using Separate Channel + Recognition. When set to true, the service will recognize each channel + independently. + 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/ml/speech/recognizers/update b/gcloud/alpha/ml/speech/recognizers/update index 5a48d8a04..b26844a6b 100644 --- a/gcloud/alpha/ml/speech/recognizers/update +++ b/gcloud/alpha/ml/speech/recognizers/update @@ -13,10 +13,11 @@ SYNOPSIS [--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] - [GCLOUD_WIDE_FLAG ...] + [--[no-]separate-channel-recognition] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Update a Speech-to-text recognizer. @@ -90,6 +91,10 @@ FLAGS (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. @@ -106,6 +111,12 @@ FLAGS Sample rate in Hertz of the audio data sent for recognition. Required if using explicit decoding. + --[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. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/netapp/storage-pools/create b/gcloud/alpha/netapp/storage-pools/create index 1e6944d56..27f7cdf1c 100644 --- a/gcloud/alpha/netapp/storage-pools/create +++ b/gcloud/alpha/netapp/storage-pools/create @@ -86,10 +86,8 @@ REQUIRED FLAGS accepted, but please use the long-form when attempting to create a Storage Pool using a shared VPC. psa-range - The psa-range is the name of the allocated range of the Private - Service Access connection. The range you specify can't overlap with - either existing subnets or assigned IP address ranges for other - Cloud NetApp Files Storage Pools in the selected VPC network. + This field is not implemented. The values provided in this field + are ignored. --service-level=SERVICE_LEVEL The service level for the Cloud NetApp Storage Pool. For more details, diff --git a/gcloud/alpha/network-connectivity/hubs/create b/gcloud/alpha/network-connectivity/hubs/create index ea168f929..66a36c77a 100644 --- a/gcloud/alpha/network-connectivity/hubs/create +++ b/gcloud/alpha/network-connectivity/hubs/create @@ -68,7 +68,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: $ gcloud network-connectivity hubs create + $ gcloud beta network-connectivity hubs create + diff --git a/gcloud/alpha/network-connectivity/hubs/delete b/gcloud/alpha/network-connectivity/hubs/delete index 44c650905..2f82fdf4b 100644 --- a/gcloud/alpha/network-connectivity/hubs/delete +++ b/gcloud/alpha/network-connectivity/hubs/delete @@ -54,7 +54,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: $ gcloud network-connectivity hubs delete + $ gcloud beta network-connectivity hubs delete + diff --git a/gcloud/alpha/network-connectivity/hubs/describe b/gcloud/alpha/network-connectivity/hubs/describe index 1311f16df..8c26ccb11 100644 --- a/gcloud/alpha/network-connectivity/hubs/describe +++ b/gcloud/alpha/network-connectivity/hubs/describe @@ -48,7 +48,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: $ gcloud network-connectivity hubs describe + $ gcloud beta network-connectivity hubs describe + diff --git a/gcloud/alpha/network-connectivity/hubs/help b/gcloud/alpha/network-connectivity/hubs/help index 97f1f2612..a59362840 100644 --- a/gcloud/alpha/network-connectivity/hubs/help +++ b/gcloud/alpha/network-connectivity/hubs/help @@ -35,7 +35,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: $ gcloud network-connectivity hubs + $ gcloud beta network-connectivity hubs + diff --git a/gcloud/alpha/network-connectivity/hubs/list b/gcloud/alpha/network-connectivity/hubs/list index d2755f199..a4c3af83e 100644 --- a/gcloud/alpha/network-connectivity/hubs/list +++ b/gcloud/alpha/network-connectivity/hubs/list @@ -57,7 +57,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: $ gcloud network-connectivity hubs list + $ gcloud beta network-connectivity hubs list + diff --git a/gcloud/alpha/network-connectivity/hubs/update b/gcloud/alpha/network-connectivity/hubs/update index 24069483f..a036b0ea1 100644 --- a/gcloud/alpha/network-connectivity/hubs/update +++ b/gcloud/alpha/network-connectivity/hubs/update @@ -62,7 +62,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: $ gcloud network-connectivity hubs update + $ gcloud beta network-connectivity hubs update + diff --git a/gcloud/alpha/network-security/address-groups/create b/gcloud/alpha/network-security/address-groups/create index ff005440f..57b85a86a 100644 --- a/gcloud/alpha/network-security/address-groups/create +++ b/gcloud/alpha/network-security/address-groups/create @@ -6,7 +6,8 @@ SYNOPSIS gcloud alpha network-security address-groups create (ADDRESS_GROUP : --location=LOCATION) --capacity=CAPACITY --type=TYPE [--async] [--description=DESCRIPTION] [--items=[ITEMS,...]] - [--labels=[KEY=VALUE,...]] [GCLOUD_WIDE_FLAG ...] + [--labels=[KEY=VALUE,...]] [--purpose=[PURPOSE,...]] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Create a new address group with the given name. @@ -72,6 +73,10 @@ OPTIONAL FLAGS --labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to add. + --purpose=[PURPOSE,...] + List of Address Group purposes. PURPOSE must be one of: cloud-armor, + default. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/network-security/address-groups/update b/gcloud/alpha/network-security/address-groups/update index 4230456df..74109f0b1 100644 --- a/gcloud/alpha/network-security/address-groups/update +++ b/gcloud/alpha/network-security/address-groups/update @@ -6,7 +6,7 @@ SYNOPSIS gcloud alpha network-security address-groups update (ADDRESS_GROUP : --location=LOCATION) [--async] [--description=DESCRIPTION] [--items=[ITEMS,...]] - [--update-labels=[KEY=VALUE,...]] + [--purpose=[PURPOSE,...]] [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -61,6 +61,10 @@ FLAGS --items=[ITEMS,...] Items of the address group. + --purpose=[PURPOSE,...] + List of Address Group purposes. PURPOSE must be one of: cloud-armor, + default. + --update-labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to update. If a label exists, its value is modified. Otherwise, a new label is created. diff --git a/gcloud/alpha/run/deploy b/gcloud/alpha/run/deploy index ea80aaf07..ef4d97f3c 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 + --service-max-instances=SERVICE_MAX_INSTANCES --service-min-instances=SERVICE_MIN_INSTANCES --[no-]session-affinity --vpc-connector=VPC_CONNECTOR --vpc-egress=VPC_EGRESS --add-cloudsql-instances=[CLOUDSQL-INSTANCES,...] @@ -481,6 +482,12 @@ FLAGS [--revision-suffix=v1] for a service named 'helloworld', would lead to a revision named 'helloworld-v1'. + --service-max-instances=SERVICE_MAX_INSTANCES + The maximum number of container instances for this Service to run. + This instance limit will be divided among all Revisions receiving a + percentage of traffic. Once service-max-instances is enabled for a + service, it cannot be disabled. + --service-min-instances=SERVICE_MIN_INSTANCES The minimum number of container instances for this Service to run or 'default' to remove any minimum. These instances will be divided diff --git a/gcloud/alpha/run/services/update b/gcloud/alpha/run/services/update index 528157828..4a92b0852 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 + --service-max-instances=SERVICE_MAX_INSTANCES --service-min-instances=SERVICE_MIN_INSTANCES --[no-]session-affinity --vpc-connector=VPC_CONNECTOR --vpc-egress=VPC_EGRESS --add-cloudsql-instances=[CLOUDSQL-INSTANCES,...] @@ -367,6 +368,12 @@ FLAGS [--revision-suffix=v1] for a service named 'helloworld', would lead to a revision named 'helloworld-v1'. + --service-max-instances=SERVICE_MAX_INSTANCES + The maximum number of container instances for this Service to run. + This instance limit will be divided among all Revisions receiving a + percentage of traffic. Once service-max-instances is enabled for a + service, it cannot be disabled. + --service-min-instances=SERVICE_MIN_INSTANCES The minimum number of container instances for this Service to run or 'default' to remove any minimum. These instances will be divided diff --git a/gcloud/alpha/sql/export/sql b/gcloud/alpha/sql/export/sql index 39b691977..becaf797e 100644 --- a/gcloud/alpha/sql/export/sql +++ b/gcloud/alpha/sql/export/sql @@ -3,9 +3,9 @@ NAME SQL file SYNOPSIS - gcloud alpha sql export sql INSTANCE URI [--async] + gcloud alpha sql export sql INSTANCE URI [--async] [--clean] [--database=DATABASE,[DATABASE,...], -d DATABASE,[DATABASE,...]] - [--offload] [--parallel] + [--if-exists] [--offload] [--parallel] [--table=TABLE,[TABLE,...], -t TABLE,[TABLE,...]] [--threads=THREADS] [GCLOUD_WIDE_FLAG ...] @@ -33,11 +33,21 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + --clean + Include SQL statements (DROP ) required to drop database + objects prior to import; corresponds to the clean flag for pg_dump. + Only applies to PostgreSQL non-parallel exports. + --database=DATABASE,[DATABASE,...], -d DATABASE,[DATABASE,...] Database(s) from which the export is made. Information on requirements can be found here: https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances/export#exportContext.databases + --if-exists + Include an SQL statement (IF EXISTS) with each drop statement produced + by the clean flag; corresponds to the if-exists flag for pg_dump. Only + applies to PostgreSQL non-parallel exports. + --offload Offload an export to a temporary instance. Doing so reduces strain on source instances and allows other operations to be performed while the diff --git a/gcloud/alpha/sql/import/sql b/gcloud/alpha/sql/import/sql index 057b4f715..e505126be 100644 --- a/gcloud/alpha/sql/import/sql +++ b/gcloud/alpha/sql/import/sql @@ -3,9 +3,9 @@ NAME SQL dump file SYNOPSIS - gcloud alpha sql import sql INSTANCE URI [--async] - [--database=DATABASE, -d DATABASE] [--parallel] [--threads=THREADS] - [--user=USER] [GCLOUD_WIDE_FLAG ...] + gcloud alpha sql import sql INSTANCE URI [--async] [--clean] + [--database=DATABASE, -d DATABASE] [--if-exists] [--parallel] + [--threads=THREADS] [--user=USER] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) gcloud alpha sql import sql imports data into a Cloud SQL instance @@ -40,12 +40,22 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + --clean + Option to clean (DROP) database objects before recreating them. + corresponds to the clean flag for pg_restore. Only applies if + --parallel is set. PostgreSQL only. + --database=DATABASE, -d DATABASE Database to which the import is made. The database needs to be created before importing. If not set, it is assumed that the database is specified in the file to be imported. If your SQL dump file includes a database statement, it will override the database set in this flag. + --if-exists + Include an SQL statement (IF EXISTS) with each DROP statement produced + by --clean; corresponds to the if-exists flag for pg_restore. Only + applies if --parallel is set. PostgreSQL only. + --parallel Perform a parallel import. This flag is only applicable to MySQL and Postgres. diff --git a/gcloud/alpha/storage/cp b/gcloud/alpha/storage/cp index e69803c45..72c37145a 100644 --- a/gcloud/alpha/storage/cp +++ b/gcloud/alpha/storage/cp @@ -125,7 +125,10 @@ FLAGS Includes managed folders in command operations. For transfers, gcloud storage will set up managed folders in the destination with the same IAM policy bindings as the source. Managed folders are only included - with recursive cloud-to-cloud transfers. + with recursive cloud-to-cloud transfers. Please note that for + hierarchical namespace buckets, managed folders are always included. + Hence this flag would not be applicable to hierarchical namespace + buckets. --manifest-path=MANIFEST_PATH, -L MANIFEST_PATH Outputs a manifest log file with detailed information about each item diff --git a/gcloud/alpha/storage/mv b/gcloud/alpha/storage/mv index ea04a0bbe..726985d61 100644 --- a/gcloud/alpha/storage/mv +++ b/gcloud/alpha/storage/mv @@ -136,7 +136,10 @@ FLAGS Includes managed folders in command operations. For transfers, gcloud storage will set up managed folders in the destination with the same IAM policy bindings as the source. Managed folders are only included - with recursive cloud-to-cloud transfers. + with recursive cloud-to-cloud transfers. Please note that for + hierarchical namespace buckets, managed folders are always included. + Hence this flag would not be applicable to hierarchical namespace + buckets. --manifest-path=MANIFEST_PATH, -L MANIFEST_PATH Outputs a manifest log file with detailed information about each item diff --git a/gcloud/alpha/storage/rm b/gcloud/alpha/storage/rm index 1a27f9d7a..42bbfc1da 100644 --- a/gcloud/alpha/storage/rm +++ b/gcloud/alpha/storage/rm @@ -71,7 +71,9 @@ FLAGS --exclude-managed-folders Excludes managed folders from command operations. By default gcloud - storage includes managed folders in recursive removals. + storage includes managed folders in recursive removals. Please note + that this flag would not be applicable for hierarchical namespace + buckets as we always list managed folders for these buckets. --read-paths-from-stdin, -I Read the list of URLs from stdin. diff --git a/gcloud/alpha/workstations/configs/create b/gcloud/alpha/workstations/configs/create index ff593289e..68842548d 100644 --- a/gcloud/alpha/workstations/configs/create +++ b/gcloud/alpha/workstations/configs/create @@ -28,7 +28,7 @@ SYNOPSIS [--service-account=SERVICE_ACCOUNT] [--service-account-scopes=[SERVICE_ACCOUNT_SCOPES,...]] [--shielded-integrity-monitoring] [--shielded-secure-boot] - [--shielded-vtpm] + [--shielded-vtpm] [--vm-tags=[VM_TAGS,...]] [--accelerator-count=ACCELERATOR_COUNT : --accelerator-type=ACCELERATOR_TYPE] [--container-custom-image=CONTAINER_CUSTOM_IMAGE @@ -333,6 +333,17 @@ FLAGS --shielded-vtpm Default value is false. If set, instances will have vTPM enabled. + --vm-tags=[VM_TAGS,...] + Resource manager tags to be bound to the instance. Tag keys and values + have the same definition as + https://cloud.google.com/resource-manager/docs/tags/tags-overview + + Example: + + $ gcloud alpha workstations configs create \ + --vm-tags=tagKeys/key1=tagValues/value1,tagKeys/key2=tagValues/\ + value2 + Accelerator settings --accelerator-count=ACCELERATOR_COUNT diff --git a/gcloud/alpha/workstations/configs/update b/gcloud/alpha/workstations/configs/update index a3e9a0cb5..d2ee06f3c 100644 --- a/gcloud/alpha/workstations/configs/update +++ b/gcloud/alpha/workstations/configs/update @@ -20,7 +20,7 @@ SYNOPSIS [--service-account=SERVICE_ACCOUNT] [--service-account-scopes=[SERVICE_ACCOUNT_SCOPES,...]] [--shielded-integrity-monitoring] [--shielded-secure-boot] - [--shielded-vtpm] + [--shielded-vtpm] [--vm-tags=[VM_TAGS,...]] [--accelerator-count=ACCELERATOR_COUNT : --accelerator-type=ACCELERATOR_TYPE] [--container-custom-image=CONTAINER_CUSTOM_IMAGE @@ -281,6 +281,17 @@ FLAGS --shielded-vtpm Default value is false. If set, instances will have vTPM enabled. + --vm-tags=[VM_TAGS,...] + Resource manager tags to be bound to the instance. Tag keys and values + have the same definition as + https://cloud.google.com/resource-manager/docs/tags/tags-overview + + Example: + + $ gcloud alpha workstations configs update \ + --vm-tags=tagKeys/key1=tagValues/value1,tagKeys/key2=tagValues/\ + value2 + Accelerator settings --accelerator-count=ACCELERATOR_COUNT diff --git a/gcloud/beta/access-context-manager/help b/gcloud/beta/access-context-manager/help index 32293b841..444be1a0c 100644 --- a/gcloud/beta/access-context-manager/help +++ b/gcloud/beta/access-context-manager/help @@ -27,7 +27,7 @@ GROUPS (BETA) Manage Access Context Manager policies. supported-services - (BETA) Retrieve VPC-SC Supported Services. + (BETA) Retrieve VPC Service Controls Supported Services. NOTES This command is currently in beta and might change without notice. These diff --git a/gcloud/beta/access-context-manager/supported-services/describe b/gcloud/beta/access-context-manager/supported-services/describe index f77c7b129..c226853c9 100644 --- a/gcloud/beta/access-context-manager/supported-services/describe +++ b/gcloud/beta/access-context-manager/supported-services/describe @@ -1,6 +1,6 @@ NAME - gcloud beta access-context-manager supported-services describe - get a VPC - Service Controls Supported Service] + gcloud beta access-context-manager supported-services describe - gets + information about a VPC Service Controls Supported Service SYNOPSIS gcloud beta access-context-manager supported-services describe SERVICE_NAME @@ -43,8 +43,10 @@ API REFERENCE https://cloud.google.com/access-context-manager/docs/reference/rest/ NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud access-context-manager supported-services describe $ gcloud alpha access-context-manager supported-services describe diff --git a/gcloud/beta/access-context-manager/supported-services/help b/gcloud/beta/access-context-manager/supported-services/help index c8bf1f67a..f838cb18c 100644 --- a/gcloud/beta/access-context-manager/supported-services/help +++ b/gcloud/beta/access-context-manager/supported-services/help @@ -1,6 +1,6 @@ NAME - gcloud beta access-context-manager supported-services - retrieve VPC-SC - Supported Services + gcloud beta access-context-manager supported-services - retrieve VPC + Service Controls Supported Services SYNOPSIS gcloud beta access-context-manager supported-services COMMAND @@ -12,11 +12,11 @@ DESCRIPTION properties. EXAMPLES - To see all VPC-SC supportedservices: + To see all VPC Service Controls supported services: $ gcloud beta access-context-manager supported-services list - To see support information about VPC-SC supported service: + To see support information about VPC Service Controls supported services: $ gcloud beta access-context-manager supported-services describe \ SERVICE_NAME @@ -30,14 +30,16 @@ COMMANDS COMMAND is one of the following: describe - (BETA) Get a VPC Service Controls Supported Service]. + (BETA) Gets information about a VPC Service Controls Supported Service. list (BETA) Lists all VPC Service Controls supported services. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud access-context-manager supported-services $ gcloud alpha access-context-manager supported-services diff --git a/gcloud/beta/access-context-manager/supported-services/list b/gcloud/beta/access-context-manager/supported-services/list index 83c57365b..721262710 100644 --- a/gcloud/beta/access-context-manager/supported-services/list +++ b/gcloud/beta/access-context-manager/supported-services/list @@ -9,8 +9,11 @@ SYNOPSIS DESCRIPTION (BETA) Lists the services that VPC Service Controls supports. The services - that are in this list either fully support VPC Service Controls or the - integration of this service with VPC Service Controls is in Preview stage + that are in this list fully support VPC Service Controls or the integration + of this service with VPC Service Controls is in Preview stage + (https://cloud.google.com/products#product-launch-stages), or the service + integration is scheduled to be shut down and removed which is in + [Deprecation stage] (https://cloud.google.com/products#product-launch-stages). Services that aren't in this list don't support VPC Service Controls and aren't guaranteed to function properly in a VPC Service Controls environment. @@ -22,8 +25,8 @@ EXAMPLES This command prints out a list of all supported services in a tabular form: - NAME TITLE SUPPORT_STAGE AVAILABLE_ON_RESTRICTED_VIP KNOWN_LIMITATIONS - vpcsc_supported_service VPC-SC Supported API GA True False + NAME TITLE SERVICE_SUPPORT_STAGE AVAILABLE_ON_RESTRICTED_VIP KNOWN_LIMITATIONS + vpcsc_supported_service VPC-SC Supported API GA True False LIST COMMAND FLAGS --filter=EXPRESSION @@ -60,8 +63,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud access-context-manager supported-services list $ gcloud alpha access-context-manager supported-services list diff --git a/gcloud/beta/alloydb/backups/create b/gcloud/beta/alloydb/backups/create index 1bd9245bf..2efaba54c 100644 --- a/gcloud/beta/alloydb/backups/create +++ b/gcloud/beta/alloydb/backups/create @@ -18,17 +18,27 @@ EXAMPLES $ gcloud beta alloydb backups create my-backup \ --cluster=my-cluster --region=us-central1 + To create a new cross-region backup, run: + + $ gcloud beta alloydb backups create \ + projects/my-project/locations/us-west1/backups/my-backup \ + --cluster=my-cluster --region=us-central1 + POSITIONAL ARGUMENTS BACKUP - AlloyDB backup ID + The AlloyDB backup to create. This must either be the backup ID + (myBackup) or the full backup path + (projects/myProject/locations/us-central1/backups/myBackup). In the + first case, the project and location are assumed to be the same as the + cluster being backed up. The second form can be used to create + cross-region and cross-project backups. REQUIRED FLAGS --cluster=CLUSTER AlloyDB cluster ID --region=REGION - The region of the cluster to backup. Note: both the cluster and the - backup have to be in the same region. + The region of the cluster to backup. OPTIONAL FLAGS --async diff --git a/gcloud/beta/alloydb/clusters/create b/gcloud/beta/alloydb/clusters/create index 991a70478..46d7f212b 100644 --- a/gcloud/beta/alloydb/clusters/create +++ b/gcloud/beta/alloydb/clusters/create @@ -60,7 +60,7 @@ OPTIONAL FLAGS --database-version=DATABASE_VERSION Database version of the cluster. DATABASE_VERSION must be one of: - POSTGRES_14, POSTGRES_15. + POSTGRES_14, POSTGRES_15, POSTGRES_16. --enable-private-service-connect Enable Private Service Connect (PSC) connectivity for the cluster. diff --git a/gcloud/beta/alloydb/clusters/help b/gcloud/beta/alloydb/clusters/help index 3852392ad..2cb363181 100644 --- a/gcloud/beta/alloydb/clusters/help +++ b/gcloud/beta/alloydb/clusters/help @@ -40,6 +40,10 @@ COMMANDS (BETA) Restore an AlloyDB cluster from a given backup or a source cluster and a timestamp. + switchover + (BETA) Switchover an AlloyDB SECONDARY cluster in a given project and + region. + update (BETA) Update an AlloyDB cluster within a given project and region. diff --git a/gcloud/beta/alloydb/clusters/switchover b/gcloud/beta/alloydb/clusters/switchover new file mode 100644 index 000000000..08e08f0ef --- /dev/null +++ b/gcloud/beta/alloydb/clusters/switchover @@ -0,0 +1,48 @@ +NAME + gcloud beta alloydb clusters switchover - switchover an AlloyDB SECONDARY + cluster in a given project and region + +SYNOPSIS + gcloud beta alloydb clusters switchover CLUSTER --region=REGION [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Switchover an AlloyDB SECONDARY cluster in a given project and + region. + +EXAMPLES + To switchover a cluster, run: + + $ gcloud beta alloydb clusters switchover my-cluster \ + --region=us-central1 + +POSITIONAL ARGUMENTS + CLUSTER + AlloyDB cluster ID + +REQUIRED FLAGS + --region=REGION + Regional location (e.g. asia-east1, us-east1). See the full list of + regions at https://cloud.google.com/sql/docs/instance-locations. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud alloydb clusters switchover + + $ gcloud alpha alloydb clusters switchover + diff --git a/gcloud/beta/alloydb/instances/create b/gcloud/beta/alloydb/instances/create index 6f8a90389..03a8d531f 100644 --- a/gcloud/beta/alloydb/instances/create +++ b/gcloud/beta/alloydb/instances/create @@ -14,6 +14,13 @@ SYNOPSIS [--insights-config-query-string-length=INSIGHTS_CONFIG_QUERY_STRING_LENGTH] [--[no-]insights-config-record-application-tags] [--[no-]insights-config-record-client-address] + [--[no-]observability-config-enabled] + [--observability-config-max-query-string-length=OBSERVABILITY_CONFIG_MAX_QUERY_STRING_LENGTH] + [--[no-]observability-config-preserve-comments] + [--observability-config-query-plans-per-minute=OBSERVABILITY_CONFIG_QUERY_PLANS_PER_MINUTE] + [--[no-]observability-config-record-application-tags] + [--[no-]observability-config-track-active-queries] + [--observability-config-track-wait-events] [--read-pool-node-count=READ_POOL_NODE_COUNT] [--[no-]require-connectors] [--ssl-mode=SSL_MODE; default="ENCRYPTED_ONLY"] [GCLOUD_WIDE_FLAG ...] @@ -132,6 +139,41 @@ OPTIONAL FLAGS Use --insights-config-record-client-address to enable and --no-insights-config-record-client-address to disable. + --[no-]observability-config-enabled + Enable enhanced query insights feature. Use + --observability-config-enabled to enable and + --no-observability-config-enabled to disable. + + --observability-config-max-query-string-length=OBSERVABILITY_CONFIG_MAX_QUERY_STRING_LENGTH + Query string length in bytes to be stored by the enhanced query + insights feature. Default length is 10k bytes. + + --[no-]observability-config-preserve-comments + Allow preservation of comments in query string recorded by the enhanced + query insights feature. + + Use --observability-config-preserve-comments to enable and + --no-observability-config-preserve-comments to disable. + + --observability-config-query-plans-per-minute=OBSERVABILITY_CONFIG_QUERY_PLANS_PER_MINUTE + Number of query plans to sample every minute. Default value is 200. + Allowed range: 0 to 200. + + --[no-]observability-config-record-application-tags + Allow application tags to be recorded by the enhanced query insights + feature. + + Use --observability-config-record-application-tags to enable and + --no-observability-config-record-application-tags to disable. + + --[no-]observability-config-track-active-queries + Track actively running queries. Use + --observability-config-track-active-queries to enable and + --no-observability-config-track-active-queries to disable. + + --observability-config-track-wait-events + Track wait events during query execution. + --read-pool-node-count=READ_POOL_NODE_COUNT Read capacity, i.e. number of nodes in a read pool instance. diff --git a/gcloud/beta/alloydb/instances/update b/gcloud/beta/alloydb/instances/update index 8813a4744..f71c17236 100644 --- a/gcloud/beta/alloydb/instances/update +++ b/gcloud/beta/alloydb/instances/update @@ -13,6 +13,13 @@ SYNOPSIS [--insights-config-query-string-length=INSIGHTS_CONFIG_QUERY_STRING_LENGTH] [--[no-]insights-config-record-application-tags] [--[no-]insights-config-record-client-address] + [--[no-]observability-config-enabled] + [--observability-config-max-query-string-length=OBSERVABILITY_CONFIG_MAX_QUERY_STRING_LENGTH] + [--[no-]observability-config-preserve-comments] + [--observability-config-query-plans-per-minute=OBSERVABILITY_CONFIG_QUERY_PLANS_PER_MINUTE] + [--[no-]observability-config-record-application-tags] + [--[no-]observability-config-track-active-queries] + [--observability-config-track-wait-events] [--read-pool-node-count=READ_POOL_NODE_COUNT] [--[no-]require-connectors] [--ssl-mode=SSL_MODE] [--update-mode=UPDATE_MODE] [GCLOUD_WIDE_FLAG ...] @@ -114,6 +121,41 @@ OPTIONAL FLAGS Use --insights-config-record-client-address to enable and --no-insights-config-record-client-address to disable. + --[no-]observability-config-enabled + Enable enhanced query insights feature. Use + --observability-config-enabled to enable and + --no-observability-config-enabled to disable. + + --observability-config-max-query-string-length=OBSERVABILITY_CONFIG_MAX_QUERY_STRING_LENGTH + Query string length in bytes to be stored by the enhanced query + insights feature. Default length is 10k bytes. + + --[no-]observability-config-preserve-comments + Allow preservation of comments in query string recorded by the enhanced + query insights feature. + + Use --observability-config-preserve-comments to enable and + --no-observability-config-preserve-comments to disable. + + --observability-config-query-plans-per-minute=OBSERVABILITY_CONFIG_QUERY_PLANS_PER_MINUTE + Number of query plans to sample every minute. Default value is 200. + Allowed range: 0 to 200. + + --[no-]observability-config-record-application-tags + Allow application tags to be recorded by the enhanced query insights + feature. + + Use --observability-config-record-application-tags to enable and + --no-observability-config-record-application-tags to disable. + + --[no-]observability-config-track-active-queries + Track actively running queries. Use + --observability-config-track-active-queries to enable and + --no-observability-config-track-active-queries to disable. + + --observability-config-track-wait-events + Track wait events during query execution. + --read-pool-node-count=READ_POOL_NODE_COUNT Read capacity, i.e. number of nodes in a read pool instance. diff --git a/gcloud/beta/compute/backend-services/add-backend b/gcloud/beta/compute/backend-services/add-backend index aa14215f1..9d3577d07 100644 --- a/gcloud/beta/compute/backend-services/add-backend +++ b/gcloud/beta/compute/backend-services/add-backend @@ -234,17 +234,18 @@ OPTIONAL FLAGS (https://cloud.google.com/load-balancing/docs/backend-service#balancing-mode-combos). --preference=PREFERENCE - Defines whether a backend should be fully utilized before sending - traffic to backends with default preference. This parameter cannot be - used with regional managed instance groups and when the endpoint type - of an attached network endpoint group is INTERNET_IP_PORT, - INTERNET_FQDN_PORT, or SERVERLESS. PREFERENCE must be one of: + This parameter specifies whether a backend should be fully utilized + before sending traffic to backends with the default preference. This + parameter cannot be used with regional managed instance groups and when + the endpoint type of an attached network endpoint group is + INTERNET_IP_PORT, INTERNET_FQDN_PORT, or SERVERLESS. PREFERENCE must be + one of: DEFAULT This is the default setting. If the designated preferred backends don't have enough capacity, backends in the default category are used. Traffic is distributed between default backends based on the - load balancing algorithm you use. + load balancing algorithm used. PREFERRED Backends with this preference setting are used up to their capacity diff --git a/gcloud/beta/compute/backend-services/update-backend b/gcloud/beta/compute/backend-services/update-backend index 38b1b4da0..c52324649 100644 --- a/gcloud/beta/compute/backend-services/update-backend +++ b/gcloud/beta/compute/backend-services/update-backend @@ -203,17 +203,18 @@ OPTIONAL FLAGS (https://cloud.google.com/load-balancing/docs/backend-service#balancing-mode-combos). --preference=PREFERENCE - Defines whether a backend should be fully utilized before sending - traffic to backends with default preference. This parameter cannot be - used with regional managed instance groups and when the endpoint type - of an attached network endpoint group is INTERNET_IP_PORT, - INTERNET_FQDN_PORT, or SERVERLESS. PREFERENCE must be one of: + This parameter specifies whether a backend should be fully utilized + before sending traffic to backends with the default preference. This + parameter cannot be used with regional managed instance groups and when + the endpoint type of an attached network endpoint group is + INTERNET_IP_PORT, INTERNET_FQDN_PORT, or SERVERLESS. PREFERENCE must be + one of: DEFAULT This is the default setting. If the designated preferred backends don't have enough capacity, backends in the default category are used. Traffic is distributed between default backends based on the - load balancing algorithm you use. + load balancing algorithm used. PREFERRED Backends with this preference setting are used up to their capacity diff --git a/gcloud/beta/compute/instances/create-with-container b/gcloud/beta/compute/instances/create-with-container index ea02a1f7c..9d5f066d6 100644 --- a/gcloud/beta/compute/instances/create-with-container +++ b/gcloud/beta/compute/instances/create-with-container @@ -24,6 +24,7 @@ SYNOPSIS [--container-restart-policy=POLICY; default="always"] [--container-stdin] [--container-tty] [--create-disk=[PROPERTY=VALUE,...]] [--description=DESCRIPTION] + [--discard-local-ssds-at-termination-timestamp=DISCARD_LOCAL_SSDS_AT_TERMINATION_TIMESTAMP] [--disk=[auto-delete=AUTO-DELETE],[boot=BOOT],[device-name=DEVICE-NAME], [force-attach=FORCE-ATTACH],[mode=MODE],[name=NAME],[scope=SCOPE]] [--[no-]enable-nested-virtualization] @@ -37,6 +38,7 @@ SYNOPSIS [--local-ssd=[device-name=DEVICE-NAME],[interface=INTERFACE]] [--local-ssd-recovery-timeout=LOCAL_SSD_RECOVERY_TIMEOUT] [--machine-type=MACHINE_TYPE] [--maintenance-policy=MAINTENANCE_POLICY] + [--max-run-duration=MAX_RUN_DURATION] [--metadata=KEY=VALUE,[KEY=VALUE,...]] [--metadata-from-file=KEY=LOCAL_FILE_PATH,[...]] [--min-cpu-platform=PLATFORM] [--network=NETWORK] @@ -50,6 +52,7 @@ SYNOPSIS [--shielded-integrity-monitoring] [--shielded-secure-boot] [--shielded-vtpm] [--source-instance-template=SOURCE_INSTANCE_TEMPLATE] [--stack-type=STACK_TYPE] [--subnet=SUBNET] [--tags=TAG,[TAG,...]] + [--termination-time=TERMINATION_TIME] [--threads-per-core=THREADS_PER_CORE] [--visible-core-count=VISIBLE_CORE_COUNT] [--zone=ZONE] [--address=ADDRESS | --no-address] @@ -392,6 +395,20 @@ FLAGS --description=DESCRIPTION Specifies a textual description of the instances. + --discard-local-ssds-at-termination-timestamp=DISCARD_LOCAL_SSDS_AT_TERMINATION_TIMESTAMP + Required to be set to true and only allowed for VMs that have one or + more local SSDs, use --instance-termination-action=STOP, and use either + --max-run-duration or --termination-time. + + This flag indicates the value that you want Compute Engine to use for + the --discard-local-ssd flag in the automatic gcloud compute instances + stop command. This flag only supports the true value, which discards + local SSD data when automatically stopping this VM during its + terminationTimestamp. + + For more information about the --discard-local-ssd flag, see + https://cloud.google.com/compute/docs/disks/local-ssd#stop_instance. + --disk=[auto-delete=AUTO-DELETE],[boot=BOOT],[device-name=DEVICE-NAME],[force-attach=FORCE-ATTACH],[mode=MODE],[name=NAME],[scope=SCOPE] Attaches an existing persistent disk to the instances. @@ -539,6 +556,28 @@ FLAGS TERMINATE The instances should be terminated. + --max-run-duration=MAX_RUN_DURATION + Limits how long this VM instance can run, specified as a duration + relative to the last time when the VM began running. Format the + duration, MAX_RUN_DURATION, as the number of days, hours, minutes, and + seconds followed by d, h, m, and s respectively. For example, specify + 30m for a duration of 30 minutes or specify 1d2h3m4s for a duration of + 1 day, 2 hours, 3 minutes, and 4 seconds. Alternatively, to specify a + timestamp, use --termination-time instead. + + If neither --max-run-duration nor --termination-time is specified + (default), the VM instance runs until prompted by a user action or + system event. If either is specified, the VM instance is scheduled to + be automatically terminated at the VM's termination timestamp + (terminationTimestamp) using the action specified by + --instance-termination-action. + + Note: The terminationTimestamp is removed whenever the VM is stopped or + suspended and redefined whenever the VM is rerun. For + --max-run-duration specifically, the terminationTimestamp is the sum of + MAX_RUN_DURATION and the time when the VM last entered the RUNNING + state, which changes whenever the VM is rerun. + --metadata=KEY=VALUE,[KEY=VALUE,...] Metadata to be made available to the guest operating system running on the instances. Each metadata entry is a key/value pair separated by an @@ -814,6 +853,25 @@ FLAGS $ gcloud compute instances list --filter='tags:tag1' + --termination-time=TERMINATION_TIME + Limits how long this VM instance can run, specified as a time. Format + the time, TERMINATION_TIME, as a RFC 3339 timestamp. For more + information, see https://tools.ietf.org/html/rfc3339. Alternatively, to + specify a duration, use --max-run-duration instead. + + If neither --termination-time nor --max-run-duration is specified + (default), the VM instance runs until prompted by a user action or + system event. If either is specified, the VM instance is scheduled to + be automatically terminated at the VM's termination timestamp + (terminationTimestamp) using the action specified by + --instance-termination-action. + + Note: The terminationTimestamp is removed whenever the VM is stopped or + suspended and redefined whenever the VM is rerun. For + --termination-time specifically, the terminationTimestamp remains the + same whenever the VM is rerun, but any requests to rerun the VM fail if + the specified timestamp is in the past. + --threads-per-core=THREADS_PER_CORE The number of visible threads per physical core. To disable simultaneous multithreading (SMT) set this to 1. Valid values are: 1 or diff --git a/gcloud/beta/compute/instances/help b/gcloud/beta/compute/instances/help index f14bcebfc..13d05a8d6 100644 --- a/gcloud/beta/compute/instances/help +++ b/gcloud/beta/compute/instances/help @@ -32,7 +32,7 @@ GROUPS interfaces. ops-agents - (BETA) Manage Operation Suite (Ops) agents for Compute Engine VM + (BETA) Manage Google Cloud Observability agents for Compute Engine VM instances. os-inventory diff --git a/gcloud/beta/compute/instances/ops-agents/help b/gcloud/beta/compute/instances/ops-agents/help index 68080f71c..561b5c720 100644 --- a/gcloud/beta/compute/instances/ops-agents/help +++ b/gcloud/beta/compute/instances/ops-agents/help @@ -1,12 +1,13 @@ NAME - gcloud beta compute instances ops-agents - manage Operation Suite (Ops) - agents for Compute Engine VM instances + gcloud beta compute instances ops-agents - manage Google Cloud + Observability agents for Compute Engine VM instances SYNOPSIS gcloud beta compute instances ops-agents GROUP [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Manage Operation Suite (Ops) agents for Compute Engine VM instances. + (BETA) Manage Google Cloud Observability agents for Compute Engine VM + instances. GCLOUD WIDE FLAGS These flags are available to all commands: --help. @@ -17,7 +18,7 @@ GROUPS GROUP is one of the following: policies - (BETA) Manage Operation Suite (Ops) agents policies that install, + (BETA) Manage Google Cloud Observability agents policies that install, update, and uninstall agents for Compute Engine VM instances. NOTES diff --git a/gcloud/beta/compute/instances/ops-agents/policies/create b/gcloud/beta/compute/instances/ops-agents/policies/create index 5ef85b123..13b286c9d 100644 --- a/gcloud/beta/compute/instances/ops-agents/policies/create +++ b/gcloud/beta/compute/instances/ops-agents/policies/create @@ -343,8 +343,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud compute instances ops-agents policies create $ gcloud alpha compute instances ops-agents policies create diff --git a/gcloud/beta/compute/instances/ops-agents/policies/delete b/gcloud/beta/compute/instances/ops-agents/policies/delete index 17f722d94..30a65862f 100644 --- a/gcloud/beta/compute/instances/ops-agents/policies/delete +++ b/gcloud/beta/compute/instances/ops-agents/policies/delete @@ -46,8 +46,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud compute instances ops-agents policies delete $ gcloud alpha compute instances ops-agents policies delete diff --git a/gcloud/beta/compute/instances/ops-agents/policies/describe b/gcloud/beta/compute/instances/ops-agents/policies/describe index d3d1bd2e4..f72bff935 100644 --- a/gcloud/beta/compute/instances/ops-agents/policies/describe +++ b/gcloud/beta/compute/instances/ops-agents/policies/describe @@ -62,8 +62,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud compute instances ops-agents policies describe $ gcloud alpha compute instances ops-agents policies describe diff --git a/gcloud/beta/compute/instances/ops-agents/policies/help b/gcloud/beta/compute/instances/ops-agents/policies/help index c6e8214b0..cc30a517c 100644 --- a/gcloud/beta/compute/instances/ops-agents/policies/help +++ b/gcloud/beta/compute/instances/ops-agents/policies/help @@ -1,15 +1,15 @@ NAME - gcloud beta compute instances ops-agents policies - manage Operation Suite - (Ops) agents policies that install, update, and uninstall agents for - Compute Engine VM instances + gcloud beta compute instances ops-agents policies - manage Google Cloud + Observability agents policies that install, update, and uninstall + agents for Compute Engine VM instances SYNOPSIS gcloud beta compute instances ops-agents policies COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Manage Operation Suite (Ops) agents policies that install, update, - and uninstall agents for Compute Engine VM instances. + (BETA) Manage Google Cloud Observability agents policies that install, + update, and uninstall agents for Compute Engine VM instances. GCLOUD WIDE FLAGS These flags are available to all commands: --help. diff --git a/gcloud/beta/compute/instances/ops-agents/policies/list b/gcloud/beta/compute/instances/ops-agents/policies/list index dc292914b..5e2559e91 100644 --- a/gcloud/beta/compute/instances/ops-agents/policies/list +++ b/gcloud/beta/compute/instances/ops-agents/policies/list @@ -65,8 +65,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud compute instances ops-agents policies list $ gcloud alpha compute instances ops-agents policies list diff --git a/gcloud/beta/compute/instances/ops-agents/policies/update b/gcloud/beta/compute/instances/ops-agents/policies/update index ec2a04e58..80ffed0d9 100644 --- a/gcloud/beta/compute/instances/ops-agents/policies/update +++ b/gcloud/beta/compute/instances/ops-agents/policies/update @@ -394,8 +394,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud compute instances ops-agents policies update $ gcloud alpha compute instances ops-agents policies update diff --git a/gcloud/beta/container/backup-restore/backup-plans/create b/gcloud/beta/container/backup-restore/backup-plans/create index de856e09b..5b8cca65b 100644 --- a/gcloud/beta/container/backup-restore/backup-plans/create +++ b/gcloud/beta/container/backup-restore/backup-plans/create @@ -26,7 +26,7 @@ EXAMPLES $ gcloud beta container backup-restore backup-plans create \ my-backup-plan --project=my-project --location=us-central1 \ - --cluster=project/my-project/location/us-central1/clusters/\ + --cluster=projects/my-project/locations/us-central1/clusters/\ my-cluster --all-namespaces POSITIONAL ARGUMENTS diff --git a/gcloud/beta/filestore/instances/promote-replica b/gcloud/beta/filestore/instances/promote-replica index 64d8e32a9..2f1335b20 100644 --- a/gcloud/beta/filestore/instances/promote-replica +++ b/gcloud/beta/filestore/instances/promote-replica @@ -75,5 +75,8 @@ API REFERENCE can be found at: https://cloud.google.com/filestore/ NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud filestore instances promote-replica diff --git a/gcloud/beta/firestore/databases/restore b/gcloud/beta/firestore/databases/restore index e4e8ee4b2..ae167571f 100644 --- a/gcloud/beta/firestore/databases/restore +++ b/gcloud/beta/firestore/databases/restore @@ -14,13 +14,6 @@ EXAMPLES --source-backup=projects/PROJECT_ID/locations/LOCATION_ID/\ backups/BACKUP_ID --destination-database=DATABASE_ID - To restore a database from a database snapshot. - - $ gcloud beta firestore databases restore \ - --source-database=SOURCE_DB \ - --snapshot-time=2023-05-26T10:20:00.00Z \ - --destination-database=DATABASE_ID - REQUIRED FLAGS --destination-database=DESTINATION_DATABASE Destination database to restore to. Destination database will be diff --git a/gcloud/beta/functions/deploy b/gcloud/beta/functions/deploy index d0570bed0..d61d8444a 100644 --- a/gcloud/beta/functions/deploy +++ b/gcloud/beta/functions/deploy @@ -16,6 +16,8 @@ SYNOPSIS [--trigger-location=TRIGGER_LOCATION] [--trigger-service-account=TRIGGER_SERVICE_ACCOUNT] [--update-labels=[KEY=VALUE,...]] + [--binary-authorization=BINARY_AUTHORIZATION + | --clear-binary-authorization] [--build-env-vars-file=FILE_PATH | --clear-build-env-vars | --set-build-env-vars=[KEY=VALUE,...] | --remove-build-env-vars=[KEY,...] @@ -307,6 +309,19 @@ FLAGS Label keys starting with deployment are reserved for use by deployment tools and cannot be specified manually. + At most one of these can be specified: + + --binary-authorization=BINARY_AUTHORIZATION + Name of the Binary Authorization policy that the function image + should be checked against when deploying to Cloud Run. + + Example: default + + The flag is only applicable to 2nd gen functions. + + --clear-binary-authorization + Clears the Binary Authorization policy field. + At most one of these can be specified: --build-env-vars-file=FILE_PATH diff --git a/gcloud/beta/managed-kafka/topics/update b/gcloud/beta/managed-kafka/topics/update index ea6474bde..6df8cf47c 100644 --- a/gcloud/beta/managed-kafka/topics/update +++ b/gcloud/beta/managed-kafka/topics/update @@ -5,7 +5,7 @@ NAME SYNOPSIS gcloud beta managed-kafka topics update (TOPIC : --cluster=CLUSTER --location=LOCATION) - (--configs=[KEY=VALUE,...] --partitions=PARTITIONS) + (--partitions=PARTITIONS --clear-configs | --configs=[KEY=VALUE,...]) [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -62,20 +62,25 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS At least one of these must be specified: - --configs=[KEY=VALUE,...] - Configuration for the topic that are overridden from the cluster - defaults. The key of the map is a Kafka topic property name, for - example: cleanup.policy=compact,compression.type=producer. If you - provide a map with a key that already exists, only that configuration - is updated. If the map contains a key that does not exist, the entry - is appended to the topic configuration. - --partitions=PARTITIONS The number of partitions in a topic. You can increase the partition count for a topic, but you cannot decrease it. Increasing partitions for a topic that uses a key might change how messages are distributed. + At most one of these can be specified: + + --clear-configs + Remove all the configurations for the topic. + + --configs=[KEY=VALUE,...] + Configuration for the topic that are overridden from the cluster + defaults. The key of the map is a Kafka topic property name, for + example: cleanup.policy=compact,compression.type=producer. If you + provide a map with a key that already exists, only that + configuration is updated. If the map contains a key that does not + exist, the entry is appended to the topic configuration. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/beta/metastore/services/create b/gcloud/beta/metastore/services/create index 1560000fb..37675813a 100644 --- a/gcloud/beta/metastore/services/create +++ b/gcloud/beta/metastore/services/create @@ -23,6 +23,8 @@ SYNOPSIS --keytab=KEYTAB --krb5-config=KRB5_CONFIG] [--maintenance-window-day=MAINTENANCE_WINDOW_DAY --maintenance-window-hour=MAINTENANCE_WINDOW_HOUR] + [--read-only-regions=[READ_ONLY_REGIONS,...] + --read-write-regions=[READ_WRITE_REGIONS,...]] [--scheduled-backup-configs-from-file=SCHEDULED_BACKUP_CONFIGS_FROM_FILE | --enable-scheduled-backup --scheduled-backup-cron=SCHEDULED_BACKUP_CRON --scheduled-backup-location=SCHEDULED_BACKUP_LOCATION] [GCLOUD_WIDE_FLAG ...] @@ -357,6 +359,16 @@ FLAGS This flag argument must be specified if any of the other arguments in this group are specified. + Custom region configuration for the metastore service. + + --read-only-regions=[READ_ONLY_REGIONS,...] + The list of read-only regions where the metastore service runs in. + These regions should be part (or subset) of the multi-region. + + --read-write-regions=[READ_WRITE_REGIONS,...] + The list of read-write regions where the metastore service runs in. + These regions should be part (or subset) of the multi-region. + Scheduled backup configurations to enable a scheduled backup of the metastore service. diff --git a/gcloud/beta/netapp/storage-pools/create b/gcloud/beta/netapp/storage-pools/create index b2fb08b5e..51ad99c84 100644 --- a/gcloud/beta/netapp/storage-pools/create +++ b/gcloud/beta/netapp/storage-pools/create @@ -86,10 +86,8 @@ REQUIRED FLAGS accepted, but please use the long-form when attempting to create a Storage Pool using a shared VPC. psa-range - The psa-range is the name of the allocated range of the Private - Service Access connection. The range you specify can't overlap with - either existing subnets or assigned IP address ranges for other - Cloud NetApp Files Storage Pools in the selected VPC network. + This field is not implemented. The values provided in this field + are ignored. --service-level=SERVICE_LEVEL The service level for the Cloud NetApp Storage Pool. For more details, diff --git a/gcloud/beta/network-connectivity/help b/gcloud/beta/network-connectivity/help index 55d6e7907..629586809 100644 --- a/gcloud/beta/network-connectivity/help +++ b/gcloud/beta/network-connectivity/help @@ -16,6 +16,9 @@ GCLOUD WIDE FLAGS GROUPS GROUP is one of the following: + hubs + (BETA) Manage Network Connectivity Center hubs. + policy-based-routes (BETA) Manage Policy-based Routes. diff --git a/gcloud/beta/network-connectivity/hubs/add-iam-policy-binding b/gcloud/beta/network-connectivity/hubs/add-iam-policy-binding new file mode 100644 index 000000000..72f34289a --- /dev/null +++ b/gcloud/beta/network-connectivity/hubs/add-iam-policy-binding @@ -0,0 +1,79 @@ +NAME + gcloud beta network-connectivity hubs add-iam-policy-binding - add an IAM + policy binding to the IAM policy of a hub resource + +SYNOPSIS + gcloud beta network-connectivity hubs add-iam-policy-binding HUB + --member=PRINCIPAL --role=ROLE [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Add an IAM policy binding to the IAM policy of a hub resource. One + binding consists of a member, a role, and an optional condition. + +EXAMPLES + To grant a user the roles/networkconnectivity.groupUser role on the hub + called my-hub, run the following command: + + $ gcloud beta network-connectivity hubs add-iam-policy-binding \ + my-hub --member="user:username@gmail.com" \ + --role="roles/networkconnectivity.groupUser" + +POSITIONAL ARGUMENTS + Hub resource - The hub that you want to update. 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 hub 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. + + HUB + ID of the hub or fully qualified identifier for the hub. + + To set the hub attribute: + ▸ provide the argument hub on the command line. + +REQUIRED FLAGS + --member=PRINCIPAL + The principal to add the binding for. Should be of the form + user|group|serviceAccount:email or domain:domain. + + Examples: user:test-user@gmail.com, group:admins@example.com, + serviceAccount:test123@example.domain.com, or + domain:example.domain.com. + + Some resources also accept the following special values: + ◆ allUsers - Special identifier that represents anyone who is on the + internet, with or without a Google account. + ◆ allAuthenticatedUsers - Special identifier that represents anyone + who is authenticated with a Google account or a service account. + + --role=ROLE + Role name to assign to the principal. The role name is the complete + path of a predefined role, such as roles/logging.viewer, or the role ID + for a custom role, such as + organizations/{ORGANIZATION_ID}/roles/logging.viewer. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkconnectivity/v1beta API. The full + documentation for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud network-connectivity hubs add-iam-policy-binding + diff --git a/gcloud/beta/network-connectivity/hubs/create b/gcloud/beta/network-connectivity/hubs/create new file mode 100644 index 000000000..03f7ad4a9 --- /dev/null +++ b/gcloud/beta/network-connectivity/hubs/create @@ -0,0 +1,88 @@ +NAME + gcloud beta network-connectivity hubs create - create a new hub + +SYNOPSIS + gcloud beta network-connectivity hubs create HUB [--async] + [--description=DESCRIPTION] [--export-psc] [--labels=[KEY=VALUE,...]] + [--policy-mode=POLICY_MODE] [--preset-topology=PRESET_TOPOLOGY] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Create a new hub with the given name. + +EXAMPLES + To create a hub with the name my-hub and the description optional + description, run: + + $ gcloud beta network-connectivity hubs create my-hub \ + --description="optional description" + +POSITIONAL ARGUMENTS + Hub resource - Name of the hub to be created. 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 hub 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. + + HUB + ID of the hub or fully qualified identifier for the hub. + + To set the hub attribute: + ▸ provide the argument hub on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + Description of the hub. + + --export-psc + This boolean controls whether Private Service Connect transitivity is + enabled for the hub. + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + --policy-mode=POLICY_MODE + Policy mode of the hub. POLICY_MODE must be one of: + policy-mode-unspecified, preset. + + --preset-topology=PRESET_TOPOLOGY + Topology of the hub. Only applicable when --policy-mode=PRESET. + PRESET_TOPOLOGY must be one of: mesh, preset-topology-unspecified, + star. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkconnectivity/v1beta API. The full + documentation for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-connectivity hubs create + + $ gcloud alpha network-connectivity hubs create + diff --git a/gcloud/beta/network-connectivity/hubs/delete b/gcloud/beta/network-connectivity/hubs/delete new file mode 100644 index 000000000..ea45d3bed --- /dev/null +++ b/gcloud/beta/network-connectivity/hubs/delete @@ -0,0 +1,60 @@ +NAME + gcloud beta network-connectivity hubs delete - delete a hub + +SYNOPSIS + gcloud beta network-connectivity hubs delete HUB [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Delete the specified hub. + +EXAMPLES + To delete a hub named my-hub, run: + + $ gcloud beta network-connectivity hubs delete my-hub + +POSITIONAL ARGUMENTS + Hub resource - Name of the hub to be deleted. 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 hub 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. + + HUB + ID of the hub or fully qualified identifier for the hub. + + To set the hub attribute: + ▸ provide the argument hub on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkconnectivity/v1beta API. The full + documentation for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-connectivity hubs delete + + $ gcloud alpha network-connectivity hubs delete + diff --git a/gcloud/beta/network-connectivity/hubs/describe b/gcloud/beta/network-connectivity/hubs/describe new file mode 100644 index 000000000..37eaf0ab2 --- /dev/null +++ b/gcloud/beta/network-connectivity/hubs/describe @@ -0,0 +1,54 @@ +NAME + gcloud beta network-connectivity hubs describe - describe a hub + +SYNOPSIS + gcloud beta network-connectivity hubs describe HUB [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Retrieve and display details about a hub. + +EXAMPLES + To display details about a hub named my-hub, run: + + $ gcloud beta network-connectivity hubs describe my-hub + +POSITIONAL ARGUMENTS + Hub resource - Name of the hub to be described. 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 hub 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. + + HUB + ID of the hub or fully qualified identifier for the hub. + + To set the hub attribute: + ▸ provide the argument hub on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkconnectivity/v1beta API. The full + documentation for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-connectivity hubs describe + + $ gcloud alpha network-connectivity hubs describe + diff --git a/gcloud/beta/network-connectivity/hubs/get-iam-policy b/gcloud/beta/network-connectivity/hubs/get-iam-policy new file mode 100644 index 000000000..b79d441ba --- /dev/null +++ b/gcloud/beta/network-connectivity/hubs/get-iam-policy @@ -0,0 +1,82 @@ +NAME + gcloud beta network-connectivity hubs get-iam-policy - get the IAM policy + for a hub resource + +SYNOPSIS + gcloud beta network-connectivity hubs get-iam-policy HUB + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Get the IAM policy of a hub. If formatted as JSON, the output can be + edited and used as a policy file for set-iam-policy. + +EXAMPLES + To get the IAM policy for a hub named my-hub, run: + + $ gcloud beta network-connectivity hubs get-iam-policy my-hub + +POSITIONAL ARGUMENTS + Hub resource - The hub for which you want the IAM policy. 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 hub 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. + + HUB + ID of the hub or fully qualified identifier for the hub. + + To set the hub attribute: + ▸ provide the argument hub on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkconnectivity/v1beta API. The full + documentation for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud network-connectivity hubs get-iam-policy + diff --git a/gcloud/beta/network-connectivity/hubs/groups/add-iam-policy-binding b/gcloud/beta/network-connectivity/hubs/groups/add-iam-policy-binding new file mode 100644 index 000000000..ca2476609 --- /dev/null +++ b/gcloud/beta/network-connectivity/hubs/groups/add-iam-policy-binding @@ -0,0 +1,93 @@ +NAME + gcloud beta network-connectivity hubs groups add-iam-policy-binding - add + an IAM policy binding to the IAM policy of a group resource + +SYNOPSIS + gcloud beta network-connectivity hubs groups add-iam-policy-binding + (GROUP : --hub=HUB) --member=PRINCIPAL --role=ROLE + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Add an IAM policy binding to the IAM policy of a group resource. One + binding consists of a member, a role, and an optional condition. + +EXAMPLES + To grant a user the roles/networkconnectivity.groupUser role on the group + called my-group in the hub called my-hub', run the following command: + + $ gcloud beta network-connectivity hubs groups \ + add-iam-policy-binding my-group \ + --member="user:username@gmail.com" \ + --role="roles/networkconnectivity.groupUser" --hub="my-hub" + +POSITIONAL ARGUMENTS + Group resource - The group that you want to update. The arguments in this + group can be used to specify the attributes of this resource. (NOTE) Some + attributes are not given arguments in this group but can be set in other + ways. + + To set the project attribute: + ◆ provide the argument group 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. + + GROUP + ID of the group or fully qualified identifier for the group. + + To set the group attribute: + ▸ provide the argument group on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --hub=HUB + Id of the hub. + + To set the hub attribute: + ▸ provide the argument group on the command line with a fully + specified name; + ▸ provide the argument --hub on the command line. + +REQUIRED FLAGS + --member=PRINCIPAL + The principal to add the binding for. Should be of the form + user|group|serviceAccount:email or domain:domain. + + Examples: user:test-user@gmail.com, group:admins@example.com, + serviceAccount:test123@example.domain.com, or + domain:example.domain.com. + + Some resources also accept the following special values: + ◆ allUsers - Special identifier that represents anyone who is on the + internet, with or without a Google account. + ◆ allAuthenticatedUsers - Special identifier that represents anyone + who is authenticated with a Google account or a service account. + + --role=ROLE + Role name to assign to the principal. The role name is the complete + path of a predefined role, such as roles/logging.viewer, or the role ID + for a custom role, such as + organizations/{ORGANIZATION_ID}/roles/logging.viewer. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkconnectivity/v1beta API. The full + documentation for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud network-connectivity hubs groups add-iam-policy-binding + diff --git a/gcloud/beta/network-connectivity/hubs/groups/describe b/gcloud/beta/network-connectivity/hubs/groups/describe new file mode 100644 index 000000000..ddf945e95 --- /dev/null +++ b/gcloud/beta/network-connectivity/hubs/groups/describe @@ -0,0 +1,65 @@ +NAME + gcloud beta network-connectivity hubs groups describe - describe a group + +SYNOPSIS + gcloud beta network-connectivity hubs groups describe (GROUP : --hub=HUB) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Retrieve and display details about a group. + +EXAMPLES + To display details about a group named my-group, run: + + $ gcloud beta network-connectivity hubs groups describe my-group + +POSITIONAL ARGUMENTS + Group resource - Name of the group to describe. The arguments in this + group can be used to specify the attributes of this resource. (NOTE) Some + attributes are not given arguments in this group but can be set in other + ways. + + To set the project attribute: + ◆ provide the argument group 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. + + GROUP + ID of the group or fully qualified identifier for the group. + + To set the group attribute: + ▸ provide the argument group on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --hub=HUB + Id of the hub. + + To set the hub attribute: + ▸ provide the argument group on the command line with a fully + specified name; + ▸ provide the argument --hub on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkconnectivity/v1beta API. The full + documentation for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud network-connectivity hubs groups describe + diff --git a/gcloud/beta/network-connectivity/hubs/groups/get-iam-policy b/gcloud/beta/network-connectivity/hubs/groups/get-iam-policy new file mode 100644 index 000000000..e2086ee50 --- /dev/null +++ b/gcloud/beta/network-connectivity/hubs/groups/get-iam-policy @@ -0,0 +1,96 @@ +NAME + gcloud beta network-connectivity hubs groups get-iam-policy - get the IAM + policy for a group resource + +SYNOPSIS + gcloud beta network-connectivity hubs groups get-iam-policy + (GROUP : --hub=HUB) [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Get the IAM policy of a group. If formatted as JSON, the output can + be edited and used as a policy file for set-iam-policy. + +EXAMPLES + To get the IAM policy for a group named my-group in the hub named my-hub, + run: + + $ gcloud beta network-connectivity hubs groups get-iam-policy \ + my-group --hub="my-hub" + +POSITIONAL ARGUMENTS + Group resource - The group for which you want the IAM policy. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument group 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. + + GROUP + ID of the group or fully qualified identifier for the group. + + To set the group attribute: + ▸ provide the argument group on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --hub=HUB + Id of the hub. + + To set the hub attribute: + ▸ provide the argument group on the command line with a fully + specified name; + ▸ provide the argument --hub on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkconnectivity/v1beta API. The full + documentation for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud network-connectivity hubs groups get-iam-policy + diff --git a/gcloud/beta/network-connectivity/hubs/groups/help b/gcloud/beta/network-connectivity/hubs/groups/help new file mode 100644 index 000000000..41de2d7a5 --- /dev/null +++ b/gcloud/beta/network-connectivity/hubs/groups/help @@ -0,0 +1,43 @@ +NAME + gcloud beta network-connectivity hubs groups - manage Network Connectivity + Center groups + +SYNOPSIS + gcloud beta network-connectivity hubs groups COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Manage Network Connectivity Center groups. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + add-iam-policy-binding + (BETA) Add an IAM policy binding to the IAM policy of a group resource. + + describe + (BETA) Describe a group. + + get-iam-policy + (BETA) Get the IAM policy for a group resource. + + list + (BETA) List groups. + + remove-iam-policy-binding + (BETA) Remove an IAM policy binding from the IAM policy of a group + resource. + + set-iam-policy + (BETA) Set the IAM policy of a group resource. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud network-connectivity hubs groups + diff --git a/gcloud/beta/network-connectivity/hubs/groups/list b/gcloud/beta/network-connectivity/hubs/groups/list new file mode 100644 index 000000000..e84c721a6 --- /dev/null +++ b/gcloud/beta/network-connectivity/hubs/groups/list @@ -0,0 +1,84 @@ +NAME + gcloud beta network-connectivity hubs groups list - list groups + +SYNOPSIS + gcloud beta network-connectivity hubs groups list --hub=HUB + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Retrieve and display a list of all groups in the specified hub. + +EXAMPLES + To list all groups across all hubs, run: + + $ gcloud beta network-connectivity hubs groups list --hub=- + + To list all groups in hub my-hub, run: + + $ gcloud beta network-connectivity hubs groups list --hub=my-hub + +REQUIRED FLAGS + Hub resource - Parent hub of the groups to display. This represents a + Cloud resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --hub 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. + + --hub=HUB + ID of the hub or fully qualified identifier for the hub. + + To set the hub attribute: + ▸ provide the argument --hub on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkconnectivity/v1beta API. The full + documentation for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud network-connectivity hubs groups list + diff --git a/gcloud/beta/network-connectivity/hubs/groups/remove-iam-policy-binding b/gcloud/beta/network-connectivity/hubs/groups/remove-iam-policy-binding new file mode 100644 index 000000000..1a8d77e80 --- /dev/null +++ b/gcloud/beta/network-connectivity/hubs/groups/remove-iam-policy-binding @@ -0,0 +1,94 @@ +NAME + gcloud beta network-connectivity hubs groups remove-iam-policy-binding - + remove an IAM policy binding from the IAM policy of a group resource + +SYNOPSIS + gcloud beta network-connectivity hubs groups remove-iam-policy-binding + (GROUP : --hub=HUB) --member=PRINCIPAL --role=ROLE + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Remove an IAM policy binding from the IAM policy of a group + resource. + +EXAMPLES + To remove the roles/networkconnectivity.groupUser role from a user of the + group my-group in the hub my-hub, run: + + $ gcloud beta network-connectivity hubs groups \ + remove-iam-policy-binding my-group \ + --member="user:username@gmail.com" \ + --role="roles/networkconnectivity.groupUser" --hub="my-hub" + +POSITIONAL ARGUMENTS + Group resource - The group that you want to update. The arguments in this + group can be used to specify the attributes of this resource. (NOTE) Some + attributes are not given arguments in this group but can be set in other + ways. + + To set the project attribute: + ◆ provide the argument group 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. + + GROUP + ID of the group or fully qualified identifier for the group. + + To set the group attribute: + ▸ provide the argument group on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --hub=HUB + Id of the hub. + + To set the hub attribute: + ▸ provide the argument group on the command line with a fully + specified name; + ▸ provide the argument --hub on the command line. + +REQUIRED FLAGS + --member=PRINCIPAL + The principal to remove the binding for. Should be of the form + user|group|serviceAccount:email or domain:domain. + + Examples: user:test-user@gmail.com, group:admins@example.com, + serviceAccount:test123@example.domain.com, or + domain:example.domain.com. + + Deleted principals have an additional deleted: prefix and a ?uid=UID + suffix, where UID is a unique identifier for the principal. Example: + deleted:user:test-user@gmail.com?uid=123456789012345678901. + + Some resources also accept the following special values: + ◆ allUsers - Special identifier that represents anyone who is on the + internet, with or without a Google account. + ◆ allAuthenticatedUsers - Special identifier that represents anyone + who is authenticated with a Google account or a service account. + + --role=ROLE + The role to remove the principal from. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkconnectivity/v1beta API. The full + documentation for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud network-connectivity hubs groups remove-iam-policy-binding + diff --git a/gcloud/beta/network-connectivity/hubs/groups/set-iam-policy b/gcloud/beta/network-connectivity/hubs/groups/set-iam-policy new file mode 100644 index 000000000..cd713e279 --- /dev/null +++ b/gcloud/beta/network-connectivity/hubs/groups/set-iam-policy @@ -0,0 +1,76 @@ +NAME + gcloud beta network-connectivity hubs groups set-iam-policy - set the IAM + policy of a group resource + +SYNOPSIS + gcloud beta network-connectivity hubs groups set-iam-policy + (GROUP : --hub=HUB) POLICY_FILE [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Replace the existing IAM policy of a group resource with a policy + encoded in a JSON or YAML file. + +EXAMPLES + To replace the IAM policy of a group resource with the policy defined in a + file called policy.json, run: + + $ gcloud beta network-connectivity hubs groups set-iam-policy \ + my-group policy.json --hub="my-hub" + +POSITIONAL ARGUMENTS + Group resource - The hub for which to set the IAM policy. The arguments in + this group can be used to specify the attributes of this resource. (NOTE) + Some attributes are not given arguments in this group but can be set in + other ways. + + To set the project attribute: + ◆ provide the argument group 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. + + GROUP + ID of the group or fully qualified identifier for the group. + + To set the group attribute: + ▸ provide the argument group on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --hub=HUB + Id of the hub. + + To set the hub attribute: + ▸ provide the argument group on the command line with a fully + specified name; + ▸ provide the argument --hub on the command line. + + POLICY_FILE + Path to a local JSON or YAML formatted file containing a valid policy. + + The output of the get-iam-policy command is a valid file, as is any + JSON or YAML file conforming to the structure of a Policy + (https://cloud.google.com/iam/reference/rest/v1/Policy). + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkconnectivity/v1beta API. The full + documentation for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud network-connectivity hubs groups set-iam-policy + diff --git a/gcloud/beta/network-connectivity/hubs/help b/gcloud/beta/network-connectivity/hubs/help new file mode 100644 index 000000000..17270b284 --- /dev/null +++ b/gcloud/beta/network-connectivity/hubs/help @@ -0,0 +1,64 @@ +NAME + gcloud beta network-connectivity hubs - manage Network Connectivity Center + hubs + +SYNOPSIS + gcloud beta network-connectivity hubs GROUP | COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Manage Network Connectivity Center hubs. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + groups + (BETA) Manage Network Connectivity Center groups. + + route-tables + (BETA) Manage Network Connectivity Center route tables. + +COMMANDS + COMMAND is one of the following: + + add-iam-policy-binding + (BETA) Add an IAM policy binding to the IAM policy of a hub resource. + + create + (BETA) Create a new hub. + + delete + (BETA) Delete a hub. + + describe + (BETA) Describe a hub. + + get-iam-policy + (BETA) Get the IAM policy for a hub resource. + + list + (BETA) List hubs. + + remove-iam-policy-binding + (BETA) Remove an IAM policy binding from the IAM policy of a hub + resource. + + set-iam-policy + (BETA) Set the IAM policy of a hub resource. + + update + (BETA) Update a hub. + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-connectivity hubs + + $ gcloud alpha network-connectivity hubs + diff --git a/gcloud/beta/network-connectivity/hubs/list b/gcloud/beta/network-connectivity/hubs/list new file mode 100644 index 000000000..ec9f9beee --- /dev/null +++ b/gcloud/beta/network-connectivity/hubs/list @@ -0,0 +1,63 @@ +NAME + gcloud beta network-connectivity hubs list - list hubs + +SYNOPSIS + gcloud beta network-connectivity hubs list [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Retrieve and display a list of all hubs in the specified project. + +EXAMPLES + To list all hubs, run: + + $ gcloud beta network-connectivity hubs list + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkconnectivity/v1beta API. The full + documentation for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-connectivity hubs list + + $ gcloud alpha network-connectivity hubs list + diff --git a/gcloud/beta/network-connectivity/hubs/remove-iam-policy-binding b/gcloud/beta/network-connectivity/hubs/remove-iam-policy-binding new file mode 100644 index 000000000..135d25f86 --- /dev/null +++ b/gcloud/beta/network-connectivity/hubs/remove-iam-policy-binding @@ -0,0 +1,79 @@ +NAME + gcloud beta network-connectivity hubs remove-iam-policy-binding - remove an + IAM policy binding from the IAM policy of a hub resource + +SYNOPSIS + gcloud beta network-connectivity hubs remove-iam-policy-binding HUB + --member=PRINCIPAL --role=ROLE [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Remove an IAM policy binding from the IAM policy of a hub resource. + +EXAMPLES + To remove the roles/networkconnectivity.groupUser role from a user of the + hub my-hub, run: + + $ gcloud beta network-connectivity hubs remove-iam-policy-binding \ + my-hub --member="user:username@gmail.com" \ + --role="roles/networkconnectivity.groupUser" + +POSITIONAL ARGUMENTS + Hub resource - The hub that you want to update. 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 hub 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. + + HUB + ID of the hub or fully qualified identifier for the hub. + + To set the hub attribute: + ▸ provide the argument hub on the command line. + +REQUIRED FLAGS + --member=PRINCIPAL + The principal to remove the binding for. Should be of the form + user|group|serviceAccount:email or domain:domain. + + Examples: user:test-user@gmail.com, group:admins@example.com, + serviceAccount:test123@example.domain.com, or + domain:example.domain.com. + + Deleted principals have an additional deleted: prefix and a ?uid=UID + suffix, where UID is a unique identifier for the principal. Example: + deleted:user:test-user@gmail.com?uid=123456789012345678901. + + Some resources also accept the following special values: + ◆ allUsers - Special identifier that represents anyone who is on the + internet, with or without a Google account. + ◆ allAuthenticatedUsers - Special identifier that represents anyone + who is authenticated with a Google account or a service account. + + --role=ROLE + The role to remove the principal from. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkconnectivity/v1beta API. The full + documentation for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud network-connectivity hubs remove-iam-policy-binding + diff --git a/gcloud/beta/network-connectivity/hubs/route-tables/describe b/gcloud/beta/network-connectivity/hubs/route-tables/describe new file mode 100644 index 000000000..d259605b2 --- /dev/null +++ b/gcloud/beta/network-connectivity/hubs/route-tables/describe @@ -0,0 +1,68 @@ +NAME + gcloud beta network-connectivity hubs route-tables describe - describe a + route table + +SYNOPSIS + gcloud beta network-connectivity hubs route-tables describe + (ROUTE_TABLE : --hub=HUB) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Retrieve and display details about a route table. + +EXAMPLES + To display details about a route table named my-route-table, run: + + $ gcloud beta network-connectivity hubs route-tables describe \ + my-route-table + +POSITIONAL ARGUMENTS + Route table resource - Name of the route table to describe. The arguments + in this group can be used to specify the attributes of this resource. + (NOTE) Some attributes are not given arguments in this group but can be + set in other ways. + + To set the project attribute: + ◆ provide the argument route_table 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. + + ROUTE_TABLE + ID of the route table or fully qualified identifier for the route + table. + + To set the route_table attribute: + ▸ provide the argument route_table on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --hub=HUB + Id of the hub. + + To set the hub attribute: + ▸ provide the argument route_table on the command line with a fully + specified name; + ▸ provide the argument --hub on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkconnectivity/v1beta API. The full + documentation for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud network-connectivity hubs route-tables describe + diff --git a/gcloud/beta/network-connectivity/hubs/route-tables/help b/gcloud/beta/network-connectivity/hubs/route-tables/help new file mode 100644 index 000000000..8f88840aa --- /dev/null +++ b/gcloud/beta/network-connectivity/hubs/route-tables/help @@ -0,0 +1,37 @@ +NAME + gcloud beta network-connectivity hubs route-tables - manage Network + Connectivity Center route tables + +SYNOPSIS + gcloud beta network-connectivity hubs route-tables GROUP | COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Manage Network Connectivity Center route tables. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + routes + (BETA) Manage Network Connectivity Center routes. + +COMMANDS + COMMAND is one of the following: + + describe + (BETA) Describe a route table. + + list + (BETA) List route tables. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud network-connectivity hubs route-tables + diff --git a/gcloud/beta/network-connectivity/hubs/route-tables/list b/gcloud/beta/network-connectivity/hubs/route-tables/list new file mode 100644 index 000000000..790c145be --- /dev/null +++ b/gcloud/beta/network-connectivity/hubs/route-tables/list @@ -0,0 +1,86 @@ +NAME + gcloud beta network-connectivity hubs route-tables list - list route tables + +SYNOPSIS + gcloud beta network-connectivity hubs route-tables list --hub=HUB + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Retrieve and display a list of all route tables in the specified + hub. + +EXAMPLES + To list all route tables across all hubs, run: + + $ gcloud beta network-connectivity hubs route-tables list --hub=- + + To list all route tables in hub my-hub, run: + + $ gcloud beta network-connectivity hubs route-tables list \ + --hub=my-hub + +REQUIRED FLAGS + Hub resource - Parent hub of the route tables to display. This represents + a Cloud resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --hub 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. + + --hub=HUB + ID of the hub or fully qualified identifier for the hub. + + To set the hub attribute: + ▸ provide the argument --hub on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkconnectivity/v1beta API. The full + documentation for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud network-connectivity hubs route-tables list + diff --git a/gcloud/beta/network-connectivity/hubs/route-tables/routes/describe b/gcloud/beta/network-connectivity/hubs/route-tables/routes/describe new file mode 100644 index 000000000..4c735af6d --- /dev/null +++ b/gcloud/beta/network-connectivity/hubs/route-tables/routes/describe @@ -0,0 +1,75 @@ +NAME + gcloud beta network-connectivity hubs route-tables routes describe - + describe a route + +SYNOPSIS + gcloud beta network-connectivity hubs route-tables routes describe + (ROUTE : --hub=HUB --route_table=ROUTE_TABLE) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Retrieve and display details about a route. + +EXAMPLES + To display details about a route named my-route, run: + + $ gcloud beta network-connectivity hubs route-tables routes \ + describe my-route + +POSITIONAL ARGUMENTS + Route resource - Name of the route to describe. The arguments in this + group can be used to specify the attributes of this resource. (NOTE) Some + attributes are not given arguments in this group but can be set in other + ways. + + To set the project attribute: + ◆ provide the argument route 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. + + ROUTE + ID of the route or fully qualified identifier for the route. + + To set the route attribute: + ▸ provide the argument route on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --hub=HUB + Id of the hub. + + To set the hub attribute: + ▸ provide the argument route on the command line with a fully + specified name; + ▸ provide the argument --hub on the command line. + + --route_table=ROUTE_TABLE + Id of the route table. + + To set the route_table attribute: + ▸ provide the argument route on the command line with a fully + specified name; + ▸ provide the argument --route_table on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkconnectivity/v1beta API. The full + documentation for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud network-connectivity hubs route-tables routes describe + diff --git a/gcloud/beta/network-connectivity/hubs/route-tables/routes/help b/gcloud/beta/network-connectivity/hubs/route-tables/routes/help new file mode 100644 index 000000000..c8b217fcd --- /dev/null +++ b/gcloud/beta/network-connectivity/hubs/route-tables/routes/help @@ -0,0 +1,31 @@ +NAME + gcloud beta network-connectivity hubs route-tables routes - manage Network + Connectivity Center routes + +SYNOPSIS + gcloud beta network-connectivity hubs route-tables routes COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Manage Network Connectivity Center routes. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + (BETA) Describe a route. + + list + (BETA) List routes. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud network-connectivity hubs route-tables routes + diff --git a/gcloud/beta/network-connectivity/hubs/route-tables/routes/list b/gcloud/beta/network-connectivity/hubs/route-tables/routes/list new file mode 100644 index 000000000..594186100 --- /dev/null +++ b/gcloud/beta/network-connectivity/hubs/route-tables/routes/list @@ -0,0 +1,102 @@ +NAME + gcloud beta network-connectivity hubs route-tables routes list - list + routes + +SYNOPSIS + gcloud beta network-connectivity hubs route-tables routes list + (--route_table=ROUTE_TABLE : --hub=HUB) [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Retrieve and display a list of all routes in the specified route + table. + +EXAMPLES + To list all routes across all route tables, run: + + $ gcloud beta network-connectivity hubs route-tables routes list \ + --hub=- --route_table=- + + To list all routes in route table my-route-table, run: + + $ gcloud beta network-connectivity hubs route-tables routes list \ + --hub=my-hub --route_table=my-route-table + +REQUIRED FLAGS + Route table resource - Parent route table of the routes to display. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument --route_table 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. + + --route_table=ROUTE_TABLE + ID of the route table or fully qualified identifier for the route + table. + + To set the route_table attribute: + ▸ provide the argument --route_table on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --hub=HUB + Id of the hub. + + To set the hub attribute: + ▸ provide the argument --route_table on the command line with a + fully specified name; + ▸ provide the argument --hub on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkconnectivity/v1beta API. The full + documentation for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud network-connectivity hubs route-tables routes list + diff --git a/gcloud/beta/network-connectivity/hubs/set-iam-policy b/gcloud/beta/network-connectivity/hubs/set-iam-policy new file mode 100644 index 000000000..8cdf6422a --- /dev/null +++ b/gcloud/beta/network-connectivity/hubs/set-iam-policy @@ -0,0 +1,64 @@ +NAME + gcloud beta network-connectivity hubs set-iam-policy - set the IAM policy + of a hub resource + +SYNOPSIS + gcloud beta network-connectivity hubs set-iam-policy HUB POLICY_FILE + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Replace the existing IAM policy of a hub resource with a policy + encoded in a JSON or YAML file. + +EXAMPLES + To replace the IAM policy of a hub resource with the policy defined in a + file called policy.json, run: + + $ gcloud beta network-connectivity hubs set-iam-policy my-hub \ + policy.json + +POSITIONAL ARGUMENTS + Hub resource - The hub for which to set the IAM policy. 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 hub 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. + + HUB + ID of the hub or fully qualified identifier for the hub. + + To set the hub attribute: + ▸ provide the argument hub on the command line. + + POLICY_FILE + Path to a local JSON or YAML formatted file containing a valid policy. + + The output of the get-iam-policy command is a valid file, as is any + JSON or YAML file conforming to the structure of a Policy + (https://cloud.google.com/iam/reference/rest/v1/Policy). + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkconnectivity/v1beta API. The full + documentation for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud network-connectivity hubs set-iam-policy + diff --git a/gcloud/beta/network-connectivity/hubs/update b/gcloud/beta/network-connectivity/hubs/update new file mode 100644 index 000000000..5013b6aab --- /dev/null +++ b/gcloud/beta/network-connectivity/hubs/update @@ -0,0 +1,98 @@ +NAME + gcloud beta network-connectivity hubs update - update a hub + +SYNOPSIS + gcloud beta network-connectivity hubs update HUB [--async] + [--description=DESCRIPTION] [--export-psc] + [--update-labels=[KEY=VALUE,...]] + [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Update the details of a hub. + +EXAMPLES + To update the description of a hub named my-hub, run: + + $ gcloud beta network-connectivity hubs update my-hub \ + --description="The new description of my-hub". + +POSITIONAL ARGUMENTS + Hub resource - Name of the hub to be updated. 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 hub 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. + + HUB + ID of the hub or fully qualified identifier for the hub. + + To set the hub attribute: + ▸ provide the argument hub on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + New description of the hub. + + --export-psc + Whether Private Service Connect transitivity is enabled for the hub. + + --update-labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to update. If a label exists, its value + is modified. Otherwise, a new label is created. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + At most one of these can be specified: + + --clear-labels + Remove all labels. If --update-labels is also specified then + --clear-labels is applied first. + + For example, to remove all labels: + + $ gcloud beta network-connectivity hubs update --clear-labels + + To remove all existing labels and create two new labels, foo and baz: + + $ gcloud beta network-connectivity hubs update --clear-labels \ + --update-labels foo=bar,baz=qux + + --remove-labels=[KEY,...] + List of label keys to remove. If a label does not exist it is + silently ignored. If --update-labels is also specified then + --update-labels is applied first. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkconnectivity/v1beta API. The full + documentation for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-connectivity hubs update + + $ gcloud alpha network-connectivity hubs update + diff --git a/gcloud/beta/network-security/address-groups/create b/gcloud/beta/network-security/address-groups/create index fcc2156d5..8948923fb 100644 --- a/gcloud/beta/network-security/address-groups/create +++ b/gcloud/beta/network-security/address-groups/create @@ -6,7 +6,8 @@ SYNOPSIS gcloud beta network-security address-groups create (ADDRESS_GROUP : --location=LOCATION) --capacity=CAPACITY --type=TYPE [--async] [--description=DESCRIPTION] [--items=[ITEMS,...]] - [--labels=[KEY=VALUE,...]] [GCLOUD_WIDE_FLAG ...] + [--labels=[KEY=VALUE,...]] [--purpose=[PURPOSE,...]] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Create a new address group with the given name. @@ -72,6 +73,10 @@ OPTIONAL FLAGS --labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to add. + --purpose=[PURPOSE,...] + List of Address Group purposes. PURPOSE must be one of: cloud-armor, + default. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/beta/network-security/address-groups/update b/gcloud/beta/network-security/address-groups/update index e7ce6d1d0..04b0fe40e 100644 --- a/gcloud/beta/network-security/address-groups/update +++ b/gcloud/beta/network-security/address-groups/update @@ -6,7 +6,7 @@ SYNOPSIS gcloud beta network-security address-groups update (ADDRESS_GROUP : --location=LOCATION) [--async] [--description=DESCRIPTION] [--items=[ITEMS,...]] - [--update-labels=[KEY=VALUE,...]] + [--purpose=[PURPOSE,...]] [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -61,6 +61,10 @@ FLAGS --items=[ITEMS,...] Items of the address group. + --purpose=[PURPOSE,...] + List of Address Group purposes. PURPOSE must be one of: cloud-armor, + default. + --update-labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to update. If a label exists, its value is modified. Otherwise, a new label is created. diff --git a/gcloud/beta/secrets/add-iam-policy-binding b/gcloud/beta/secrets/add-iam-policy-binding index 0ca8e060c..96772d2eb 100644 --- a/gcloud/beta/secrets/add-iam-policy-binding +++ b/gcloud/beta/secrets/add-iam-policy-binding @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud beta secrets add-iam-policy-binding SECRET --member=PRINCIPAL - --role=ROLE + --role=ROLE [--location=LOCATION] [--condition=[KEY=VALUE,...] | --condition-from-file=CONDITION_FROM_FILE] [GCLOUD_WIDE_FLAG ...] @@ -24,9 +24,9 @@ EXAMPLES policy role and member types. POSITIONAL ARGUMENTS - Secret resource - The secret to add iam policy. This represents a Cloud - resource. (NOTE) Some attributes are not given arguments in this group but - can be set in other ways. + Secret resource - Name of the secret for which to add the IAM policy + binding. 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 SECRET on the command line with a fully @@ -64,6 +64,22 @@ REQUIRED FLAGS organizations/{ORGANIZATION_ID}/roles/logging.viewer. OPTIONAL FLAGS + Location resource - The location to add iam policy. This represents a + Cloud resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + At most one of these can be specified: --condition=[KEY=VALUE,...] diff --git a/gcloud/beta/secrets/create b/gcloud/beta/secrets/create index edd3996d7..9b0898dbf 100644 --- a/gcloud/beta/secrets/create +++ b/gcloud/beta/secrets/create @@ -3,8 +3,10 @@ NAME SYNOPSIS gcloud beta secrets create SECRET [--data-file=PATH] - [--labels=[KEY=VALUE,...]] [--set-annotations=[KEY=VALUE,...]] - [--topics=[TOPICS,...]] [--version-destroy-ttl=VERSION-DESTROY-TTL] + [--labels=[KEY=VALUE,...]] [--location=LOCATION] + [--regional-kms-key-name=KMS-KEY-NAME] + [--set-annotations=[KEY=VALUE,...]] [--topics=[TOPICS,...]] + [--version-destroy-ttl=VERSION-DESTROY-TTL] [--expire-time=EXPIRE-TIME | --ttl=TTL] [--next-rotation-time=NEXT_ROTATION_TIME --rotation-period=ROTATION_PERIOD] @@ -109,6 +111,26 @@ FLAGS contain only hyphens (-), underscores (_), lowercase characters, and numbers. + Location resource - The location to create secret. This represents a Cloud + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + + --regional-kms-key-name=KMS-KEY-NAME + Regional KMS key with which to encrypt and decrypt the secret. Only + valid for regional secrets. + Annotations --set-annotations=[KEY=VALUE,...] diff --git a/gcloud/beta/secrets/delete b/gcloud/beta/secrets/delete index 8143734e0..b53f4ddc7 100644 --- a/gcloud/beta/secrets/delete +++ b/gcloud/beta/secrets/delete @@ -2,7 +2,8 @@ NAME gcloud beta secrets delete - delete a secret SYNOPSIS - gcloud beta secrets delete SECRET [--etag=ETAG] [GCLOUD_WIDE_FLAG ...] + gcloud beta secrets delete SECRET [--etag=ETAG] [--location=LOCATION] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Delete a secret and destroy all secret versions. This action is @@ -43,6 +44,22 @@ FLAGS secret is updated only if the ETag provided matched the current secret's ETag. + Location resource - The location to delete secret. This represents a Cloud + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + 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/secrets/describe b/gcloud/beta/secrets/describe index baf728e78..c26865f7e 100644 --- a/gcloud/beta/secrets/describe +++ b/gcloud/beta/secrets/describe @@ -2,7 +2,8 @@ NAME gcloud beta secrets describe - describe a secret's metadata SYNOPSIS - gcloud beta secrets describe SECRET [GCLOUD_WIDE_FLAG ...] + gcloud beta secrets describe SECRET [--location=LOCATION] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Describe a secret's metadata. @@ -31,6 +32,23 @@ POSITIONAL ARGUMENTS To set the secret attribute: ▸ provide the argument SECRET on the command line. +FLAGS + Location resource - The location to describe. This represents a Cloud + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + 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/secrets/get-iam-policy b/gcloud/beta/secrets/get-iam-policy index af2a50854..3363b170d 100644 --- a/gcloud/beta/secrets/get-iam-policy +++ b/gcloud/beta/secrets/get-iam-policy @@ -2,9 +2,9 @@ NAME gcloud beta secrets get-iam-policy - get the IAM policy of a secret SYNOPSIS - gcloud beta secrets get-iam-policy SECRET [--filter=EXPRESSION] - [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] - [GCLOUD_WIDE_FLAG ...] + gcloud beta secrets get-iam-policy SECRET [--location=LOCATION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Gets the IAM policy for the given secret. @@ -17,9 +17,9 @@ EXAMPLES $ gcloud beta secrets get-iam-policy my-secret [--location=] POSITIONAL ARGUMENTS - Secret resource - The secret to get iam policy. This represents a Cloud - resource. (NOTE) Some attributes are not given arguments in this group but - can be set in other ways. + Secret resource - Name of the secret from which to get IAM policy. 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 SECRET on the command line with a fully @@ -35,6 +35,23 @@ POSITIONAL ARGUMENTS To set the secret attribute: ▸ provide the argument SECRET on the command line. +FLAGS + Location resource - The location to get iam policy. This represents a + Cloud resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + LIST COMMAND FLAGS --filter=EXPRESSION Apply a Boolean filter EXPRESSION to each resource item to be listed. diff --git a/gcloud/beta/secrets/list b/gcloud/beta/secrets/list index b5441c52a..e9b2fb65c 100644 --- a/gcloud/beta/secrets/list +++ b/gcloud/beta/secrets/list @@ -2,9 +2,9 @@ NAME gcloud beta secrets list - list all secret names SYNOPSIS - gcloud beta secrets list [--filter=EXPRESSION] [--limit=LIMIT] - [--page-size=PAGE_SIZE; default=100] [--sort-by=[FIELD,...]] [--uri] - [GCLOUD_WIDE_FLAG ...] + gcloud beta secrets list [--location=LOCATION] [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE; default=100] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) List all secret names. This command only returns the secret's names, @@ -16,6 +16,23 @@ EXAMPLES $ gcloud beta secrets list +FLAGS + Location resource - The location to list regional secrets. This represents + a Cloud resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + LIST COMMAND FLAGS --filter=EXPRESSION Apply a Boolean filter EXPRESSION to each resource item to be listed. diff --git a/gcloud/beta/secrets/remove-iam-policy-binding b/gcloud/beta/secrets/remove-iam-policy-binding index 0d6304a20..1013f8fad 100644 --- a/gcloud/beta/secrets/remove-iam-policy-binding +++ b/gcloud/beta/secrets/remove-iam-policy-binding @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud beta secrets remove-iam-policy-binding SECRET --member=PRINCIPAL - --role=ROLE + --role=ROLE [--location=LOCATION] [--all | --condition=[KEY=VALUE,...] | --condition-from-file=CONDITION_FROM_FILE] [GCLOUD_WIDE_FLAG ...] @@ -19,9 +19,9 @@ EXAMPLES --member='user:test-user@gmail.com' --role='roles/viewer' POSITIONAL ARGUMENTS - Secret resource - The secret to remove iam policy. This represents a Cloud - resource. (NOTE) Some attributes are not given arguments in this group but - can be set in other ways. + Secret resource - Name of the secret from which to remove IAM policy + binding. 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 SECRET on the command line with a fully @@ -60,6 +60,22 @@ REQUIRED FLAGS The role to remove the principal from. OPTIONAL FLAGS + Location resource - The location to remove iam policy. This represents a + Cloud resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + At most one of these can be specified: --all diff --git a/gcloud/beta/secrets/set-iam-policy b/gcloud/beta/secrets/set-iam-policy index 0f785be71..0b95ff23f 100644 --- a/gcloud/beta/secrets/set-iam-policy +++ b/gcloud/beta/secrets/set-iam-policy @@ -2,7 +2,7 @@ NAME gcloud beta secrets set-iam-policy - set the IAM policy for a secret SYNOPSIS - gcloud beta secrets set-iam-policy SECRET POLICY_FILE + gcloud beta secrets set-iam-policy SECRET POLICY_FILE [--location=LOCATION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -16,9 +16,9 @@ EXAMPLES $ gcloud beta secrets set-iam-policy my-secret [--location=] POSITIONAL ARGUMENTS - Secret resource - The secret to set iam policy. This represents a Cloud - resource. (NOTE) Some attributes are not given arguments in this group but - can be set in other ways. + Secret resource - Name of the secret for which to set the IAM policy. 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 SECRET on the command line with a fully @@ -41,6 +41,23 @@ POSITIONAL ARGUMENTS JSON or YAML file conforming to the structure of a Policy (https://cloud.google.com/iam/reference/rest/v1/Policy). +FLAGS + Location resource - The location to set iam policy. This represents a + Cloud resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + 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/secrets/update b/gcloud/beta/secrets/update index 96c34486d..d2c6faefa 100644 --- a/gcloud/beta/secrets/update +++ b/gcloud/beta/secrets/update @@ -2,7 +2,7 @@ NAME gcloud beta secrets update - update a secret's metadata SYNOPSIS - gcloud beta secrets update SECRET [--etag=ETAG] + gcloud beta secrets update SECRET [--etag=ETAG] [--location=LOCATION] [--update-labels=[KEY=VALUE,...]] [--add-topics=[ADD-TOPICS,...] | --clear-topics | --remove-topics=[REMOVE-TOPICS,...]] @@ -15,6 +15,8 @@ SYNOPSIS [--next-rotation-time=NEXT_ROTATION_TIME --remove-next-rotation-time --remove-rotation-period --remove-rotation-schedule --rotation-period=ROTATION_PERIOD] + [--regional-kms-key-name=REGIONAL-KMS-KEY-NAME + | --remove-regional-kms-key-name] [--remove-version-destroy-ttl | --version-destroy-ttl=VERSION-DESTROY-TTL] [GCLOUD_WIDE_FLAG ...] @@ -97,6 +99,22 @@ FLAGS secret is updated only if the ETag provided matched the current secret's ETag. + Location resource - The location to update secret. This represents a Cloud + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + --update-labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to update. If a label exists, its value is modified. Otherwise, a new label is created. @@ -197,6 +215,16 @@ FLAGS --rotation-period=ROTATION_PERIOD Duration of time (in seconds) between rotation notifications. + regional kms key. + + At most one of these can be specified: + + --regional-kms-key-name=REGIONAL-KMS-KEY-NAME + regional kms key name for regional secret. + + --remove-regional-kms-key-name + If set, removes the regional kms key. + Version destroy ttl. At most one of these can be specified: diff --git a/gcloud/beta/secrets/versions/access b/gcloud/beta/secrets/versions/access index 0ef4a748d..e368826dc 100644 --- a/gcloud/beta/secrets/versions/access +++ b/gcloud/beta/secrets/versions/access @@ -3,7 +3,7 @@ NAME SYNOPSIS gcloud beta secrets versions access (VERSION : --secret=SECRET) - [--out-file=OUT-FILE-PATH] [GCLOUD_WIDE_FLAG ...] + [--location=LOCATION] [--out-file=OUT-FILE-PATH] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Access the data for the specified secret version. @@ -60,6 +60,22 @@ POSITIONAL ARGUMENTS ▸ provide the argument --secret on the command line. FLAGS + Location resource - The location to access secret. This represents a Cloud + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + --out-file=OUT-FILE-PATH File path to which secret data is written. If this flag is not provided secret data will be written to stdout in UTF-8 format. diff --git a/gcloud/beta/secrets/versions/add b/gcloud/beta/secrets/versions/add index a0dcb4e40..d9ca83505 100644 --- a/gcloud/beta/secrets/versions/add +++ b/gcloud/beta/secrets/versions/add @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud beta secrets versions add SECRET --data-file=PATH - [GCLOUD_WIDE_FLAG ...] + [--location=LOCATION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Create a new version of an existing secret with the provided data. @@ -53,6 +53,23 @@ REQUIRED FLAGS File path from which to read secret data. Set this to "-" to read the secret data from stdin. +OPTIONAL FLAGS + Location resource - The location to create secret version. This represents + a Cloud resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + 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/secrets/versions/describe b/gcloud/beta/secrets/versions/describe index 43a248274..586ea6018 100644 --- a/gcloud/beta/secrets/versions/describe +++ b/gcloud/beta/secrets/versions/describe @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud beta secrets versions describe (VERSION : --secret=SECRET) - [GCLOUD_WIDE_FLAG ...] + [--location=LOCATION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Describe a secret version's metadata. This command does not include @@ -47,6 +47,23 @@ POSITIONAL ARGUMENTS specified name; ▸ provide the argument --secret on the command line. +FLAGS + Location resource - The location to describe secret. This represents a + Cloud resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + 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/secrets/versions/destroy b/gcloud/beta/secrets/versions/destroy index 556582e1f..f16d4f952 100644 --- a/gcloud/beta/secrets/versions/destroy +++ b/gcloud/beta/secrets/versions/destroy @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud beta secrets versions destroy (VERSION : --secret=SECRET) - [--etag=ETAG] [GCLOUD_WIDE_FLAG ...] + [--etag=ETAG] [--location=LOCATION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Destroy a secret version's metadata and secret data. This action is @@ -57,6 +57,22 @@ FLAGS defined, the version is updated only if the ETag provided matched the current version's ETag. + Location resource - The location to destroy . This represents a Cloud + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + 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/secrets/versions/disable b/gcloud/beta/secrets/versions/disable index 18e93e372..8419e2ce8 100644 --- a/gcloud/beta/secrets/versions/disable +++ b/gcloud/beta/secrets/versions/disable @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud beta secrets versions disable (VERSION : --secret=SECRET) - [--etag=ETAG] [GCLOUD_WIDE_FLAG ...] + [--etag=ETAG] [--location=LOCATION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Disable the version of the provided secret. It can be re-enabled @@ -57,6 +57,22 @@ FLAGS defined, the version is updated only if the ETag provided matched the current version's ETag. + Location resource - The location to disable. This represents a Cloud + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + 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/secrets/versions/enable b/gcloud/beta/secrets/versions/enable index 7742f3b82..b9316f10c 100644 --- a/gcloud/beta/secrets/versions/enable +++ b/gcloud/beta/secrets/versions/enable @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud beta secrets versions enable (VERSION : --secret=SECRET) - [--etag=ETAG] [GCLOUD_WIDE_FLAG ...] + [--etag=ETAG] [--location=LOCATION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Enable the version of the provided secret. It can be disabled with @@ -57,6 +57,22 @@ FLAGS defined, the version is updated only if the ETag provided matched the current version's ETag. + Location resource - The location to enable. This represents a Cloud + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + 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/secrets/versions/list b/gcloud/beta/secrets/versions/list index f5bb6b6eb..6e99601d9 100644 --- a/gcloud/beta/secrets/versions/list +++ b/gcloud/beta/secrets/versions/list @@ -2,9 +2,10 @@ NAME gcloud beta secrets versions list - list all versions for a secret SYNOPSIS - gcloud beta secrets versions list SECRET [--filter=EXPRESSION] - [--limit=LIMIT] [--page-size=PAGE_SIZE; default=100] - [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + gcloud beta secrets versions list SECRET [--location=LOCATION] + [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE; default=100] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) List all versions and their status (For example: @@ -34,6 +35,23 @@ POSITIONAL ARGUMENTS To set the secret attribute: ▸ provide the argument SECRET on the command line. +FLAGS + Location resource - The location to create secret. This represents a Cloud + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + LIST COMMAND FLAGS --filter=EXPRESSION Apply a Boolean filter EXPRESSION to each resource item to be listed. diff --git a/gcloud/beta/sql/export/sql b/gcloud/beta/sql/export/sql index 173fec189..a56ec0155 100644 --- a/gcloud/beta/sql/export/sql +++ b/gcloud/beta/sql/export/sql @@ -3,9 +3,9 @@ NAME SQL file SYNOPSIS - gcloud beta sql export sql INSTANCE URI [--async] + gcloud beta sql export sql INSTANCE URI [--async] [--clean] [--database=DATABASE,[DATABASE,...], -d DATABASE,[DATABASE,...]] - [--offload] [--parallel] + [--if-exists] [--offload] [--parallel] [--table=TABLE,[TABLE,...], -t TABLE,[TABLE,...]] [--threads=THREADS] [GCLOUD_WIDE_FLAG ...] @@ -33,11 +33,21 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + --clean + Include SQL statements (DROP ) required to drop database + objects prior to import; corresponds to the clean flag for pg_dump. + Only applies to PostgreSQL non-parallel exports. + --database=DATABASE,[DATABASE,...], -d DATABASE,[DATABASE,...] Database(s) from which the export is made. Information on requirements can be found here: https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances/export#exportContext.databases + --if-exists + Include an SQL statement (IF EXISTS) with each drop statement produced + by the clean flag; corresponds to the if-exists flag for pg_dump. Only + applies to PostgreSQL non-parallel exports. + --offload Offload an export to a temporary instance. Doing so reduces strain on source instances and allows other operations to be performed while the diff --git a/gcloud/beta/sql/import/sql b/gcloud/beta/sql/import/sql index 1c32d8c2e..9ff8bad38 100644 --- a/gcloud/beta/sql/import/sql +++ b/gcloud/beta/sql/import/sql @@ -3,9 +3,9 @@ NAME SQL dump file SYNOPSIS - gcloud beta sql import sql INSTANCE URI [--async] - [--database=DATABASE, -d DATABASE] [--parallel] [--threads=THREADS] - [--user=USER] [GCLOUD_WIDE_FLAG ...] + gcloud beta sql import sql INSTANCE URI [--async] [--clean] + [--database=DATABASE, -d DATABASE] [--if-exists] [--parallel] + [--threads=THREADS] [--user=USER] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) gcloud beta sql import sql imports data into a Cloud SQL instance @@ -40,12 +40,22 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + --clean + Option to clean (DROP) database objects before recreating them. + corresponds to the clean flag for pg_restore. Only applies if + --parallel is set. PostgreSQL only. + --database=DATABASE, -d DATABASE Database to which the import is made. The database needs to be created before importing. If not set, it is assumed that the database is specified in the file to be imported. If your SQL dump file includes a database statement, it will override the database set in this flag. + --if-exists + Include an SQL statement (IF EXISTS) with each DROP statement produced + by --clean; corresponds to the if-exists flag for pg_restore. Only + applies if --parallel is set. PostgreSQL only. + --parallel Perform a parallel import. This flag is only applicable to MySQL and Postgres. diff --git a/gcloud/beta/workstations/configs/create b/gcloud/beta/workstations/configs/create index 0bd517027..6a8d39d79 100644 --- a/gcloud/beta/workstations/configs/create +++ b/gcloud/beta/workstations/configs/create @@ -28,7 +28,7 @@ SYNOPSIS [--service-account=SERVICE_ACCOUNT] [--service-account-scopes=[SERVICE_ACCOUNT_SCOPES,...]] [--shielded-integrity-monitoring] [--shielded-secure-boot] - [--shielded-vtpm] + [--shielded-vtpm] [--vm-tags=[VM_TAGS,...]] [--accelerator-count=ACCELERATOR_COUNT : --accelerator-type=ACCELERATOR_TYPE] [--container-custom-image=CONTAINER_CUSTOM_IMAGE @@ -333,6 +333,17 @@ FLAGS --shielded-vtpm Default value is false. If set, instances will have vTPM enabled. + --vm-tags=[VM_TAGS,...] + Resource manager tags to be bound to the instance. Tag keys and values + have the same definition as + https://cloud.google.com/resource-manager/docs/tags/tags-overview + + Example: + + $ gcloud beta workstations configs create \ + --vm-tags=tagKeys/key1=tagValues/value1,tagKeys/key2=tagValues/\ + value2 + Accelerator settings --accelerator-count=ACCELERATOR_COUNT diff --git a/gcloud/beta/workstations/configs/update b/gcloud/beta/workstations/configs/update index d5c8ed62a..de5aa92ac 100644 --- a/gcloud/beta/workstations/configs/update +++ b/gcloud/beta/workstations/configs/update @@ -20,7 +20,7 @@ SYNOPSIS [--service-account=SERVICE_ACCOUNT] [--service-account-scopes=[SERVICE_ACCOUNT_SCOPES,...]] [--shielded-integrity-monitoring] [--shielded-secure-boot] - [--shielded-vtpm] + [--shielded-vtpm] [--vm-tags=[VM_TAGS,...]] [--accelerator-count=ACCELERATOR_COUNT : --accelerator-type=ACCELERATOR_TYPE] [--container-custom-image=CONTAINER_CUSTOM_IMAGE @@ -281,6 +281,17 @@ FLAGS --shielded-vtpm Default value is false. If set, instances will have vTPM enabled. + --vm-tags=[VM_TAGS,...] + Resource manager tags to be bound to the instance. Tag keys and values + have the same definition as + https://cloud.google.com/resource-manager/docs/tags/tags-overview + + Example: + + $ gcloud beta workstations configs update \ + --vm-tags=tagKeys/key1=tagValues/value1,tagKeys/key2=tagValues/\ + value2 + Accelerator settings --accelerator-count=ACCELERATOR_COUNT diff --git a/gcloud/compute/backend-services/add-backend b/gcloud/compute/backend-services/add-backend index 0947e1620..8d16d6084 100644 --- a/gcloud/compute/backend-services/add-backend +++ b/gcloud/compute/backend-services/add-backend @@ -13,7 +13,8 @@ SYNOPSIS | --network-endpoint-group-zone=NETWORK_ENDPOINT_GROUP_ZONE]) [--balancing-mode=BALANCING_MODE] [--capacity-scaler=CAPACITY_SCALER] [--description=DESCRIPTION] [--failover] - [--max-utilization=MAX_UTILIZATION] [--global | --region=REGION] + [--max-utilization=MAX_UTILIZATION] [--preference=PREFERENCE] + [--global | --region=REGION] [--max-connections=MAX_CONNECTIONS | --max-connections-per-endpoint=MAX_CONNECTIONS_PER_ENDPOINT | --max-connections-per-instance=MAX_CONNECTIONS_PER_INSTANCE @@ -231,6 +232,24 @@ OPTIONAL FLAGS capacity. For usage guidelines, see Balancing mode combinations (https://cloud.google.com/load-balancing/docs/backend-service#balancing-mode-combos). + --preference=PREFERENCE + This parameter specifies whether a backend should be fully utilized + before sending traffic to backends with the default preference. This + parameter cannot be used with regional managed instance groups and when + the endpoint type of an attached network endpoint group is + INTERNET_IP_PORT, INTERNET_FQDN_PORT, or SERVERLESS. PREFERENCE must be + one of: + + DEFAULT + This is the default setting. If the designated preferred backends + don't have enough capacity, backends in the default category are + used. Traffic is distributed between default backends based on the + load balancing algorithm used. + + PREFERRED + Backends with this preference setting are used up to their capacity + limits first, while optimizing overall network latency. + At most one of these can be specified: --global diff --git a/gcloud/compute/backend-services/create b/gcloud/compute/backend-services/create index 3c3269ed5..5a36aed3b 100644 --- a/gcloud/compute/backend-services/create +++ b/gcloud/compute/backend-services/create @@ -33,6 +33,7 @@ SYNOPSIS [--network=NETWORK] [--port-name=PORT_NAME] [--protocol=PROTOCOL] [--[no-]request-coalescing] [--serve-while-stale=SERVE_WHILE_STALE] [--service-bindings=SERVICE_BINDING,[...]] + [--service-lb-policy=SERVICE_LOAD_BALANCING_POLICY] [--session-affinity=SESSION_AFFINITY] [--signed-url-cache-max-age=SIGNED_URL_CACHE_MAX_AGE] [--subsetting-policy=SUBSETTING_POLICY; default="NONE"] @@ -553,6 +554,12 @@ FLAGS only be set if load balancing scheme is INTERNAL_SELF_MANAGED. If set, lists of backends and health checks must be both empty. + --service-lb-policy=SERVICE_LOAD_BALANCING_POLICY + Service load balancing policy to be applied to this backend service. + Can only be set if load balancing scheme is EXTERNAL_MANAGED, + INTERNAL_MANAGED, or INTERNAL_SELF_MANAGED. Only available for global + backend services. + --session-affinity=SESSION_AFFINITY The type of session affinity to use. Supports both TCP and UDP. SESSION_AFFINITY must be one of: diff --git a/gcloud/compute/backend-services/update b/gcloud/compute/backend-services/update index 1b17824d1..23d7d361d 100644 --- a/gcloud/compute/backend-services/update +++ b/gcloud/compute/backend-services/update @@ -47,7 +47,8 @@ SYNOPSIS | --negative-caching-policy=[[CODE=TTL],...]] [--serve-while-stale=SERVE_WHILE_STALE | --no-serve-while-stale] [--service-bindings=SERVICE_BINDING,[...] | --no-service-bindings] - [GCLOUD_WIDE_FLAG ...] + [--service-lb-policy=SERVICE_LOAD_BALANCING_POLICY + | --no-service-lb-policy] [GCLOUD_WIDE_FLAG ...] DESCRIPTION gcloud compute backend-services update is used to update backend services. @@ -779,6 +780,18 @@ FLAGS --no-service-bindings No service bindings should be attached to the backend service. + At most one of these can be specified: + + --service-lb-policy=SERVICE_LOAD_BALANCING_POLICY + Service load balancing policy to be applied to this backend service. + Can only be set if load balancing scheme is EXTERNAL_MANAGED, + INTERNAL_MANAGED, or INTERNAL_SELF_MANAGED. Only available for global + backend services. + + --no-service-lb-policy + No service load balancing policies should be attached to the backend + service. + 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/backend-services/update-backend b/gcloud/compute/backend-services/update-backend index 01840382b..8d3f66b8c 100644 --- a/gcloud/compute/backend-services/update-backend +++ b/gcloud/compute/backend-services/update-backend @@ -11,7 +11,8 @@ SYNOPSIS : --network-endpoint-group-zone=NETWORK_ENDPOINT_GROUP_ZONE]) [--balancing-mode=BALANCING_MODE] [--capacity-scaler=CAPACITY_SCALER] [--description=DESCRIPTION] [--failover] - [--max-utilization=MAX_UTILIZATION] [--global | --region=REGION] + [--max-utilization=MAX_UTILIZATION] [--preference=PREFERENCE] + [--global | --region=REGION] [--max-connections=MAX_CONNECTIONS | --max-connections-per-endpoint=MAX_CONNECTIONS_PER_ENDPOINT | --max-connections-per-instance=MAX_CONNECTIONS_PER_INSTANCE @@ -194,6 +195,24 @@ OPTIONAL FLAGS capacity. For usage guidelines, see Balancing mode combinations (https://cloud.google.com/load-balancing/docs/backend-service#balancing-mode-combos). + --preference=PREFERENCE + This parameter specifies whether a backend should be fully utilized + before sending traffic to backends with the default preference. This + parameter cannot be used with regional managed instance groups and when + the endpoint type of an attached network endpoint group is + INTERNET_IP_PORT, INTERNET_FQDN_PORT, or SERVERLESS. PREFERENCE must be + one of: + + DEFAULT + This is the default setting. If the designated preferred backends + don't have enough capacity, backends in the default category are + used. Traffic is distributed between default backends based on the + load balancing algorithm used. + + PREFERRED + Backends with this preference setting are used up to their capacity + limits first, while optimizing overall network latency. + At most one of these can be specified: --global diff --git a/gcloud/compute/instance-templates/create b/gcloud/compute/instance-templates/create index b6ca98b9d..c12f2287a 100644 --- a/gcloud/compute/instance-templates/create +++ b/gcloud/compute/instance-templates/create @@ -11,6 +11,7 @@ SYNOPSIS [--boot-disk-size=BOOT_DISK_SIZE] [--boot-disk-type=BOOT_DISK_TYPE] [--can-ip-forward] [--configure-disk=[PROPERTY=VALUE,...]] [--create-disk=[PROPERTY=VALUE,...]] [--description=DESCRIPTION] + [--discard-local-ssds-at-termination-timestamp=DISCARD_LOCAL_SSDS_AT_TERMINATION_TIMESTAMP] [--disk=[auto-delete=AUTO-DELETE], [boot=BOOT],[device-name=DEVICE-NAME],[mode=MODE],[name=NAME]] [--[no-]enable-nested-virtualization] [--[no-]enable-uefi-networking] @@ -26,6 +27,7 @@ SYNOPSIS [interface=INTERFACE],[size=SIZE]] [--local-ssd-recovery-timeout=LOCAL_SSD_RECOVERY_TIMEOUT] [--machine-type=MACHINE_TYPE] [--maintenance-policy=MAINTENANCE_POLICY] + [--max-run-duration=MAX_RUN_DURATION] [--metadata=KEY=VALUE,[KEY=VALUE,...]] [--metadata-from-file=KEY=LOCAL_FILE_PATH,[...]] [--min-cpu-platform=PLATFORM] [--min-node-cpu=MIN_NODE_CPU] @@ -43,6 +45,7 @@ SYNOPSIS [--shielded-vtpm] [--source-instance=SOURCE_INSTANCE] [--source-instance-zone=SOURCE_INSTANCE_ZONE] [--stack-type=STACK_TYPE] [--subnet=SUBNET] [--tags=TAG,[TAG,...]] + [--termination-time=TERMINATION_TIME] [--threads-per-core=THREADS_PER_CORE] [--visible-core-count=VISIBLE_CORE_COUNT] [--address=ADDRESS | --no-address] @@ -319,6 +322,20 @@ FLAGS --description=DESCRIPTION Specifies a textual description for the instance template. + --discard-local-ssds-at-termination-timestamp=DISCARD_LOCAL_SSDS_AT_TERMINATION_TIMESTAMP + Required to be set to true and only allowed for VMs that have one or + more local SSDs, use --instance-termination-action=STOP, and use either + --max-run-duration or --termination-time. + + This flag indicates the value that you want Compute Engine to use for + the --discard-local-ssd flag in the automatic gcloud compute instances + stop command. This flag only supports the true value, which discards + local SSD data when automatically stopping this VM during its + terminationTimestamp. + + For more information about the --discard-local-ssd flag, see + https://cloud.google.com/compute/docs/disks/local-ssd#stop_instance. + --disk=[auto-delete=AUTO-DELETE],[boot=BOOT],[device-name=DEVICE-NAME],[mode=MODE],[name=NAME] Attaches an existing persistent disk to the instances. @@ -471,6 +488,28 @@ FLAGS TERMINATE The instances should be terminated. + --max-run-duration=MAX_RUN_DURATION + Limits how long this VM instance can run, specified as a duration + relative to the last time when the VM began running. Format the + duration, MAX_RUN_DURATION, as the number of days, hours, minutes, and + seconds followed by d, h, m, and s respectively. For example, specify + 30m for a duration of 30 minutes or specify 1d2h3m4s for a duration of + 1 day, 2 hours, 3 minutes, and 4 seconds. Alternatively, to specify a + timestamp, use --termination-time instead. + + If neither --max-run-duration nor --termination-time is specified + (default), the VM instance runs until prompted by a user action or + system event. If either is specified, the VM instance is scheduled to + be automatically terminated at the VM's termination timestamp + (terminationTimestamp) using the action specified by + --instance-termination-action. + + Note: The terminationTimestamp is removed whenever the VM is stopped or + suspended and redefined whenever the VM is rerun. For + --max-run-duration specifically, the terminationTimestamp is the sum of + MAX_RUN_DURATION and the time when the VM last entered the RUNNING + state, which changes whenever the VM is rerun. + --metadata=KEY=VALUE,[KEY=VALUE,...] Metadata to be made available to the guest operating system running on the instances. Each metadata entry is a key/value pair separated by an @@ -799,6 +838,25 @@ FLAGS $ gcloud compute instances list --filter='tags:tag1' + --termination-time=TERMINATION_TIME + Limits how long this VM instance can run, specified as a time. Format + the time, TERMINATION_TIME, as a RFC 3339 timestamp. For more + information, see https://tools.ietf.org/html/rfc3339. Alternatively, to + specify a duration, use --max-run-duration instead. + + If neither --termination-time nor --max-run-duration is specified + (default), the VM instance runs until prompted by a user action or + system event. If either is specified, the VM instance is scheduled to + be automatically terminated at the VM's termination timestamp + (terminationTimestamp) using the action specified by + --instance-termination-action. + + Note: The terminationTimestamp is removed whenever the VM is stopped or + suspended and redefined whenever the VM is rerun. For + --termination-time specifically, the terminationTimestamp remains the + same whenever the VM is rerun, but any requests to rerun the VM fail if + the specified timestamp is in the past. + --threads-per-core=THREADS_PER_CORE The number of visible threads per physical core. To disable simultaneous multithreading (SMT) set this to 1. Valid values are: 1 or diff --git a/gcloud/compute/instances/bulk/create b/gcloud/compute/instances/bulk/create index b18fed011..6f2b03fb7 100644 --- a/gcloud/compute/instances/bulk/create +++ b/gcloud/compute/instances/bulk/create @@ -14,6 +14,7 @@ SYNOPSIS [--boot-disk-size=BOOT_DISK_SIZE] [--boot-disk-type=BOOT_DISK_TYPE] [--can-ip-forward] [--count=COUNT] [--create-disk=[PROPERTY=VALUE,...]] [--description=DESCRIPTION] + [--discard-local-ssds-at-termination-timestamp=DISCARD_LOCAL_SSDS_AT_TERMINATION_TIMESTAMP] [--disk=[boot=BOOT], [device-name=DEVICE-NAME],[name=NAME],[scope=SCOPE]] [--[no-]enable-nested-virtualization] [--[no-]enable-uefi-networking] @@ -25,6 +26,7 @@ SYNOPSIS [--local-ssd-recovery-timeout=LOCAL_SSD_RECOVERY_TIMEOUT] [--location-policy=[ZONE=POLICY,...]] [--machine-type=MACHINE_TYPE] [--max-count-per-zone=[ZONE=MAX_COUNT_PER_ZONE,...]] + [--max-run-duration=MAX_RUN_DURATION] [--metadata=KEY=VALUE,[KEY=VALUE,...]] [--metadata-from-file=KEY=LOCAL_FILE_PATH,[...]] [--min-count=MIN_COUNT] [--min-cpu-platform=PLATFORM] @@ -41,6 +43,7 @@ SYNOPSIS [--shielded-vtpm] [--source-instance-template=SOURCE_INSTANCE_TEMPLATE] [--stack-type=STACK_TYPE] [--subnet=SUBNET] [--tags=TAG,[TAG,...]] [--target-distribution-shape=SHAPE] + [--termination-time=TERMINATION_TIME] [--threads-per-core=THREADS_PER_CORE] [--visible-core-count=VISIBLE_CORE_COUNT] [--boot-disk-kms-key=BOOT_DISK_KMS_KEY @@ -373,6 +376,20 @@ OPTIONAL FLAGS --description=DESCRIPTION Specifies a textual description of the instances. + --discard-local-ssds-at-termination-timestamp=DISCARD_LOCAL_SSDS_AT_TERMINATION_TIMESTAMP + Required to be set to true and only allowed for VMs that have one or + more local SSDs, use --instance-termination-action=STOP, and use either + --max-run-duration or --termination-time. + + This flag indicates the value that you want Compute Engine to use for + the --discard-local-ssd flag in the automatic gcloud compute instances + stop command. This flag only supports the true value, which discards + local SSD data when automatically stopping this VM during its + terminationTimestamp. + + For more information about the --discard-local-ssd flag, see + https://cloud.google.com/compute/docs/disks/local-ssd#stop_instance. + --disk=[boot=BOOT],[device-name=DEVICE-NAME],[name=NAME],[scope=SCOPE] Attaches persistent disks to the instances. The disks specified must already exist. @@ -487,6 +504,28 @@ OPTIONAL FLAGS --count=5 --region=us-east1 --max-count-per-zone=us-east1-b=2,us-east-1-c=1 + --max-run-duration=MAX_RUN_DURATION + Limits how long this VM instance can run, specified as a duration + relative to the last time when the VM began running. Format the + duration, MAX_RUN_DURATION, as the number of days, hours, minutes, and + seconds followed by d, h, m, and s respectively. For example, specify + 30m for a duration of 30 minutes or specify 1d2h3m4s for a duration of + 1 day, 2 hours, 3 minutes, and 4 seconds. Alternatively, to specify a + timestamp, use --termination-time instead. + + If neither --max-run-duration nor --termination-time is specified + (default), the VM instance runs until prompted by a user action or + system event. If either is specified, the VM instance is scheduled to + be automatically terminated at the VM's termination timestamp + (terminationTimestamp) using the action specified by + --instance-termination-action. + + Note: The terminationTimestamp is removed whenever the VM is stopped or + suspended and redefined whenever the VM is rerun. For + --max-run-duration specifically, the terminationTimestamp is the sum of + MAX_RUN_DURATION and the time when the VM last entered the RUNNING + state, which changes whenever the VM is rerun. + --metadata=KEY=VALUE,[KEY=VALUE,...] Metadata to be made available to the guest operating system running on the instances. Each metadata entry is a key/value pair separated by an @@ -743,6 +782,25 @@ OPTIONAL FLAGS to minimize the impact of zonal failures. Recommended for highly available serving or batch workloads. + --termination-time=TERMINATION_TIME + Limits how long this VM instance can run, specified as a time. Format + the time, TERMINATION_TIME, as a RFC 3339 timestamp. For more + information, see https://tools.ietf.org/html/rfc3339. Alternatively, to + specify a duration, use --max-run-duration instead. + + If neither --termination-time nor --max-run-duration is specified + (default), the VM instance runs until prompted by a user action or + system event. If either is specified, the VM instance is scheduled to + be automatically terminated at the VM's termination timestamp + (terminationTimestamp) using the action specified by + --instance-termination-action. + + Note: The terminationTimestamp is removed whenever the VM is stopped or + suspended and redefined whenever the VM is rerun. For + --termination-time specifically, the terminationTimestamp remains the + same whenever the VM is rerun, but any requests to rerun the VM fail if + the specified timestamp is in the past. + --threads-per-core=THREADS_PER_CORE The number of visible threads per physical core. To disable simultaneous multithreading (SMT) set this to 1. Valid values are: 1 or diff --git a/gcloud/compute/instances/create b/gcloud/compute/instances/create index 4f2f5d321..11b122c36 100644 --- a/gcloud/compute/instances/create +++ b/gcloud/compute/instances/create @@ -13,6 +13,7 @@ SYNOPSIS [--can-ip-forward] [--create-disk=[PROPERTY=VALUE,...]] [--csek-key-file=FILE] [--deletion-protection] [--description=DESCRIPTION] + [--discard-local-ssds-at-termination-timestamp=DISCARD_LOCAL_SSDS_AT_TERMINATION_TIMESTAMP] [--disk=[auto-delete=AUTO-DELETE],[boot=BOOT],[device-name=DEVICE-NAME], [force-attach=FORCE-ATTACH],[mode=MODE],[name=NAME],[scope=SCOPE]] [--enable-display-device] [--[no-]enable-nested-virtualization] @@ -30,6 +31,7 @@ SYNOPSIS [interface=INTERFACE],[size=SIZE]] [--local-ssd-recovery-timeout=LOCAL_SSD_RECOVERY_TIMEOUT] [--machine-type=MACHINE_TYPE] [--maintenance-policy=MAINTENANCE_POLICY] + [--max-run-duration=MAX_RUN_DURATION] [--metadata=KEY=VALUE,[KEY=VALUE,...]] [--metadata-from-file=KEY=LOCAL_FILE_PATH,[...]] [--min-cpu-platform=PLATFORM] [--min-node-cpu=MIN_NODE_CPU] @@ -49,6 +51,7 @@ SYNOPSIS [--source-machine-image=SOURCE_MACHINE_IMAGE] [--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] [--visible-core-count=VISIBLE_CORE_COUNT] [--zone=ZONE] [--address=ADDRESS | --no-address] @@ -373,6 +376,20 @@ FLAGS --description=DESCRIPTION Specifies a textual description of the instances. + --discard-local-ssds-at-termination-timestamp=DISCARD_LOCAL_SSDS_AT_TERMINATION_TIMESTAMP + Required to be set to true and only allowed for VMs that have one or + more local SSDs, use --instance-termination-action=STOP, and use either + --max-run-duration or --termination-time. + + This flag indicates the value that you want Compute Engine to use for + the --discard-local-ssd flag in the automatic gcloud compute instances + stop command. This flag only supports the true value, which discards + local SSD data when automatically stopping this VM during its + terminationTimestamp. + + For more information about the --discard-local-ssd flag, see + https://cloud.google.com/compute/docs/disks/local-ssd#stop_instance. + --disk=[auto-delete=AUTO-DELETE],[boot=BOOT],[device-name=DEVICE-NAME],[force-attach=FORCE-ATTACH],[mode=MODE],[name=NAME],[scope=SCOPE] Attaches an existing persistent disk to the instances. @@ -553,6 +570,28 @@ FLAGS TERMINATE The instances should be terminated. + --max-run-duration=MAX_RUN_DURATION + Limits how long this VM instance can run, specified as a duration + relative to the last time when the VM began running. Format the + duration, MAX_RUN_DURATION, as the number of days, hours, minutes, and + seconds followed by d, h, m, and s respectively. For example, specify + 30m for a duration of 30 minutes or specify 1d2h3m4s for a duration of + 1 day, 2 hours, 3 minutes, and 4 seconds. Alternatively, to specify a + timestamp, use --termination-time instead. + + If neither --max-run-duration nor --termination-time is specified + (default), the VM instance runs until prompted by a user action or + system event. If either is specified, the VM instance is scheduled to + be automatically terminated at the VM's termination timestamp + (terminationTimestamp) using the action specified by + --instance-termination-action. + + Note: The terminationTimestamp is removed whenever the VM is stopped or + suspended and redefined whenever the VM is rerun. For + --max-run-duration specifically, the terminationTimestamp is the sum of + MAX_RUN_DURATION and the time when the VM last entered the RUNNING + state, which changes whenever the VM is rerun. + --metadata=KEY=VALUE,[KEY=VALUE,...] Metadata to be made available to the guest operating system running on the instances. Each metadata entry is a key/value pair separated by an @@ -885,6 +924,25 @@ FLAGS $ gcloud compute instances list --filter='tags:tag1' + --termination-time=TERMINATION_TIME + Limits how long this VM instance can run, specified as a time. Format + the time, TERMINATION_TIME, as a RFC 3339 timestamp. For more + information, see https://tools.ietf.org/html/rfc3339. Alternatively, to + specify a duration, use --max-run-duration instead. + + If neither --termination-time nor --max-run-duration is specified + (default), the VM instance runs until prompted by a user action or + system event. If either is specified, the VM instance is scheduled to + be automatically terminated at the VM's termination timestamp + (terminationTimestamp) using the action specified by + --instance-termination-action. + + Note: The terminationTimestamp is removed whenever the VM is stopped or + suspended and redefined whenever the VM is rerun. For + --termination-time specifically, the terminationTimestamp remains the + same whenever the VM is rerun, but any requests to rerun the VM fail if + the specified timestamp is in the past. + --threads-per-core=THREADS_PER_CORE The number of visible threads per physical core. To disable simultaneous multithreading (SMT) set this to 1. Valid values are: 1 or diff --git a/gcloud/compute/instances/create-with-container b/gcloud/compute/instances/create-with-container index fb6235987..dbec99b06 100644 --- a/gcloud/compute/instances/create-with-container +++ b/gcloud/compute/instances/create-with-container @@ -24,6 +24,7 @@ SYNOPSIS [--container-restart-policy=POLICY; default="always"] [--container-stdin] [--container-tty] [--create-disk=[PROPERTY=VALUE,...]] [--description=DESCRIPTION] + [--discard-local-ssds-at-termination-timestamp=DISCARD_LOCAL_SSDS_AT_TERMINATION_TIMESTAMP] [--disk=[auto-delete=AUTO-DELETE],[boot=BOOT],[device-name=DEVICE-NAME], [force-attach=FORCE-ATTACH],[mode=MODE],[name=NAME],[scope=SCOPE]] [--[no-]enable-nested-virtualization] @@ -35,6 +36,7 @@ SYNOPSIS [--ipv6-network-tier=IPV6_NETWORK_TIER] [--labels=[KEY=VALUE,...]] [--local-ssd-recovery-timeout=LOCAL_SSD_RECOVERY_TIMEOUT] [--machine-type=MACHINE_TYPE] [--maintenance-policy=MAINTENANCE_POLICY] + [--max-run-duration=MAX_RUN_DURATION] [--metadata=KEY=VALUE,[KEY=VALUE,...]] [--metadata-from-file=KEY=LOCAL_FILE_PATH,[...]] [--min-cpu-platform=PLATFORM] [--network=NETWORK] @@ -48,6 +50,7 @@ SYNOPSIS [--shielded-integrity-monitoring] [--shielded-secure-boot] [--shielded-vtpm] [--source-instance-template=SOURCE_INSTANCE_TEMPLATE] [--stack-type=STACK_TYPE] [--subnet=SUBNET] [--tags=TAG,[TAG,...]] + [--termination-time=TERMINATION_TIME] [--threads-per-core=THREADS_PER_CORE] [--visible-core-count=VISIBLE_CORE_COUNT] [--zone=ZONE] [--address=ADDRESS | --no-address] @@ -372,6 +375,20 @@ FLAGS --description=DESCRIPTION Specifies a textual description of the instances. + --discard-local-ssds-at-termination-timestamp=DISCARD_LOCAL_SSDS_AT_TERMINATION_TIMESTAMP + Required to be set to true and only allowed for VMs that have one or + more local SSDs, use --instance-termination-action=STOP, and use either + --max-run-duration or --termination-time. + + This flag indicates the value that you want Compute Engine to use for + the --discard-local-ssd flag in the automatic gcloud compute instances + stop command. This flag only supports the true value, which discards + local SSD data when automatically stopping this VM during its + terminationTimestamp. + + For more information about the --discard-local-ssd flag, see + https://cloud.google.com/compute/docs/disks/local-ssd#stop_instance. + --disk=[auto-delete=AUTO-DELETE],[boot=BOOT],[device-name=DEVICE-NAME],[force-attach=FORCE-ATTACH],[mode=MODE],[name=NAME],[scope=SCOPE] Attaches an existing persistent disk to the instances. @@ -500,6 +517,28 @@ FLAGS TERMINATE The instances should be terminated. + --max-run-duration=MAX_RUN_DURATION + Limits how long this VM instance can run, specified as a duration + relative to the last time when the VM began running. Format the + duration, MAX_RUN_DURATION, as the number of days, hours, minutes, and + seconds followed by d, h, m, and s respectively. For example, specify + 30m for a duration of 30 minutes or specify 1d2h3m4s for a duration of + 1 day, 2 hours, 3 minutes, and 4 seconds. Alternatively, to specify a + timestamp, use --termination-time instead. + + If neither --max-run-duration nor --termination-time is specified + (default), the VM instance runs until prompted by a user action or + system event. If either is specified, the VM instance is scheduled to + be automatically terminated at the VM's termination timestamp + (terminationTimestamp) using the action specified by + --instance-termination-action. + + Note: The terminationTimestamp is removed whenever the VM is stopped or + suspended and redefined whenever the VM is rerun. For + --max-run-duration specifically, the terminationTimestamp is the sum of + MAX_RUN_DURATION and the time when the VM last entered the RUNNING + state, which changes whenever the VM is rerun. + --metadata=KEY=VALUE,[KEY=VALUE,...] Metadata to be made available to the guest operating system running on the instances. Each metadata entry is a key/value pair separated by an @@ -775,6 +814,25 @@ FLAGS $ gcloud compute instances list --filter='tags:tag1' + --termination-time=TERMINATION_TIME + Limits how long this VM instance can run, specified as a time. Format + the time, TERMINATION_TIME, as a RFC 3339 timestamp. For more + information, see https://tools.ietf.org/html/rfc3339. Alternatively, to + specify a duration, use --max-run-duration instead. + + If neither --termination-time nor --max-run-duration is specified + (default), the VM instance runs until prompted by a user action or + system event. If either is specified, the VM instance is scheduled to + be automatically terminated at the VM's termination timestamp + (terminationTimestamp) using the action specified by + --instance-termination-action. + + Note: The terminationTimestamp is removed whenever the VM is stopped or + suspended and redefined whenever the VM is rerun. For + --termination-time specifically, the terminationTimestamp remains the + same whenever the VM is rerun, but any requests to rerun the VM fail if + the specified timestamp is in the past. + --threads-per-core=THREADS_PER_CORE The number of visible threads per physical core. To disable simultaneous multithreading (SMT) set this to 1. Valid values are: 1 or diff --git a/gcloud/compute/instances/help b/gcloud/compute/instances/help index 4f07e1f22..4f8fbcab9 100644 --- a/gcloud/compute/instances/help +++ b/gcloud/compute/instances/help @@ -31,7 +31,8 @@ GROUPS Read and manipulate Compute Engine VM instance network interfaces. ops-agents - Manage Operation Suite (Ops) agents for Compute Engine VM instances. + Manage Google Cloud Observability agents for Compute Engine VM + instances. os-inventory Read Compute Engine OS Inventory Data and Related Resources. diff --git a/gcloud/compute/instances/ops-agents/help b/gcloud/compute/instances/ops-agents/help index cba430dd9..aa9eda960 100644 --- a/gcloud/compute/instances/ops-agents/help +++ b/gcloud/compute/instances/ops-agents/help @@ -1,12 +1,12 @@ NAME - gcloud compute instances ops-agents - manage Operation Suite (Ops) agents - for Compute Engine VM instances + gcloud compute instances ops-agents - manage Google Cloud Observability + agents for Compute Engine VM instances SYNOPSIS gcloud compute instances ops-agents GROUP [GCLOUD_WIDE_FLAG ...] DESCRIPTION - Manage Operation Suite (Ops) agents for Compute Engine VM instances. + Manage Google Cloud Observability agents for Compute Engine VM instances. GCLOUD WIDE FLAGS These flags are available to all commands: --help. @@ -17,8 +17,8 @@ GROUPS GROUP is one of the following: policies - Manage Operation Suite (Ops) agents policies that install, update, and - uninstall agents for Compute Engine VM instances. + Manage Google Cloud Observability agents policies that install, update, + and uninstall agents for Compute Engine VM instances. NOTES These variants are also available: diff --git a/gcloud/compute/instances/ops-agents/policies/create b/gcloud/compute/instances/ops-agents/policies/create new file mode 100644 index 000000000..6559a7551 --- /dev/null +++ b/gcloud/compute/instances/ops-agents/policies/create @@ -0,0 +1,60 @@ +NAME + gcloud compute instances ops-agents policies create - create a Google Cloud + Observability agents policy for the Ops Agent + +SYNOPSIS + gcloud compute instances ops-agents policies create POLICY_ID --file=FILE + --zone=ZONE [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + gcloud compute instances ops-agents policies create creates a policy that + facilitates agent management across Compute Engine instances based on user + specified instance filters. This policy installs, specifies versioning, and + removes Ops Agents. + + The command returns the content of the created policy or an error + indicating why the creation fails. The created policy takes effect + asynchronously. It can take 10-15 minutes for the VMs to enforce the newly + 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 \ + --project=PROJECT --zone=ZONE --file=config.yaml + +POSITIONAL ARGUMENTS + POLICY_ID + ID of the policy. + + This ID must contain only lowercase letters, numbers, and hyphens, end + with a number or a letter, be between 1-63 characters, and be unique + within the project. + +REQUIRED FLAGS + --file=FILE + YAML file with agents policy to create. For information about the + agents policy format, see + https://cloud.google.com/stackdriver/docs/solutions/agents/ops-agent/agent-policies#config-files. + + --zone=ZONE + Zone in which to create the agents policy. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha compute instances ops-agents policies create + + $ gcloud beta compute instances ops-agents policies create + diff --git a/gcloud/compute/instances/ops-agents/policies/delete b/gcloud/compute/instances/ops-agents/policies/delete new file mode 100644 index 000000000..efd39e24e --- /dev/null +++ b/gcloud/compute/instances/ops-agents/policies/delete @@ -0,0 +1,68 @@ +NAME + gcloud compute instances ops-agents policies delete - delete a Google Cloud + Observability agents policy for the Ops Agent + +SYNOPSIS + gcloud compute instances ops-agents policies delete POLICY_ID --zone=ZONE + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + gcloud compute instances ops-agents policies delete deletes a policy that + facilitates agent management across Compute Engine instances based on user + specified instance filters. + + The command returns a response indicating whether the deletion succeeded. + After a policy is deleted, it takes 10-15 minutes to be wiped from the + applicable instances. Deleting a policy does not delete any existing agents + managed by that policy, but the agents become unmanaged by any policies. To + remove the agents from the instances, first update the policy to set the + agent packageState to removed, wait for the policy to take effect, then + delete the policy. + + The command returns the content of the deleted policy. For instance: + + agentsRule: + packageState: installed + version: latest + instanceFilter: + inclusionLabels: + - labels: + env: prod + + If no policies are found, or the policy is not an agents policy, then the + command returns a NOT_FOUND error. + +EXAMPLES + To delete an agents policy named ops-agents-test-policy in the current + project, run: + + $ gcloud compute instances ops-agents policies delete \ + ops-agents-test-policy --zone=ZONE + +POSITIONAL ARGUMENTS + POLICY_ID + ID of the policy. + + This ID must contain only lowercase letters, numbers, and hyphens, end + with a number or a letter, be between 1-63 characters, and be unique + within the project. + +REQUIRED FLAGS + --zone=ZONE + Zone of the agents policy you want to delete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha compute instances ops-agents policies delete + + $ gcloud beta compute instances ops-agents policies delete + diff --git a/gcloud/compute/instances/ops-agents/policies/describe b/gcloud/compute/instances/ops-agents/policies/describe new file mode 100644 index 000000000..b84748639 --- /dev/null +++ b/gcloud/compute/instances/ops-agents/policies/describe @@ -0,0 +1,60 @@ +NAME + gcloud compute instances ops-agents policies describe - describe a Google + Cloud Observability agents policy for the Ops Agent + +SYNOPSIS + gcloud compute instances ops-agents policies describe POLICY_ID --zone=ZONE + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + gcloud compute instances ops-agents policies describe describes a policy + that facilitates agent management across Compute Engine instances based on + user specified instance filters. This policy installs, specifies + versioning, and removes Ops Agents. + + The command returns the content of one policy. For instance: + + agentsRule: + packageState: installed + version: latest + instanceFilter: + inclusionLabels: + - labels: + env: prod + + If no policies are found, then the command returns a NOT_FOUND error. + +EXAMPLES + To describe an agents policy named ops-agents-test-policy in the current + project, run: + + $ gcloud compute instances ops-agents policies describe \ + ops-agents-test-policy --zone=ZONE + +POSITIONAL ARGUMENTS + POLICY_ID + ID of the policy. + + This ID must contain only lowercase letters, numbers, and hyphens, end + with a number or a letter, be between 1-63 characters, and be unique + within the project. + +REQUIRED FLAGS + --zone=ZONE + Zone of the agents policy. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha compute instances ops-agents policies describe + + $ gcloud beta compute instances ops-agents policies describe + diff --git a/gcloud/compute/instances/ops-agents/policies/help b/gcloud/compute/instances/ops-agents/policies/help index df624f27b..049b8710a 100644 --- a/gcloud/compute/instances/ops-agents/policies/help +++ b/gcloud/compute/instances/ops-agents/policies/help @@ -1,13 +1,13 @@ NAME - gcloud compute instances ops-agents policies - manage Operation Suite (Ops) - agents policies that install, update, and uninstall agents for Compute - Engine VM instances + gcloud compute instances ops-agents policies - manage Google Cloud + Observability agents policies that install, update, and uninstall + agents for Compute Engine VM instances SYNOPSIS gcloud compute instances ops-agents policies COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION - Manage Operation Suite (Ops) agents policies that install, update, and + Manage Google Cloud Observability agents policies that install, update, and uninstall agents for Compute Engine VM instances. GCLOUD WIDE FLAGS @@ -15,6 +15,24 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. +COMMANDS + COMMAND is one of the following: + + create + Create a Google Cloud Observability agents policy for the Ops Agent. + + delete + Delete a Google Cloud Observability agents policy for the Ops Agent. + + describe + Describe a Google Cloud Observability agents policy for the Ops Agent. + + list + List a Google Cloud Observability agents policy for the Ops Agent. + + update + Update a Google Cloud Observability agents policy for the Ops Agent. + NOTES These variants are also available: diff --git a/gcloud/compute/instances/ops-agents/policies/list b/gcloud/compute/instances/ops-agents/policies/list new file mode 100644 index 000000000..6a229b997 --- /dev/null +++ b/gcloud/compute/instances/ops-agents/policies/list @@ -0,0 +1,77 @@ +NAME + gcloud compute instances ops-agents policies list - list a Google Cloud + Observability agents policy for the Ops Agent + +SYNOPSIS + gcloud compute instances ops-agents policies list --zone=ZONE + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + gcloud compute instances ops-agents policies list lists policies that + facilitate agent management across Compute Engine instances based on user + specified instance filters. These policies install, specify versioning, and + remove agents. + + The command returns a list of policies, including the POLICY_ID, + ROLLOUT_STATE, and UPDATE_TIME for each policy. If no policies are found, + then the command returns an empty list. If policies were found but they + don't match as agents policies, then those policies won't be shown in the + list. + +EXAMPLES + To list agents policies in the current project, run: + + $ gcloud compute instances ops-agents policies list --zone=ZONE + +REQUIRED FLAGS + --zone=ZONE + Zone for which you want to list agent policies. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha compute instances ops-agents policies list + + $ gcloud beta compute instances ops-agents policies list + diff --git a/gcloud/compute/instances/ops-agents/policies/update b/gcloud/compute/instances/ops-agents/policies/update new file mode 100644 index 000000000..ca4b7a891 --- /dev/null +++ b/gcloud/compute/instances/ops-agents/policies/update @@ -0,0 +1,60 @@ +NAME + gcloud compute instances ops-agents policies update - update a Google Cloud + Observability agents policy for the Ops Agent + +SYNOPSIS + gcloud compute instances ops-agents policies update POLICY_ID --file=FILE + --zone=ZONE [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + gcloud compute instances ops-agents policies update modifies a policy that + facilitates agent management across Compute Engine instances based on user + specified instance filters. This policy installs, specifies versioning, and + removes Ops Agents. + + The command returns the content of the modified policy or an error + indicating why the modification fails. The modified policy takes effect + asynchronously. It can take 10-15 minutes for the VMs to enforce the newly + 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 \ + --project=PROJECT --zone=ZONE --file=config.yaml + +POSITIONAL ARGUMENTS + POLICY_ID + ID of the policy. + + This ID must contain only lowercase letters, numbers, and hyphens, end + with a number or a letter, be between 1-63 characters, and be unique + within the project. + +REQUIRED FLAGS + --file=FILE + YAML file with a subset of agents policy fields you wish to update. For + information about the agents policy format, see + https://cloud.google.com/stackdriver/docs/solutions/agents/ops-agent/agent-policies#config-files. + + --zone=ZONE + Zone where the agents policy is located. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha compute instances ops-agents policies update + + $ gcloud beta compute instances ops-agents policies update + diff --git a/gcloud/compute/instances/set-scheduling b/gcloud/compute/instances/set-scheduling index 96b51a769..77f288c5d 100644 --- a/gcloud/compute/instances/set-scheduling +++ b/gcloud/compute/instances/set-scheduling @@ -9,10 +9,14 @@ SYNOPSIS [--maintenance-policy=MAINTENANCE_POLICY] [--min-node-cpu=MIN_NODE_CPU] [--[no-]preemptible] [--provisioning-model=PROVISIONING_MODEL] [--[no-]restart-on-failure] [--zone=ZONE] + [--clear-discard-local-ssds-at-termination-timestamp + | --discard-local-ssds-at-termination-timestamp=DISCARD_LOCAL_SSDS_AT_TERMINATION_TIMESTAMP] [--clear-instance-termination-action | --instance-termination-action=INSTANCE_TERMINATION_ACTION] + [--clear-max-run-duration | --max-run-duration=MAX_RUN_DURATION] [--clear-node-affinities | --node=NODE | --node-affinity-file=NODE_AFFINITY_FILE | --node-group=NODE_GROUP] + [--clear-termination-time | --termination-time=TERMINATION_TIME] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -111,6 +115,28 @@ FLAGS Alternatively, the zone can be stored in the environment variable CLOUDSDK_COMPUTE_ZONE. + Discard Local SSDs At Termination Timestamp + + At most one of these can be specified: + + --clear-discard-local-ssds-at-termination-timestamp + Removes the discard-local-ssds-at-termination-timestamp field from + the scheduling options. + + --discard-local-ssds-at-termination-timestamp=DISCARD_LOCAL_SSDS_AT_TERMINATION_TIMESTAMP + Required to be set to true and only allowed for VMs that have one or + more local SSDs, use --instance-termination-action=STOP, and use + either --max-run-duration or --termination-time. + + This flag indicates the value that you want Compute Engine to use for + the --discard-local-ssd flag in the automatic gcloud compute + instances stop command. This flag only supports the true value, which + discards local SSD data when automatically stopping this VM during + its terminationTimestamp. + + For more information about the --discard-local-ssd flag, see + https://cloud.google.com/compute/docs/disks/local-ssd#stop_instance. + Instance Termination Action At most one of these can be specified: @@ -137,6 +163,35 @@ FLAGS Default only for Spot VMs. Stop the VM without preserving memory. The VM can be restarted later. + Max Run Duration + + At most one of these can be specified: + + --clear-max-run-duration + Removes the max-run-duration field from the scheduling options. + + --max-run-duration=MAX_RUN_DURATION + Limits how long this VM instance can run, specified as a duration + relative to the last time when the VM began running. Format the + duration, MAX_RUN_DURATION, as the number of days, hours, minutes, + and seconds followed by d, h, m, and s respectively. For example, + specify 30m for a duration of 30 minutes or specify 1d2h3m4s for a + duration of 1 day, 2 hours, 3 minutes, and 4 seconds. Alternatively, + to specify a timestamp, use --termination-time instead. + + If neither --max-run-duration nor --termination-time is specified + (default), the VM instance runs until prompted by a user action or + system event. If either is specified, the VM instance is scheduled to + be automatically terminated at the VM's termination timestamp + (terminationTimestamp) using the action specified by + --instance-termination-action. + + Note: The terminationTimestamp is removed whenever the VM is stopped + or suspended and redefined whenever the VM is rerun. For + --max-run-duration specifically, the terminationTimestamp is the sum + of MAX_RUN_DURATION and the time when the VM last entered the RUNNING + state, which changes whenever the VM is rerun. + Sole Tenancy. At most one of these can be specified: @@ -173,6 +228,32 @@ FLAGS --node-group=NODE_GROUP The name of the node group to schedule this instance on. + Termination Time + + At most one of these can be specified: + + --clear-termination-time + Removes the termination-time field from the scheduling options. + + --termination-time=TERMINATION_TIME + Limits how long this VM instance can run, specified as a time. Format + the time, TERMINATION_TIME, as a RFC 3339 timestamp. For more + information, see https://tools.ietf.org/html/rfc3339. Alternatively, + to specify a duration, use --max-run-duration instead. + + If neither --termination-time nor --max-run-duration is specified + (default), the VM instance runs until prompted by a user action or + system event. If either is specified, the VM instance is scheduled to + be automatically terminated at the VM's termination timestamp + (terminationTimestamp) using the action specified by + --instance-termination-action. + + Note: The terminationTimestamp is removed whenever the VM is stopped + or suspended and redefined whenever the VM is rerun. For + --termination-time specifically, the terminationTimestamp remains the + same whenever the VM is rerun, but any requests to rerun the VM fail + if the specified timestamp is in the past. + 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/edge-cloud/networking/subnets/create b/gcloud/edge-cloud/networking/subnets/create index c2a052d3d..97197f47a 100644 --- a/gcloud/edge-cloud/networking/subnets/create +++ b/gcloud/edge-cloud/networking/subnets/create @@ -13,15 +13,16 @@ DESCRIPTION Create a new Distributed Cloud Edge Network subnet. EXAMPLES - To create a Distributed Cloud Edge Network subnet called 'my-subnet' with - vlan id and owned ip ranges specified in the edge zone + To create a Distributed Cloud Edge Network subnet called my-subnet with + VLAN ID and owned ip ranges specified in the edge zone 'us-central1-edge-den1', run: $ gcloud edge-cloud networking subnets create my-subnet \ --network=my-network --location=us-central1 \ --zone=us-central1-edge-den1 \ --ipv4-range=192.168.1.1/24,172.10.10.1/24 \ - --ipv6-range=2001:db8::1/64,4001:230::1/64 --vlan-id=100 + --ipv6-range=2001:db8::1/64,4001:230::1/64 --vlan-id=100 \ + --bonding-type=bonded POSITIONAL ARGUMENTS Subnet resource - Distributed Cloud Edge Network subnet to create. The @@ -91,7 +92,7 @@ OPTIONAL FLAGS numbers. --vlan-id=VLAN_ID - The ID of the vlan to tag the subnetwork. If not specified we assign + The ID of the VLAN to tag the subnetwork. If not specified we assign one automatically. GCLOUD WIDE FLAGS diff --git a/gcloud/filestore/instances/help b/gcloud/filestore/instances/help index 18d19393a..4877e78b9 100644 --- a/gcloud/filestore/instances/help +++ b/gcloud/filestore/instances/help @@ -33,6 +33,9 @@ COMMANDS list List Filestore instances. + promote-replica + Promote a Filestore standby replication instance. + restore Restore a Filestore instance from a backup. diff --git a/gcloud/filestore/instances/promote-replica b/gcloud/filestore/instances/promote-replica new file mode 100644 index 000000000..eee0047a9 --- /dev/null +++ b/gcloud/filestore/instances/promote-replica @@ -0,0 +1,80 @@ +NAME + gcloud filestore instances promote-replica - promote a Filestore standby + replication instance + +SYNOPSIS + gcloud filestore instances promote-replica (INSTANCE : --zone=ZONE) + [--async] [--location=LOCATION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Promote a Filestore standby replication instance to a regular instance. + + This command can fail for the following reasons: + ▪ The target instance does not exist. + ▪ The instance is not a standby replication member. + +EXAMPLES + To promote an instance with the name my-instance that's located in + us-central1, run: + + $ gcloud filestore instances promote-replica my-instance \ + --zone=us-central1 + +POSITIONAL ARGUMENTS + Instance resource - Arguments and flags that specify the Filestore + instance to promote. The arguments in this group can be used to specify + the attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument instance on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + INSTANCE + ID of the instance or fully qualified identifier for the instance. + + To set the instance attribute: + ▸ provide the argument instance on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --zone=ZONE + The zone of the Filestore instance. + + To set the zone attribute: + ▸ provide the argument instance on the command line with a fully + specified name; + ▸ provide the argument --zone on the command line; + ▸ provide the argument --location on the command line; + ▸ set the property filestore/zone. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --location=LOCATION + Location of the Filestore instance to promote. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the file/v1 API. The full documentation for this API can + be found at: https://cloud.google.com/filestore/ + +NOTES + This variant is also available: + + $ gcloud beta filestore instances promote-replica + diff --git a/gcloud/firestore/databases/restore b/gcloud/firestore/databases/restore index cdd8cad77..4cde3acca 100644 --- a/gcloud/firestore/databases/restore +++ b/gcloud/firestore/databases/restore @@ -14,12 +14,6 @@ EXAMPLES --source-backup=projects/PROJECT_ID/locations/LOCATION_ID/\ backups/BACKUP_ID --destination-database=DATABASE_ID - To restore a database from a database snapshot. - - $ gcloud firestore databases restore --source-database=SOURCE_DB \ - --snapshot-time=2023-05-26T10:20:00.00Z \ - --destination-database=DATABASE_ID - REQUIRED FLAGS --destination-database=DESTINATION_DATABASE Destination database to restore to. Destination database will be diff --git a/gcloud/netapp/storage-pools/create b/gcloud/netapp/storage-pools/create index eb3add878..61dde12ff 100644 --- a/gcloud/netapp/storage-pools/create +++ b/gcloud/netapp/storage-pools/create @@ -82,10 +82,8 @@ REQUIRED FLAGS accepted, but please use the long-form when attempting to create a Storage Pool using a shared VPC. psa-range - The psa-range is the name of the allocated range of the Private - Service Access connection. The range you specify can't overlap with - either existing subnets or assigned IP address ranges for other - Cloud NetApp Files Storage Pools in the selected VPC network. + This field is not implemented. The values provided in this field + are ignored. --service-level=SERVICE_LEVEL The service level for the Cloud NetApp Storage Pool. For more details, diff --git a/gcloud/network-connectivity/hubs/add-iam-policy-binding b/gcloud/network-connectivity/hubs/add-iam-policy-binding index 3be3b7e9d..59eae6ef3 100644 --- a/gcloud/network-connectivity/hubs/add-iam-policy-binding +++ b/gcloud/network-connectivity/hubs/add-iam-policy-binding @@ -70,3 +70,9 @@ API REFERENCE This command uses the networkconnectivity/v1 API. The full documentation for this API can be found at: https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This variant is also available: + + $ gcloud beta network-connectivity hubs add-iam-policy-binding + diff --git a/gcloud/network-connectivity/hubs/create b/gcloud/network-connectivity/hubs/create index c4a7f3db7..ab9c4b8f4 100644 --- a/gcloud/network-connectivity/hubs/create +++ b/gcloud/network-connectivity/hubs/create @@ -79,7 +79,9 @@ API REFERENCE https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest NOTES - This variant is also available: + These variants are also available: $ gcloud alpha network-connectivity hubs create + $ gcloud beta network-connectivity hubs create + diff --git a/gcloud/network-connectivity/hubs/delete b/gcloud/network-connectivity/hubs/delete index 7c678a154..319d82f26 100644 --- a/gcloud/network-connectivity/hubs/delete +++ b/gcloud/network-connectivity/hubs/delete @@ -51,7 +51,9 @@ API REFERENCE https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest NOTES - This variant is also available: + These variants are also available: $ gcloud alpha network-connectivity hubs delete + $ gcloud beta network-connectivity hubs delete + diff --git a/gcloud/network-connectivity/hubs/describe b/gcloud/network-connectivity/hubs/describe index 3be51c371..c284ba77f 100644 --- a/gcloud/network-connectivity/hubs/describe +++ b/gcloud/network-connectivity/hubs/describe @@ -45,7 +45,9 @@ API REFERENCE https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest NOTES - This variant is also available: + These variants are also available: $ gcloud alpha network-connectivity hubs describe + $ gcloud beta network-connectivity hubs describe + diff --git a/gcloud/network-connectivity/hubs/get-iam-policy b/gcloud/network-connectivity/hubs/get-iam-policy index e800df941..79d9b8611 100644 --- a/gcloud/network-connectivity/hubs/get-iam-policy +++ b/gcloud/network-connectivity/hubs/get-iam-policy @@ -73,3 +73,9 @@ API REFERENCE This command uses the networkconnectivity/v1 API. The full documentation for this API can be found at: https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This variant is also available: + + $ gcloud beta network-connectivity hubs get-iam-policy + diff --git a/gcloud/network-connectivity/hubs/groups/add-iam-policy-binding b/gcloud/network-connectivity/hubs/groups/add-iam-policy-binding index 4d8630e16..3adcf043b 100644 --- a/gcloud/network-connectivity/hubs/groups/add-iam-policy-binding +++ b/gcloud/network-connectivity/hubs/groups/add-iam-policy-binding @@ -83,3 +83,9 @@ API REFERENCE This command uses the networkconnectivity/v1 API. The full documentation for this API can be found at: https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This variant is also available: + + $ gcloud beta network-connectivity hubs groups add-iam-policy-binding + diff --git a/gcloud/network-connectivity/hubs/groups/describe b/gcloud/network-connectivity/hubs/groups/describe index 4fb36d345..671dfe504 100644 --- a/gcloud/network-connectivity/hubs/groups/describe +++ b/gcloud/network-connectivity/hubs/groups/describe @@ -56,3 +56,9 @@ API REFERENCE This command uses the networkconnectivity/v1 API. The full documentation for this API can be found at: https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This variant is also available: + + $ gcloud beta network-connectivity hubs groups describe + diff --git a/gcloud/network-connectivity/hubs/groups/get-iam-policy b/gcloud/network-connectivity/hubs/groups/get-iam-policy index 13e27338d..311e1f960 100644 --- a/gcloud/network-connectivity/hubs/groups/get-iam-policy +++ b/gcloud/network-connectivity/hubs/groups/get-iam-policy @@ -87,3 +87,9 @@ API REFERENCE This command uses the networkconnectivity/v1 API. The full documentation for this API can be found at: https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This variant is also available: + + $ gcloud beta network-connectivity hubs groups get-iam-policy + diff --git a/gcloud/network-connectivity/hubs/groups/help b/gcloud/network-connectivity/hubs/groups/help index 9cc302fb5..421ab1fd3 100644 --- a/gcloud/network-connectivity/hubs/groups/help +++ b/gcloud/network-connectivity/hubs/groups/help @@ -36,3 +36,9 @@ COMMANDS update Update a group. + +NOTES + This variant is also available: + + $ gcloud beta network-connectivity hubs groups + diff --git a/gcloud/network-connectivity/hubs/groups/list b/gcloud/network-connectivity/hubs/groups/list index 2b9b8b6f3..a15f0f99c 100644 --- a/gcloud/network-connectivity/hubs/groups/list +++ b/gcloud/network-connectivity/hubs/groups/list @@ -16,7 +16,7 @@ EXAMPLES To list all groups in hub my-hub, run: - $gcloud network-connectivity hubs groups list --hub=my-hub + $ gcloud network-connectivity hubs groups list --hub=my-hub REQUIRED FLAGS Hub resource - Parent hub of the groups to display. This represents a @@ -75,3 +75,9 @@ API REFERENCE This command uses the networkconnectivity/v1 API. The full documentation for this API can be found at: https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This variant is also available: + + $ gcloud beta network-connectivity hubs groups list + diff --git a/gcloud/network-connectivity/hubs/groups/remove-iam-policy-binding b/gcloud/network-connectivity/hubs/groups/remove-iam-policy-binding index a7c79417d..894ec31ea 100644 --- a/gcloud/network-connectivity/hubs/groups/remove-iam-policy-binding +++ b/gcloud/network-connectivity/hubs/groups/remove-iam-policy-binding @@ -84,3 +84,10 @@ API REFERENCE This command uses the networkconnectivity/v1 API. The full documentation for this API can be found at: https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This variant is also available: + + $ gcloud beta network-connectivity hubs groups \ + remove-iam-policy-binding + diff --git a/gcloud/network-connectivity/hubs/groups/set-iam-policy b/gcloud/network-connectivity/hubs/groups/set-iam-policy index 9a64f7061..1235bccd2 100644 --- a/gcloud/network-connectivity/hubs/groups/set-iam-policy +++ b/gcloud/network-connectivity/hubs/groups/set-iam-policy @@ -67,3 +67,9 @@ API REFERENCE This command uses the networkconnectivity/v1 API. The full documentation for this API can be found at: https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This variant is also available: + + $ gcloud beta network-connectivity hubs groups set-iam-policy + diff --git a/gcloud/network-connectivity/hubs/help b/gcloud/network-connectivity/hubs/help index c040c6914..6eac0a353 100644 --- a/gcloud/network-connectivity/hubs/help +++ b/gcloud/network-connectivity/hubs/help @@ -61,7 +61,9 @@ COMMANDS Update a hub. NOTES - This variant is also available: + These variants are also available: $ gcloud alpha network-connectivity hubs + $ gcloud beta network-connectivity hubs + diff --git a/gcloud/network-connectivity/hubs/list b/gcloud/network-connectivity/hubs/list index fda0d0c03..7359e1753 100644 --- a/gcloud/network-connectivity/hubs/list +++ b/gcloud/network-connectivity/hubs/list @@ -53,7 +53,9 @@ API REFERENCE https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest NOTES - This variant is also available: + These variants are also available: $ gcloud alpha network-connectivity hubs list + $ gcloud beta network-connectivity hubs list + diff --git a/gcloud/network-connectivity/hubs/remove-iam-policy-binding b/gcloud/network-connectivity/hubs/remove-iam-policy-binding index 81b8b33ca..a30418590 100644 --- a/gcloud/network-connectivity/hubs/remove-iam-policy-binding +++ b/gcloud/network-connectivity/hubs/remove-iam-policy-binding @@ -70,3 +70,9 @@ API REFERENCE This command uses the networkconnectivity/v1 API. The full documentation for this API can be found at: https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This variant is also available: + + $ gcloud beta network-connectivity hubs remove-iam-policy-binding + diff --git a/gcloud/network-connectivity/hubs/route-tables/describe b/gcloud/network-connectivity/hubs/route-tables/describe index b4e7f01aa..fb8e3ffef 100644 --- a/gcloud/network-connectivity/hubs/route-tables/describe +++ b/gcloud/network-connectivity/hubs/route-tables/describe @@ -59,3 +59,9 @@ API REFERENCE This command uses the networkconnectivity/v1 API. The full documentation for this API can be found at: https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This variant is also available: + + $ gcloud beta network-connectivity hubs route-tables describe + diff --git a/gcloud/network-connectivity/hubs/route-tables/help b/gcloud/network-connectivity/hubs/route-tables/help index aa8f79499..d81ae3030 100644 --- a/gcloud/network-connectivity/hubs/route-tables/help +++ b/gcloud/network-connectivity/hubs/route-tables/help @@ -28,3 +28,9 @@ COMMANDS list List route tables. + +NOTES + This variant is also available: + + $ gcloud beta network-connectivity hubs route-tables + diff --git a/gcloud/network-connectivity/hubs/route-tables/list b/gcloud/network-connectivity/hubs/route-tables/list index 1f1df7827..3bcad9d4f 100644 --- a/gcloud/network-connectivity/hubs/route-tables/list +++ b/gcloud/network-connectivity/hubs/route-tables/list @@ -16,7 +16,7 @@ EXAMPLES To list all route tables in hub my-hub, run: - $gcloud network-connectivity hubs route-tables list --hub=my-hub + $ gcloud network-connectivity hubs route-tables list --hub=my-hub REQUIRED FLAGS Hub resource - Parent hub of the route tables to display. This represents @@ -75,3 +75,9 @@ API REFERENCE This command uses the networkconnectivity/v1 API. The full documentation for this API can be found at: https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This variant is also available: + + $ gcloud beta network-connectivity hubs route-tables list + diff --git a/gcloud/network-connectivity/hubs/route-tables/routes/describe b/gcloud/network-connectivity/hubs/route-tables/routes/describe index 5a99f894c..bcedd24ba 100644 --- a/gcloud/network-connectivity/hubs/route-tables/routes/describe +++ b/gcloud/network-connectivity/hubs/route-tables/routes/describe @@ -66,3 +66,9 @@ API REFERENCE This command uses the networkconnectivity/v1 API. The full documentation for this API can be found at: https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This variant is also available: + + $ gcloud beta network-connectivity hubs route-tables routes describe + diff --git a/gcloud/network-connectivity/hubs/route-tables/routes/help b/gcloud/network-connectivity/hubs/route-tables/routes/help index a7df8359f..8be1baadb 100644 --- a/gcloud/network-connectivity/hubs/route-tables/routes/help +++ b/gcloud/network-connectivity/hubs/route-tables/routes/help @@ -22,3 +22,9 @@ COMMANDS list List routes. + +NOTES + This variant is also available: + + $ gcloud beta network-connectivity hubs route-tables routes + diff --git a/gcloud/network-connectivity/hubs/route-tables/routes/list b/gcloud/network-connectivity/hubs/route-tables/routes/list index a4fe07124..7c796aa1f 100644 --- a/gcloud/network-connectivity/hubs/route-tables/routes/list +++ b/gcloud/network-connectivity/hubs/route-tables/routes/list @@ -18,7 +18,8 @@ EXAMPLES To list all routes in route table my-route-table, run: - $gcloud network-connectivity hubs route-tables routes list --hub=my-hub --route_table=my-route-table + $ gcloud network-connectivity hubs route-tables routes list \ + --hub=my-hub --route_table=my-route-table REQUIRED FLAGS Route table resource - Parent route table of the routes to display. The @@ -90,3 +91,9 @@ API REFERENCE This command uses the networkconnectivity/v1 API. The full documentation for this API can be found at: https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This variant is also available: + + $ gcloud beta network-connectivity hubs route-tables routes list + diff --git a/gcloud/network-connectivity/hubs/set-iam-policy b/gcloud/network-connectivity/hubs/set-iam-policy index fa1a3f636..ba3b0e170 100644 --- a/gcloud/network-connectivity/hubs/set-iam-policy +++ b/gcloud/network-connectivity/hubs/set-iam-policy @@ -54,3 +54,9 @@ API REFERENCE This command uses the networkconnectivity/v1 API. The full documentation for this API can be found at: https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This variant is also available: + + $ gcloud beta network-connectivity hubs set-iam-policy + diff --git a/gcloud/network-connectivity/hubs/update b/gcloud/network-connectivity/hubs/update index 4ae3cfa08..c38220c66 100644 --- a/gcloud/network-connectivity/hubs/update +++ b/gcloud/network-connectivity/hubs/update @@ -89,7 +89,9 @@ API REFERENCE https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest NOTES - This variant is also available: + These variants are also available: $ gcloud alpha network-connectivity hubs update + $ gcloud beta network-connectivity hubs update + diff --git a/gcloud/secrets/add-iam-policy-binding b/gcloud/secrets/add-iam-policy-binding index 6841342b7..0bd2543de 100644 --- a/gcloud/secrets/add-iam-policy-binding +++ b/gcloud/secrets/add-iam-policy-binding @@ -3,6 +3,7 @@ NAME SYNOPSIS gcloud secrets add-iam-policy-binding SECRET --member=PRINCIPAL --role=ROLE + [--location=LOCATION] [--condition=[KEY=VALUE,...] | --condition-from-file=CONDITION_FROM_FILE] [GCLOUD_WIDE_FLAG ...] @@ -28,10 +29,10 @@ POSITIONAL ARGUMENTS given arguments in this group but can be set in other ways. To set the project attribute: - ◆ provide the argument secret on the command line with a fully + ◆ provide the argument SECRET on the command line with a fully specified name; - ◆ set the property core/project; - ◆ provide the argument --project on the command line. + ◆ provide the argument --project on the command line; + ◆ set the property core/project. This must be specified. @@ -39,7 +40,7 @@ POSITIONAL ARGUMENTS ID of the secret or fully qualified identifier for the secret. To set the secret attribute: - ▸ provide the argument secret on the command line. + ▸ provide the argument SECRET on the command line. REQUIRED FLAGS --member=PRINCIPAL @@ -63,6 +64,22 @@ REQUIRED FLAGS organizations/{ORGANIZATION_ID}/roles/logging.viewer. OPTIONAL FLAGS + Location resource - The location to add iam policy. This represents a + Cloud resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + At most one of these can be specified: --condition=[KEY=VALUE,...] @@ -108,10 +125,6 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. -API REFERENCE - This command uses the secretmanager/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/secret-manager/ - NOTES This variant is also available: diff --git a/gcloud/secrets/create b/gcloud/secrets/create index a93b1693e..9069aa7b0 100644 --- a/gcloud/secrets/create +++ b/gcloud/secrets/create @@ -3,6 +3,7 @@ NAME SYNOPSIS gcloud secrets create SECRET [--data-file=PATH] [--labels=[KEY=VALUE,...]] + [--location=LOCATION] [--regional-kms-key-name=KMS-KEY-NAME] [--set-annotations=[KEY=VALUE,...]] [--topics=[TOPICS,...]] [--version-destroy-ttl=VERSION-DESTROY-TTL] [--expire-time=EXPIRE-TIME | --ttl=TTL] @@ -98,6 +99,26 @@ FLAGS contain only hyphens (-), underscores (_), lowercase characters, and numbers. + Location resource - The location to create secret. This represents a Cloud + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + + --regional-kms-key-name=KMS-KEY-NAME + Regional KMS key with which to encrypt and decrypt the secret. Only + valid for regional secrets. + Annotations --set-annotations=[KEY=VALUE,...] diff --git a/gcloud/secrets/delete b/gcloud/secrets/delete index 39b61b678..a6c0a4542 100644 --- a/gcloud/secrets/delete +++ b/gcloud/secrets/delete @@ -2,7 +2,8 @@ NAME gcloud secrets delete - delete a secret SYNOPSIS - gcloud secrets delete SECRET [--etag=ETAG] [GCLOUD_WIDE_FLAG ...] + gcloud secrets delete SECRET [--etag=ETAG] [--location=LOCATION] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION Delete a secret and destroy all secret versions. This action is @@ -43,6 +44,22 @@ FLAGS secret is updated only if the ETag provided matched the current secret's ETag. + Location resource - The location to delete secret. This represents a Cloud + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + 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/secrets/describe b/gcloud/secrets/describe index d75f23173..29244b47b 100644 --- a/gcloud/secrets/describe +++ b/gcloud/secrets/describe @@ -2,7 +2,7 @@ NAME gcloud secrets describe - describe a secret's metadata SYNOPSIS - gcloud secrets describe SECRET [GCLOUD_WIDE_FLAG ...] + gcloud secrets describe SECRET [--location=LOCATION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION Describe a secret's metadata. @@ -31,6 +31,23 @@ POSITIONAL ARGUMENTS To set the secret attribute: ▸ provide the argument SECRET on the command line. +FLAGS + Location resource - The location to describe. This represents a Cloud + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + 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/secrets/get-iam-policy b/gcloud/secrets/get-iam-policy index ccbf2380c..1cf0328bf 100644 --- a/gcloud/secrets/get-iam-policy +++ b/gcloud/secrets/get-iam-policy @@ -2,8 +2,9 @@ NAME gcloud secrets get-iam-policy - get the IAM policy for the secret SYNOPSIS - gcloud secrets get-iam-policy SECRET [--filter=EXPRESSION] [--limit=LIMIT] - [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + gcloud secrets get-iam-policy SECRET [--location=LOCATION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION Displays the IAM policy associated with the secret. If formatted as JSON, @@ -24,10 +25,10 @@ POSITIONAL ARGUMENTS arguments in this group but can be set in other ways. To set the project attribute: - ◆ provide the argument secret on the command line with a fully + ◆ provide the argument SECRET on the command line with a fully specified name; - ◆ set the property core/project; - ◆ provide the argument --project on the command line. + ◆ provide the argument --project on the command line; + ◆ set the property core/project. This must be specified. @@ -35,7 +36,24 @@ POSITIONAL ARGUMENTS ID of the secret or fully qualified identifier for the secret. To set the secret attribute: - ▸ provide the argument secret on the command line. + ▸ provide the argument SECRET on the command line. + +FLAGS + Location resource - The location to get iam policy. This represents a + Cloud resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. LIST COMMAND FLAGS --filter=EXPRESSION @@ -71,10 +89,6 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. -API REFERENCE - This command uses the secretmanager/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/secret-manager/ - NOTES This variant is also available: diff --git a/gcloud/secrets/list b/gcloud/secrets/list index 8d067f360..f4868101f 100644 --- a/gcloud/secrets/list +++ b/gcloud/secrets/list @@ -2,9 +2,9 @@ NAME gcloud secrets list - list all secret names SYNOPSIS - gcloud secrets list [--filter=EXPRESSION] [--limit=LIMIT] - [--page-size=PAGE_SIZE; default=100] [--sort-by=[FIELD,...]] [--uri] - [GCLOUD_WIDE_FLAG ...] + gcloud secrets list [--location=LOCATION] [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE; default=100] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION List all secret names. This command only returns the secret's names, not @@ -16,6 +16,23 @@ EXAMPLES $ gcloud secrets list +FLAGS + Location resource - The location to list regional secrets. This represents + a Cloud resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + LIST COMMAND FLAGS --filter=EXPRESSION Apply a Boolean filter EXPRESSION to each resource item to be listed. diff --git a/gcloud/secrets/remove-iam-policy-binding b/gcloud/secrets/remove-iam-policy-binding index 7408a2408..04a7a8ead 100644 --- a/gcloud/secrets/remove-iam-policy-binding +++ b/gcloud/secrets/remove-iam-policy-binding @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud secrets remove-iam-policy-binding SECRET --member=PRINCIPAL - --role=ROLE + --role=ROLE [--location=LOCATION] [--all | --condition=[KEY=VALUE,...] | --condition-from-file=CONDITION_FROM_FILE] [GCLOUD_WIDE_FLAG ...] @@ -28,10 +28,10 @@ POSITIONAL ARGUMENTS given arguments in this group but can be set in other ways. To set the project attribute: - ◆ provide the argument secret on the command line with a fully + ◆ provide the argument SECRET on the command line with a fully specified name; - ◆ set the property core/project; - ◆ provide the argument --project on the command line. + ◆ provide the argument --project on the command line; + ◆ set the property core/project. This must be specified. @@ -39,7 +39,7 @@ POSITIONAL ARGUMENTS ID of the secret or fully qualified identifier for the secret. To set the secret attribute: - ▸ provide the argument secret on the command line. + ▸ provide the argument SECRET on the command line. REQUIRED FLAGS --member=PRINCIPAL @@ -64,6 +64,22 @@ REQUIRED FLAGS The role to remove the principal from. OPTIONAL FLAGS + Location resource - The location to remove iam policy. This represents a + Cloud resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + At most one of these can be specified: --all @@ -113,10 +129,6 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. -API REFERENCE - This command uses the secretmanager/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/secret-manager/ - NOTES This variant is also available: diff --git a/gcloud/secrets/set-iam-policy b/gcloud/secrets/set-iam-policy index 49f8fda77..97ea37534 100644 --- a/gcloud/secrets/set-iam-policy +++ b/gcloud/secrets/set-iam-policy @@ -2,7 +2,8 @@ NAME gcloud secrets set-iam-policy - set the IAM policy binding for a secret SYNOPSIS - gcloud secrets set-iam-policy SECRET POLICY_FILE [GCLOUD_WIDE_FLAG ...] + gcloud secrets set-iam-policy SECRET POLICY_FILE [--location=LOCATION] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION Sets the IAM policy for the given secret as defined in a JSON or YAML file. @@ -22,10 +23,10 @@ POSITIONAL ARGUMENTS arguments in this group but can be set in other ways. To set the project attribute: - ◆ provide the argument secret on the command line with a fully + ◆ provide the argument SECRET on the command line with a fully specified name; - ◆ set the property core/project; - ◆ provide the argument --project on the command line. + ◆ provide the argument --project on the command line; + ◆ set the property core/project. This must be specified. @@ -33,7 +34,7 @@ POSITIONAL ARGUMENTS ID of the secret or fully qualified identifier for the secret. To set the secret attribute: - ▸ provide the argument secret on the command line. + ▸ provide the argument SECRET on the command line. POLICY_FILE Path to a local JSON or YAML formatted file containing a valid policy. @@ -42,6 +43,23 @@ POSITIONAL ARGUMENTS JSON or YAML file conforming to the structure of a Policy (https://cloud.google.com/iam/reference/rest/v1/Policy). +FLAGS + Location resource - The location to set iam policy. This represents a + Cloud resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, @@ -50,10 +68,6 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. -API REFERENCE - This command uses the secretmanager/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/secret-manager/ - NOTES This variant is also available: diff --git a/gcloud/secrets/update b/gcloud/secrets/update index 551cbfc14..5e0ea031e 100644 --- a/gcloud/secrets/update +++ b/gcloud/secrets/update @@ -2,7 +2,7 @@ NAME gcloud secrets update - update a secret's metadata SYNOPSIS - gcloud secrets update SECRET [--etag=ETAG] + gcloud secrets update SECRET [--etag=ETAG] [--location=LOCATION] [--update-labels=[KEY=VALUE,...]] [--add-topics=[ADD-TOPICS,...] | --clear-topics | --remove-topics=[REMOVE-TOPICS,...]] @@ -15,6 +15,8 @@ SYNOPSIS [--next-rotation-time=NEXT_ROTATION_TIME --remove-next-rotation-time --remove-rotation-period --remove-rotation-schedule --rotation-period=ROTATION_PERIOD] + [--regional-kms-key-name=REGIONAL-KMS-KEY-NAME + | --remove-regional-kms-key-name] [--remove-version-destroy-ttl | --version-destroy-ttl=VERSION-DESTROY-TTL] [GCLOUD_WIDE_FLAG ...] @@ -84,6 +86,22 @@ FLAGS secret is updated only if the ETag provided matched the current secret's ETag. + Location resource - The location to update secret. This represents a Cloud + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + --update-labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to update. If a label exists, its value is modified. Otherwise, a new label is created. @@ -184,6 +202,16 @@ FLAGS --rotation-period=ROTATION_PERIOD Duration of time (in seconds) between rotation notifications. + regional kms key. + + At most one of these can be specified: + + --regional-kms-key-name=REGIONAL-KMS-KEY-NAME + regional kms key name for regional secret. + + --remove-regional-kms-key-name + If set, removes the regional kms key. + Version destroy ttl. At most one of these can be specified: diff --git a/gcloud/secrets/versions/access b/gcloud/secrets/versions/access index ce5d9b573..f3ec686dc 100644 --- a/gcloud/secrets/versions/access +++ b/gcloud/secrets/versions/access @@ -3,7 +3,7 @@ NAME SYNOPSIS gcloud secrets versions access (VERSION : --secret=SECRET) - [--out-file=OUT-FILE-PATH] [GCLOUD_WIDE_FLAG ...] + [--location=LOCATION] [--out-file=OUT-FILE-PATH] [GCLOUD_WIDE_FLAG ...] DESCRIPTION Access the data for the specified secret version. @@ -60,6 +60,22 @@ POSITIONAL ARGUMENTS ▸ provide the argument --secret on the command line. FLAGS + Location resource - The location to access secret. This represents a Cloud + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + --out-file=OUT-FILE-PATH File path to which secret data is written. If this flag is not provided secret data will be written to stdout in UTF-8 format. diff --git a/gcloud/secrets/versions/add b/gcloud/secrets/versions/add index 461a20723..51fed0d95 100644 --- a/gcloud/secrets/versions/add +++ b/gcloud/secrets/versions/add @@ -2,7 +2,8 @@ NAME gcloud secrets versions add - create a new version of an existing secret SYNOPSIS - gcloud secrets versions add SECRET --data-file=PATH [GCLOUD_WIDE_FLAG ...] + gcloud secrets versions add SECRET --data-file=PATH [--location=LOCATION] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION Create a new version of an existing secret with the provided data. The @@ -51,6 +52,23 @@ REQUIRED FLAGS File path from which to read secret data. Set this to "-" to read the secret data from stdin. +OPTIONAL FLAGS + Location resource - The location to create secret version. This represents + a Cloud resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + 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/secrets/versions/describe b/gcloud/secrets/versions/describe index cc501c6f1..0d709a867 100644 --- a/gcloud/secrets/versions/describe +++ b/gcloud/secrets/versions/describe @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud secrets versions describe (VERSION : --secret=SECRET) - [GCLOUD_WIDE_FLAG ...] + [--location=LOCATION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION Describe a secret version's metadata. This command does not include the @@ -47,6 +47,23 @@ POSITIONAL ARGUMENTS specified name; ▸ provide the argument --secret on the command line. +FLAGS + Location resource - The location to describe secret. This represents a + Cloud resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + 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/secrets/versions/destroy b/gcloud/secrets/versions/destroy index c972ce650..69266b5ab 100644 --- a/gcloud/secrets/versions/destroy +++ b/gcloud/secrets/versions/destroy @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud secrets versions destroy (VERSION : --secret=SECRET) [--etag=ETAG] - [GCLOUD_WIDE_FLAG ...] + [--location=LOCATION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION Destroy a secret version's metadata and secret data. This action is @@ -57,6 +57,22 @@ FLAGS defined, the version is updated only if the ETag provided matched the current version's ETag. + Location resource - The location to destroy . This represents a Cloud + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + 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/secrets/versions/disable b/gcloud/secrets/versions/disable index 54445035f..28636794e 100644 --- a/gcloud/secrets/versions/disable +++ b/gcloud/secrets/versions/disable @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud secrets versions disable (VERSION : --secret=SECRET) [--etag=ETAG] - [GCLOUD_WIDE_FLAG ...] + [--location=LOCATION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION Disable the version of the provided secret. It can be re-enabled with @@ -57,6 +57,22 @@ FLAGS defined, the version is updated only if the ETag provided matched the current version's ETag. + Location resource - The location to disable. This represents a Cloud + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + 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/secrets/versions/enable b/gcloud/secrets/versions/enable index d92ec9281..f84065d5b 100644 --- a/gcloud/secrets/versions/enable +++ b/gcloud/secrets/versions/enable @@ -3,7 +3,7 @@ NAME SYNOPSIS gcloud secrets versions enable (VERSION : --secret=SECRET) [--etag=ETAG] - [GCLOUD_WIDE_FLAG ...] + [--location=LOCATION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION Enable the version of the provided secret. It can be disabled with gcloud @@ -56,6 +56,22 @@ FLAGS defined, the version is updated only if the ETag provided matched the current version's ETag. + Location resource - The location to enable. This represents a Cloud + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + 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/secrets/versions/list b/gcloud/secrets/versions/list index 2448bd916..d6aebf3ab 100644 --- a/gcloud/secrets/versions/list +++ b/gcloud/secrets/versions/list @@ -2,7 +2,8 @@ NAME gcloud secrets versions list - list all versions for a secret SYNOPSIS - gcloud secrets versions list SECRET [--filter=EXPRESSION] [--limit=LIMIT] + gcloud secrets versions list SECRET [--location=LOCATION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE; default=100] [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] @@ -34,6 +35,23 @@ POSITIONAL ARGUMENTS To set the secret attribute: ▸ provide the argument SECRET on the command line. +FLAGS + Location resource - The location to create secret. This represents a Cloud + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + LIST COMMAND FLAGS --filter=EXPRESSION Apply a Boolean filter EXPRESSION to each resource item to be listed. diff --git a/gcloud/sql/export/sql b/gcloud/sql/export/sql index 0e19aa026..6767fd189 100644 --- a/gcloud/sql/export/sql +++ b/gcloud/sql/export/sql @@ -3,9 +3,9 @@ NAME file SYNOPSIS - gcloud sql export sql INSTANCE URI [--async] + gcloud sql export sql INSTANCE URI [--async] [--clean] [--database=DATABASE,[DATABASE,...], -d DATABASE,[DATABASE,...]] - [--offload] [--parallel] + [--if-exists] [--offload] [--parallel] [--table=TABLE,[TABLE,...], -t TABLE,[TABLE,...]] [--threads=THREADS] [GCLOUD_WIDE_FLAG ...] @@ -33,11 +33,21 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + --clean + Include SQL statements (DROP ) required to drop database + objects prior to import; corresponds to the clean flag for pg_dump. + Only applies to PostgreSQL non-parallel exports. + --database=DATABASE,[DATABASE,...], -d DATABASE,[DATABASE,...] Database(s) from which the export is made. Information on requirements can be found here: https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances/export#exportContext.databases + --if-exists + Include an SQL statement (IF EXISTS) with each drop statement produced + by the clean flag; corresponds to the if-exists flag for pg_dump. Only + applies to PostgreSQL non-parallel exports. + --offload Offload an export to a temporary instance. Doing so reduces strain on source instances and allows other operations to be performed while the diff --git a/gcloud/sql/import/sql b/gcloud/sql/import/sql index ffdb56df1..b4103f7b5 100644 --- a/gcloud/sql/import/sql +++ b/gcloud/sql/import/sql @@ -3,9 +3,9 @@ NAME dump file SYNOPSIS - gcloud sql import sql INSTANCE URI [--async] - [--database=DATABASE, -d DATABASE] [--parallel] [--threads=THREADS] - [--user=USER] [GCLOUD_WIDE_FLAG ...] + gcloud sql import sql INSTANCE URI [--async] [--clean] + [--database=DATABASE, -d DATABASE] [--if-exists] [--parallel] + [--threads=THREADS] [--user=USER] [GCLOUD_WIDE_FLAG ...] DESCRIPTION gcloud sql import sql imports data into a Cloud SQL instance from a SQL @@ -40,12 +40,22 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + --clean + Option to clean (DROP) database objects before recreating them. + corresponds to the clean flag for pg_restore. Only applies if + --parallel is set. PostgreSQL only. + --database=DATABASE, -d DATABASE Database to which the import is made. The database needs to be created before importing. If not set, it is assumed that the database is specified in the file to be imported. If your SQL dump file includes a database statement, it will override the database set in this flag. + --if-exists + Include an SQL statement (IF EXISTS) with each DROP statement produced + by --clean; corresponds to the if-exists flag for pg_restore. Only + applies if --parallel is set. PostgreSQL only. + --parallel Perform a parallel import. This flag is only applicable to MySQL and Postgres. diff --git a/gcloud/storage/cp b/gcloud/storage/cp index 1c5da9eda..fc9d9f936 100644 --- a/gcloud/storage/cp +++ b/gcloud/storage/cp @@ -125,7 +125,10 @@ FLAGS Includes managed folders in command operations. For transfers, gcloud storage will set up managed folders in the destination with the same IAM policy bindings as the source. Managed folders are only included - with recursive cloud-to-cloud transfers. + with recursive cloud-to-cloud transfers. Please note that for + hierarchical namespace buckets, managed folders are always included. + Hence this flag would not be applicable to hierarchical namespace + buckets. --manifest-path=MANIFEST_PATH, -L MANIFEST_PATH Outputs a manifest log file with detailed information about each item diff --git a/gcloud/storage/mv b/gcloud/storage/mv index 96eeae8e4..72658e774 100644 --- a/gcloud/storage/mv +++ b/gcloud/storage/mv @@ -134,7 +134,10 @@ FLAGS Includes managed folders in command operations. For transfers, gcloud storage will set up managed folders in the destination with the same IAM policy bindings as the source. Managed folders are only included - with recursive cloud-to-cloud transfers. + with recursive cloud-to-cloud transfers. Please note that for + hierarchical namespace buckets, managed folders are always included. + Hence this flag would not be applicable to hierarchical namespace + buckets. --manifest-path=MANIFEST_PATH, -L MANIFEST_PATH Outputs a manifest log file with detailed information about each item diff --git a/gcloud/storage/rm b/gcloud/storage/rm index bc5655484..0533232df 100644 --- a/gcloud/storage/rm +++ b/gcloud/storage/rm @@ -71,7 +71,9 @@ FLAGS --exclude-managed-folders Excludes managed folders from command operations. By default gcloud - storage includes managed folders in recursive removals. + storage includes managed folders in recursive removals. Please note + that this flag would not be applicable for hierarchical namespace + buckets as we always list managed folders for these buckets. --read-paths-from-stdin, -I Read the list of URLs from stdin. diff --git a/gcloud/workstations/configs/create b/gcloud/workstations/configs/create index 0e83b7b67..511179fd5 100644 --- a/gcloud/workstations/configs/create +++ b/gcloud/workstations/configs/create @@ -25,7 +25,7 @@ SYNOPSIS [--service-account=SERVICE_ACCOUNT] [--service-account-scopes=[SERVICE_ACCOUNT_SCOPES,...]] [--shielded-integrity-monitoring] [--shielded-secure-boot] - [--shielded-vtpm] + [--shielded-vtpm] [--vm-tags=[VM_TAGS,...]] [--accelerator-count=ACCELERATOR_COUNT : --accelerator-type=ACCELERATOR_TYPE] [--container-custom-image=CONTAINER_CUSTOM_IMAGE @@ -249,6 +249,17 @@ FLAGS --shielded-vtpm Default value is false. If set, instances will have vTPM enabled. + --vm-tags=[VM_TAGS,...] + Resource manager tags to be bound to the instance. Tag keys and values + have the same definition as + https://cloud.google.com/resource-manager/docs/tags/tags-overview + + Example: + + $ gcloud workstations configs create \ + --vm-tags=tagKeys/key1=tagValues/value1,tagKeys/key2=tagValues/\ + value2 + Accelerator settings --accelerator-count=ACCELERATOR_COUNT diff --git a/gcloud/workstations/configs/update b/gcloud/workstations/configs/update index 96036d32d..81868e712 100644 --- a/gcloud/workstations/configs/update +++ b/gcloud/workstations/configs/update @@ -18,7 +18,7 @@ SYNOPSIS [--service-account=SERVICE_ACCOUNT] [--service-account-scopes=[SERVICE_ACCOUNT_SCOPES,...]] [--shielded-integrity-monitoring] [--shielded-secure-boot] - [--shielded-vtpm] + [--shielded-vtpm] [--vm-tags=[VM_TAGS,...]] [--accelerator-count=ACCELERATOR_COUNT : --accelerator-type=ACCELERATOR_TYPE] [--container-custom-image=CONTAINER_CUSTOM_IMAGE @@ -198,6 +198,17 @@ FLAGS --shielded-vtpm Default value is false. If set, instances will have vTPM enabled. + --vm-tags=[VM_TAGS,...] + Resource manager tags to be bound to the instance. Tag keys and values + have the same definition as + https://cloud.google.com/resource-manager/docs/tags/tags-overview + + Example: + + $ gcloud workstations configs update \ + --vm-tags=tagKeys/key1=tagValues/value1,tagKeys/key2=tagValues/\ + value2 + Accelerator settings --accelerator-count=ACCELERATOR_COUNT