From 9c53f3cabe585b807834d4e9f903b49f7212c204 Mon Sep 17 00:00:00 2001 From: Automated Date: Wed, 18 Dec 2024 10:08:20 +0000 Subject: [PATCH] gcloud: Wed Dec 18 10:08:20 UTC 2024 --- gcloud/_version | 12 +- gcloud/access-context-manager/policies/delete | 2 +- gcloud/alloydb/clusters/export | 118 +++++++++++ gcloud/alloydb/clusters/help | 3 + .../access-context-manager/policies/delete | 2 +- gcloud/alpha/alloydb/clusters/export | 6 +- gcloud/alpha/bigtable/instances/tables/create | 34 +++- gcloud/alpha/bigtable/instances/tables/update | 34 +++- gcloud/alpha/bigtable/tables/create | 34 +++- gcloud/alpha/bigtable/tables/update | 34 +++- .../interconnects/cross-site-networks/create | 48 +++++ .../interconnects/cross-site-networks/help | 28 +++ gcloud/alpha/compute/interconnects/help | 3 + .../alpha/compute/network-profiles/describe | 4 +- gcloud/alpha/compute/network-profiles/help | 4 +- gcloud/alpha/compute/network-profiles/list | 4 +- gcloud/alpha/compute/security-policies/update | 5 + gcloud/alpha/container/clusters/create | 9 +- gcloud/alpha/container/clusters/create-auto | 5 + gcloud/alpha/container/clusters/update | 13 ++ .../packages/resource-bundles/releases/create | 6 +- .../fleet/scopes/rbacrolebindings/create | 3 +- .../fleet/scopes/rbacrolebindings/update | 4 +- .../packages/resource-bundles/releases/create | 6 +- .../hub/scopes/rbacrolebindings/create | 3 +- .../hub/scopes/rbacrolebindings/update | 4 +- gcloud/alpha/functions/deploy | 5 + .../vms/machine-image-imports/create | 4 +- .../vms/machine-image-imports/delete | 4 +- .../vms/machine-image-imports/describe | 4 +- .../migration/vms/machine-image-imports/help | 22 ++- .../migration/vms/machine-image-imports/list | 4 +- .../intercept-endpoint-groups/create | 13 +- .../intercept-endpoint-groups/update | 12 +- .../mirroring-endpoint-groups/create | 13 +- .../mirroring-endpoint-groups/update | 12 +- .../security-profiles/custom-intercept/create | 127 ++++++++++++ .../security-profiles/custom-intercept/delete | 78 ++++++++ .../custom-intercept/describe | 73 +++++++ .../security-profiles/custom-intercept/help | 43 ++++ .../security-profiles/custom-intercept/list | 90 +++++++++ .../security-profiles/custom-intercept/update | 119 +++++++++++ .../network-security/security-profiles/help | 3 + gcloud/alpha/network-services/help | 3 + .../multicast-domain-groups/create | 87 +++++++++ .../multicast-domain-groups/delete | 74 +++++++ .../multicast-domain-groups/describe | 68 +++++++ .../multicast-domain-groups/help | 37 ++++ .../multicast-domain-groups/list | 89 +++++++++ .../network-services/route-views/describe | 4 +- .../alpha/network-services/route-views/help | 4 +- .../alpha/network-services/route-views/list | 4 +- gcloud/alpha/run/deploy | 26 ++- gcloud/alpha/run/multi-region-services/update | 26 ++- gcloud/alpha/run/services/update | 26 ++- gcloud/alpha/run/workers/deploy | 15 +- gcloud/alpha/run/workers/update | 15 +- gcloud/alpha/storage/buckets/describe | 7 +- gcloud/alpha/storage/buckets/list | 10 +- gcloud/app/deploy | 2 +- .../access-context-manager/policies/delete | 2 +- gcloud/beta/alloydb/clusters/export | 8 +- gcloud/beta/app/deploy | 2 +- gcloud/beta/bigtable/instances/tables/create | 34 +++- gcloud/beta/bigtable/instances/tables/update | 34 +++- gcloud/beta/bigtable/tables/create | 34 +++- gcloud/beta/bigtable/tables/update | 34 +++- gcloud/beta/colab/runtime-templates/create | 5 +- gcloud/beta/compute/network-profiles/describe | 6 +- gcloud/beta/compute/network-profiles/help | 6 +- gcloud/beta/compute/network-profiles/list | 6 +- gcloud/beta/compute/networks/subnets/update | 12 +- gcloud/beta/compute/security-policies/update | 5 + gcloud/beta/container/clusters/create | 9 +- gcloud/beta/container/clusters/create-auto | 5 + gcloud/beta/container/clusters/update | 13 ++ .../fleet/scopes/rbacrolebindings/create | 3 +- .../fleet/scopes/rbacrolebindings/update | 4 +- .../hub/scopes/rbacrolebindings/create | 3 +- .../hub/scopes/rbacrolebindings/update | 4 +- gcloud/beta/functions/deploy | 5 + .../intercept-endpoint-groups/create | 13 +- .../intercept-endpoint-groups/update | 12 +- .../mirroring-endpoint-groups/create | 8 + .../mirroring-endpoint-groups/update | 6 + .../security-profile-groups/create | 44 +++++ .../security-profiles/custom-intercept/create | 125 ++++++++++++ .../security-profiles/custom-intercept/delete | 76 ++++++++ .../custom-intercept/describe | 71 +++++++ .../security-profiles/custom-intercept/help | 41 ++++ .../security-profiles/custom-intercept/list | 88 +++++++++ .../security-profiles/custom-intercept/update | 117 +++++++++++ .../network-security/security-profiles/help | 3 + gcloud/beta/run/deploy | 19 +- gcloud/beta/run/multi-region-services/update | 19 +- gcloud/beta/run/services/update | 19 +- gcloud/bigtable/instances/tables/create | 34 +++- gcloud/bigtable/instances/tables/update | 34 +++- gcloud/bigtable/tables/create | 34 +++- gcloud/bigtable/tables/update | 34 +++- gcloud/colab/runtime-templates/create | 5 +- gcloud/compute/help | 3 + gcloud/compute/network-profiles/describe | 53 +++++ gcloud/compute/network-profiles/help | 30 +++ gcloud/compute/network-profiles/list | 67 +++++++ gcloud/compute/networks/create | 6 +- gcloud/compute/networks/subnets/update | 12 +- gcloud/container/clusters/create | 8 +- gcloud/container/clusters/create-auto | 5 + gcloud/container/clusters/update | 13 ++ .../fleet/scopes/rbacrolebindings/create | 3 +- .../fleet/scopes/rbacrolebindings/update | 4 +- .../hub/scopes/rbacrolebindings/create | 3 +- .../hub/scopes/rbacrolebindings/update | 4 +- gcloud/functions/deploy | 5 + gcloud/migration/vms/help | 4 + .../vms/machine-image-imports/create | 184 ++++++++++++++++++ .../vms/machine-image-imports/delete | 71 +++++++ .../vms/machine-image-imports/describe | 69 +++++++ .../migration/vms/machine-image-imports/help | 63 ++++++ .../migration/vms/machine-image-imports/list | 89 +++++++++ .../regional-endpoints/create | 6 +- gcloud/network-services/help | 3 + gcloud/network-services/route-views/describe | 99 ++++++++++ gcloud/network-services/route-views/help | 28 +++ gcloud/network-services/route-views/list | 117 +++++++++++ gcloud/run/deploy | 19 +- gcloud/run/services/update | 19 +- 128 files changed, 3295 insertions(+), 279 deletions(-) create mode 100644 gcloud/alloydb/clusters/export create mode 100644 gcloud/alpha/compute/interconnects/cross-site-networks/create create mode 100644 gcloud/alpha/compute/interconnects/cross-site-networks/help create mode 100644 gcloud/alpha/network-security/security-profiles/custom-intercept/create create mode 100644 gcloud/alpha/network-security/security-profiles/custom-intercept/delete create mode 100644 gcloud/alpha/network-security/security-profiles/custom-intercept/describe create mode 100644 gcloud/alpha/network-security/security-profiles/custom-intercept/help create mode 100644 gcloud/alpha/network-security/security-profiles/custom-intercept/list create mode 100644 gcloud/alpha/network-security/security-profiles/custom-intercept/update create mode 100644 gcloud/alpha/network-services/multicast-domain-groups/create create mode 100644 gcloud/alpha/network-services/multicast-domain-groups/delete create mode 100644 gcloud/alpha/network-services/multicast-domain-groups/describe create mode 100644 gcloud/alpha/network-services/multicast-domain-groups/help create mode 100644 gcloud/alpha/network-services/multicast-domain-groups/list create mode 100644 gcloud/beta/network-security/security-profiles/custom-intercept/create create mode 100644 gcloud/beta/network-security/security-profiles/custom-intercept/delete create mode 100644 gcloud/beta/network-security/security-profiles/custom-intercept/describe create mode 100644 gcloud/beta/network-security/security-profiles/custom-intercept/help create mode 100644 gcloud/beta/network-security/security-profiles/custom-intercept/list create mode 100644 gcloud/beta/network-security/security-profiles/custom-intercept/update create mode 100644 gcloud/compute/network-profiles/describe create mode 100644 gcloud/compute/network-profiles/help create mode 100644 gcloud/compute/network-profiles/list create mode 100644 gcloud/migration/vms/machine-image-imports/create create mode 100644 gcloud/migration/vms/machine-image-imports/delete create mode 100644 gcloud/migration/vms/machine-image-imports/describe create mode 100644 gcloud/migration/vms/machine-image-imports/help create mode 100644 gcloud/migration/vms/machine-image-imports/list create mode 100644 gcloud/network-services/route-views/describe create mode 100644 gcloud/network-services/route-views/help create mode 100644 gcloud/network-services/route-views/list diff --git a/gcloud/_version b/gcloud/_version index 5d366d17d..8e264c074 100644 --- a/gcloud/_version +++ b/gcloud/_version @@ -1,8 +1,8 @@ -Google Cloud SDK 503.0.0 -alpha 2024.12.06 -beta 2024.12.06 -bq 2.1.10 +Google Cloud SDK 504.0.0 +alpha 2024.12.13 +beta 2024.12.13 +bq 2.1.11 bundled-python3-unix 3.11.9 -core 2024.12.06 +core 2024.12.13 gcloud-crc32c 1.0.0 -gsutil 5.32 +gsutil 5.33 diff --git a/gcloud/access-context-manager/policies/delete b/gcloud/access-context-manager/policies/delete index 6b4dcc967..83e591131 100644 --- a/gcloud/access-context-manager/policies/delete +++ b/gcloud/access-context-manager/policies/delete @@ -9,7 +9,7 @@ DESCRIPTION Delete a given access policy. POSITIONAL ARGUMENTS - Policy resource - The access level you want to delete. This represents a + Policy resource - The access policy you want to delete. This represents a Cloud resource. [POLICY] diff --git a/gcloud/alloydb/clusters/export b/gcloud/alloydb/clusters/export new file mode 100644 index 000000000..b77c35299 --- /dev/null +++ b/gcloud/alloydb/clusters/export @@ -0,0 +1,118 @@ +NAME + gcloud alloydb clusters export - export data from an AlloyDB cluster to + Google Cloud Storage + +SYNOPSIS + gcloud alloydb clusters export CLUSTER --database=DATABASE + --gcs-uri=GCS_URI --region=REGION + ([--csv --select-query=SELECT_QUERY + : --escape-character=ESCAPE_CHARACTER + --field-delimiter=FIELD_DELIMITER --quote-character=QUOTE_CHARACTER] + | [--sql : --schema-only --tables=TABLES [--clean-target-objects + : --if-exist-target-objects]]) [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Export data from an AlloyDB cluster to Google Cloud Storage. + +EXAMPLES + To export a cluster, run: + + $ gcloud alloydb clusters export my-cluster --region=us-central1 \ + --database=my-database \ + --gcs-uri=gs://my-bucket/my-export-file-path --csv \ + --select-query="SELECT * FROM my-table" + +POSITIONAL ARGUMENTS + CLUSTER + AlloyDB cluster ID + +REQUIRED FLAGS + --database=DATABASE + Database name from which export has to be done. + + Destination URI where the file needs to be exported. + + This must be specified. + + --gcs-uri=GCS_URI + Path to the Google Cloud Storage file to which export has to be done. + + --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. + + Export options for the cluster. + + Exactly one of these must be specified: + + CSV export options for the cluster. + + --csv + Specifies destination file type. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --select-query=SELECT_QUERY + Select query to be used for export. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --escape-character=ESCAPE_CHARACTER + Escape character to be used for export. + + --field-delimiter=FIELD_DELIMITER + Field delimiter to be used for export. + + --quote-character=QUOTE_CHARACTER + Quote character to be used for export. + + SQL export options for the cluster. + + --sql + Specifies destination file type. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --schema-only + Export only schema of the database. + + --tables=TABLES + Comma-separated list of table names which need to be exported. + + SQL export options to clean target objects. + + --clean-target-objects + If true, output commands to DROP all the dumped database objects + prior to outputting the commands for creating them. + + This flag argument must be specified if any of the other + arguments in this group are specified. + + --if-exist-target-objects + If true, use DROP ... IF EXISTS commands to check for the + object's existence before dropping it in clean_target_objects + mode. + +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 export + + $ gcloud beta alloydb clusters export + diff --git a/gcloud/alloydb/clusters/help b/gcloud/alloydb/clusters/help index 2d2fcf6c9..be9cfe499 100644 --- a/gcloud/alloydb/clusters/help +++ b/gcloud/alloydb/clusters/help @@ -28,6 +28,9 @@ COMMANDS describe Describe an AlloyDB cluster in a given project and region. + export + Export data from an AlloyDB cluster to Google Cloud Storage. + list List AlloyDB clusters in a given project and region. diff --git a/gcloud/alpha/access-context-manager/policies/delete b/gcloud/alpha/access-context-manager/policies/delete index 444a8cec6..946de6aa8 100644 --- a/gcloud/alpha/access-context-manager/policies/delete +++ b/gcloud/alpha/access-context-manager/policies/delete @@ -10,7 +10,7 @@ DESCRIPTION (ALPHA) Delete a given access policy. POSITIONAL ARGUMENTS - Policy resource - The access level you want to delete. This represents a + Policy resource - The access policy you want to delete. This represents a Cloud resource. [POLICY] diff --git a/gcloud/alpha/alloydb/clusters/export b/gcloud/alpha/alloydb/clusters/export index e55fcef36..c402a0de3 100644 --- a/gcloud/alpha/alloydb/clusters/export +++ b/gcloud/alpha/alloydb/clusters/export @@ -19,7 +19,7 @@ EXAMPLES $ gcloud alpha alloydb clusters export my-cluster \ --region=us-central1 --database=my-database \ - --gcs-uri=gs://my-bucket/my-export-file-path \ + --gcs-uri=gs://my-bucket/my-export-file-path --csv \ --select-query="SELECT * FROM my-table" POSITIONAL ARGUMENTS @@ -113,7 +113,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 alloydb clusters export $ gcloud beta alloydb clusters export diff --git a/gcloud/alpha/bigtable/instances/tables/create b/gcloud/alpha/bigtable/instances/tables/create index 505d4c037..8951c9222 100644 --- a/gcloud/alpha/bigtable/instances/tables/create +++ b/gcloud/alpha/bigtable/instances/tables/create @@ -6,8 +6,9 @@ SYNOPSIS gcloud alpha bigtable instances tables create (TABLE : --instance=INSTANCE) --column-families=[COLUMN_FAMILIES,...] [--change-stream-retention-period=CHANGE_STREAM_RETENTION_PERIOD] - [--deletion-protection] [--enable-automated-backup] - [--splits=[SPLITS,...]] [GCLOUD_WIDE_FLAG ...] + [--deletion-protection] [--splits=[SPLITS,...]] + [--automated-backup-retention-period=AUTOMATED_BACKUP_RETENTION_PERIOD + | --enable-automated-backup] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Create a new Cloud Bigtable table. @@ -60,14 +61,22 @@ EXAMPLES --instance=my-instance --column-families="my-family" \ --no-deletion-protection - To create a table my-table with automated backup policy - (retention_period=72h, frequency=24h) enabled in instance my-instance with - a column family my-family, run: + To create a table my-table with the default automated backup policy + (retention_period=7d, frequency=1d) enabled in instance my-instance with a + column family my-family, run: $ gcloud alpha bigtable instances tables create my-table \ --instance=my-instance --column-families="my-family" \ --enable-automated-backup + To create a table my-table with a custom automated backup policy configured + to retain backups for 30 days in instance my-instance with a column family + my-family, run: + + $ gcloud alpha bigtable instances tables create my-table \ + --instance=my-instance --column-families="my-family" \ + --automated-backup-retention_period=30d + POSITIONAL ARGUMENTS Table resource - Cloud Bigtable table to create. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some @@ -116,14 +125,21 @@ OPTIONAL FLAGS --deletion-protection Once specified, the table is deletion protected. - --enable-automated-backup - Once set, enables the default automated backup policy - (retention_period=72h, frequency=24h) for the table. - --splits=[SPLITS,...] Row keys where the table should initially be split. For example: car,key + At most one of these can be specified: + + --automated-backup-retention-period=AUTOMATED_BACKUP_RETENTION_PERIOD + The retention period of automated backup in the format of 30d for 30 + days. Min retention period is 3d and max is 90d. Setting this flag + will enable automated backup for the table. + + --enable-automated-backup + Once set, enables the default automated backup policy + (retention_period=7d, frequency=1d) for the table. + 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/bigtable/instances/tables/update b/gcloud/alpha/bigtable/instances/tables/update index 42277eec2..9e11c1ba3 100644 --- a/gcloud/alpha/bigtable/instances/tables/update +++ b/gcloud/alpha/bigtable/instances/tables/update @@ -4,8 +4,9 @@ NAME SYNOPSIS gcloud alpha bigtable instances tables update (TABLE : --instance=INSTANCE) - [--async] [--deletion-protection] [--disable-automated-backup] - [--enable-automated-backup] + [--async] [--deletion-protection] + [--automated-backup-retention-period=AUTOMATED_BACKUP_RETENTION_PERIOD + | --disable-automated-backup | --enable-automated-backup] [--change-stream-retention-period=CHANGE_STREAM_RETENTION_PERIOD | --clear-change-stream-retention-period] [GCLOUD_WIDE_FLAG ...] @@ -35,8 +36,8 @@ EXAMPLES $ gcloud alpha bigtable instances tables update my-table \ --instance=my-instance --clear-change-stream-retention-period - To enable default automated backup policy (retention_period=72h, - frequency=24h), run: + To enable the default automated backup policy on a table, or update a table + to use the default policy (retention_period=7d, frequency=1d), run: $ gcloud alpha bigtable instances tables update my-table \ --instance=my-instance --enable-automated-backup @@ -46,6 +47,12 @@ EXAMPLES $ gcloud alpha bigtable instances tables update my-table \ --instance=my-instance --disable-automated-backup + To enable or update a custom automated backup policy and configure it to + retain backups for 30 days, run: + + $ gcloud alpha bigtable instances tables update my-table \ + --instance=my-instance --automated-backup-retention_period=30d + POSITIONAL ARGUMENTS Table resource - Cloud Bigtable table to update. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some @@ -85,12 +92,21 @@ FLAGS --deletion-protection Once specified, the table is deletion protected. - --disable-automated-backup - Once set, disables automated backup policy for the table. + At most one of these can be specified: - --enable-automated-backup - Once set, enables the default automated backup policy - (retention_period=72h, frequency=24h) for the table. + --automated-backup-retention-period=AUTOMATED_BACKUP_RETENTION_PERIOD + The retention period of automated backup in the format of 30d for 30 + days. Min retention period is 3d and max is 90d. Setting this flag + will enable automated backup for the table. + + --disable-automated-backup + Once set, disables automated backup policy for the table. + + --enable-automated-backup + Once set, enables the default automated backup policy + (retention_period=7d, frequency=1d) for the table. Note: If a table + has automated backup enabled, this flag resets it to the default + policy. At most one of these can be specified: diff --git a/gcloud/alpha/bigtable/tables/create b/gcloud/alpha/bigtable/tables/create index 2819c554d..65725205a 100644 --- a/gcloud/alpha/bigtable/tables/create +++ b/gcloud/alpha/bigtable/tables/create @@ -5,8 +5,9 @@ SYNOPSIS gcloud alpha bigtable tables create (TABLE : --instance=INSTANCE) --column-families=[COLUMN_FAMILIES,...] [--change-stream-retention-period=CHANGE_STREAM_RETENTION_PERIOD] - [--deletion-protection] [--enable-automated-backup] - [--splits=[SPLITS,...]] [GCLOUD_WIDE_FLAG ...] + [--deletion-protection] [--splits=[SPLITS,...]] + [--automated-backup-retention-period=AUTOMATED_BACKUP_RETENTION_PERIOD + | --enable-automated-backup] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Create a new Cloud Bigtable table. @@ -59,14 +60,22 @@ EXAMPLES --instance=my-instance --column-families="my-family" \ --no-deletion-protection - To create a table my-table with automated backup policy - (retention_period=72h, frequency=24h) enabled in instance my-instance with - a column family my-family, run: + To create a table my-table with the default automated backup policy + (retention_period=7d, frequency=1d) enabled in instance my-instance with a + column family my-family, run: $ gcloud alpha bigtable tables create my-table \ --instance=my-instance --column-families="my-family" \ --enable-automated-backup + To create a table my-table with a custom automated backup policy configured + to retain backups for 30 days in instance my-instance with a column family + my-family, run: + + $ gcloud alpha bigtable tables create my-table \ + --instance=my-instance --column-families="my-family" \ + --automated-backup-retention_period=30d + POSITIONAL ARGUMENTS Table resource - Cloud Bigtable table to create. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some @@ -115,14 +124,21 @@ OPTIONAL FLAGS --deletion-protection Once specified, the table is deletion protected. - --enable-automated-backup - Once set, enables the default automated backup policy - (retention_period=72h, frequency=24h) for the table. - --splits=[SPLITS,...] Row keys where the table should initially be split. For example: car,key + At most one of these can be specified: + + --automated-backup-retention-period=AUTOMATED_BACKUP_RETENTION_PERIOD + The retention period of automated backup in the format of 30d for 30 + days. Min retention period is 3d and max is 90d. Setting this flag + will enable automated backup for the table. + + --enable-automated-backup + Once set, enables the default automated backup policy + (retention_period=7d, frequency=1d) for the table. + 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/bigtable/tables/update b/gcloud/alpha/bigtable/tables/update index 6653ab4aa..1c42e32d1 100644 --- a/gcloud/alpha/bigtable/tables/update +++ b/gcloud/alpha/bigtable/tables/update @@ -4,8 +4,9 @@ NAME SYNOPSIS gcloud alpha bigtable tables update (TABLE : --instance=INSTANCE) [--async] - [--deletion-protection] [--disable-automated-backup] - [--enable-automated-backup] + [--deletion-protection] + [--automated-backup-retention-period=AUTOMATED_BACKUP_RETENTION_PERIOD + | --disable-automated-backup | --enable-automated-backup] [--change-stream-retention-period=CHANGE_STREAM_RETENTION_PERIOD | --clear-change-stream-retention-period] [GCLOUD_WIDE_FLAG ...] @@ -35,8 +36,8 @@ EXAMPLES $ gcloud alpha bigtable tables update my-table \ --instance=my-instance --clear-change-stream-retention-period - To enable default automated backup policy (retention_period=72h, - frequency=24h), run: + To enable the default automated backup policy on a table, or update a table + to use the default policy (retention_period=7d, frequency=1d), run: $ gcloud alpha bigtable tables update my-table \ --instance=my-instance --enable-automated-backup @@ -46,6 +47,12 @@ EXAMPLES $ gcloud alpha bigtable tables update my-table \ --instance=my-instance --disable-automated-backup + To enable or update a custom automated backup policy and configure it to + retain backups for 30 days, run: + + $ gcloud alpha bigtable tables update my-table \ + --instance=my-instance --automated-backup-retention_period=30d + POSITIONAL ARGUMENTS Table resource - Cloud Bigtable table to update. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some @@ -85,12 +92,21 @@ FLAGS --deletion-protection Once specified, the table is deletion protected. - --disable-automated-backup - Once set, disables automated backup policy for the table. + At most one of these can be specified: - --enable-automated-backup - Once set, enables the default automated backup policy - (retention_period=72h, frequency=24h) for the table. + --automated-backup-retention-period=AUTOMATED_BACKUP_RETENTION_PERIOD + The retention period of automated backup in the format of 30d for 30 + days. Min retention period is 3d and max is 90d. Setting this flag + will enable automated backup for the table. + + --disable-automated-backup + Once set, disables automated backup policy for the table. + + --enable-automated-backup + Once set, enables the default automated backup policy + (retention_period=7d, frequency=1d) for the table. Note: If a table + has automated backup enabled, this flag resets it to the default + policy. At most one of these can be specified: diff --git a/gcloud/alpha/compute/interconnects/cross-site-networks/create b/gcloud/alpha/compute/interconnects/cross-site-networks/create new file mode 100644 index 000000000..af845a8ae --- /dev/null +++ b/gcloud/alpha/compute/interconnects/cross-site-networks/create @@ -0,0 +1,48 @@ +NAME + gcloud alpha compute interconnects cross-site-networks create - create a + Compute Engine cross site network + +SYNOPSIS + gcloud alpha compute interconnects cross-site-networks create NAME + --project=PROJECT [--description=DESCRIPTION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) gcloud alpha compute interconnects cross-site-networks create is + used to create cross site networks. A cross site network contains wire + groups. + + For an example, refer to the EXAMPLES section below. + +EXAMPLES + To create a cross site network, run: + + $ gcloud alpha compute interconnects cross-site-networks create \ + example-cross-site-network --project=my-project \ + --description="Example cross site network" + +POSITIONAL ARGUMENTS + NAME + Name of the cross site network to create. + +REQUIRED FLAGS + --project=PROJECT + A project for the cross site network. + +OPTIONAL FLAGS + --description=DESCRIPTION + An optional, textual description for the cross site network. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/compute/interconnects/cross-site-networks/help b/gcloud/alpha/compute/interconnects/cross-site-networks/help new file mode 100644 index 000000000..8300fbba0 --- /dev/null +++ b/gcloud/alpha/compute/interconnects/cross-site-networks/help @@ -0,0 +1,28 @@ +NAME + gcloud alpha compute interconnects cross-site-networks - create or + manipulate cross site networks + +SYNOPSIS + gcloud alpha compute interconnects cross-site-networks COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create or manipulate cross site networks. + +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 Compute Engine cross site network. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/compute/interconnects/help b/gcloud/alpha/compute/interconnects/help index b52350889..95b34fd2f 100644 --- a/gcloud/alpha/compute/interconnects/help +++ b/gcloud/alpha/compute/interconnects/help @@ -26,6 +26,9 @@ GROUPS attachments (ALPHA) Read and manipulate Compute Engine interconnect attachments. + cross-site-networks + (ALPHA) Create or manipulate cross site networks. + groups (ALPHA) Create or manipulate interconnect groups. diff --git a/gcloud/alpha/compute/network-profiles/describe b/gcloud/alpha/compute/network-profiles/describe index 6e95cfd4e..30e0af4b5 100644 --- a/gcloud/alpha/compute/network-profiles/describe +++ b/gcloud/alpha/compute/network-profiles/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 compute network-profiles describe $ gcloud beta compute network-profiles describe diff --git a/gcloud/alpha/compute/network-profiles/help b/gcloud/alpha/compute/network-profiles/help index cf3c79ab3..21eaef2ac 100644 --- a/gcloud/alpha/compute/network-profiles/help +++ b/gcloud/alpha/compute/network-profiles/help @@ -26,7 +26,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 network-profiles $ gcloud beta compute network-profiles diff --git a/gcloud/alpha/compute/network-profiles/list b/gcloud/alpha/compute/network-profiles/list index 29d85507b..c8be55b98 100644 --- a/gcloud/alpha/compute/network-profiles/list +++ b/gcloud/alpha/compute/network-profiles/list @@ -62,7 +62,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud compute network-profiles list $ gcloud beta compute network-profiles list diff --git a/gcloud/alpha/compute/security-policies/update b/gcloud/alpha/compute/security-policies/update index 52b7c4523..d8bbd4f53 100644 --- a/gcloud/alpha/compute/security-policies/update +++ b/gcloud/alpha/compute/security-policies/update @@ -16,6 +16,7 @@ SYNOPSIS [--log-level=LOG_LEVEL] [--network-ddos-protection=NETWORK_DDOS_PROTECTION] [--recaptcha-redirect-site-key=RECAPTCHA_REDIRECT_SITE_KEY] + [--request-body-inspection-size=REQUEST_BODY_INSPECTION_SIZE] [--user-ip-request-headers=[USER_IP_REQUEST_HEADER,...]] [--global | --region=REGION] [GCLOUD_WIDE_FLAG ...] @@ -92,6 +93,10 @@ FLAGS The reCAPTCHA site key to be used for rules using the redirect action and the google-recaptcha redirect type under the security policy. + --request-body-inspection-size=REQUEST_BODY_INSPECTION_SIZE + Maximum request body inspection size. REQUEST_BODY_INSPECTION_SIZE must + be one of: 8KB, 128KB. + --user-ip-request-headers=[USER_IP_REQUEST_HEADER,...] A comma-separated list of request header names to use for resolving the caller's user IP address. diff --git a/gcloud/alpha/container/clusters/create b/gcloud/alpha/container/clusters/create index f073318c9..45bee0dc9 100644 --- a/gcloud/alpha/container/clusters/create +++ b/gcloud/alpha/container/clusters/create @@ -24,8 +24,9 @@ SYNOPSIS [--create-subnetwork=[KEY=VALUE,...]] [--database-encryption-key=DATABASE_ENCRYPTION_KEY] [--default-max-pods-per-node=DEFAULT_MAX_PODS_PER_NODE] - [--disable-default-snat] [--disable-pod-cidr-overprovision] - [--disk-size=DISK_SIZE] [--disk-type=DISK_TYPE] + [--disable-default-snat] [--disable-l4-lb-firewall-reconciliation] + [--disable-pod-cidr-overprovision] [--disk-size=DISK_SIZE] + [--disk-type=DISK_TYPE] [--enable-authorized-networks-on-private-endpoint] [--enable-autorepair] [--no-enable-autoupgrade] [--enable-cilium-clusterwide-network-policy] [--enable-cloud-logging] @@ -444,6 +445,10 @@ FLAGS requires that you also set --enable-ip-alias and --enable-private-nodes. + --disable-l4-lb-firewall-reconciliation + Disable reconciliation on the cluster for L4 Load Balancer VPC + firewalls targeting ingress traffic. + --disable-pod-cidr-overprovision Disables pod cidr overprovision on nodes. Pod cidr overprovisioning is enabled by default. diff --git a/gcloud/alpha/container/clusters/create-auto b/gcloud/alpha/container/clusters/create-auto index 05559668c..64e05dd03 100644 --- a/gcloud/alpha/container/clusters/create-auto +++ b/gcloud/alpha/container/clusters/create-auto @@ -15,6 +15,7 @@ SYNOPSIS [--containerd-config-from-file=PATH_TO_FILE] [--create-subnetwork=[KEY=VALUE,...]] [--database-encryption-key=DATABASE_ENCRYPTION_KEY] + [--disable-l4-lb-firewall-reconciliation] [--enable-authorized-networks-on-private-endpoint] [--enable-backup-restore] [--enable-cilium-clusterwide-network-policy] [--enable-dns-access] [--enable-fleet] [--enable-google-cloud-access] @@ -235,6 +236,10 @@ FLAGS For more information, see https://cloud.google.com/kubernetes-engine/docs/how-to/encrypting-secrets. + --disable-l4-lb-firewall-reconciliation + Disable reconciliation on the cluster for L4 Load Balancer VPC + firewalls targeting ingress traffic. + --enable-authorized-networks-on-private-endpoint Enable enforcement of --master-authorized-networks CIDR ranges for traffic reaching cluster's control plane via private IP. diff --git a/gcloud/alpha/container/clusters/update b/gcloud/alpha/container/clusters/update index 00cea3100..de7a014bd 100644 --- a/gcloud/alpha/container/clusters/update +++ b/gcloud/alpha/container/clusters/update @@ -80,6 +80,8 @@ SYNOPSIS | --disable-dataplane-v2-flow-observability | --enable-dataplane-v2-flow-observability --disable-dataplane-v2-metrics | --enable-dataplane-v2-metrics + | --disable-l4-lb-firewall-reconciliation + | --enable-l4-lb-firewall-reconciliation | --enable-authorized-networks-on-private-endpoint --enable-dns-access --enable-google-cloud-access --enable-ip-access --enable-master-global-access --enable-private-endpoint @@ -1186,6 +1188,17 @@ REQUIRED FLAGS --enable-dataplane-v2-metrics Exposes advanced datapath flow metrics on node port. + At most one of these can be specified: + + --disable-l4-lb-firewall-reconciliation + Disable reconciliation on the cluster for L4 Load Balancer VPC + firewalls targeting ingress traffic. + + --enable-l4-lb-firewall-reconciliation + Enable reconciliation on the cluster for L4 Load Balancer VPC + firewalls targeting ingress traffic. L4 LB VPC firewall + reconciliation is enabled by default. + --enable-authorized-networks-on-private-endpoint Enable enforcement of --master-authorized-networks CIDR ranges for traffic reaching cluster's control plane via private IP. diff --git a/gcloud/alpha/container/fleet/packages/resource-bundles/releases/create b/gcloud/alpha/container/fleet/packages/resource-bundles/releases/create index 3b07548de..a46fa58dc 100644 --- a/gcloud/alpha/container/fleet/packages/resource-bundles/releases/create +++ b/gcloud/alpha/container/fleet/packages/resource-bundles/releases/create @@ -5,7 +5,7 @@ NAME SYNOPSIS gcloud alpha container fleet packages resource-bundles releases create --resource-bundle=RESOURCE_BUNDLE --source=SOURCE --version=VERSION - [--lifecycle=LIFECYCLE] [--location=LOCATION] + [--lifecycle=LIFECYCLE] [--location=LOCATION] [--use-nested-variants] [--variants-pattern=VARIANTS_PATTERN] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -50,6 +50,10 @@ OPTIONAL FLAGS --location=LOCATION Google Cloud zone or region. + --use-nested-variants + Whether to use nested variants. If true, the Release will create + variants as nested resources. + --variants-pattern=VARIANTS_PATTERN Glob pattern to Variants of the Release, to be paired with the --source arg. ex: --source=/manifests-dir/ --variants-pattern=**, diff --git a/gcloud/alpha/container/fleet/scopes/rbacrolebindings/create b/gcloud/alpha/container/fleet/scopes/rbacrolebindings/create index 90496bc0a..fb1370da2 100644 --- a/gcloud/alpha/container/fleet/scopes/rbacrolebindings/create +++ b/gcloud/alpha/container/fleet/scopes/rbacrolebindings/create @@ -69,7 +69,8 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS --role=ROLE - Role to assign. ROLE must be one of: admin, edit, view. + Predefined role to assign to principal (admin, edit, view). ROLE must + be one of: admin, edit, view. Exactly one of these must be specified: diff --git a/gcloud/alpha/container/fleet/scopes/rbacrolebindings/update b/gcloud/alpha/container/fleet/scopes/rbacrolebindings/update index 3d4c394b8..c47ed845a 100644 --- a/gcloud/alpha/container/fleet/scopes/rbacrolebindings/update +++ b/gcloud/alpha/container/fleet/scopes/rbacrolebindings/update @@ -70,8 +70,8 @@ POSITIONAL ARGUMENTS FLAGS --role=ROLE - Role for the RBACRoleBinding to update to. ROLE must be one of: admin, - edit, view. + Predefined role to assign to principal (admin, edit, view). ROLE must + be one of: admin, edit, view. --update-labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to update. If a label exists, its value diff --git a/gcloud/alpha/container/hub/packages/resource-bundles/releases/create b/gcloud/alpha/container/hub/packages/resource-bundles/releases/create index 5633e2fc6..56a6950b0 100644 --- a/gcloud/alpha/container/hub/packages/resource-bundles/releases/create +++ b/gcloud/alpha/container/hub/packages/resource-bundles/releases/create @@ -5,7 +5,7 @@ NAME SYNOPSIS gcloud alpha container hub packages resource-bundles releases create --resource-bundle=RESOURCE_BUNDLE --source=SOURCE --version=VERSION - [--lifecycle=LIFECYCLE] [--location=LOCATION] + [--lifecycle=LIFECYCLE] [--location=LOCATION] [--use-nested-variants] [--variants-pattern=VARIANTS_PATTERN] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -50,6 +50,10 @@ OPTIONAL FLAGS --location=LOCATION Google Cloud zone or region. + --use-nested-variants + Whether to use nested variants. If true, the Release will create + variants as nested resources. + --variants-pattern=VARIANTS_PATTERN Glob pattern to Variants of the Release, to be paired with the --source arg. ex: --source=/manifests-dir/ --variants-pattern=**, diff --git a/gcloud/alpha/container/hub/scopes/rbacrolebindings/create b/gcloud/alpha/container/hub/scopes/rbacrolebindings/create index 9a5bf86dc..9ecd86215 100644 --- a/gcloud/alpha/container/hub/scopes/rbacrolebindings/create +++ b/gcloud/alpha/container/hub/scopes/rbacrolebindings/create @@ -69,7 +69,8 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS --role=ROLE - Role to assign. ROLE must be one of: admin, edit, view. + Predefined role to assign to principal (admin, edit, view). ROLE must + be one of: admin, edit, view. Exactly one of these must be specified: diff --git a/gcloud/alpha/container/hub/scopes/rbacrolebindings/update b/gcloud/alpha/container/hub/scopes/rbacrolebindings/update index c08fcce5a..15ed59f51 100644 --- a/gcloud/alpha/container/hub/scopes/rbacrolebindings/update +++ b/gcloud/alpha/container/hub/scopes/rbacrolebindings/update @@ -70,8 +70,8 @@ POSITIONAL ARGUMENTS FLAGS --role=ROLE - Role for the RBACRoleBinding to update to. ROLE must be one of: admin, - edit, view. + Predefined role to assign to principal (admin, edit, view). ROLE must + be one of: admin, edit, view. --update-labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to update. If a label exists, its value diff --git a/gcloud/alpha/functions/deploy b/gcloud/alpha/functions/deploy index 6231ff1da..8e4ece3ff 100644 --- a/gcloud/alpha/functions/deploy +++ b/gcloud/alpha/functions/deploy @@ -381,6 +381,11 @@ FLAGS DOCKER_REPOSITORY must be an Artifact Registry Docker repository present in the same project and location as the Cloud Function. + **Preview:** for 2nd gen functions, a Docker Artifact registry + repository in a different project and/or location may be used. + Additional requirements apply, see + https://cloud.google.com/functions/docs/building#image_registry + The repository name should match one of these patterns: ▸ projects/${PROJECT}/locations/${LOCATION}/repositories/${REPOSITORY}, diff --git a/gcloud/alpha/migration/vms/machine-image-imports/create b/gcloud/alpha/migration/vms/machine-image-imports/create index e48b8cc89..168d5fe26 100644 --- a/gcloud/alpha/migration/vms/machine-image-imports/create +++ b/gcloud/alpha/migration/vms/machine-image-imports/create @@ -181,5 +181,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud migration vms machine-image-imports create diff --git a/gcloud/alpha/migration/vms/machine-image-imports/delete b/gcloud/alpha/migration/vms/machine-image-imports/delete index 2c79760b0..bf1b7685a 100644 --- a/gcloud/alpha/migration/vms/machine-image-imports/delete +++ b/gcloud/alpha/migration/vms/machine-image-imports/delete @@ -68,5 +68,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud migration vms machine-image-imports delete diff --git a/gcloud/alpha/migration/vms/machine-image-imports/describe b/gcloud/alpha/migration/vms/machine-image-imports/describe index c67dc3279..34019000e 100644 --- a/gcloud/alpha/migration/vms/machine-image-imports/describe +++ b/gcloud/alpha/migration/vms/machine-image-imports/describe @@ -66,5 +66,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud migration vms machine-image-imports describe diff --git a/gcloud/alpha/migration/vms/machine-image-imports/help b/gcloud/alpha/migration/vms/machine-image-imports/help index 25b6835d5..f1481adca 100644 --- a/gcloud/alpha/migration/vms/machine-image-imports/help +++ b/gcloud/alpha/migration/vms/machine-image-imports/help @@ -7,20 +7,20 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) gcloud alpha migration vms machine-image-imports provides a more - robust and better supported method for importing machine images to Google - Compute Engine. Other image-related operations (for example, list) can be - done using gcloud compute images, as usual. + (ALPHA) gcloud migration vms machine-image-imports provides a more robust + and better supported method for importing machine images to Google Compute + Engine. Other image-related operations (for example, list) can be done + using gcloud compute images, as usual. The commands use VM Migration API which supports importing of a machine image from a Google Cloud Storage file (gs://...) to a target project. VM Migration API must be enabled in your project. - gcloud alpha migration vms machine-image-imports create creates a machine - Image Import resource with a nested Image Import Job resource. The Image - Import Job resource tracks the machine image import progress. After the - Image Import Job completes, successfully or otherwise, there's no further - use for the Image Import resource. + gcloud migration vms machine-image-imports create creates a machine Image + Import resource with a nested Image Import Job resource. The Image Import + Job resource tracks the machine image import progress. After the Image + Import Job completes, successfully or otherwise, there's no further use for + the Image Import resource. The machine image is imported to a Google Cloud Project, desginated by the Target Project resource. To get a list of Target Projects, run the gcloud @@ -61,5 +61,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud migration vms machine-image-imports diff --git a/gcloud/alpha/migration/vms/machine-image-imports/list b/gcloud/alpha/migration/vms/machine-image-imports/list index a263c6cd6..c23423934 100644 --- a/gcloud/alpha/migration/vms/machine-image-imports/list +++ b/gcloud/alpha/migration/vms/machine-image-imports/list @@ -86,5 +86,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud migration vms machine-image-imports list diff --git a/gcloud/alpha/network-security/intercept-endpoint-groups/create b/gcloud/alpha/network-security/intercept-endpoint-groups/create index ca558d28b..fc21c2c9c 100644 --- a/gcloud/alpha/network-security/intercept-endpoint-groups/create +++ b/gcloud/alpha/network-security/intercept-endpoint-groups/create @@ -7,7 +7,7 @@ SYNOPSIS (INTERCEPT_ENDPOINT_GROUP : --location=LOCATION) (--intercept-deployment-group=INTERCEPT_DEPLOYMENT_GROUP : --intercept-deployment-group-location=INTERCEPT_DEPLOYMENT_GROUP_LOCATION) - [--async] [--labels=[KEY=VALUE,...]] + [--async] [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] [--max-wait=MAX_WAIT; default="20m"] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -39,6 +39,14 @@ EXAMPLES --intercept-deployment-group=projects/my-project/locations/\ global/interceptDeploymentGroups/my-deployment-group + OR + + $ gcloud alpha network-security intercept-endpoint-groups create \ + my-endpoint-group --project=my-project --location=global \ + --mirroring-deployment-group=projects/my-project/locations/\ + global/interceptDeploymentGroups/my-deployment-group \ + --description='new description' + POSITIONAL ARGUMENTS Intercept endpoint group resource - Intercept Endpoint Group. The arguments in this group can be used to specify the attributes of this @@ -115,6 +123,9 @@ OPTIONAL FLAGS complete. The default is True. Enabled by default, use --no-async to disable. + --description=DESCRIPTION + Description of the endpoint + --labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to add. diff --git a/gcloud/alpha/network-security/intercept-endpoint-groups/update b/gcloud/alpha/network-security/intercept-endpoint-groups/update index de09c2b33..217d1ed93 100644 --- a/gcloud/alpha/network-security/intercept-endpoint-groups/update +++ b/gcloud/alpha/network-security/intercept-endpoint-groups/update @@ -5,7 +5,8 @@ NAME SYNOPSIS gcloud alpha network-security intercept-endpoint-groups update (INTERCEPT_ENDPOINT_GROUP : --location=LOCATION) [--async] - [--max-wait=MAX_WAIT; default="20m"] [--update-labels=[KEY=VALUE,...]] + [--description=DESCRIPTION] [--max-wait=MAX_WAIT; default="20m"] + [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -34,6 +35,12 @@ EXAMPLES my-endpoint-group --project=my-project \ --location=us-central1-a --clear-labels + To update description to 'new description', run: + + $ gcloud alpha network-security intercept-endpoint-groups update \ + my-endpoint-group --project=my-project \ + --location=us-central1-a --description='new description' + POSITIONAL ARGUMENTS Intercept endpoint group resource - Intercept Endpoint Group. The arguments in this group can be used to specify the attributes of this @@ -73,6 +80,9 @@ FLAGS complete. The default is True. Enabled by default, use --no-async to disable. + --description=DESCRIPTION + Description of the endpoint + --max-wait=MAX_WAIT; default="20m" Time to synchronously wait for the operation to complete, after which the operation continues asynchronously. Ignored if --no-async isn't diff --git a/gcloud/alpha/network-security/mirroring-endpoint-groups/create b/gcloud/alpha/network-security/mirroring-endpoint-groups/create index a78cc19e2..04f0fa520 100644 --- a/gcloud/alpha/network-security/mirroring-endpoint-groups/create +++ b/gcloud/alpha/network-security/mirroring-endpoint-groups/create @@ -7,7 +7,7 @@ SYNOPSIS (MIRRORING_ENDPOINT_GROUP : --location=LOCATION) (--mirroring-deployment-group=MIRRORING_DEPLOYMENT_GROUP : --mirroring-deployment-group-location=MIRRORING_DEPLOYMENT_GROUP_LOCATION) - [--async] [--labels=[KEY=VALUE,...]] + [--async] [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] [--max-wait=MAX_WAIT; default="20m"] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -39,6 +39,14 @@ EXAMPLES --mirroring-deployment-group=projects/my-project/locations/\ global/mirroringDeploymentGroups/my-deployment-group + OR + + $ gcloud alpha network-security mirroring-endpoint-groups create \ + my-endpoint-group --project=my-project --location=global \ + --mirroring-deployment-group=projects/my-project/locations/\ + global/mirroringDeploymentGroups/my-deployment-group \ + --description='new description' + POSITIONAL ARGUMENTS Mirroring endpoint group resource - Mirroring Endpoint Group. The arguments in this group can be used to specify the attributes of this @@ -115,6 +123,9 @@ OPTIONAL FLAGS complete. The default is True. Enabled by default, use --no-async to disable. + --description=DESCRIPTION + Description of the endpoint + --labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to add. diff --git a/gcloud/alpha/network-security/mirroring-endpoint-groups/update b/gcloud/alpha/network-security/mirroring-endpoint-groups/update index 8a077e1a0..aefb806bb 100644 --- a/gcloud/alpha/network-security/mirroring-endpoint-groups/update +++ b/gcloud/alpha/network-security/mirroring-endpoint-groups/update @@ -5,7 +5,8 @@ NAME SYNOPSIS gcloud alpha network-security mirroring-endpoint-groups update (MIRRORING_ENDPOINT_GROUP : --location=LOCATION) [--async] - [--max-wait=MAX_WAIT; default="20m"] [--update-labels=[KEY=VALUE,...]] + [--description=DESCRIPTION] [--max-wait=MAX_WAIT; default="20m"] + [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -34,6 +35,12 @@ EXAMPLES my-endpoint-group --project=my-project \ --location=us-central1-a --clear-labels + To update description to 'new description', run: + + $ gcloud alpha network-security mirroring-endpoint-groups update \ + my-endpoint-group --project=my-project \ + --location=us-central1-a --description='new description' + POSITIONAL ARGUMENTS Mirroring endpoint group resource - Mirroring Endpoint Group. The arguments in this group can be used to specify the attributes of this @@ -73,6 +80,9 @@ FLAGS complete. The default is True. Enabled by default, use --no-async to disable. + --description=DESCRIPTION + Description of the endpoint + --max-wait=MAX_WAIT; default="20m" Time to synchronously wait for the operation to complete, after which the operation continues asynchronously. Ignored if --no-async isn't diff --git a/gcloud/alpha/network-security/security-profiles/custom-intercept/create b/gcloud/alpha/network-security/security-profiles/custom-intercept/create new file mode 100644 index 000000000..805511307 --- /dev/null +++ b/gcloud/alpha/network-security/security-profiles/custom-intercept/create @@ -0,0 +1,127 @@ +NAME + gcloud alpha network-security security-profiles custom-intercept create - + create a new Custom Intercept Profile + +SYNOPSIS + gcloud alpha network-security security-profiles custom-intercept create + (SECURITY_PROFILE : --location=LOCATION --organization=ORGANIZATION) + (--intercept-endpoint-group=INTERCEPT_ENDPOINT_GROUP + : --intercept-endpoint-group-location=INTERCEPT_ENDPOINT_GROUP_LOCATION) + [--async] [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create a new Custom Intercept Security Profile. + +EXAMPLES + To create a Custom Intercept Security Profile named intercept-profile + linked to a Intercept Endpoint Group (q.v.), run: + + $ gcloud alpha network-security security-profiles custom-intercept \ + create intercept-profile --description="An Intercept Profile" \ + --intercept-endpoint-group=projects/my-project/locations/\ + global/interceptEndpointGroups/my-mep + +POSITIONAL ARGUMENTS + Security profile resource - Security Profile Name. The arguments in this + group can be used to specify the attributes of this resource. + + This must be specified. + + SECURITY_PROFILE + ID of the security_profile or fully qualified identifier for the + security_profile. + + To set the security_profile attribute: + ▸ provide the argument security_profile on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + location of the security_profile - Global. + + To set the location attribute: + ▸ provide the argument security_profile on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + + --organization=ORGANIZATION + Organization ID to which the changes should apply. + + To set the organization attribute: + ▸ provide the argument security_profile on the command line with a + fully specified name; + ▸ provide the argument --organization on the command line. + +REQUIRED FLAGS + Intercept endpoint group resource - Intercept Endpoint Group. 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 --intercept-endpoint-group 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. + + --intercept-endpoint-group=INTERCEPT_ENDPOINT_GROUP + ID of the intercept endpoint group or fully qualified identifier for + the intercept endpoint group. + + To set the id attribute: + ▸ provide the argument --intercept-endpoint-group on the command + line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --intercept-endpoint-group-location=INTERCEPT_ENDPOINT_GROUP_LOCATION + Location of the intercept endpoint group. + + To set the location attribute: + ▸ provide the argument --intercept-endpoint-group on the command + line with a fully specified name; + ▸ provide the argument --intercept-endpoint-group-location on the + command line; + ▸ provide the argument --location on the command line; + ▸ provide the argument + networksecurity.projects.locations.interceptEndpointGroupAssociations + on the command line with a fully specified name. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. The default is False. + + --description=DESCRIPTION + Brief description of the security profile + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta network-security security-profiles custom-intercept \ + create + diff --git a/gcloud/alpha/network-security/security-profiles/custom-intercept/delete b/gcloud/alpha/network-security/security-profiles/custom-intercept/delete new file mode 100644 index 000000000..52ec75c26 --- /dev/null +++ b/gcloud/alpha/network-security/security-profiles/custom-intercept/delete @@ -0,0 +1,78 @@ +NAME + gcloud alpha network-security security-profiles custom-intercept delete - + delete a Security Profile + +SYNOPSIS + gcloud alpha network-security security-profiles custom-intercept delete + (SECURITY_PROFILE : --location=LOCATION --organization=ORGANIZATION) + [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete the specified Security Profile. + +EXAMPLES + To delete a Security Profile called my-security-profile run: + + $ gcloud alpha network-security security-profiles custom-intercept \ + delete my-security-profile + +POSITIONAL ARGUMENTS + Security profile resource - Name of the Security Profile you want to + delete. The arguments in this group can be used to specify the attributes + of this resource. + + This must be specified. + + SECURITY_PROFILE + ID of the security_profile or fully qualified identifier for the + security_profile. + + To set the security_profile attribute: + ▸ provide the argument security_profile on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location ID of the resource. + + To set the location attribute: + ▸ provide the argument security_profile on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ use default global location . + + --organization=ORGANIZATION + Organization number. + + To set the organization attribute: + ▸ provide the argument security_profile on the command line with a + fully specified name; + ▸ provide the argument --organization 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 networksecurity/v1alpha1 API. The full documentation + for this API can be found at: https://cloud.google.com/networking + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta network-security security-profiles custom-intercept \ + delete + diff --git a/gcloud/alpha/network-security/security-profiles/custom-intercept/describe b/gcloud/alpha/network-security/security-profiles/custom-intercept/describe new file mode 100644 index 000000000..10d64354b --- /dev/null +++ b/gcloud/alpha/network-security/security-profiles/custom-intercept/describe @@ -0,0 +1,73 @@ +NAME + gcloud alpha network-security security-profiles custom-intercept describe - + describe a Custom InterceptSecurity Profile + +SYNOPSIS + gcloud alpha network-security security-profiles custom-intercept describe + (SECURITY_PROFILE : --location=LOCATION --organization=ORGANIZATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Show details of the Security Profile. + +EXAMPLES + To show details of a Security Profile named my-intercept-sp run: + + $ gcloud alpha network-security security-profiles custom-intercept \ + describe my-intercept-sp --organization=1234 --location=global + +POSITIONAL ARGUMENTS + Security profile resource - Name of the Security Profile to be described. + The arguments in this group can be used to specify the attributes of this + resource. + + This must be specified. + + SECURITY_PROFILE + ID of the security_profile or fully qualified identifier for the + security_profile. + + To set the security_profile attribute: + ▸ provide the argument security_profile on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location ID of the resource. + + To set the location attribute: + ▸ provide the argument security_profile on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ use default global location . + + --organization=ORGANIZATION + Organization number. + + To set the organization attribute: + ▸ provide the argument security_profile on the command line with a + fully specified name; + ▸ provide the argument --organization on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networksecurity/v1alpha1 API. The full documentation + for this API can be found at: https://cloud.google.com/networking + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta network-security security-profiles custom-intercept \ + describe + diff --git a/gcloud/alpha/network-security/security-profiles/custom-intercept/help b/gcloud/alpha/network-security/security-profiles/custom-intercept/help new file mode 100644 index 000000000..20c877c32 --- /dev/null +++ b/gcloud/alpha/network-security/security-profiles/custom-intercept/help @@ -0,0 +1,43 @@ +NAME + gcloud alpha network-security security-profiles custom-intercept - manage + Security Profiles - Custom Intercept Profile + +SYNOPSIS + gcloud alpha network-security security-profiles custom-intercept COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) This class provides commands for managing Custom Intercept Security + Profile. + +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 new Custom Intercept Profile. + + delete + (ALPHA) Delete a Security Profile. + + describe + (ALPHA) Describe a Custom InterceptSecurity Profile. + + list + (ALPHA) List Custom Intercept Security Profiles. + + update + (ALPHA) Updates a Custom Intercept Profile. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta network-security security-profiles custom-intercept + diff --git a/gcloud/alpha/network-security/security-profiles/custom-intercept/list b/gcloud/alpha/network-security/security-profiles/custom-intercept/list new file mode 100644 index 000000000..3194e6a18 --- /dev/null +++ b/gcloud/alpha/network-security/security-profiles/custom-intercept/list @@ -0,0 +1,90 @@ +NAME + gcloud alpha network-security security-profiles custom-intercept list - + list Custom Intercept Security Profiles + +SYNOPSIS + gcloud alpha network-security security-profiles custom-intercept list + [--location=LOCATION : --organization=ORGANIZATION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List Custom Intercept Security Profiles. + + For more examples, refer to the EXAMPLES section below. + +EXAMPLES + To list Custom Intercept security profiles in an organization, run: + + $ gcloud alpha network-security security-profiles custom-intercept \ list --organization=12345 --location=global + +FLAGS + Location resource - Parent resource for the list operation. The arguments + in this group can be used to specify the attributes of this resource. + + --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. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --organization=ORGANIZATION + Organization ID of the location. + + To set the organization attribute: + ▸ provide the argument --location on the command line with a fully + specified name; + ▸ provide the argument --organization on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta network-security security-profiles custom-intercept \ + list + diff --git a/gcloud/alpha/network-security/security-profiles/custom-intercept/update b/gcloud/alpha/network-security/security-profiles/custom-intercept/update new file mode 100644 index 000000000..1d833dbfe --- /dev/null +++ b/gcloud/alpha/network-security/security-profiles/custom-intercept/update @@ -0,0 +1,119 @@ +NAME + gcloud alpha network-security security-profiles custom-intercept update - + updates a Custom Intercept Profile + +SYNOPSIS + gcloud alpha network-security security-profiles custom-intercept update + (SECURITY_PROFILE : --location=LOCATION --organization=ORGANIZATION) + [--async] [--description=DESCRIPTION] [--update-labels=[KEY=VALUE,...]] + [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Update a Custom Intercept Security Profile. + + The supported fields for update are description and labels. + +EXAMPLES + To update the description of a Custom Intercept Security Profile named + intercept-profile, run: + + $ gcloud alpha network-security security-profiles custom-intercept \ + update intercept-profile --description="A new description" \ + --organization=1234567890 --location=global + + To change the labels of a Custom Intercept Security Profile named + intercept-profile, run: + + $ gcloud alpha network-security security-profiles custom-intercept \ + update intercept-profile \ + --update-labels=key1=value1,key2=value2 \ + --delete-labels=key3,key4 --organization=1234567890 \ + --location=glob + +POSITIONAL ARGUMENTS + Security profile resource - Security Profile Name. The arguments in this + group can be used to specify the attributes of this resource. + + This must be specified. + + SECURITY_PROFILE + ID of the security_profile or fully qualified identifier for the + security_profile. + + To set the security_profile attribute: + ▸ provide the argument security_profile on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + location of the security_profile - Global. + + To set the location attribute: + ▸ provide the argument security_profile on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + + --organization=ORGANIZATION + Organization ID to which the changes should apply. + + To set the organization attribute: + ▸ provide the argument security_profile on the command line with a + fully specified name; + ▸ provide the argument --organization on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. The default is False. + + --description=DESCRIPTION + Brief description of the security profile + + --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 alpha network-security security-profiles custom-intercept \ + update --clear-labels + + To remove all existing labels and create two new labels, foo and baz: + + $ gcloud alpha network-security security-profiles custom-intercept \ + update --clear-labels --update-labels foo=bar,baz=qux + + --remove-labels=[KEY,...] + List of label keys to remove. If a label does not exist it is + silently ignored. If --update-labels is also specified then + --update-labels is applied first. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta network-security security-profiles custom-intercept \ + update + diff --git a/gcloud/alpha/network-security/security-profiles/help b/gcloud/alpha/network-security/security-profiles/help index 5a326d749..d6e3a0421 100644 --- a/gcloud/alpha/network-security/security-profiles/help +++ b/gcloud/alpha/network-security/security-profiles/help @@ -17,6 +17,9 @@ GCLOUD WIDE FLAGS GROUPS GROUP is one of the following: + custom-intercept + (ALPHA) Manage Security Profiles - Custom Intercept Profile. + custom-mirroring (ALPHA) Manage Security Profiles - Custom Mirroring Profile. diff --git a/gcloud/alpha/network-services/help b/gcloud/alpha/network-services/help index 41ede16e2..5730b5636 100644 --- a/gcloud/alpha/network-services/help +++ b/gcloud/alpha/network-services/help @@ -39,6 +39,9 @@ GROUPS multicast-domain-activations (ALPHA) Manage Network Services MulticastDomainActivations. + multicast-domain-groups + (ALPHA) Manage Network Services MulticastDomainGroups. + multicast-domains (ALPHA) Manage Network Services MulticastDomains. diff --git a/gcloud/alpha/network-services/multicast-domain-groups/create b/gcloud/alpha/network-services/multicast-domain-groups/create new file mode 100644 index 000000000..33a31f087 --- /dev/null +++ b/gcloud/alpha/network-services/multicast-domain-groups/create @@ -0,0 +1,87 @@ +NAME + gcloud alpha network-services multicast-domain-groups create - create a + multicast domain group + +SYNOPSIS + gcloud alpha network-services multicast-domain-groups create + (MULTICAST_DOMAIN_GROUP : --location=LOCATION) [--async] + [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create a multicast domain group in the specified location of the + current project. + +EXAMPLES + Create a multicast domain group with the name 'my-multicast-domain-group', + and location global. + + $ gcloud alpha network-services multicast-domain-groups create \ + my-multicast-domain-group --location=global + +POSITIONAL ARGUMENTS + Multicast domain group resource - Name of the multicast domain group to be + created. The arguments in this group can be used to specify the attributes + of this resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicast_domain_group 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. + + MULTICAST_DOMAIN_GROUP + ID of the multicast domain group or fully qualified identifier for + the multicast domain group. + + To set the multicast_domain_group attribute: + ▸ provide the argument multicast_domain_group on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_domain_group on the command line + with a fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + The description for the multicast domain group. + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1alpha1 API. The full documentation + for this API can be found at: https://cloud.google.com/networking + +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/network-services/multicast-domain-groups/delete b/gcloud/alpha/network-services/multicast-domain-groups/delete new file mode 100644 index 000000000..8bb9ad725 --- /dev/null +++ b/gcloud/alpha/network-services/multicast-domain-groups/delete @@ -0,0 +1,74 @@ +NAME + gcloud alpha network-services multicast-domain-groups delete - delete a + multicast domain group + +SYNOPSIS + gcloud alpha network-services multicast-domain-groups delete + (MULTICAST_DOMAIN_GROUP : --location=LOCATION) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete a multicast domain group in the specified location of the + current project. + +EXAMPLES + To delete a multicast domain group in the current project, run: + + $ gcloud alpha network-services multicast-domain-groups delete \ + my-multicast-domain-group --location=global + +POSITIONAL ARGUMENTS + Multicast domain group resource - The multicast domain group to delete. + The arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicast_domain_group 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. + + MULTICAST_DOMAIN_GROUP + ID of the multicast domain group or fully qualified identifier for + the multicast domain group. + + To set the multicast_domain_group attribute: + ▸ provide the argument multicast_domain_group on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_domain_group on the command line + with a fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +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 networkservices/v1alpha1 API. The full documentation + for this API can be found at: https://cloud.google.com/networking + +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/network-services/multicast-domain-groups/describe b/gcloud/alpha/network-services/multicast-domain-groups/describe new file mode 100644 index 000000000..57ee3b321 --- /dev/null +++ b/gcloud/alpha/network-services/multicast-domain-groups/describe @@ -0,0 +1,68 @@ +NAME + gcloud alpha network-services multicast-domain-groups describe - describe a + multicast domain group + +SYNOPSIS + gcloud alpha network-services multicast-domain-groups describe + (MULTICAST_DOMAIN_GROUP : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Show details of a multicast domain group in the specified location + of the current project. + +EXAMPLES + To describe a multicast domain group in the current project, run: + + $ gcloud alpha network-services multicast-domain-groups describe \ + my-multicast-domain-group --location=global + +POSITIONAL ARGUMENTS + Multicast domain group resource - The multicast domain group 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 multicast_domain_group 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. + + MULTICAST_DOMAIN_GROUP + ID of the multicast domain group or fully qualified identifier for + the multicast domain group. + + To set the multicast_domain_group attribute: + ▸ provide the argument multicast_domain_group on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_domain_group on the command line + with a fully specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1alpha1 API. The full documentation + for this API can be found at: https://cloud.google.com/networking + +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/network-services/multicast-domain-groups/help b/gcloud/alpha/network-services/multicast-domain-groups/help new file mode 100644 index 000000000..838d2c007 --- /dev/null +++ b/gcloud/alpha/network-services/multicast-domain-groups/help @@ -0,0 +1,37 @@ +NAME + gcloud alpha network-services multicast-domain-groups - manage Network + Services MulticastDomainGroups + +SYNOPSIS + gcloud alpha network-services multicast-domain-groups COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Network Services MulticastDomainGroups. + +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 multicast domain group. + + delete + (ALPHA) Delete a multicast domain group. + + describe + (ALPHA) Describe a multicast domain group. + + list + (ALPHA) List multicast domain groups. + +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/network-services/multicast-domain-groups/list b/gcloud/alpha/network-services/multicast-domain-groups/list new file mode 100644 index 000000000..27390d3dc --- /dev/null +++ b/gcloud/alpha/network-services/multicast-domain-groups/list @@ -0,0 +1,89 @@ +NAME + gcloud alpha network-services multicast-domain-groups list - list multicast + domain groups + +SYNOPSIS + gcloud alpha network-services multicast-domain-groups list + --location=LOCATION [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List all multicast domain groups in the specified location of the + current project. + +EXAMPLES + To list multicast domain groups in the current project, run: + + $ gcloud alpha network-services multicast-domain-groups list \ + --location=global + +REQUIRED FLAGS + Location resource - The location of the multicast domain 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 --location 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. + + --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. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1alpha1 API. The full documentation + for this API can be found at: https://cloud.google.com/networking + +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/network-services/route-views/describe b/gcloud/alpha/network-services/route-views/describe index f9a21c205..a0507a99a 100644 --- a/gcloud/alpha/network-services/route-views/describe +++ b/gcloud/alpha/network-services/route-views/describe @@ -96,5 +96,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud network-services route-views describe diff --git a/gcloud/alpha/network-services/route-views/help b/gcloud/alpha/network-services/route-views/help index db9b87000..0b5819c48 100644 --- a/gcloud/alpha/network-services/route-views/help +++ b/gcloud/alpha/network-services/route-views/help @@ -26,5 +26,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud network-services route-views diff --git a/gcloud/alpha/network-services/route-views/list b/gcloud/alpha/network-services/route-views/list index 919d35ecf..7a5bd43d8 100644 --- a/gcloud/alpha/network-services/route-views/list +++ b/gcloud/alpha/network-services/route-views/list @@ -115,5 +115,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud network-services route-views list diff --git a/gcloud/alpha/run/deploy b/gcloud/alpha/run/deploy index ddc2818f6..d066d5029 100644 --- a/gcloud/alpha/run/deploy +++ b/gcloud/alpha/run/deploy @@ -213,14 +213,16 @@ FLAGS disable. --max=MAX - The maximum number of container instances for this Service to run. This + The maximum number of container instances to run for this Service. This instance limit will be divided among all Revisions receiving a - percentage of traffic. Once service-max-instances is enabled for a - service, it cannot be disabled. + percentage of traffic and can be modified without deploying a new + Revision. Once service-max-instances is enabled for a service, it + cannot be disabled. --max-instances=MAX_INSTANCES - The maximum number of container instances of the Service to run. Use - 'default' to unset the limit and use the platform default. + The maximum number of container instances for this Revision to run or + 'default' to remove. This setting is immutably set on each new Revision + and modifying its value will deploy another Revision. --max-surge=MAX_SURGE A maximum percentage of instances that will be moved in each step of @@ -238,13 +240,17 @@ FLAGS projects/PROJECT/locations/global/meshes/MESH_NAME. --min=MIN - The minimum number of container instances for this Service to run or - 'default' to remove any minimum. These instances will be divided among - all Revisions receiving a percentage of traffic. + The minimum number of container instances to run for this Service or + 'default' to remove. These instances will be divided among all + Revisions receiving a percentage of traffic and can be modified without + deploying a new Revision. --min-instances=MIN_INSTANCES - The minimum number of container instances for this Revision of the - Service to run or 'default' to remove any minimum. + The minimum number of container instances to run for this Revision or + 'default' to remove. This setting is immutably set on each new Revision + and modifying its value will deploy a another Revision. Consider using + --min to set the minimum number of instances across all revisions of + the Service which may be modified dynamically. --region=REGION Region in which the resource can be found. Alternatively, set the diff --git a/gcloud/alpha/run/multi-region-services/update b/gcloud/alpha/run/multi-region-services/update index 762eabbb4..dd5473ef9 100644 --- a/gcloud/alpha/run/multi-region-services/update +++ b/gcloud/alpha/run/multi-region-services/update @@ -180,14 +180,16 @@ FLAGS disable. --max=MAX - The maximum number of container instances for this Service to run. This + The maximum number of container instances to run for this Service. This instance limit will be divided among all Revisions receiving a - percentage of traffic. Once service-max-instances is enabled for a - service, it cannot be disabled. + percentage of traffic and can be modified without deploying a new + Revision. Once service-max-instances is enabled for a service, it + cannot be disabled. --max-instances=MAX_INSTANCES - The maximum number of container instances of the Service to run. Use - 'default' to unset the limit and use the platform default. + The maximum number of container instances for this Revision to run or + 'default' to remove. This setting is immutably set on each new Revision + and modifying its value will deploy another Revision. --max-surge=MAX_SURGE A maximum percentage of instances that will be moved in each step of @@ -205,13 +207,17 @@ FLAGS projects/PROJECT/locations/global/meshes/MESH_NAME. --min=MIN - The minimum number of container instances for this Service to run or - 'default' to remove any minimum. These instances will be divided among - all Revisions receiving a percentage of traffic. + The minimum number of container instances to run for this Service or + 'default' to remove. These instances will be divided among all + Revisions receiving a percentage of traffic and can be modified without + deploying a new Revision. --min-instances=MIN_INSTANCES - The minimum number of container instances for this Revision of the - Service to run or 'default' to remove any minimum. + The minimum number of container instances to run for this Revision or + 'default' to remove. This setting is immutably set on each new Revision + and modifying its value will deploy a another Revision. Consider using + --min to set the minimum number of instances across all revisions of + the Service which may be modified dynamically. --region=REGION Region in which the resource can be found. Alternatively, set the diff --git a/gcloud/alpha/run/services/update b/gcloud/alpha/run/services/update index 0c428558d..7875d19a3 100644 --- a/gcloud/alpha/run/services/update +++ b/gcloud/alpha/run/services/update @@ -181,14 +181,16 @@ FLAGS disable. --max=MAX - The maximum number of container instances for this Service to run. This + The maximum number of container instances to run for this Service. This instance limit will be divided among all Revisions receiving a - percentage of traffic. Once service-max-instances is enabled for a - service, it cannot be disabled. + percentage of traffic and can be modified without deploying a new + Revision. Once service-max-instances is enabled for a service, it + cannot be disabled. --max-instances=MAX_INSTANCES - The maximum number of container instances of the Service to run. Use - 'default' to unset the limit and use the platform default. + The maximum number of container instances for this Revision to run or + 'default' to remove. This setting is immutably set on each new Revision + and modifying its value will deploy another Revision. --max-surge=MAX_SURGE A maximum percentage of instances that will be moved in each step of @@ -206,13 +208,17 @@ FLAGS projects/PROJECT/locations/global/meshes/MESH_NAME. --min=MIN - The minimum number of container instances for this Service to run or - 'default' to remove any minimum. These instances will be divided among - all Revisions receiving a percentage of traffic. + The minimum number of container instances to run for this Service or + 'default' to remove. These instances will be divided among all + Revisions receiving a percentage of traffic and can be modified without + deploying a new Revision. --min-instances=MIN_INSTANCES - The minimum number of container instances for this Revision of the - Service to run or 'default' to remove any minimum. + The minimum number of container instances to run for this Revision or + 'default' to remove. This setting is immutably set on each new Revision + and modifying its value will deploy a another Revision. Consider using + --min to set the minimum number of instances across all revisions of + the Service which may be modified dynamically. --region=REGION Region in which the resource can be found. Alternatively, set the diff --git a/gcloud/alpha/run/workers/deploy b/gcloud/alpha/run/workers/deploy index 502c0db95..61e0cb466 100644 --- a/gcloud/alpha/run/workers/deploy +++ b/gcloud/alpha/run/workers/deploy @@ -88,8 +88,11 @@ FLAGS Provides an optional, human-readable description of the service. --max-instances=MAX_INSTANCES - The maximum number of container instances of the Worker to run. Use - 'default' to unset the limit and use the platform default. + The maximum number of container instances for this Revision to run or + 'default' to remove. This setting is immutably set on each new Revision + and modifying its value will deploy another Revision. Consider using + --max to set the maximum number of instances across all revisions of + the Worker which may be modified dynamically. --max-surge=MAX_SURGE A maximum percentage of instances that will be moved in each step of @@ -107,9 +110,11 @@ FLAGS projects/PROJECT/locations/global/meshes/MESH_NAME. --min-instances=MIN_INSTANCES - The minimum number of container instances for this Worker to run or - 'default' to remove any minimum. These instances will be divided among - all Revisions receiving a percentage of instance split. + The minimum number of container instances to run for this Revision or + 'default' to remove. This setting is immutably set on each new Revision + and modifying its value will deploy a another Revision. Consider using + --min to set the minimum number of instances across all revisions of + the Worker which may be modified dynamically. --no-promote True to avoid assign instances to the worker revision being deployed. diff --git a/gcloud/alpha/run/workers/update b/gcloud/alpha/run/workers/update index a7f7e01ac..c91dc0666 100644 --- a/gcloud/alpha/run/workers/update +++ b/gcloud/alpha/run/workers/update @@ -89,8 +89,11 @@ FLAGS Provides an optional, human-readable description of the service. --max-instances=MAX_INSTANCES - The maximum number of container instances of the Worker to run. Use - 'default' to unset the limit and use the platform default. + The maximum number of container instances for this Revision to run or + 'default' to remove. This setting is immutably set on each new Revision + and modifying its value will deploy another Revision. Consider using + --max to set the maximum number of instances across all revisions of + the Worker which may be modified dynamically. --max-surge=MAX_SURGE A maximum percentage of instances that will be moved in each step of @@ -108,9 +111,11 @@ FLAGS projects/PROJECT/locations/global/meshes/MESH_NAME. --min-instances=MIN_INSTANCES - The minimum number of container instances for this Worker to run or - 'default' to remove any minimum. These instances will be divided among - all Revisions receiving a percentage of instance split. + The minimum number of container instances to run for this Revision or + 'default' to remove. This setting is immutably set on each new Revision + and modifying its value will deploy a another Revision. Consider using + --min to set the minimum number of instances across all revisions of + the Worker which may be modified dynamically. --no-promote True to avoid assign instances to the worker revision being deployed. diff --git a/gcloud/alpha/storage/buckets/describe b/gcloud/alpha/storage/buckets/describe index 73dcdb392..3c2d5d185 100644 --- a/gcloud/alpha/storage/buckets/describe +++ b/gcloud/alpha/storage/buckets/describe @@ -3,7 +3,8 @@ NAME SYNOPSIS gcloud alpha storage buckets describe URL - [--additional-headers=HEADER=VALUE] [--raw] [GCLOUD_WIDE_FLAG ...] + [--additional-headers=HEADER=VALUE] [--raw] [--soft-deleted] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Describe a Cloud Storage bucket. @@ -33,6 +34,10 @@ FLAGS Shows metadata in the format returned by the API instead of standardizing it. + --soft-deleted + Displays soft-deleted resources only. For objects, it will exclude live + and noncurrent ones. + 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/storage/buckets/list b/gcloud/alpha/storage/buckets/list index 555fd5f11..53ac826ef 100644 --- a/gcloud/alpha/storage/buckets/list +++ b/gcloud/alpha/storage/buckets/list @@ -3,9 +3,9 @@ NAME SYNOPSIS gcloud alpha storage buckets list [URLS ...] - [--additional-headers=HEADER=VALUE] [--raw] [--filter=EXPRESSION] - [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] - [GCLOUD_WIDE_FLAG ...] + [--additional-headers=HEADER=VALUE] [--raw] [--soft-deleted] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) List Cloud Storage buckets. @@ -38,6 +38,10 @@ FLAGS Shows metadata in the format returned by the API instead of standardizing it. + --soft-deleted + Displays soft-deleted resources only. For objects, it will exclude live + and noncurrent ones. + LIST COMMAND FLAGS --filter=EXPRESSION Apply a Boolean filter EXPRESSION to each resource item to be listed. diff --git a/gcloud/app/deploy b/gcloud/app/deploy index b7a6c3187..58c36697b 100644 --- a/gcloud/app/deploy +++ b/gcloud/app/deploy @@ -98,7 +98,7 @@ FLAGS --image-url=IMAGE_URL (App Engine flexible environment only.) Deploy with a specific Docker - image. Docker url must be from one of the valid Container Registry + image. Docker url must be from one of the valid Artifact Registry hostnames. --promote diff --git a/gcloud/beta/access-context-manager/policies/delete b/gcloud/beta/access-context-manager/policies/delete index dac43b329..8ba8ba3ab 100644 --- a/gcloud/beta/access-context-manager/policies/delete +++ b/gcloud/beta/access-context-manager/policies/delete @@ -10,7 +10,7 @@ DESCRIPTION (BETA) Delete a given access policy. POSITIONAL ARGUMENTS - Policy resource - The access level you want to delete. This represents a + Policy resource - The access policy you want to delete. This represents a Cloud resource. [POLICY] diff --git a/gcloud/beta/alloydb/clusters/export b/gcloud/beta/alloydb/clusters/export index 3efcce6ae..13662f90c 100644 --- a/gcloud/beta/alloydb/clusters/export +++ b/gcloud/beta/alloydb/clusters/export @@ -19,7 +19,7 @@ EXAMPLES $ gcloud beta alloydb clusters export my-cluster \ --region=us-central1 --database=my-database \ - --gcs-uri=gs://my-bucket/my-export-file-path \ + --gcs-uri=gs://my-bucket/my-export-file-path --csv \ --select-query="SELECT * FROM my-table" POSITIONAL ARGUMENTS @@ -110,8 +110,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 alloydb clusters export $ gcloud alpha alloydb clusters export diff --git a/gcloud/beta/app/deploy b/gcloud/beta/app/deploy index ecb17e649..42fb36b65 100644 --- a/gcloud/beta/app/deploy +++ b/gcloud/beta/app/deploy @@ -99,7 +99,7 @@ FLAGS --image-url=IMAGE_URL (App Engine flexible environment only.) Deploy with a specific Docker - image. Docker url must be from one of the valid Container Registry + image. Docker url must be from one of the valid Artifact Registry hostnames. --promote diff --git a/gcloud/beta/bigtable/instances/tables/create b/gcloud/beta/bigtable/instances/tables/create index 8f358679a..ef02fcf04 100644 --- a/gcloud/beta/bigtable/instances/tables/create +++ b/gcloud/beta/bigtable/instances/tables/create @@ -6,8 +6,9 @@ SYNOPSIS gcloud beta bigtable instances tables create (TABLE : --instance=INSTANCE) --column-families=[COLUMN_FAMILIES,...] [--change-stream-retention-period=CHANGE_STREAM_RETENTION_PERIOD] - [--deletion-protection] [--enable-automated-backup] - [--splits=[SPLITS,...]] [GCLOUD_WIDE_FLAG ...] + [--deletion-protection] [--splits=[SPLITS,...]] + [--automated-backup-retention-period=AUTOMATED_BACKUP_RETENTION_PERIOD + | --enable-automated-backup] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Create a new Cloud Bigtable table. @@ -60,14 +61,22 @@ EXAMPLES --instance=my-instance --column-families="my-family" \ --no-deletion-protection - To create a table my-table with automated backup policy - (retention_period=72h, frequency=24h) enabled in instance my-instance with - a column family my-family, run: + To create a table my-table with the default automated backup policy + (retention_period=7d, frequency=1d) enabled in instance my-instance with a + column family my-family, run: $ gcloud beta bigtable instances tables create my-table \ --instance=my-instance --column-families="my-family" \ --enable-automated-backup + To create a table my-table with a custom automated backup policy configured + to retain backups for 30 days in instance my-instance with a column family + my-family, run: + + $ gcloud beta bigtable instances tables create my-table \ + --instance=my-instance --column-families="my-family" \ + --automated-backup-retention_period=30d + POSITIONAL ARGUMENTS Table resource - Cloud Bigtable table to create. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some @@ -116,14 +125,21 @@ OPTIONAL FLAGS --deletion-protection Once specified, the table is deletion protected. - --enable-automated-backup - Once set, enables the default automated backup policy - (retention_period=72h, frequency=24h) for the table. - --splits=[SPLITS,...] Row keys where the table should initially be split. For example: car,key + At most one of these can be specified: + + --automated-backup-retention-period=AUTOMATED_BACKUP_RETENTION_PERIOD + The retention period of automated backup in the format of 30d for 30 + days. Min retention period is 3d and max is 90d. Setting this flag + will enable automated backup for the table. + + --enable-automated-backup + Once set, enables the default automated backup policy + (retention_period=7d, frequency=1d) for the table. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/beta/bigtable/instances/tables/update b/gcloud/beta/bigtable/instances/tables/update index cc6b65e52..ae07592ac 100644 --- a/gcloud/beta/bigtable/instances/tables/update +++ b/gcloud/beta/bigtable/instances/tables/update @@ -4,8 +4,9 @@ NAME SYNOPSIS gcloud beta bigtable instances tables update (TABLE : --instance=INSTANCE) - [--async] [--deletion-protection] [--disable-automated-backup] - [--enable-automated-backup] + [--async] [--deletion-protection] + [--automated-backup-retention-period=AUTOMATED_BACKUP_RETENTION_PERIOD + | --disable-automated-backup | --enable-automated-backup] [--change-stream-retention-period=CHANGE_STREAM_RETENTION_PERIOD | --clear-change-stream-retention-period] [GCLOUD_WIDE_FLAG ...] @@ -35,8 +36,8 @@ EXAMPLES $ gcloud beta bigtable instances tables update my-table \ --instance=my-instance --clear-change-stream-retention-period - To enable default automated backup policy (retention_period=72h, - frequency=24h), run: + To enable the default automated backup policy on a table, or update a table + to use the default policy (retention_period=7d, frequency=1d), run: $ gcloud beta bigtable instances tables update my-table \ --instance=my-instance --enable-automated-backup @@ -46,6 +47,12 @@ EXAMPLES $ gcloud beta bigtable instances tables update my-table \ --instance=my-instance --disable-automated-backup + To enable or update a custom automated backup policy and configure it to + retain backups for 30 days, run: + + $ gcloud beta bigtable instances tables update my-table \ + --instance=my-instance --automated-backup-retention_period=30d + POSITIONAL ARGUMENTS Table resource - Cloud Bigtable table to update. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some @@ -85,12 +92,21 @@ FLAGS --deletion-protection Once specified, the table is deletion protected. - --disable-automated-backup - Once set, disables automated backup policy for the table. + At most one of these can be specified: - --enable-automated-backup - Once set, enables the default automated backup policy - (retention_period=72h, frequency=24h) for the table. + --automated-backup-retention-period=AUTOMATED_BACKUP_RETENTION_PERIOD + The retention period of automated backup in the format of 30d for 30 + days. Min retention period is 3d and max is 90d. Setting this flag + will enable automated backup for the table. + + --disable-automated-backup + Once set, disables automated backup policy for the table. + + --enable-automated-backup + Once set, enables the default automated backup policy + (retention_period=7d, frequency=1d) for the table. Note: If a table + has automated backup enabled, this flag resets it to the default + policy. At most one of these can be specified: diff --git a/gcloud/beta/bigtable/tables/create b/gcloud/beta/bigtable/tables/create index abd9e0584..31900c0fd 100644 --- a/gcloud/beta/bigtable/tables/create +++ b/gcloud/beta/bigtable/tables/create @@ -5,8 +5,9 @@ SYNOPSIS gcloud beta bigtable tables create (TABLE : --instance=INSTANCE) --column-families=[COLUMN_FAMILIES,...] [--change-stream-retention-period=CHANGE_STREAM_RETENTION_PERIOD] - [--deletion-protection] [--enable-automated-backup] - [--splits=[SPLITS,...]] [GCLOUD_WIDE_FLAG ...] + [--deletion-protection] [--splits=[SPLITS,...]] + [--automated-backup-retention-period=AUTOMATED_BACKUP_RETENTION_PERIOD + | --enable-automated-backup] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Create a new Cloud Bigtable table. @@ -59,14 +60,22 @@ EXAMPLES --instance=my-instance --column-families="my-family" \ --no-deletion-protection - To create a table my-table with automated backup policy - (retention_period=72h, frequency=24h) enabled in instance my-instance with - a column family my-family, run: + To create a table my-table with the default automated backup policy + (retention_period=7d, frequency=1d) enabled in instance my-instance with a + column family my-family, run: $ gcloud beta bigtable tables create my-table \ --instance=my-instance --column-families="my-family" \ --enable-automated-backup + To create a table my-table with a custom automated backup policy configured + to retain backups for 30 days in instance my-instance with a column family + my-family, run: + + $ gcloud beta bigtable tables create my-table \ + --instance=my-instance --column-families="my-family" \ + --automated-backup-retention_period=30d + POSITIONAL ARGUMENTS Table resource - Cloud Bigtable table to create. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some @@ -115,14 +124,21 @@ OPTIONAL FLAGS --deletion-protection Once specified, the table is deletion protected. - --enable-automated-backup - Once set, enables the default automated backup policy - (retention_period=72h, frequency=24h) for the table. - --splits=[SPLITS,...] Row keys where the table should initially be split. For example: car,key + At most one of these can be specified: + + --automated-backup-retention-period=AUTOMATED_BACKUP_RETENTION_PERIOD + The retention period of automated backup in the format of 30d for 30 + days. Min retention period is 3d and max is 90d. Setting this flag + will enable automated backup for the table. + + --enable-automated-backup + Once set, enables the default automated backup policy + (retention_period=7d, frequency=1d) for the table. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/beta/bigtable/tables/update b/gcloud/beta/bigtable/tables/update index 318bd8d30..12159df04 100644 --- a/gcloud/beta/bigtable/tables/update +++ b/gcloud/beta/bigtable/tables/update @@ -4,8 +4,9 @@ NAME SYNOPSIS gcloud beta bigtable tables update (TABLE : --instance=INSTANCE) [--async] - [--deletion-protection] [--disable-automated-backup] - [--enable-automated-backup] + [--deletion-protection] + [--automated-backup-retention-period=AUTOMATED_BACKUP_RETENTION_PERIOD + | --disable-automated-backup | --enable-automated-backup] [--change-stream-retention-period=CHANGE_STREAM_RETENTION_PERIOD | --clear-change-stream-retention-period] [GCLOUD_WIDE_FLAG ...] @@ -35,8 +36,8 @@ EXAMPLES $ gcloud beta bigtable tables update my-table \ --instance=my-instance --clear-change-stream-retention-period - To enable default automated backup policy (retention_period=72h, - frequency=24h), run: + To enable the default automated backup policy on a table, or update a table + to use the default policy (retention_period=7d, frequency=1d), run: $ gcloud beta bigtable tables update my-table \ --instance=my-instance --enable-automated-backup @@ -46,6 +47,12 @@ EXAMPLES $ gcloud beta bigtable tables update my-table \ --instance=my-instance --disable-automated-backup + To enable or update a custom automated backup policy and configure it to + retain backups for 30 days, run: + + $ gcloud beta bigtable tables update my-table \ + --instance=my-instance --automated-backup-retention_period=30d + POSITIONAL ARGUMENTS Table resource - Cloud Bigtable table to update. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some @@ -85,12 +92,21 @@ FLAGS --deletion-protection Once specified, the table is deletion protected. - --disable-automated-backup - Once set, disables automated backup policy for the table. + At most one of these can be specified: - --enable-automated-backup - Once set, enables the default automated backup policy - (retention_period=72h, frequency=24h) for the table. + --automated-backup-retention-period=AUTOMATED_BACKUP_RETENTION_PERIOD + The retention period of automated backup in the format of 30d for 30 + days. Min retention period is 3d and max is 90d. Setting this flag + will enable automated backup for the table. + + --disable-automated-backup + Once set, disables automated backup policy for the table. + + --enable-automated-backup + Once set, enables the default automated backup policy + (retention_period=7d, frequency=1d) for the table. Note: If a table + has automated backup enabled, this flag resets it to the default + policy. At most one of these can be specified: diff --git a/gcloud/beta/colab/runtime-templates/create b/gcloud/beta/colab/runtime-templates/create index eea03276a..500c5a9c9 100644 --- a/gcloud/beta/colab/runtime-templates/create +++ b/gcloud/beta/colab/runtime-templates/create @@ -96,7 +96,7 @@ OPTIONAL FLAGS --network-tags=[TAGS,...] Applies the given Compute Engine tags to the runtime. - The machine configuration of the runtime provisioned from this template. + The machine configuration of the runtime. --accelerator-count=ACCELERATOR_COUNT The number of accelerators used by the runtime. @@ -110,8 +110,7 @@ OPTIONAL FLAGS --machine-type=MACHINE_TYPE; default="e2-standard-4" The Compute Engine machine type selected for the runtime. - The configuration for the data disk of the runtime provisioned from this - template. + The configuration for the data disk of the runtime. --disk-size-gb=DISK_SIZE_GB; default=100 The disk size of the runtime in GB. If specified, the --disk-type diff --git a/gcloud/beta/compute/network-profiles/describe b/gcloud/beta/compute/network-profiles/describe index b4c7110be..3ea2c5273 100644 --- a/gcloud/beta/compute/network-profiles/describe +++ b/gcloud/beta/compute/network-profiles/describe @@ -45,8 +45,10 @@ API REFERENCE can be found at: https://cloud.google.com/compute/ 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 network-profiles describe $ gcloud alpha compute network-profiles describe diff --git a/gcloud/beta/compute/network-profiles/help b/gcloud/beta/compute/network-profiles/help index 131433cb0..6694ff85c 100644 --- a/gcloud/beta/compute/network-profiles/help +++ b/gcloud/beta/compute/network-profiles/help @@ -22,8 +22,10 @@ COMMANDS (BETA) List network profiles. 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 network-profiles $ gcloud alpha compute network-profiles diff --git a/gcloud/beta/compute/network-profiles/list b/gcloud/beta/compute/network-profiles/list index 319e75ad3..978b9d5f1 100644 --- a/gcloud/beta/compute/network-profiles/list +++ b/gcloud/beta/compute/network-profiles/list @@ -59,8 +59,10 @@ API REFERENCE can be found at: https://cloud.google.com/compute/ 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 network-profiles list $ gcloud alpha compute network-profiles list diff --git a/gcloud/beta/compute/networks/subnets/update b/gcloud/beta/compute/networks/subnets/update index e66223932..6d644ca3f 100644 --- a/gcloud/beta/compute/networks/subnets/update +++ b/gcloud/beta/compute/networks/subnets/update @@ -162,12 +162,16 @@ FLAGS enable-bidirectional-access, enable-outbound-vm-access. --purpose=PURPOSE - The purpose of the subnetwork is set to REGIONAL_MANAGED_PROXY to - migrate from the INTERNAL_HTTPS_LOAD_BALANCER purpose. PURPOSE must - be (only one value is supported): + The purpose of the subnetwork can be changed in a few scenarios. + PURPOSE must be one of: + PRIVATE + The default subnet type. Only PEER_MIGRATION subnets can be + changed to PRIVATE. REGIONAL_MANAGED_PROXY - The proxy-only subnet for regional HTTP(S) load balancers. + The proxy-only subnet for regional HTTP(S) load balancers. Only + INTERNAL_HTTPS_LOAD_BALANCER subnets can be changed to + REGIONAL_MANAGED_PROXY. --remove-secondary-ranges=PROPERTY=VALUE,[...] Removes secondary ranges from the subnetwork. diff --git a/gcloud/beta/compute/security-policies/update b/gcloud/beta/compute/security-policies/update index d3018caf8..f00b01be0 100644 --- a/gcloud/beta/compute/security-policies/update +++ b/gcloud/beta/compute/security-policies/update @@ -15,6 +15,7 @@ SYNOPSIS [--log-level=LOG_LEVEL] [--network-ddos-protection=NETWORK_DDOS_PROTECTION] [--recaptcha-redirect-site-key=RECAPTCHA_REDIRECT_SITE_KEY] + [--request-body-inspection-size=REQUEST_BODY_INSPECTION_SIZE] [--user-ip-request-headers=[USER_IP_REQUEST_HEADER,...]] [--global | --region=REGION] [GCLOUD_WIDE_FLAG ...] @@ -83,6 +84,10 @@ FLAGS The reCAPTCHA site key to be used for rules using the redirect action and the google-recaptcha redirect type under the security policy. + --request-body-inspection-size=REQUEST_BODY_INSPECTION_SIZE + Maximum request body inspection size. REQUEST_BODY_INSPECTION_SIZE must + be one of: 8KB, 128KB. + --user-ip-request-headers=[USER_IP_REQUEST_HEADER,...] A comma-separated list of request header names to use for resolving the caller's user IP address. diff --git a/gcloud/beta/container/clusters/create b/gcloud/beta/container/clusters/create index 9d31200e4..b0dc0a105 100644 --- a/gcloud/beta/container/clusters/create +++ b/gcloud/beta/container/clusters/create @@ -24,8 +24,9 @@ SYNOPSIS [--create-subnetwork=[KEY=VALUE,...]] [--database-encryption-key=DATABASE_ENCRYPTION_KEY] [--default-max-pods-per-node=DEFAULT_MAX_PODS_PER_NODE] - [--disable-default-snat] [--disable-pod-cidr-overprovision] - [--disk-size=DISK_SIZE] [--disk-type=DISK_TYPE] + [--disable-default-snat] [--disable-l4-lb-firewall-reconciliation] + [--disable-pod-cidr-overprovision] [--disk-size=DISK_SIZE] + [--disk-type=DISK_TYPE] [--enable-authorized-networks-on-private-endpoint] [--enable-autorepair] [--no-enable-autoupgrade] [--enable-cilium-clusterwide-network-policy] [--enable-cloud-logging] @@ -438,6 +439,10 @@ FLAGS requires that you also set --enable-ip-alias and --enable-private-nodes. + --disable-l4-lb-firewall-reconciliation + Disable reconciliation on the cluster for L4 Load Balancer VPC + firewalls targeting ingress traffic. + --disable-pod-cidr-overprovision Disables pod cidr overprovision on nodes. Pod cidr overprovisioning is enabled by default. diff --git a/gcloud/beta/container/clusters/create-auto b/gcloud/beta/container/clusters/create-auto index 0932ff6ed..09bf40e5b 100644 --- a/gcloud/beta/container/clusters/create-auto +++ b/gcloud/beta/container/clusters/create-auto @@ -15,6 +15,7 @@ SYNOPSIS [--containerd-config-from-file=PATH_TO_FILE] [--create-subnetwork=[KEY=VALUE,...]] [--database-encryption-key=DATABASE_ENCRYPTION_KEY] + [--disable-l4-lb-firewall-reconciliation] [--enable-authorized-networks-on-private-endpoint] [--enable-backup-restore] [--enable-cilium-clusterwide-network-policy] [--enable-dns-access] [--enable-fleet] [--enable-google-cloud-access] @@ -234,6 +235,10 @@ FLAGS For more information, see https://cloud.google.com/kubernetes-engine/docs/how-to/encrypting-secrets. + --disable-l4-lb-firewall-reconciliation + Disable reconciliation on the cluster for L4 Load Balancer VPC + firewalls targeting ingress traffic. + --enable-authorized-networks-on-private-endpoint Enable enforcement of --master-authorized-networks CIDR ranges for traffic reaching cluster's control plane via private IP. diff --git a/gcloud/beta/container/clusters/update b/gcloud/beta/container/clusters/update index 0d693a279..3f37fdc0a 100644 --- a/gcloud/beta/container/clusters/update +++ b/gcloud/beta/container/clusters/update @@ -78,6 +78,8 @@ SYNOPSIS | --disable-dataplane-v2-flow-observability | --enable-dataplane-v2-flow-observability --disable-dataplane-v2-metrics | --enable-dataplane-v2-metrics + | --disable-l4-lb-firewall-reconciliation + | --enable-l4-lb-firewall-reconciliation | --enable-authorized-networks-on-private-endpoint --enable-dns-access --enable-google-cloud-access --enable-ip-access --enable-master-global-access --enable-private-endpoint @@ -1165,6 +1167,17 @@ REQUIRED FLAGS --enable-dataplane-v2-metrics Exposes advanced datapath flow metrics on node port. + At most one of these can be specified: + + --disable-l4-lb-firewall-reconciliation + Disable reconciliation on the cluster for L4 Load Balancer VPC + firewalls targeting ingress traffic. + + --enable-l4-lb-firewall-reconciliation + Enable reconciliation on the cluster for L4 Load Balancer VPC + firewalls targeting ingress traffic. L4 LB VPC firewall + reconciliation is enabled by default. + --enable-authorized-networks-on-private-endpoint Enable enforcement of --master-authorized-networks CIDR ranges for traffic reaching cluster's control plane via private IP. diff --git a/gcloud/beta/container/fleet/scopes/rbacrolebindings/create b/gcloud/beta/container/fleet/scopes/rbacrolebindings/create index 24d4666ef..e3dfdb190 100644 --- a/gcloud/beta/container/fleet/scopes/rbacrolebindings/create +++ b/gcloud/beta/container/fleet/scopes/rbacrolebindings/create @@ -69,7 +69,8 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS --role=ROLE - Role to assign. ROLE must be one of: admin, edit, view. + Predefined role to assign to principal (admin, edit, view). ROLE must + be one of: admin, edit, view. Exactly one of these must be specified: diff --git a/gcloud/beta/container/fleet/scopes/rbacrolebindings/update b/gcloud/beta/container/fleet/scopes/rbacrolebindings/update index 3d1b16948..077abbfb8 100644 --- a/gcloud/beta/container/fleet/scopes/rbacrolebindings/update +++ b/gcloud/beta/container/fleet/scopes/rbacrolebindings/update @@ -70,8 +70,8 @@ POSITIONAL ARGUMENTS FLAGS --role=ROLE - Role for the RBACRoleBinding to update to. ROLE must be one of: admin, - edit, view. + Predefined role to assign to principal (admin, edit, view). ROLE must + be one of: admin, edit, view. --update-labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to update. If a label exists, its value diff --git a/gcloud/beta/container/hub/scopes/rbacrolebindings/create b/gcloud/beta/container/hub/scopes/rbacrolebindings/create index 855b93dde..00889f8f1 100644 --- a/gcloud/beta/container/hub/scopes/rbacrolebindings/create +++ b/gcloud/beta/container/hub/scopes/rbacrolebindings/create @@ -69,7 +69,8 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS --role=ROLE - Role to assign. ROLE must be one of: admin, edit, view. + Predefined role to assign to principal (admin, edit, view). ROLE must + be one of: admin, edit, view. Exactly one of these must be specified: diff --git a/gcloud/beta/container/hub/scopes/rbacrolebindings/update b/gcloud/beta/container/hub/scopes/rbacrolebindings/update index 6529cc5b3..85b13e038 100644 --- a/gcloud/beta/container/hub/scopes/rbacrolebindings/update +++ b/gcloud/beta/container/hub/scopes/rbacrolebindings/update @@ -70,8 +70,8 @@ POSITIONAL ARGUMENTS FLAGS --role=ROLE - Role for the RBACRoleBinding to update to. ROLE must be one of: admin, - edit, view. + Predefined role to assign to principal (admin, edit, view). ROLE must + be one of: admin, edit, view. --update-labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to update. If a label exists, its value diff --git a/gcloud/beta/functions/deploy b/gcloud/beta/functions/deploy index 814362d29..681679ecd 100644 --- a/gcloud/beta/functions/deploy +++ b/gcloud/beta/functions/deploy @@ -377,6 +377,11 @@ FLAGS DOCKER_REPOSITORY must be an Artifact Registry Docker repository present in the same project and location as the Cloud Function. + **Preview:** for 2nd gen functions, a Docker Artifact registry + repository in a different project and/or location may be used. + Additional requirements apply, see + https://cloud.google.com/functions/docs/building#image_registry + The repository name should match one of these patterns: ▸ projects/${PROJECT}/locations/${LOCATION}/repositories/${REPOSITORY}, diff --git a/gcloud/beta/network-security/intercept-endpoint-groups/create b/gcloud/beta/network-security/intercept-endpoint-groups/create index 9e40818ad..fc0f16b6a 100644 --- a/gcloud/beta/network-security/intercept-endpoint-groups/create +++ b/gcloud/beta/network-security/intercept-endpoint-groups/create @@ -7,7 +7,7 @@ SYNOPSIS (INTERCEPT_ENDPOINT_GROUP : --location=LOCATION) (--intercept-deployment-group=INTERCEPT_DEPLOYMENT_GROUP : --intercept-deployment-group-location=INTERCEPT_DEPLOYMENT_GROUP_LOCATION) - [--async] [--labels=[KEY=VALUE,...]] + [--async] [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] [--max-wait=MAX_WAIT; default="20m"] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -39,6 +39,14 @@ EXAMPLES --intercept-deployment-group=projects/my-project/locations/\ global/interceptDeploymentGroups/my-deployment-group + OR + + $ gcloud beta network-security intercept-endpoint-groups create \ + my-endpoint-group --project=my-project --location=global \ + --mirroring-deployment-group=projects/my-project/locations/\ + global/interceptDeploymentGroups/my-deployment-group \ + --description='new description' + POSITIONAL ARGUMENTS Intercept endpoint group resource - Intercept Endpoint Group. The arguments in this group can be used to specify the attributes of this @@ -115,6 +123,9 @@ OPTIONAL FLAGS complete. The default is True. Enabled by default, use --no-async to disable. + --description=DESCRIPTION + Description of the endpoint + --labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to add. diff --git a/gcloud/beta/network-security/intercept-endpoint-groups/update b/gcloud/beta/network-security/intercept-endpoint-groups/update index 043124cc9..f1c176361 100644 --- a/gcloud/beta/network-security/intercept-endpoint-groups/update +++ b/gcloud/beta/network-security/intercept-endpoint-groups/update @@ -5,7 +5,8 @@ NAME SYNOPSIS gcloud beta network-security intercept-endpoint-groups update (INTERCEPT_ENDPOINT_GROUP : --location=LOCATION) [--async] - [--max-wait=MAX_WAIT; default="20m"] [--update-labels=[KEY=VALUE,...]] + [--description=DESCRIPTION] [--max-wait=MAX_WAIT; default="20m"] + [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -34,6 +35,12 @@ EXAMPLES my-endpoint-group --project=my-project \ --location=us-central1-a --clear-labels + To update description to 'new description', run: + + $ gcloud beta network-security intercept-endpoint-groups update \ + my-endpoint-group --project=my-project \ + --location=us-central1-a --description='new description' + POSITIONAL ARGUMENTS Intercept endpoint group resource - Intercept Endpoint Group. The arguments in this group can be used to specify the attributes of this @@ -73,6 +80,9 @@ FLAGS complete. The default is True. Enabled by default, use --no-async to disable. + --description=DESCRIPTION + Description of the endpoint + --max-wait=MAX_WAIT; default="20m" Time to synchronously wait for the operation to complete, after which the operation continues asynchronously. Ignored if --no-async isn't diff --git a/gcloud/beta/network-security/mirroring-endpoint-groups/create b/gcloud/beta/network-security/mirroring-endpoint-groups/create index b4bc9fa92..3662609dc 100644 --- a/gcloud/beta/network-security/mirroring-endpoint-groups/create +++ b/gcloud/beta/network-security/mirroring-endpoint-groups/create @@ -39,6 +39,14 @@ EXAMPLES --mirroring-deployment-group=projects/my-project/locations/\ global/mirroringDeploymentGroups/my-deployment-group + OR + + $ gcloud beta network-security mirroring-endpoint-groups create \ + my-endpoint-group --project=my-project --location=global \ + --mirroring-deployment-group=projects/my-project/locations/\ + global/mirroringDeploymentGroups/my-deployment-group \ + --description='new description' + POSITIONAL ARGUMENTS Mirroring endpoint group resource - Mirroring Endpoint Group. The arguments in this group can be used to specify the attributes of this diff --git a/gcloud/beta/network-security/mirroring-endpoint-groups/update b/gcloud/beta/network-security/mirroring-endpoint-groups/update index 96d9930ce..8be79b0ae 100644 --- a/gcloud/beta/network-security/mirroring-endpoint-groups/update +++ b/gcloud/beta/network-security/mirroring-endpoint-groups/update @@ -34,6 +34,12 @@ EXAMPLES my-endpoint-group --project=my-project \ --location=us-central1-a --clear-labels + To update description to 'new description', run: + + $ gcloud beta network-security mirroring-endpoint-groups update \ + my-endpoint-group --project=my-project \ + --location=us-central1-a --description='new description' + POSITIONAL ARGUMENTS Mirroring endpoint group resource - Mirroring Endpoint Group. The arguments in this group can be used to specify the attributes of this diff --git a/gcloud/beta/network-security/security-profile-groups/create b/gcloud/beta/network-security/security-profile-groups/create index c3fe1655a..e141606ed 100644 --- a/gcloud/beta/network-security/security-profile-groups/create +++ b/gcloud/beta/network-security/security-profile-groups/create @@ -7,6 +7,8 @@ SYNOPSIS (SECURITY_PROFILE_GROUP : --location=LOCATION --organization=ORGANIZATION) [--async] [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] + [--custom-intercept-profile=CUSTOM_INTERCEPT_PROFILE + : --custom-intercept-profile-location=CUSTOM_INTERCEPT_PROFILE_LOCATION --custom-intercept-profile-organization=CUSTOM_INTERCEPT_PROFILE_ORGANIZATION] [--custom-mirroring-profile=CUSTOM_MIRRORING_PROFILE : --custom-mirroring-profile-location=CUSTOM_MIRRORING_PROFILE_LOCATION --custom-mirroring-profile-organization=CUSTOM_MIRRORING_PROFILE_ORGANIZATION] [--threat-prevention-profile=THREAT_PREVENTION_PROFILE @@ -77,6 +79,48 @@ FLAGS contain only hyphens (-), underscores (_), lowercase characters, and numbers. + Security Profile resource - Path to Security Profile resource. The + arguments in this group can be used to specify the attributes of this + resource. + + --custom-intercept-profile=CUSTOM_INTERCEPT_PROFILE + ID of the Security Profile or fully qualified identifier for the + Security Profile. + + To set the custom-intercept-profile-profile attribute: + ▸ provide the argument --custom-intercept-profile on the command + line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --custom-intercept-profile-location=CUSTOM_INTERCEPT_PROFILE_LOCATION + Location of the Security Profile. NOTE: Only global security profiles + are supported. + + To set the custom-intercept-profile-location attribute: + ▸ provide the argument --custom-intercept-profile on the command + line with a fully specified name; + ▸ provide the argument --custom-intercept-profile-location on the + command line; + ▸ provide the argument --location on the command line; + ▸ provide the argument + networksecurity.organizations.locations.securityProfileGroups on + the command line with a fully specified name. + + --custom-intercept-profile-organization=CUSTOM_INTERCEPT_PROFILE_ORGANIZATION + Organization ID of the Security Profile. + + To set the custom-intercept-profile-organization attribute: + ▸ provide the argument --custom-intercept-profile on the command + line with a fully specified name; + ▸ provide the argument --custom-intercept-profile-organization on + the command line; + ▸ provide the argument --organization on the command line; + ▸ provide the argument + networksecurity.organizations.locations.securityProfileGroups on + the command line with a fully specified name. + Security Profile resource - Path to Security Profile resource. The arguments in this group can be used to specify the attributes of this resource. diff --git a/gcloud/beta/network-security/security-profiles/custom-intercept/create b/gcloud/beta/network-security/security-profiles/custom-intercept/create new file mode 100644 index 000000000..f2ac6b01d --- /dev/null +++ b/gcloud/beta/network-security/security-profiles/custom-intercept/create @@ -0,0 +1,125 @@ +NAME + gcloud beta network-security security-profiles custom-intercept create - + create a new Custom Intercept Profile + +SYNOPSIS + gcloud beta network-security security-profiles custom-intercept create + (SECURITY_PROFILE : --location=LOCATION --organization=ORGANIZATION) + (--intercept-endpoint-group=INTERCEPT_ENDPOINT_GROUP + : --intercept-endpoint-group-location=INTERCEPT_ENDPOINT_GROUP_LOCATION) + [--async] [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Create a new Custom Intercept Security Profile. + +EXAMPLES + To create a Custom Intercept Security Profile named intercept-profile + linked to a Intercept Endpoint Group (q.v.), run: + + $ gcloud beta network-security security-profiles custom-intercept \ + create intercept-profile --description="An Intercept Profile" \ + --intercept-endpoint-group=projects/my-project/locations/\ + global/interceptEndpointGroups/my-mep + +POSITIONAL ARGUMENTS + Security profile resource - Security Profile Name. The arguments in this + group can be used to specify the attributes of this resource. + + This must be specified. + + SECURITY_PROFILE + ID of the security_profile or fully qualified identifier for the + security_profile. + + To set the security_profile attribute: + ▸ provide the argument security_profile on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + location of the security_profile - Global. + + To set the location attribute: + ▸ provide the argument security_profile on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + + --organization=ORGANIZATION + Organization ID to which the changes should apply. + + To set the organization attribute: + ▸ provide the argument security_profile on the command line with a + fully specified name; + ▸ provide the argument --organization on the command line. + +REQUIRED FLAGS + Intercept endpoint group resource - Intercept Endpoint Group. 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 --intercept-endpoint-group 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. + + --intercept-endpoint-group=INTERCEPT_ENDPOINT_GROUP + ID of the intercept endpoint group or fully qualified identifier for + the intercept endpoint group. + + To set the id attribute: + ▸ provide the argument --intercept-endpoint-group on the command + line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --intercept-endpoint-group-location=INTERCEPT_ENDPOINT_GROUP_LOCATION + Location of the intercept endpoint group. + + To set the location attribute: + ▸ provide the argument --intercept-endpoint-group on the command + line with a fully specified name; + ▸ provide the argument --intercept-endpoint-group-location on the + command line; + ▸ provide the argument --location on the command line; + ▸ provide the argument + networksecurity.projects.locations.interceptEndpointGroupAssociations + on the command line with a fully specified name. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. The default is False. + + --description=DESCRIPTION + Brief description of the security profile + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha network-security security-profiles custom-intercept \ + create + diff --git a/gcloud/beta/network-security/security-profiles/custom-intercept/delete b/gcloud/beta/network-security/security-profiles/custom-intercept/delete new file mode 100644 index 000000000..f2f407e6d --- /dev/null +++ b/gcloud/beta/network-security/security-profiles/custom-intercept/delete @@ -0,0 +1,76 @@ +NAME + gcloud beta network-security security-profiles custom-intercept delete - + delete a Security Profile + +SYNOPSIS + gcloud beta network-security security-profiles custom-intercept delete + (SECURITY_PROFILE : --location=LOCATION --organization=ORGANIZATION) + [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Delete the specified Security Profile. + +EXAMPLES + To delete a Security Profile called my-security-profile run: + + $ gcloud beta network-security security-profiles custom-intercept \ + delete my-security-profile + +POSITIONAL ARGUMENTS + Security profile resource - Name of the Security Profile you want to + delete. The arguments in this group can be used to specify the attributes + of this resource. + + This must be specified. + + SECURITY_PROFILE + ID of the security_profile or fully qualified identifier for the + security_profile. + + To set the security_profile attribute: + ▸ provide the argument security_profile on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location ID of the resource. + + To set the location attribute: + ▸ provide the argument security_profile on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ use default global location . + + --organization=ORGANIZATION + Organization number. + + To set the organization attribute: + ▸ provide the argument security_profile on the command line with a + fully specified name; + ▸ provide the argument --organization 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 networksecurity/v1beta1 API. The full documentation + for this API can be found at: https://cloud.google.com/networking + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha network-security security-profiles custom-intercept \ + delete + diff --git a/gcloud/beta/network-security/security-profiles/custom-intercept/describe b/gcloud/beta/network-security/security-profiles/custom-intercept/describe new file mode 100644 index 000000000..58289d950 --- /dev/null +++ b/gcloud/beta/network-security/security-profiles/custom-intercept/describe @@ -0,0 +1,71 @@ +NAME + gcloud beta network-security security-profiles custom-intercept describe - + describe a Custom InterceptSecurity Profile + +SYNOPSIS + gcloud beta network-security security-profiles custom-intercept describe + (SECURITY_PROFILE : --location=LOCATION --organization=ORGANIZATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Show details of the Security Profile. + +EXAMPLES + To show details of a Security Profile named my-intercept-sp run: + + $ gcloud beta network-security security-profiles custom-intercept \ + describe my-intercept-sp --organization=1234 --location=global + +POSITIONAL ARGUMENTS + Security profile resource - Name of the Security Profile to be described. + The arguments in this group can be used to specify the attributes of this + resource. + + This must be specified. + + SECURITY_PROFILE + ID of the security_profile or fully qualified identifier for the + security_profile. + + To set the security_profile attribute: + ▸ provide the argument security_profile on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location ID of the resource. + + To set the location attribute: + ▸ provide the argument security_profile on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ use default global location . + + --organization=ORGANIZATION + Organization number. + + To set the organization attribute: + ▸ provide the argument security_profile on the command line with a + fully specified name; + ▸ provide the argument --organization on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networksecurity/v1beta1 API. The full documentation + for this API can be found at: https://cloud.google.com/networking + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha network-security security-profiles custom-intercept \ + describe + diff --git a/gcloud/beta/network-security/security-profiles/custom-intercept/help b/gcloud/beta/network-security/security-profiles/custom-intercept/help new file mode 100644 index 000000000..fb02619cc --- /dev/null +++ b/gcloud/beta/network-security/security-profiles/custom-intercept/help @@ -0,0 +1,41 @@ +NAME + gcloud beta network-security security-profiles custom-intercept - manage + Security Profiles - Custom Intercept Profile + +SYNOPSIS + gcloud beta network-security security-profiles custom-intercept COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) This class provides commands for managing Custom Intercept Security + Profile. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (BETA) Create a new Custom Intercept Profile. + + delete + (BETA) Delete a Security Profile. + + describe + (BETA) Describe a Custom InterceptSecurity Profile. + + list + (BETA) List Custom Intercept Security Profiles. + + update + (BETA) Updates a Custom Intercept Profile. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha network-security security-profiles custom-intercept + diff --git a/gcloud/beta/network-security/security-profiles/custom-intercept/list b/gcloud/beta/network-security/security-profiles/custom-intercept/list new file mode 100644 index 000000000..c54cec19d --- /dev/null +++ b/gcloud/beta/network-security/security-profiles/custom-intercept/list @@ -0,0 +1,88 @@ +NAME + gcloud beta network-security security-profiles custom-intercept list - list + Custom Intercept Security Profiles + +SYNOPSIS + gcloud beta network-security security-profiles custom-intercept list + [--location=LOCATION : --organization=ORGANIZATION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) List Custom Intercept Security Profiles. + + For more examples, refer to the EXAMPLES section below. + +EXAMPLES + To list Custom Intercept security profiles in an organization, run: + + $ gcloud beta network-security security-profiles custom-intercept \ list --organization=12345 --location=global + +FLAGS + Location resource - Parent resource for the list operation. The arguments + in this group can be used to specify the attributes of this resource. + + --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. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --organization=ORGANIZATION + Organization ID of the location. + + To set the organization attribute: + ▸ provide the argument --location on the command line with a fully + specified name; + ▸ provide the argument --organization on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha network-security security-profiles custom-intercept \ + list + diff --git a/gcloud/beta/network-security/security-profiles/custom-intercept/update b/gcloud/beta/network-security/security-profiles/custom-intercept/update new file mode 100644 index 000000000..e571defde --- /dev/null +++ b/gcloud/beta/network-security/security-profiles/custom-intercept/update @@ -0,0 +1,117 @@ +NAME + gcloud beta network-security security-profiles custom-intercept update - + updates a Custom Intercept Profile + +SYNOPSIS + gcloud beta network-security security-profiles custom-intercept update + (SECURITY_PROFILE : --location=LOCATION --organization=ORGANIZATION) + [--async] [--description=DESCRIPTION] [--update-labels=[KEY=VALUE,...]] + [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Update a Custom Intercept Security Profile. + + The supported fields for update are description and labels. + +EXAMPLES + To update the description of a Custom Intercept Security Profile named + intercept-profile, run: + + $ gcloud beta network-security security-profiles custom-intercept \ + update intercept-profile --description="A new description" \ + --organization=1234567890 --location=global + + To change the labels of a Custom Intercept Security Profile named + intercept-profile, run: + + $ gcloud beta network-security security-profiles custom-intercept \ + update intercept-profile \ + --update-labels=key1=value1,key2=value2 \ + --delete-labels=key3,key4 --organization=1234567890 \ + --location=glob + +POSITIONAL ARGUMENTS + Security profile resource - Security Profile Name. The arguments in this + group can be used to specify the attributes of this resource. + + This must be specified. + + SECURITY_PROFILE + ID of the security_profile or fully qualified identifier for the + security_profile. + + To set the security_profile attribute: + ▸ provide the argument security_profile on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + location of the security_profile - Global. + + To set the location attribute: + ▸ provide the argument security_profile on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + + --organization=ORGANIZATION + Organization ID to which the changes should apply. + + To set the organization attribute: + ▸ provide the argument security_profile on the command line with a + fully specified name; + ▸ provide the argument --organization on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. The default is False. + + --description=DESCRIPTION + Brief description of the security profile + + --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-security security-profiles custom-intercept \ + update --clear-labels + + To remove all existing labels and create two new labels, foo and baz: + + $ gcloud beta network-security security-profiles custom-intercept \ + update --clear-labels --update-labels foo=bar,baz=qux + + --remove-labels=[KEY,...] + List of label keys to remove. If a label does not exist it is + silently ignored. If --update-labels is also specified then + --update-labels is applied first. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha network-security security-profiles custom-intercept \ + update + diff --git a/gcloud/beta/network-security/security-profiles/help b/gcloud/beta/network-security/security-profiles/help index d1fab5e6b..ae71d8359 100644 --- a/gcloud/beta/network-security/security-profiles/help +++ b/gcloud/beta/network-security/security-profiles/help @@ -16,6 +16,9 @@ GCLOUD WIDE FLAGS GROUPS GROUP is one of the following: + custom-intercept + (BETA) Manage Security Profiles - Custom Intercept Profile. + custom-mirroring (BETA) Manage Security Profiles - Custom Mirroring Profile. diff --git a/gcloud/beta/run/deploy b/gcloud/beta/run/deploy index 1d2abe3c3..4a93d5015 100644 --- a/gcloud/beta/run/deploy +++ b/gcloud/beta/run/deploy @@ -211,8 +211,9 @@ FLAGS disable. --max-instances=MAX_INSTANCES - The maximum number of container instances of the Service to run. Use - 'default' to unset the limit and use the platform default. + The maximum number of container instances for this Revision to run or + 'default' to remove. This setting is immutably set on each new Revision + and modifying its value will deploy another Revision. --mesh=MESH Enables Cloud Service Mesh using the specified mesh resource name. Mesh @@ -220,13 +221,17 @@ FLAGS projects/PROJECT/locations/global/meshes/MESH_NAME. --min=MIN - The minimum number of container instances for this Service to run or - 'default' to remove any minimum. These instances will be divided among - all Revisions receiving a percentage of traffic. + The minimum number of container instances to run for this Service or + 'default' to remove. These instances will be divided among all + Revisions receiving a percentage of traffic and can be modified without + deploying a new Revision. --min-instances=MIN_INSTANCES - The minimum number of container instances for this Revision of the - Service to run or 'default' to remove any minimum. + The minimum number of container instances to run for this Revision or + 'default' to remove. This setting is immutably set on each new Revision + and modifying its value will deploy a another Revision. Consider using + --min to set the minimum number of instances across all revisions of + the Service which may be modified dynamically. --region=REGION Region in which the resource can be found. Alternatively, set the diff --git a/gcloud/beta/run/multi-region-services/update b/gcloud/beta/run/multi-region-services/update index 100009de8..031469db8 100644 --- a/gcloud/beta/run/multi-region-services/update +++ b/gcloud/beta/run/multi-region-services/update @@ -179,8 +179,9 @@ FLAGS disable. --max-instances=MAX_INSTANCES - The maximum number of container instances of the Service to run. Use - 'default' to unset the limit and use the platform default. + The maximum number of container instances for this Revision to run or + 'default' to remove. This setting is immutably set on each new Revision + and modifying its value will deploy another Revision. --mesh=MESH Enables Cloud Service Mesh using the specified mesh resource name. Mesh @@ -188,13 +189,17 @@ FLAGS projects/PROJECT/locations/global/meshes/MESH_NAME. --min=MIN - The minimum number of container instances for this Service to run or - 'default' to remove any minimum. These instances will be divided among - all Revisions receiving a percentage of traffic. + The minimum number of container instances to run for this Service or + 'default' to remove. These instances will be divided among all + Revisions receiving a percentage of traffic and can be modified without + deploying a new Revision. --min-instances=MIN_INSTANCES - The minimum number of container instances for this Revision of the - Service to run or 'default' to remove any minimum. + The minimum number of container instances to run for this Revision or + 'default' to remove. This setting is immutably set on each new Revision + and modifying its value will deploy a another Revision. Consider using + --min to set the minimum number of instances across all revisions of + the Service which may be modified dynamically. --region=REGION Region in which the resource can be found. Alternatively, set the diff --git a/gcloud/beta/run/services/update b/gcloud/beta/run/services/update index 5ba24aec3..4cf68e7f9 100644 --- a/gcloud/beta/run/services/update +++ b/gcloud/beta/run/services/update @@ -179,8 +179,9 @@ FLAGS disable. --max-instances=MAX_INSTANCES - The maximum number of container instances of the Service to run. Use - 'default' to unset the limit and use the platform default. + The maximum number of container instances for this Revision to run or + 'default' to remove. This setting is immutably set on each new Revision + and modifying its value will deploy another Revision. --mesh=MESH Enables Cloud Service Mesh using the specified mesh resource name. Mesh @@ -188,13 +189,17 @@ FLAGS projects/PROJECT/locations/global/meshes/MESH_NAME. --min=MIN - The minimum number of container instances for this Service to run or - 'default' to remove any minimum. These instances will be divided among - all Revisions receiving a percentage of traffic. + The minimum number of container instances to run for this Service or + 'default' to remove. These instances will be divided among all + Revisions receiving a percentage of traffic and can be modified without + deploying a new Revision. --min-instances=MIN_INSTANCES - The minimum number of container instances for this Revision of the - Service to run or 'default' to remove any minimum. + The minimum number of container instances to run for this Revision or + 'default' to remove. This setting is immutably set on each new Revision + and modifying its value will deploy a another Revision. Consider using + --min to set the minimum number of instances across all revisions of + the Service which may be modified dynamically. --region=REGION Region in which the resource can be found. Alternatively, set the diff --git a/gcloud/bigtable/instances/tables/create b/gcloud/bigtable/instances/tables/create index 53936835d..96da8c76b 100644 --- a/gcloud/bigtable/instances/tables/create +++ b/gcloud/bigtable/instances/tables/create @@ -5,8 +5,9 @@ SYNOPSIS gcloud bigtable instances tables create (TABLE : --instance=INSTANCE) --column-families=[COLUMN_FAMILIES,...] [--change-stream-retention-period=CHANGE_STREAM_RETENTION_PERIOD] - [--deletion-protection] [--enable-automated-backup] - [--splits=[SPLITS,...]] [GCLOUD_WIDE_FLAG ...] + [--deletion-protection] [--splits=[SPLITS,...]] + [--automated-backup-retention-period=AUTOMATED_BACKUP_RETENTION_PERIOD + | --enable-automated-backup] [GCLOUD_WIDE_FLAG ...] DESCRIPTION Create a new Cloud Bigtable table. @@ -59,14 +60,22 @@ EXAMPLES --instance=my-instance --column-families="my-family" \ --no-deletion-protection - To create a table my-table with automated backup policy - (retention_period=72h, frequency=24h) enabled in instance my-instance with - a column family my-family, run: + To create a table my-table with the default automated backup policy + (retention_period=7d, frequency=1d) enabled in instance my-instance with a + column family my-family, run: $ gcloud bigtable instances tables create my-table \ --instance=my-instance --column-families="my-family" \ --enable-automated-backup + To create a table my-table with a custom automated backup policy configured + to retain backups for 30 days in instance my-instance with a column family + my-family, run: + + $ gcloud bigtable instances tables create my-table \ + --instance=my-instance --column-families="my-family" \ + --automated-backup-retention_period=30d + POSITIONAL ARGUMENTS Table resource - Cloud Bigtable table to create. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some @@ -115,14 +124,21 @@ OPTIONAL FLAGS --deletion-protection Once specified, the table is deletion protected. - --enable-automated-backup - Once set, enables the default automated backup policy - (retention_period=72h, frequency=24h) for the table. - --splits=[SPLITS,...] Row keys where the table should initially be split. For example: car,key + At most one of these can be specified: + + --automated-backup-retention-period=AUTOMATED_BACKUP_RETENTION_PERIOD + The retention period of automated backup in the format of 30d for 30 + days. Min retention period is 3d and max is 90d. Setting this flag + will enable automated backup for the table. + + --enable-automated-backup + Once set, enables the default automated backup policy + (retention_period=7d, frequency=1d) for the table. + 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/bigtable/instances/tables/update b/gcloud/bigtable/instances/tables/update index 100eb6965..a574e7fbb 100644 --- a/gcloud/bigtable/instances/tables/update +++ b/gcloud/bigtable/instances/tables/update @@ -4,8 +4,9 @@ NAME SYNOPSIS gcloud bigtable instances tables update (TABLE : --instance=INSTANCE) - [--async] [--deletion-protection] [--disable-automated-backup] - [--enable-automated-backup] + [--async] [--deletion-protection] + [--automated-backup-retention-period=AUTOMATED_BACKUP_RETENTION_PERIOD + | --disable-automated-backup | --enable-automated-backup] [--change-stream-retention-period=CHANGE_STREAM_RETENTION_PERIOD | --clear-change-stream-retention-period] [GCLOUD_WIDE_FLAG ...] @@ -35,8 +36,8 @@ EXAMPLES $ gcloud bigtable instances tables update my-table \ --instance=my-instance --clear-change-stream-retention-period - To enable default automated backup policy (retention_period=72h, - frequency=24h), run: + To enable the default automated backup policy on a table, or update a table + to use the default policy (retention_period=7d, frequency=1d), run: $ gcloud bigtable instances tables update my-table \ --instance=my-instance --enable-automated-backup @@ -46,6 +47,12 @@ EXAMPLES $ gcloud bigtable instances tables update my-table \ --instance=my-instance --disable-automated-backup + To enable or update a custom automated backup policy and configure it to + retain backups for 30 days, run: + + $ gcloud bigtable instances tables update my-table \ + --instance=my-instance --automated-backup-retention_period=30d + POSITIONAL ARGUMENTS Table resource - Cloud Bigtable table to update. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some @@ -85,12 +92,21 @@ FLAGS --deletion-protection Once specified, the table is deletion protected. - --disable-automated-backup - Once set, disables automated backup policy for the table. + At most one of these can be specified: - --enable-automated-backup - Once set, enables the default automated backup policy - (retention_period=72h, frequency=24h) for the table. + --automated-backup-retention-period=AUTOMATED_BACKUP_RETENTION_PERIOD + The retention period of automated backup in the format of 30d for 30 + days. Min retention period is 3d and max is 90d. Setting this flag + will enable automated backup for the table. + + --disable-automated-backup + Once set, disables automated backup policy for the table. + + --enable-automated-backup + Once set, enables the default automated backup policy + (retention_period=7d, frequency=1d) for the table. Note: If a table + has automated backup enabled, this flag resets it to the default + policy. At most one of these can be specified: diff --git a/gcloud/bigtable/tables/create b/gcloud/bigtable/tables/create index 1cf2a801b..37f8e977e 100644 --- a/gcloud/bigtable/tables/create +++ b/gcloud/bigtable/tables/create @@ -5,8 +5,9 @@ SYNOPSIS gcloud bigtable tables create (TABLE : --instance=INSTANCE) --column-families=[COLUMN_FAMILIES,...] [--change-stream-retention-period=CHANGE_STREAM_RETENTION_PERIOD] - [--deletion-protection] [--enable-automated-backup] - [--splits=[SPLITS,...]] [GCLOUD_WIDE_FLAG ...] + [--deletion-protection] [--splits=[SPLITS,...]] + [--automated-backup-retention-period=AUTOMATED_BACKUP_RETENTION_PERIOD + | --enable-automated-backup] [GCLOUD_WIDE_FLAG ...] DESCRIPTION Create a new Cloud Bigtable table. @@ -54,13 +55,21 @@ EXAMPLES $ gcloud bigtable tables create my-table --instance=my-instance \ --column-families="my-family" --no-deletion-protection - To create a table my-table with automated backup policy - (retention_period=72h, frequency=24h) enabled in instance my-instance with - a column family my-family, run: + To create a table my-table with the default automated backup policy + (retention_period=7d, frequency=1d) enabled in instance my-instance with a + column family my-family, run: $ gcloud bigtable tables create my-table --instance=my-instance \ --column-families="my-family" --enable-automated-backup + To create a table my-table with a custom automated backup policy configured + to retain backups for 30 days in instance my-instance with a column family + my-family, run: + + $ gcloud bigtable tables create my-table --instance=my-instance \ + --column-families="my-family" \ + --automated-backup-retention_period=30d + POSITIONAL ARGUMENTS Table resource - Cloud Bigtable table to create. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some @@ -109,14 +118,21 @@ OPTIONAL FLAGS --deletion-protection Once specified, the table is deletion protected. - --enable-automated-backup - Once set, enables the default automated backup policy - (retention_period=72h, frequency=24h) for the table. - --splits=[SPLITS,...] Row keys where the table should initially be split. For example: car,key + At most one of these can be specified: + + --automated-backup-retention-period=AUTOMATED_BACKUP_RETENTION_PERIOD + The retention period of automated backup in the format of 30d for 30 + days. Min retention period is 3d and max is 90d. Setting this flag + will enable automated backup for the table. + + --enable-automated-backup + Once set, enables the default automated backup policy + (retention_period=7d, frequency=1d) for the table. + 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/bigtable/tables/update b/gcloud/bigtable/tables/update index 7b386eb31..89e3f265e 100644 --- a/gcloud/bigtable/tables/update +++ b/gcloud/bigtable/tables/update @@ -3,8 +3,9 @@ NAME SYNOPSIS gcloud bigtable tables update (TABLE : --instance=INSTANCE) [--async] - [--deletion-protection] [--disable-automated-backup] - [--enable-automated-backup] + [--deletion-protection] + [--automated-backup-retention-period=AUTOMATED_BACKUP_RETENTION_PERIOD + | --disable-automated-backup | --enable-automated-backup] [--change-stream-retention-period=CHANGE_STREAM_RETENTION_PERIOD | --clear-change-stream-retention-period] [GCLOUD_WIDE_FLAG ...] @@ -34,8 +35,8 @@ EXAMPLES $ gcloud bigtable tables update my-table --instance=my-instance \ --clear-change-stream-retention-period - To enable default automated backup policy (retention_period=72h, - frequency=24h), run: + To enable the default automated backup policy on a table, or update a table + to use the default policy (retention_period=7d, frequency=1d), run: $ gcloud bigtable tables update my-table --instance=my-instance \ --enable-automated-backup @@ -45,6 +46,12 @@ EXAMPLES $ gcloud bigtable tables update my-table --instance=my-instance \ --disable-automated-backup + To enable or update a custom automated backup policy and configure it to + retain backups for 30 days, run: + + $ gcloud bigtable tables update my-table --instance=my-instance \ + --automated-backup-retention_period=30d + POSITIONAL ARGUMENTS Table resource - Cloud Bigtable table to update. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some @@ -84,12 +91,21 @@ FLAGS --deletion-protection Once specified, the table is deletion protected. - --disable-automated-backup - Once set, disables automated backup policy for the table. + At most one of these can be specified: - --enable-automated-backup - Once set, enables the default automated backup policy - (retention_period=72h, frequency=24h) for the table. + --automated-backup-retention-period=AUTOMATED_BACKUP_RETENTION_PERIOD + The retention period of automated backup in the format of 30d for 30 + days. Min retention period is 3d and max is 90d. Setting this flag + will enable automated backup for the table. + + --disable-automated-backup + Once set, disables automated backup policy for the table. + + --enable-automated-backup + Once set, enables the default automated backup policy + (retention_period=7d, frequency=1d) for the table. Note: If a table + has automated backup enabled, this flag resets it to the default + policy. At most one of these can be specified: diff --git a/gcloud/colab/runtime-templates/create b/gcloud/colab/runtime-templates/create index abb1967a0..b01bfc12a 100644 --- a/gcloud/colab/runtime-templates/create +++ b/gcloud/colab/runtime-templates/create @@ -96,7 +96,7 @@ OPTIONAL FLAGS --network-tags=[TAGS,...] Applies the given Compute Engine tags to the runtime. - The machine configuration of the runtime provisioned from this template. + The machine configuration of the runtime. --accelerator-count=ACCELERATOR_COUNT The number of accelerators used by the runtime. @@ -110,8 +110,7 @@ OPTIONAL FLAGS --machine-type=MACHINE_TYPE; default="e2-standard-4" The Compute Engine machine type selected for the runtime. - The configuration for the data disk of the runtime provisioned from this - template. + The configuration for the data disk of the runtime. --disk-size-gb=DISK_SIZE_GB; default=100 The disk size of the runtime in GB. If specified, the --disk-type diff --git a/gcloud/compute/help b/gcloud/compute/help index 9c88a608d..978ae1ad8 100644 --- a/gcloud/compute/help +++ b/gcloud/compute/help @@ -105,6 +105,9 @@ GROUPS network-firewall-policies Manage Compute Engine network firewall policies. + network-profiles + Read Compute Engine network profiles. + networks List, create, and delete Compute Engine networks. diff --git a/gcloud/compute/network-profiles/describe b/gcloud/compute/network-profiles/describe new file mode 100644 index 000000000..521e92dc8 --- /dev/null +++ b/gcloud/compute/network-profiles/describe @@ -0,0 +1,53 @@ +NAME + gcloud compute network-profiles describe - describe a network profile + +SYNOPSIS + gcloud compute network-profiles describe NETWORK_PROFILE + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe a network profile. + +EXAMPLES + To retrieve a single network profile and print its properties, run the + following command: $ gcloud compute network-profiles describe my-network-profile + +POSITIONAL ARGUMENTS + Network profile resource - Name of the network profile you want to + inspect. 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 network_profile on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + NETWORK_PROFILE + ID of the network_profile or fully qualified identifier for the + network_profile. + + To set the network_profile attribute: + ▸ provide the argument network_profile 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 compute/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/compute/ + +NOTES + These variants are also available: + + $ gcloud alpha compute network-profiles describe + + $ gcloud beta compute network-profiles describe + diff --git a/gcloud/compute/network-profiles/help b/gcloud/compute/network-profiles/help new file mode 100644 index 000000000..55aff18ae --- /dev/null +++ b/gcloud/compute/network-profiles/help @@ -0,0 +1,30 @@ +NAME + gcloud compute network-profiles - read Compute Engine network profiles + +SYNOPSIS + gcloud compute network-profiles COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Read Compute Engine network profiles. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + Describe a network profile. + + list + List network profiles. + +NOTES + These variants are also available: + + $ gcloud alpha compute network-profiles + + $ gcloud beta compute network-profiles + diff --git a/gcloud/compute/network-profiles/list b/gcloud/compute/network-profiles/list new file mode 100644 index 000000000..5f55ca427 --- /dev/null +++ b/gcloud/compute/network-profiles/list @@ -0,0 +1,67 @@ +NAME + gcloud compute network-profiles list - list network profiles + +SYNOPSIS + gcloud compute network-profiles list [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List network profiles. + +EXAMPLES + The following command lists all network profiles: + + $ gcloud compute network-profiles 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. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the compute/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/compute/ + +NOTES + These variants are also available: + + $ gcloud alpha compute network-profiles list + + $ gcloud beta compute network-profiles list + diff --git a/gcloud/compute/networks/create b/gcloud/compute/networks/create index f4bb41b1a..6495c8ed6 100644 --- a/gcloud/compute/networks/create +++ b/gcloud/compute/networks/create @@ -7,7 +7,8 @@ SYNOPSIS [--description=DESCRIPTION] [--[no-]enable-ula-internal-ipv6] [--internal-ipv6-range=INTERNAL_IPV6_RANGE] [--mtu=MTU] [--network-firewall-policy-enforcement-order=NETWORK_FIREWALL_POLICY_ENFORCEMENT_ORDER] - [--range=RANGE] [--subnet-mode=MODE] + [--network-profile=NETWORK_PROFILE] [--range=RANGE] + [--subnet-mode=MODE] [--bgp-best-path-selection-mode=BGP_BEST_PATH_SELECTION_MODE --[no-]bgp-bps-always-compare-med --bgp-bps-inter-region-cost=BGP_BPS_INTER_REGION_COST] @@ -87,6 +88,9 @@ FLAGS BEFORE_CLASSIC_FIREWALL Network Firewall Policy is enforced before classic firewall. + --network-profile=NETWORK_PROFILE + The network profile to apply to this network. + --range=RANGE Specifies the IPv4 address range of legacy mode networks. The range must be specified in CIDR format: diff --git a/gcloud/compute/networks/subnets/update b/gcloud/compute/networks/subnets/update index 922f8afe6..1ac0f20fe 100644 --- a/gcloud/compute/networks/subnets/update +++ b/gcloud/compute/networks/subnets/update @@ -156,12 +156,16 @@ FLAGS enable-bidirectional-access, enable-outbound-vm-access. --purpose=PURPOSE - The purpose of the subnetwork is set to REGIONAL_MANAGED_PROXY to - migrate from the INTERNAL_HTTPS_LOAD_BALANCER purpose. PURPOSE must - be (only one value is supported): + The purpose of the subnetwork can be changed in a few scenarios. + PURPOSE must be one of: + PRIVATE + The default subnet type. Only PEER_MIGRATION subnets can be + changed to PRIVATE. REGIONAL_MANAGED_PROXY - The proxy-only subnet for regional HTTP(S) load balancers. + The proxy-only subnet for regional HTTP(S) load balancers. Only + INTERNAL_HTTPS_LOAD_BALANCER subnets can be changed to + REGIONAL_MANAGED_PROXY. --remove-secondary-ranges=PROPERTY=VALUE,[...] Removes secondary ranges from the subnetwork. diff --git a/gcloud/container/clusters/create b/gcloud/container/clusters/create index b89633c13..5a2f4bd21 100644 --- a/gcloud/container/clusters/create +++ b/gcloud/container/clusters/create @@ -22,8 +22,8 @@ SYNOPSIS [--create-subnetwork=[KEY=VALUE,...]] [--database-encryption-key=DATABASE_ENCRYPTION_KEY] [--default-max-pods-per-node=DEFAULT_MAX_PODS_PER_NODE] - [--disable-default-snat] [--disk-size=DISK_SIZE] - [--disk-type=DISK_TYPE] + [--disable-default-snat] [--disable-l4-lb-firewall-reconciliation] + [--disk-size=DISK_SIZE] [--disk-type=DISK_TYPE] [--enable-authorized-networks-on-private-endpoint] [--enable-autorepair] [--no-enable-autoupgrade] [--enable-cilium-clusterwide-network-policy] [--enable-cloud-logging] @@ -430,6 +430,10 @@ FLAGS requires that you also set --enable-ip-alias and --enable-private-nodes. + --disable-l4-lb-firewall-reconciliation + Disable reconciliation on the cluster for L4 Load Balancer VPC + firewalls targeting ingress traffic. + --disk-size=DISK_SIZE Size for node VM boot disks in GB. Defaults to 100GB. diff --git a/gcloud/container/clusters/create-auto b/gcloud/container/clusters/create-auto index 0b64d26fb..ff5485a7c 100644 --- a/gcloud/container/clusters/create-auto +++ b/gcloud/container/clusters/create-auto @@ -15,6 +15,7 @@ SYNOPSIS [--containerd-config-from-file=PATH_TO_FILE] [--create-subnetwork=[KEY=VALUE,...]] [--database-encryption-key=DATABASE_ENCRYPTION_KEY] + [--disable-l4-lb-firewall-reconciliation] [--enable-authorized-networks-on-private-endpoint] [--enable-backup-restore] [--enable-cilium-clusterwide-network-policy] [--enable-dns-access] [--enable-fleet] [--enable-google-cloud-access] @@ -232,6 +233,10 @@ FLAGS For more information, see https://cloud.google.com/kubernetes-engine/docs/how-to/encrypting-secrets. + --disable-l4-lb-firewall-reconciliation + Disable reconciliation on the cluster for L4 Load Balancer VPC + firewalls targeting ingress traffic. + --enable-authorized-networks-on-private-endpoint Enable enforcement of --master-authorized-networks CIDR ranges for traffic reaching cluster's control plane via private IP. diff --git a/gcloud/container/clusters/update b/gcloud/container/clusters/update index ca24c26fb..87505283f 100644 --- a/gcloud/container/clusters/update +++ b/gcloud/container/clusters/update @@ -72,6 +72,8 @@ SYNOPSIS | --disable-dataplane-v2-flow-observability | --enable-dataplane-v2-flow-observability --disable-dataplane-v2-metrics | --enable-dataplane-v2-metrics + | --disable-l4-lb-firewall-reconciliation + | --enable-l4-lb-firewall-reconciliation | --enable-authorized-networks-on-private-endpoint --enable-dns-access --enable-google-cloud-access --enable-ip-access --enable-master-global-access --enable-private-endpoint @@ -1074,6 +1076,17 @@ REQUIRED FLAGS --enable-dataplane-v2-metrics Exposes advanced datapath flow metrics on node port. + At most one of these can be specified: + + --disable-l4-lb-firewall-reconciliation + Disable reconciliation on the cluster for L4 Load Balancer VPC + firewalls targeting ingress traffic. + + --enable-l4-lb-firewall-reconciliation + Enable reconciliation on the cluster for L4 Load Balancer VPC + firewalls targeting ingress traffic. L4 LB VPC firewall + reconciliation is enabled by default. + --enable-authorized-networks-on-private-endpoint Enable enforcement of --master-authorized-networks CIDR ranges for traffic reaching cluster's control plane via private IP. diff --git a/gcloud/container/fleet/scopes/rbacrolebindings/create b/gcloud/container/fleet/scopes/rbacrolebindings/create index 71e4e0751..47914123d 100644 --- a/gcloud/container/fleet/scopes/rbacrolebindings/create +++ b/gcloud/container/fleet/scopes/rbacrolebindings/create @@ -69,7 +69,8 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS --role=ROLE - Role to assign. ROLE must be one of: admin, edit, view. + Predefined role to assign to principal (admin, edit, view). ROLE must + be one of: admin, edit, view. Exactly one of these must be specified: diff --git a/gcloud/container/fleet/scopes/rbacrolebindings/update b/gcloud/container/fleet/scopes/rbacrolebindings/update index 6a63fa479..152a66bd4 100644 --- a/gcloud/container/fleet/scopes/rbacrolebindings/update +++ b/gcloud/container/fleet/scopes/rbacrolebindings/update @@ -70,8 +70,8 @@ POSITIONAL ARGUMENTS FLAGS --role=ROLE - Role for the RBACRoleBinding to update to. ROLE must be one of: admin, - edit, view. + Predefined role to assign to principal (admin, edit, view). ROLE must + be one of: admin, edit, view. --update-labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to update. If a label exists, its value diff --git a/gcloud/container/hub/scopes/rbacrolebindings/create b/gcloud/container/hub/scopes/rbacrolebindings/create index 2dfb79c85..45b386d7e 100644 --- a/gcloud/container/hub/scopes/rbacrolebindings/create +++ b/gcloud/container/hub/scopes/rbacrolebindings/create @@ -69,7 +69,8 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS --role=ROLE - Role to assign. ROLE must be one of: admin, edit, view. + Predefined role to assign to principal (admin, edit, view). ROLE must + be one of: admin, edit, view. Exactly one of these must be specified: diff --git a/gcloud/container/hub/scopes/rbacrolebindings/update b/gcloud/container/hub/scopes/rbacrolebindings/update index d6f9a6608..6bd78ef79 100644 --- a/gcloud/container/hub/scopes/rbacrolebindings/update +++ b/gcloud/container/hub/scopes/rbacrolebindings/update @@ -70,8 +70,8 @@ POSITIONAL ARGUMENTS FLAGS --role=ROLE - Role for the RBACRoleBinding to update to. ROLE must be one of: admin, - edit, view. + Predefined role to assign to principal (admin, edit, view). ROLE must + be one of: admin, edit, view. --update-labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to update. If a label exists, its value diff --git a/gcloud/functions/deploy b/gcloud/functions/deploy index 1bac37f9d..fae1b57eb 100644 --- a/gcloud/functions/deploy +++ b/gcloud/functions/deploy @@ -377,6 +377,11 @@ FLAGS DOCKER_REPOSITORY must be an Artifact Registry Docker repository present in the same project and location as the Cloud Function. + **Preview:** for 2nd gen functions, a Docker Artifact registry + repository in a different project and/or location may be used. + Additional requirements apply, see + https://cloud.google.com/functions/docs/building#image_registry + The repository name should match one of these patterns: ▸ projects/${PROJECT}/locations/${LOCATION}/repositories/${REPOSITORY}, diff --git a/gcloud/migration/vms/help b/gcloud/migration/vms/help index aa0193650..f6bfddaec 100644 --- a/gcloud/migration/vms/help +++ b/gcloud/migration/vms/help @@ -23,6 +23,10 @@ GROUPS image-imports Imports images to Google Compute Engine from Google Cloud Storage. + machine-image-imports + Imports machine images to Google Compute Engine from Google Cloud + Storage. + NOTES This variant is also available: diff --git a/gcloud/migration/vms/machine-image-imports/create b/gcloud/migration/vms/machine-image-imports/create new file mode 100644 index 000000000..f9f5a35dd --- /dev/null +++ b/gcloud/migration/vms/machine-image-imports/create @@ -0,0 +1,184 @@ +NAME + gcloud migration vms machine-image-imports create - import machine images + to Google Compute Engine + +SYNOPSIS + gcloud migration vms machine-image-imports create + (IMAGE_IMPORT_NAME : --location=LOCATION) --source-file=SOURCE_FILE + [--additional-licenses=[ADDITIONAL_LICENSES,...]] + [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] + [--machine-image-name=MACHINE_IMAGE_NAME] [--machine-type=MACHINE_TYPE] + [--network-interface=[network=NETWORK], + [networkTier=NETWORKTIER],[subnetwork=SUBNETWORK]] + [--single-region-storage] [--tags=[TAGS,...]] + [--target-project=TARGET_PROJECT] + [--enable-integrity-monitoring --enable-vtpm --secure-boot=SECURE_BOOT] + [--scopes=[SCOPES,...] --service-account=SERVICE_ACCOUNT] + [--skip-os-adaptation | --generalize --license-type=LICENSE_TYPE] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + gcloud migration vms machine-image-imports create Imports machine images + such as OVA and OVF files, from a Google Cloud Storage file (gs://...) to + Google Compute Engine, using the Migrate to Virtual Machines service API. + This command creates an Image Import resource with a nested Image Import + Job resource. The Image Import Job resource tracks the image import + progress. To use this command, you must enable VM Migration API in your + project. + +EXAMPLES + To import ub-14.04.5.ova from my-images-bucket to my-target-project in + us-central1, create my-image-import resource in my-project in us-central1. + Run: $ gcloud migration vms machine-image-imports create \ + my-machine-image-import \ + --source-file=gs://my-images-bucket/ub-14.04.5.ova \ + --image-name=my-ubuntu-machine-image --location=us-central1 \ + --target-project=projects/my-project/locations/global/\ + targetProjects/my-target-project --project=my-project + +POSITIONAL ARGUMENTS + Image import resource - The Image Import resource you want to create. This + would be the machine image name if --machine-image-name is not given. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument image_import_name on the command line with a + fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + IMAGE_IMPORT_NAME + ID of the image_import or fully qualified identifier for the + image_import. + + To set the image_import_name attribute: + ▸ provide the argument image_import_name on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Resource location. + + To set the location attribute: + ▸ provide the argument image_import_name on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property compute/region. + +REQUIRED FLAGS + --source-file=SOURCE_FILE + The path to the Google Cloud Storage file from which the image should + be imported. + +OPTIONAL FLAGS + --additional-licenses=[ADDITIONAL_LICENSES,...] + Comma-separated list of the additional licenses to assign to the + machine image. + + --description=DESCRIPTION + A description of the machine image. + + --labels=[KEY=VALUE,...] + A map of labels to associate with the machine image. + + --machine-image-name=MACHINE_IMAGE_NAME + The name of the machine image that will be imported to Google Compute + Engine. Default is the Image Import name. + + --machine-type=MACHINE_TYPE + The machine type to create the machine image with. If not provided, the + service will choose a relevant machine type series based on the + information from the source image. + + --network-interface=[network=NETWORK],[networkTier=NETWORKTIER],[subnetwork=SUBNETWORK] + The network interface to use for the instance created by the machine + image. This is a dicionary with the following keys: + ◆ network: The network to use for this network interface. + ◆ subnetwork: The subnetwork to use for this network interface. + ◆ network-tier: The network tier to use for this network interface. + This argument can be specified multiple times in case of multiple + nics. + + --single-region-storage + If true, the location of the imported machine image will be the region + of the import job. Otherwise the closest multi-region is selected. + Default is false. + + --tags=[TAGS,...] + The tags to apply to the instance created by the machine image. + + --target-project=TARGET_PROJECT + The target project resource path to which the machine image will be + imported. Default is the host project. To get a list of the target + projects run the gcloud alpha migration vms target-projects list + command. + + Shielded instance configuration. + + --enable-integrity-monitoring + Defines whether the instance created by the machine image has + integrity monitoring enabled. This can be set to true only if the + image boot option is EFI, and vTPM is enabled. + + --enable-vtpm + Defines whether the instance created by the machine image has vTPM + enabled. This can be set to true only if the image boot option is + EFI. + + --secure-boot=SECURE_BOOT + Defines whether the instance created by the machine image has Secure + Boot enabled. This can be set to true only if the image boot option + is EFI. If not specified we will use the configuration of the source. + SECURE_BOOT must be one of: false, secure-boot-unspecified, true. + + The service account to assign to the instance created by the machine + image. + + --scopes=[SCOPES,...] + The list of scopes to be made available for the service account. + + --service-account=SERVICE_ACCOUNT + The email address of the service account. + + OS adaptation parameters. + + At most one of these can be specified: + + --skip-os-adaptation + If true, skip OS adaptation. Default false. + + --generalize + If true, generalize the imported machine image. Default false. The + generalization process enables co-existence of multiple VMs created + from the same machine image. For Windows, generalizing the machine + image removes computer-specific information such as installed drivers + and the computer security identifier (SID). + + --license-type=LICENSE_TYPE + The license to use post migration. LICENSE_TYPE must be one of: + compute-engine-license-type-byol, + compute-engine-license-type-default, + compute-engine-license-type-payg. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the vmmigration/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/migrate/virtual-machines + +NOTES + This variant is also available: + + $ gcloud alpha migration vms machine-image-imports create + diff --git a/gcloud/migration/vms/machine-image-imports/delete b/gcloud/migration/vms/machine-image-imports/delete new file mode 100644 index 000000000..a7589ea5a --- /dev/null +++ b/gcloud/migration/vms/machine-image-imports/delete @@ -0,0 +1,71 @@ +NAME + gcloud migration vms machine-image-imports delete - delete an Image Import + resource + +SYNOPSIS + gcloud migration vms machine-image-imports delete + (IMAGE_IMPORT_NAME : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + gcloud migration vms machine-image-imports delete deletes an Image Import + resource. To use this command, you must enable VM Migration API in your + project. + + This command does not delete any machine images imported to Google Compute + Engine. + +EXAMPLES + To delete my-image-import resource in us-central1 in the default project, + run: $ gcloud migration vms machine-image-imports delete \ + my-image-import --location=us-central1 + +POSITIONAL ARGUMENTS + Image import resource - The Image Import resource you want to delete. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument image_import_name on the command line with a + fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + IMAGE_IMPORT_NAME + ID of the image_import or fully qualified identifier for the + image_import. + + To set the image_import_name attribute: + ▸ provide the argument image_import_name on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Resource location. + + To set the location attribute: + ▸ provide the argument image_import_name on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property compute/region. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the vmmigration/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/migrate/virtual-machines + +NOTES + This variant is also available: + + $ gcloud alpha migration vms machine-image-imports delete + diff --git a/gcloud/migration/vms/machine-image-imports/describe b/gcloud/migration/vms/machine-image-imports/describe new file mode 100644 index 000000000..9ccf7e1da --- /dev/null +++ b/gcloud/migration/vms/machine-image-imports/describe @@ -0,0 +1,69 @@ +NAME + gcloud migration vms machine-image-imports describe - describe an Image + Import + +SYNOPSIS + gcloud migration vms machine-image-imports describe + (IMAGE_IMPORT_NAME : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + gcloud migration vms machine-image-imports describe describes an Image + Import resource with a nested Image Import Job. The Image Import Job + resource tracks the image import progress. To use this command, you must + enable VM Migration API in your project. + +EXAMPLES + To describe my-image-import resource in us-central1 in the default project, + run: $ gcloud migration vms machine-image-imports describe \ + my-image-import --location=us-central1 + +POSITIONAL ARGUMENTS + Image import resource - The Image Import you want to describe. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument image_import_name on the command line with a + fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + IMAGE_IMPORT_NAME + ID of the image_import or fully qualified identifier for the + image_import. + + To set the image_import_name attribute: + ▸ provide the argument image_import_name on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Resource location. + + To set the location attribute: + ▸ provide the argument image_import_name on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property compute/region. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the vmmigration/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/migrate/virtual-machines + +NOTES + This variant is also available: + + $ gcloud alpha migration vms machine-image-imports describe + diff --git a/gcloud/migration/vms/machine-image-imports/help b/gcloud/migration/vms/machine-image-imports/help new file mode 100644 index 000000000..4e09b9c52 --- /dev/null +++ b/gcloud/migration/vms/machine-image-imports/help @@ -0,0 +1,63 @@ +NAME + gcloud migration vms machine-image-imports - imports machine images to + Google Compute Engine from Google Cloud Storage + +SYNOPSIS + gcloud migration vms machine-image-imports COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + gcloud migration vms machine-image-imports provides a more robust and + better supported method for importing machine images to Google Compute + Engine. Other image-related operations (for example, list) can be done + using gcloud compute images, as usual. + + The commands use VM Migration API which supports importing of a machine + image from a Google Cloud Storage file (gs://...) to a target project. VM + Migration API must be enabled in your project. + + gcloud migration vms machine-image-imports create creates a machine Image + Import resource with a nested Image Import Job resource. The Image Import + Job resource tracks the machine image import progress. After the Image + Import Job completes, successfully or otherwise, there's no further use for + the Image Import resource. + + The machine image is imported to a Google Cloud Project, desginated by the + Target Project resource. To get a list of Target Projects, run the gcloud + alpha migration vms target-projects list command. Use the Google Cloud + console to add target project resources. For information on adding target + projects, see + https://cloud.google.com/migrate/virtual-machines/docs/5.0/how-to/target-project. + + A project can support up to a certain number of Image Import resources per + project. Hence it's recommended to delete an Image Import resource after + the Image Import Job is complete to avoid reaching the Image Import + resources limit. Deletion of Image Import resource does not affect the + imported machine image. For more information about the image import + resource, see + https://cloud.google.com/migrate/virtual-machines/docs/5.0/migrate/image_import. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + import machine images to Google Compute Engine. + + delete + delete an Image Import resource. + + describe + describe an Image Import. + + list + list Image Imports. + +NOTES + This variant is also available: + + $ gcloud alpha migration vms machine-image-imports + diff --git a/gcloud/migration/vms/machine-image-imports/list b/gcloud/migration/vms/machine-image-imports/list new file mode 100644 index 000000000..56583c6f3 --- /dev/null +++ b/gcloud/migration/vms/machine-image-imports/list @@ -0,0 +1,89 @@ +NAME + gcloud migration vms machine-image-imports list - list Image Imports + +SYNOPSIS + gcloud migration vms machine-image-imports list [--location=LOCATION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + gcloud migration vms machine-image-imports list prints a detailed list of + Image Import resources. To use this command, you must enable VM Migration + API in your project. + +EXAMPLES + To list the Image Import resources in us-central1 in the default project, + run: $ gcloud migration vms machine-image-imports list \ + --location=us-central1 + +FLAGS + Location resource - The compute/region of the Image Import. To get a list + of the available regions, run gcloud compute regions list command. If not + specified, the value of the [compute/zone] property in the current gcloud + configuration is used. This represents a Cloud resource. (NOTE) Some + attributes are not given arguments in this group but can be set in other + ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ set the property compute/region with a fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line; + ▸ set the property compute/region. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the vmmigration/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/migrate/virtual-machines + +NOTES + This variant is also available: + + $ gcloud alpha migration vms machine-image-imports list + diff --git a/gcloud/network-connectivity/regional-endpoints/create b/gcloud/network-connectivity/regional-endpoints/create index 8b55b03f8..bea29eb59 100644 --- a/gcloud/network-connectivity/regional-endpoints/create +++ b/gcloud/network-connectivity/regional-endpoints/create @@ -63,10 +63,10 @@ OPTIONAL FLAGS The IP Address of the Regional Endpoint. When no address is provided, an IP from the subnetwork is allocated. Use one of the following formats: - ◆ IPv4 address as in ``10.0.0.1"" + ◆ IPv4 address as in 10.0.0.1 ◆ Address resource URI as in - ``projects/{project}/regions/{region}/addresses/{address_name} for an - IPv4 or IPv6 address."" + projects/{project}/regions/{region}/addresses/{address_name} for an + IPv4 or IPv6 address. --async Return immediately, without waiting for the operation in progress to diff --git a/gcloud/network-services/help b/gcloud/network-services/help index 4d1504321..9e8b36a3f 100644 --- a/gcloud/network-services/help +++ b/gcloud/network-services/help @@ -30,6 +30,9 @@ GROUPS meshes Manage Network Services Meshes. + route-views + View Network Services Route Views. + service-bindings Manage Network Services Bindings. diff --git a/gcloud/network-services/route-views/describe b/gcloud/network-services/route-views/describe new file mode 100644 index 000000000..e165f5090 --- /dev/null +++ b/gcloud/network-services/route-views/describe @@ -0,0 +1,99 @@ +NAME + gcloud network-services route-views describe - route View for a Mesh or + Gateway + +SYNOPSIS + gcloud network-services route-views describe + (--route-view=ROUTE_VIEW + : --gateway=GATEWAY --location=LOCATION --mesh=MESH) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe a Route Views for a Mesh or Gateway + +EXAMPLES + Describe a Route Views for a Mesh + + $ gcloud network-services route-views describe \ + --project=$PROJECT_ID --location=$LOCATION --mesh mesh1 \ + --route-view $ROUTE_VIEW_ID + $ gcloud network-services route-views describe \ + --route-view=projects/-/locations/-/meshes/-/routeViews/\ + $ROUTE_VIEW_ID + + Describe a Route Views for a Gateway + + $ gcloud network-services route-views describe \ + --project=$PROJECT_ID --location=$LOCATION --gateway gateway1 \ + --route-view $ROUTE_VIEW_ID + $ gcloud network-services route-views describe \ + --route-view=projects/-/locations/-/gateways/-/routeViews/\ + $ROUTE_VIEW_ID + +REQUIRED FLAGS + Mesh or gateway route view resource - RouteView 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-view on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. This resource can be one of the + following types: [networkservices.projects.locations.meshes.routeViews, + networkservices.projects.locations.gateways.routeViews]. + + This must be specified. + + --route-view=ROUTE_VIEW + ID of the mesh_or_gateway_route_view or fully qualified identifier + for the mesh_or_gateway_route_view. + + To set the route_view attribute: + ▸ provide the argument --route-view on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --gateway=GATEWAY + Parent Gateway of the mesh_or_gateway_route_view + + To set the gateway attribute: + ▸ provide the argument --route-view on the command line with a + fully specified name; + ▸ provide the argument --gateway on the command line. Must be + specified for resource of type + [networkservices.projects.locations.gateways.routeViews]. + + --location=LOCATION + Location of the mesh_or_gateway_route_view + + To set the location attribute: + ▸ provide the argument --route-view on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + + --mesh=MESH + Parent Mesh of the mesh_or_gateway_route_view + + To set the mesh attribute: + ▸ provide the argument --route-view on the command line with a + fully specified name; + ▸ provide the argument --mesh on the command line. Must be + specified for resource of type + [networkservices.projects.locations.meshes.routeViews]. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud alpha network-services route-views describe + diff --git a/gcloud/network-services/route-views/help b/gcloud/network-services/route-views/help new file mode 100644 index 000000000..97610d04b --- /dev/null +++ b/gcloud/network-services/route-views/help @@ -0,0 +1,28 @@ +NAME + gcloud network-services route-views - view Network Services Route Views + +SYNOPSIS + gcloud network-services route-views COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + View Network Services Route Views. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + Route View for a Mesh or Gateway. + + list + Route View for a Mesh or Gateway. + +NOTES + This variant is also available: + + $ gcloud alpha network-services route-views + diff --git a/gcloud/network-services/route-views/list b/gcloud/network-services/route-views/list new file mode 100644 index 000000000..1beebf24d --- /dev/null +++ b/gcloud/network-services/route-views/list @@ -0,0 +1,117 @@ +NAME + gcloud network-services route-views list - route View for a Mesh or Gateway + +SYNOPSIS + gcloud network-services route-views list (--gateway=GATEWAY | --mesh=MESH) + [--location=LOCATION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List all Route Views for a Mesh or Gateway + +EXAMPLES + List Route Views for a mesh. + + $ gcloud network-services route-views list \ + --mesh projects/-/locations/-/meshes/mesh1 + $ gcloud network-services route-views list --project $PROJECT \ + --location $LOCATION \ + --mesh projects/-/locations/-/meshes/mesh1 List Route Views \ + for a gateway. + + $ gcloud network-services route-views list \ + --gateway projects/-/locations/-/gateways/gateway1 + $ gcloud network-services route-views list --project $PROJECT \ + --location $LOCATION \ + --gateway projects/-/locations/-/gateways/gateway1 + +REQUIRED FLAGS + Parent of the Route View + + Exactly one of these must be specified: + + Gateway resource - Parent Gateway 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 --gateway on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + To set the location attribute: + ▸ provide the argument --gateway on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --gateway=GATEWAY + ID of the gateway or fully qualified identifier for the gateway. + + To set the gateway attribute: + ▫ provide the argument --gateway on the command line. + + Mesh resource - Parent Mesh 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 --mesh on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + To set the location attribute: + ▸ provide the argument --mesh on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --mesh=MESH + ID of the mesh or fully qualified identifier for the mesh. + + To set the mesh attribute: + ▫ provide the argument --mesh on the command line. + +FLAGS + Location resource - Location of the parent 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 + --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. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud alpha network-services route-views list + diff --git a/gcloud/run/deploy b/gcloud/run/deploy index 438876ccf..998175f5d 100644 --- a/gcloud/run/deploy +++ b/gcloud/run/deploy @@ -183,17 +183,22 @@ FLAGS disable. --max-instances=MAX_INSTANCES - The maximum number of container instances of the Service to run. Use - 'default' to unset the limit and use the platform default. + The maximum number of container instances for this Revision to run or + 'default' to remove. This setting is immutably set on each new Revision + and modifying its value will deploy another Revision. --min=MIN - The minimum number of container instances for this Service to run or - 'default' to remove any minimum. These instances will be divided among - all Revisions receiving a percentage of traffic. + The minimum number of container instances to run for this Service or + 'default' to remove. These instances will be divided among all + Revisions receiving a percentage of traffic and can be modified without + deploying a new Revision. --min-instances=MIN_INSTANCES - The minimum number of container instances for this Revision of the - Service to run or 'default' to remove any minimum. + The minimum number of container instances to run for this Revision or + 'default' to remove. This setting is immutably set on each new Revision + and modifying its value will deploy a another Revision. Consider using + --min to set the minimum number of instances across all revisions of + the Service which may be modified dynamically. --region=REGION Region in which the resource can be found. Alternatively, set the diff --git a/gcloud/run/services/update b/gcloud/run/services/update index 8cffbbd0e..936b0b952 100644 --- a/gcloud/run/services/update +++ b/gcloud/run/services/update @@ -158,17 +158,22 @@ FLAGS disable. --max-instances=MAX_INSTANCES - The maximum number of container instances of the Service to run. Use - 'default' to unset the limit and use the platform default. + The maximum number of container instances for this Revision to run or + 'default' to remove. This setting is immutably set on each new Revision + and modifying its value will deploy another Revision. --min=MIN - The minimum number of container instances for this Service to run or - 'default' to remove any minimum. These instances will be divided among - all Revisions receiving a percentage of traffic. + The minimum number of container instances to run for this Service or + 'default' to remove. These instances will be divided among all + Revisions receiving a percentage of traffic and can be modified without + deploying a new Revision. --min-instances=MIN_INSTANCES - The minimum number of container instances for this Revision of the - Service to run or 'default' to remove any minimum. + The minimum number of container instances to run for this Revision or + 'default' to remove. This setting is immutably set on each new Revision + and modifying its value will deploy a another Revision. Consider using + --min to set the minimum number of instances across all revisions of + the Service which may be modified dynamically. --region=REGION Region in which the resource can be found. Alternatively, set the