From 94c3362cff549494fbc1be44c793de1a85b1ce17 Mon Sep 17 00:00:00 2001 From: Automated Date: Wed, 20 Dec 2023 10:06:06 +0000 Subject: [PATCH] gcloud: Wed Dec 20 10:06:06 UTC 2023 --- gcloud/_version | 10 +-- gcloud/alpha/bms/os-images/describe | 62 ++++++++++++++ gcloud/alpha/bms/os-images/help | 3 + gcloud/alpha/builds/cancel | 2 + gcloud/alpha/builds/describe | 2 + .../enterprise-config/bitbucketserver/create | 2 + .../enterprise-config/bitbucketserver/delete | 2 + .../bitbucketserver/describe | 2 + .../enterprise-config/bitbucketserver/list | 2 + .../enterprise-config/bitbucketserver/update | 2 + .../builds/enterprise-config/github/delete | 2 + .../builds/enterprise-config/github/describe | 2 + .../builds/enterprise-config/github/list | 2 + .../builds/enterprise-config/github/update | 2 + gcloud/alpha/builds/list | 2 + gcloud/alpha/builds/log | 2 + gcloud/alpha/builds/submit | 2 + .../builds/triggers/create/bitbucketserver | 13 ++- .../triggers/create/cloud-source-repositories | 3 +- gcloud/alpha/builds/triggers/create/github | 14 ++-- gcloud/alpha/builds/triggers/create/gitlab | 22 ++--- gcloud/alpha/builds/triggers/create/manual | 3 +- gcloud/alpha/builds/triggers/create/pubsub | 3 +- gcloud/alpha/builds/triggers/create/webhook | 3 +- gcloud/alpha/builds/triggers/import | 2 + gcloud/alpha/builds/triggers/list | 2 + gcloud/alpha/compute/disks/create | 4 +- .../alpha/compute/health-checks/create/http | 12 ++- .../alpha/compute/health-checks/create/https | 12 ++- gcloud/alpha/compute/health-checks/create/tcp | 13 ++- .../alpha/compute/health-checks/update/http | 13 ++- .../alpha/compute/health-checks/update/https | 13 ++- gcloud/alpha/compute/health-checks/update/tcp | 13 ++- .../alpha/compute/instance-templates/create | 6 +- gcloud/alpha/compute/instances/create | 10 +-- .../compute/instances/perform-maintenance | 6 +- gcloud/alpha/container/clusters/create | 3 + gcloud/alpha/container/clusters/create-auto | 3 + gcloud/alpha/container/clusters/update | 3 + gcloud/alpha/netapp/storage-pools/create | 2 +- gcloud/alpha/run/deploy | 7 +- gcloud/alpha/run/services/update | 7 +- .../vpc-peerings/get-vpc-service-controls | 71 ++++++++++++++++ gcloud/alpha/services/vpc-peerings/help | 3 + gcloud/alpha/stacks/deploy | 39 +++++++++ gcloud/alpha/stacks/help | 47 +++++++++++ gcloud/alpha/stacks/resources/delete | 39 +++++++++ gcloud/alpha/stacks/resources/describe | 38 +++++++++ gcloud/alpha/stacks/resources/export-graph | 63 ++++++++++++++ gcloud/alpha/stacks/resources/help | 46 +++++++++++ gcloud/alpha/stacks/resources/list | 82 +++++++++++++++++++ gcloud/alpha/stacks/types/describe | 38 +++++++++ gcloud/alpha/stacks/types/help | 39 +++++++++ gcloud/alpha/stacks/types/list | 67 +++++++++++++++ gcloud/alpha/storage/du | 15 ++-- gcloud/alpha/storage/help | 2 +- gcloud/app/help | 3 + gcloud/app/runtimes/help | 25 ++++++ gcloud/app/runtimes/list | 67 +++++++++++++++ gcloud/beta/app/runtimes/help | 7 +- gcloud/beta/app/runtimes/list | 13 +-- gcloud/beta/builds/cancel | 2 + gcloud/beta/builds/describe | 2 + gcloud/beta/builds/list | 2 + gcloud/beta/builds/log | 2 + gcloud/beta/builds/submit | 2 + .../builds/triggers/create/bitbucketserver | 13 ++- .../triggers/create/cloud-source-repositories | 3 +- gcloud/beta/builds/triggers/create/github | 14 ++-- gcloud/beta/builds/triggers/create/gitlab | 22 ++--- gcloud/beta/builds/triggers/create/manual | 3 +- gcloud/beta/builds/triggers/create/pubsub | 3 +- gcloud/beta/builds/triggers/create/webhook | 3 +- gcloud/beta/builds/triggers/import | 2 + gcloud/beta/builds/triggers/list | 2 + gcloud/beta/compute/disks/create | 10 +-- gcloud/beta/compute/images/create | 6 +- gcloud/beta/compute/instance-templates/create | 6 +- gcloud/beta/compute/instances/create | 9 +- gcloud/beta/compute/instances/help | 3 + .../compute/instances/perform-maintenance | 65 +++++++++++++++ .../instances/simulate-maintenance-event | 8 +- gcloud/beta/container/clusters/create | 3 + gcloud/beta/container/clusters/create-auto | 3 + gcloud/beta/container/clusters/update | 3 + gcloud/beta/netapp/storage-pools/create | 2 +- gcloud/beta/run/deploy | 7 +- .../beta/run/services/add-iam-policy-binding | 39 +++++++++ .../run/services/remove-iam-policy-binding | 43 ++++++++++ gcloud/beta/run/services/update | 7 +- .../vpc-peerings/get-vpc-service-controls | 69 ++++++++++++++++ gcloud/beta/services/vpc-peerings/help | 3 + gcloud/builds/cancel | 2 + gcloud/builds/describe | 2 + gcloud/builds/list | 2 + gcloud/builds/log | 2 + gcloud/builds/submit | 2 + gcloud/builds/triggers/create/bitbucketserver | 13 ++- .../triggers/create/cloud-source-repositories | 3 +- gcloud/builds/triggers/create/github | 14 ++-- gcloud/builds/triggers/create/gitlab | 22 ++--- gcloud/builds/triggers/create/manual | 3 +- gcloud/builds/triggers/create/pubsub | 3 +- gcloud/builds/triggers/create/webhook | 3 +- gcloud/builds/triggers/import | 2 + gcloud/builds/triggers/list | 2 + gcloud/compute/disks/create | 14 ++-- gcloud/compute/images/create | 6 +- gcloud/compute/instance-templates/create | 6 +- gcloud/compute/instances/create | 11 ++- gcloud/compute/instances/help | 3 + gcloud/compute/instances/perform-maintenance | 64 +++++++++++++++ .../instances/simulate-maintenance-event | 8 +- gcloud/container/clusters/create | 19 ++++- gcloud/container/clusters/create-auto | 6 +- gcloud/container/clusters/update | 15 +++- .../conversion-workspaces/apply | 2 +- .../conversion-workspaces/convert | 2 +- .../conversion-workspaces/describe-ddls | 2 +- .../conversion-workspaces/describe-entities | 2 +- .../conversion-workspaces/describe-issues | 2 +- .../database-migration/migration-jobs/create | 2 +- gcloud/netapp/storage-pools/create | 2 +- gcloud/run/deploy | 7 +- gcloud/run/services/update | 7 +- gcloud/storage/du | 15 ++-- gcloud/storage/help | 2 +- 127 files changed, 1438 insertions(+), 194 deletions(-) create mode 100644 gcloud/alpha/bms/os-images/describe create mode 100644 gcloud/alpha/services/vpc-peerings/get-vpc-service-controls create mode 100644 gcloud/alpha/stacks/deploy create mode 100644 gcloud/alpha/stacks/help create mode 100644 gcloud/alpha/stacks/resources/delete create mode 100644 gcloud/alpha/stacks/resources/describe create mode 100644 gcloud/alpha/stacks/resources/export-graph create mode 100644 gcloud/alpha/stacks/resources/help create mode 100644 gcloud/alpha/stacks/resources/list create mode 100644 gcloud/alpha/stacks/types/describe create mode 100644 gcloud/alpha/stacks/types/help create mode 100644 gcloud/alpha/stacks/types/list create mode 100644 gcloud/app/runtimes/help create mode 100644 gcloud/app/runtimes/list create mode 100644 gcloud/beta/compute/instances/perform-maintenance create mode 100644 gcloud/beta/services/vpc-peerings/get-vpc-service-controls create mode 100644 gcloud/compute/instances/perform-maintenance diff --git a/gcloud/_version b/gcloud/_version index 47c40cff6..14d08564d 100644 --- a/gcloud/_version +++ b/gcloud/_version @@ -1,8 +1,8 @@ -Google Cloud SDK 457.0.0 -alpha 2023.12.08 -beta 2023.12.08 -bq 2.0.100 +Google Cloud SDK 458.0.0 +alpha 2023.12.15 +beta 2023.12.15 +bq 2.0.101 bundled-python3-unix 3.11.6 -core 2023.12.08 +core 2023.12.15 gcloud-crc32c 1.0.0 gsutil 5.27 diff --git a/gcloud/alpha/bms/os-images/describe b/gcloud/alpha/bms/os-images/describe new file mode 100644 index 000000000..2189eac33 --- /dev/null +++ b/gcloud/alpha/bms/os-images/describe @@ -0,0 +1,62 @@ +NAME + gcloud alpha bms os-images describe - describe Bare Metal Solution OS + images in a project + +SYNOPSIS + gcloud alpha bms os-images describe (OS_IMAGE : --region=REGION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe Bare Metal Solution OS image in a project. + +EXAMPLES + To describe given OS image within the project, run: + + $ gcloud alpha bms os-images describe my-os-image \ + --project=my-project + +POSITIONAL ARGUMENTS + Os image resource - os_image. 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 os_image on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + OS_IMAGE + ID of the os_image or fully qualified identifier for the os_image. + + To set the os_image attribute: + ▸ provide the argument os_image on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Region of the resource. + + To set the region attribute: + ▸ provide the argument os_image on the command line with a fully + specified name; + ▸ provide the argument --region on the command line; + ▸ global is the only supported location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/bms/os-images/help b/gcloud/alpha/bms/os-images/help index 1a0274ecb..7b639a7da 100644 --- a/gcloud/alpha/bms/os-images/help +++ b/gcloud/alpha/bms/os-images/help @@ -16,6 +16,9 @@ GCLOUD WIDE FLAGS COMMANDS COMMAND is one of the following: + describe + (ALPHA) Describe Bare Metal Solution OS images in a project. + list (ALPHA) List Bare Metal Solution OS images in a project. diff --git a/gcloud/alpha/builds/cancel b/gcloud/alpha/builds/cancel index 0b36e02a7..2f76d7b78 100644 --- a/gcloud/alpha/builds/cancel +++ b/gcloud/alpha/builds/cancel @@ -27,6 +27,8 @@ FLAGS supported region name (e.g. us-central1). If unset, builds/region, which is the default region to use when working with Cloud Build resources, is used. If builds/region is unset, region is set to global. + Note: Region must be specified in 2nd gen repo; global is not + supported. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/builds/describe b/gcloud/alpha/builds/describe index f652e6f3f..081413def 100644 --- a/gcloud/alpha/builds/describe +++ b/gcloud/alpha/builds/describe @@ -23,6 +23,8 @@ FLAGS supported region name (e.g. us-central1). If unset, builds/region, which is the default region to use when working with Cloud Build resources, is used. If builds/region is unset, region is set to global. + Note: Region must be specified in 2nd gen repo; global is not + supported. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/builds/enterprise-config/bitbucketserver/create b/gcloud/alpha/builds/enterprise-config/bitbucketserver/create index c014af7a8..70d1ece6b 100644 --- a/gcloud/alpha/builds/enterprise-config/bitbucketserver/create +++ b/gcloud/alpha/builds/enterprise-config/bitbucketserver/create @@ -52,6 +52,8 @@ OPTIONAL FLAGS supported region name (e.g. us-central1). If unset, builds/region, which is the default region to use when working with Cloud Build resources, is used. If builds/region is unset, region is set to global. + Note: Region must be specified in 2nd gen repo; global is not + supported. --ssl-ca-file=SSL_CA_FILE Path to a local file that contains SSL certificate to use for requests diff --git a/gcloud/alpha/builds/enterprise-config/bitbucketserver/delete b/gcloud/alpha/builds/enterprise-config/bitbucketserver/delete index 9cc32ad34..9d6939d75 100644 --- a/gcloud/alpha/builds/enterprise-config/bitbucketserver/delete +++ b/gcloud/alpha/builds/enterprise-config/bitbucketserver/delete @@ -19,6 +19,8 @@ FLAGS supported region name (e.g. us-central1). If unset, builds/region, which is the default region to use when working with Cloud Build resources, is used. If builds/region is unset, region is set to global. + Note: Region must be specified in 2nd gen repo; global is not + supported. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/builds/enterprise-config/bitbucketserver/describe b/gcloud/alpha/builds/enterprise-config/bitbucketserver/describe index 21715b15a..b4dd2f86f 100644 --- a/gcloud/alpha/builds/enterprise-config/bitbucketserver/describe +++ b/gcloud/alpha/builds/enterprise-config/bitbucketserver/describe @@ -19,6 +19,8 @@ FLAGS supported region name (e.g. us-central1). If unset, builds/region, which is the default region to use when working with Cloud Build resources, is used. If builds/region is unset, region is set to global. + Note: Region must be specified in 2nd gen repo; global is not + supported. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/builds/enterprise-config/bitbucketserver/list b/gcloud/alpha/builds/enterprise-config/bitbucketserver/list index 7be7f568b..fe40dd871 100644 --- a/gcloud/alpha/builds/enterprise-config/bitbucketserver/list +++ b/gcloud/alpha/builds/enterprise-config/bitbucketserver/list @@ -17,6 +17,8 @@ FLAGS supported region name (e.g. us-central1). If unset, builds/region, which is the default region to use when working with Cloud Build resources, is used. If builds/region is unset, region is set to global. + Note: Region must be specified in 2nd gen repo; global is not + supported. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/alpha/builds/enterprise-config/bitbucketserver/update b/gcloud/alpha/builds/enterprise-config/bitbucketserver/update index 4c3636235..b1ed788eb 100644 --- a/gcloud/alpha/builds/enterprise-config/bitbucketserver/update +++ b/gcloud/alpha/builds/enterprise-config/bitbucketserver/update @@ -40,6 +40,8 @@ FLAGS supported region name (e.g. us-central1). If unset, builds/region, which is the default region to use when working with Cloud Build resources, is used. If builds/region is unset, region is set to global. + Note: Region must be specified in 2nd gen repo; global is not + supported. --ssl-ca-file=SSL_CA_FILE Path to a local file that contains SSL certificate to use for requests diff --git a/gcloud/alpha/builds/enterprise-config/github/delete b/gcloud/alpha/builds/enterprise-config/github/delete index ba9997add..b839bee39 100644 --- a/gcloud/alpha/builds/enterprise-config/github/delete +++ b/gcloud/alpha/builds/enterprise-config/github/delete @@ -19,6 +19,8 @@ FLAGS supported region name (e.g. us-central1). If unset, builds/region, which is the default region to use when working with Cloud Build resources, is used. If builds/region is unset, region is set to global. + Note: Region must be specified in 2nd gen repo; global is not + supported. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/builds/enterprise-config/github/describe b/gcloud/alpha/builds/enterprise-config/github/describe index 606f08691..57e774601 100644 --- a/gcloud/alpha/builds/enterprise-config/github/describe +++ b/gcloud/alpha/builds/enterprise-config/github/describe @@ -19,6 +19,8 @@ FLAGS supported region name (e.g. us-central1). If unset, builds/region, which is the default region to use when working with Cloud Build resources, is used. If builds/region is unset, region is set to global. + Note: Region must be specified in 2nd gen repo; global is not + supported. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/builds/enterprise-config/github/list b/gcloud/alpha/builds/enterprise-config/github/list index e88d70e63..7fef51d05 100644 --- a/gcloud/alpha/builds/enterprise-config/github/list +++ b/gcloud/alpha/builds/enterprise-config/github/list @@ -16,6 +16,8 @@ FLAGS supported region name (e.g. us-central1). If unset, builds/region, which is the default region to use when working with Cloud Build resources, is used. If builds/region is unset, region is set to global. + Note: Region must be specified in 2nd gen repo; global is not + supported. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/alpha/builds/enterprise-config/github/update b/gcloud/alpha/builds/enterprise-config/github/update index 964c981fc..b82de29ac 100644 --- a/gcloud/alpha/builds/enterprise-config/github/update +++ b/gcloud/alpha/builds/enterprise-config/github/update @@ -38,6 +38,8 @@ FLAGS supported region name (e.g. us-central1). If unset, builds/region, which is the default region to use when working with Cloud Build resources, is used. If builds/region is unset, region is set to global. + Note: Region must be specified in 2nd gen repo; global is not + supported. --webhook-key=WEBHOOK_KEY The unique identifier that Cloud Build expects to be set as the value diff --git a/gcloud/alpha/builds/list b/gcloud/alpha/builds/list index 66ada299f..0c0b8d56b 100644 --- a/gcloud/alpha/builds/list +++ b/gcloud/alpha/builds/list @@ -28,6 +28,8 @@ FLAGS supported region name (e.g. us-central1). If unset, builds/region, which is the default region to use when working with Cloud Build resources, is used. If builds/region is unset, region is set to global. + Note: Region must be specified in 2nd gen repo; global is not + supported. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/alpha/builds/log b/gcloud/alpha/builds/log index d2eb251a5..2eadcf315 100644 --- a/gcloud/alpha/builds/log +++ b/gcloud/alpha/builds/log @@ -29,6 +29,8 @@ FLAGS supported region name (e.g. us-central1). If unset, builds/region, which is the default region to use when working with Cloud Build resources, is used. If builds/region is unset, region is set to global. + Note: Region must be specified in 2nd gen repo; global is not + supported. --stream If a build is ongoing, stream the logs to stdout until the build diff --git a/gcloud/alpha/builds/submit b/gcloud/alpha/builds/submit index 9a94e3b34..0969efd60 100644 --- a/gcloud/alpha/builds/submit +++ b/gcloud/alpha/builds/submit @@ -146,6 +146,8 @@ FLAGS supported region name (e.g. us-central1). If unset, builds/region, which is the default region to use when working with Cloud Build resources, is used. If builds/region is unset, region is set to global. + Note: Region must be specified in 2nd gen repo; global is not + supported. --revision=REVISION Revision to fetch from the Git repository such as a branch, a tag, a diff --git a/gcloud/alpha/builds/triggers/create/bitbucketserver b/gcloud/alpha/builds/triggers/create/bitbucketserver index 182265472..c4feb1cd3 100644 --- a/gcloud/alpha/builds/triggers/create/bitbucketserver +++ b/gcloud/alpha/builds/triggers/create/bitbucketserver @@ -5,12 +5,8 @@ NAME SYNOPSIS gcloud alpha builds triggers create bitbucketserver (--trigger-config=PATH - | [--bitbucket-server-config-resource=BITBUCKET_SERVER_CONFIG_RESOURCE --project-key=PROJECT_KEY --repo-slug=REPO_SLUG (--branch-pattern=REGEX | --tag-pattern=REGEX | [--pull-request-pattern=REGEX : --comment-control=COMMENT_CONTROL; default=CommentControlValueValuesEnum(COMMENTS_ENABLED, - 1)]) (--build-config=PATH | --inline-config=PATH - | [--dockerfile=DOCKERFILE : --dockerfile-dir=DOCKERFILE_DIR; - default="/" --dockerfile-image=DOCKERFILE_IMAGE]) - : --description=DESCRIPTION --ignored-files=[GLOB,...] - --included-files=[GLOB,...] --name=NAME --region=REGION + | [--bitbucket-server-config-resource=BITBUCKET_SERVER_CONFIG_RESOURCE --project-key=PROJECT_KEY --repo-slug=REPO_SLUG (--branch-pattern=REGEX | --tag-pattern=REGEX | [--pull-request-pattern=REGEX : --comment-control=COMMENT_CONTROL; default="COMMENTS_ENABLED"]) (--build-config=PATH | --inline-config=PATH | [--dockerfile=DOCKERFILE : --dockerfile-dir=DOCKERFILE_DIR; default="/" --dockerfile-image=DOCKERFILE_IMAGE]) : --description=DESCRIPTION --ignored-files=[GLOB, + ...] --included-files=[GLOB,...] --name=NAME --region=REGION --[no-]require-approval --service-account=SERVICE_ACCOUNT --substitutions=[KEY=VALUE,...]]) [GCLOUD_WIDE_FLAG ...] @@ -90,7 +86,8 @@ REQUIRED FLAGS supported region name (e.g. us-central1). If unset, builds/region, which is the default region to use when working with Cloud Build resources, is used. If builds/region is unset, region is set to - global. + global. Note: Region must be specified in 2nd gen repo; global is + not supported. --[no-]require-approval Require manual approval for triggered builds. Use @@ -167,7 +164,7 @@ REQUIRED FLAGS This flag argument must be specified if any of the other arguments in this group are specified. - --comment-control=COMMENT_CONTROL; default=CommentControlValueValuesEnum(COMMENTS_ENABLED, 1) + --comment-control=COMMENT_CONTROL; default="COMMENTS_ENABLED" Require a repository collaborator or owner to comment '/gcbrun' on a pull request before running the build. COMMENT_CONTROL must be one of: diff --git a/gcloud/alpha/builds/triggers/create/cloud-source-repositories b/gcloud/alpha/builds/triggers/create/cloud-source-repositories index b1a95facb..808e90966 100644 --- a/gcloud/alpha/builds/triggers/create/cloud-source-repositories +++ b/gcloud/alpha/builds/triggers/create/cloud-source-repositories @@ -72,7 +72,8 @@ REQUIRED FLAGS supported region name (e.g. us-central1). If unset, builds/region, which is the default region to use when working with Cloud Build resources, is used. If builds/region is unset, region is set to - global. + global. Note: Region must be specified in 2nd gen repo; global is + not supported. --[no-]require-approval Require manual approval for triggered builds. Use diff --git a/gcloud/alpha/builds/triggers/create/github b/gcloud/alpha/builds/triggers/create/github index 9fe63ece4..0284014e1 100644 --- a/gcloud/alpha/builds/triggers/create/github +++ b/gcloud/alpha/builds/triggers/create/github @@ -6,10 +6,9 @@ SYNOPSIS gcloud alpha builds triggers create github (--trigger-config=PATH | [(--branch-pattern=REGEX | --tag-pattern=REGEX | [--pull-request-pattern=REGEX : --comment-control=COMMENT_CONTROL; - default=CommentControlValueValuesEnum(COMMENTS_ENABLED, - 1)]) (--build-config=PATH | --inline-config=PATH - | [--dockerfile=DOCKERFILE : --dockerfile-dir=DOCKERFILE_DIR; - default="/" + default="COMMENTS_ENABLED"]) (--build-config=PATH + | --inline-config=PATH | [--dockerfile=DOCKERFILE + : --dockerfile-dir=DOCKERFILE_DIR; default="/" --dockerfile-image=DOCKERFILE_IMAGE]) (--repository=REPOSITORY | [--repo-name=REPO_NAME --repo-owner=REPO_OWNER : --enterprise-config=ENTERPRISE_CONFIG]) : --description=DESCRIPTION @@ -47,7 +46,7 @@ EXAMPLES --repository=projects/my-project/locations/us-central1/\ connections/my-conn/repositories/my-repo \ --pull-request-pattern="^master$" \ - --build-config="cloudbuild.yaml" + --build-config="cloudbuild.yaml" --region=us-central1 REQUIRED FLAGS Exactly one of these must be specified: @@ -82,7 +81,8 @@ REQUIRED FLAGS supported region name (e.g. us-central1). If unset, builds/region, which is the default region to use when working with Cloud Build resources, is used. If builds/region is unset, region is set to - global. + global. Note: Region must be specified in 2nd gen repo; global is + not supported. --[no-]require-approval Require manual approval for triggered builds. Use @@ -159,7 +159,7 @@ REQUIRED FLAGS This flag argument must be specified if any of the other arguments in this group are specified. - --comment-control=COMMENT_CONTROL; default=CommentControlValueValuesEnum(COMMENTS_ENABLED, 1) + --comment-control=COMMENT_CONTROL; default="COMMENTS_ENABLED" Require a repository collaborator or owner to comment '/gcbrun' on a pull request before running the build. COMMENT_CONTROL must be one of: diff --git a/gcloud/alpha/builds/triggers/create/gitlab b/gcloud/alpha/builds/triggers/create/gitlab index 0c5beaa26..a6d019b14 100644 --- a/gcloud/alpha/builds/triggers/create/gitlab +++ b/gcloud/alpha/builds/triggers/create/gitlab @@ -6,8 +6,8 @@ SYNOPSIS gcloud alpha builds triggers create gitlab (--trigger-config=PATH | [(--branch-pattern=REGEX | --tag-pattern=REGEX | [--pull-request-pattern=REGEX : --comment-control=COMMENT_CONTROL; - default=CommentControlValueValuesEnum(COMMENTS_ENABLED, - 1)]) (--build-config=PATH | --inline-config=PATH + default="COMMENTS_ENABLED"]) (--build-config=PATH + | --inline-config=PATH | [--dockerfile=DOCKERFILE --dockerfile-image=DOCKERFILE_IMAGE : --dockerfile-dir=DOCKERFILE_DIR; default="/"]) : --description=DESCRIPTION --ignored-files=[GLOB,...] @@ -25,17 +25,18 @@ EXAMPLES $ gcloud alpha builds triggers create gitlab --name="my-trigger" \ --service-account="projects/my-project/serviceAccounts/my-byosa@\ my-project.iam.gserviceaccount.com" \ - --repository="projects/1234/locations/global/connections/myconn/\ - repositories/myrepo" --branch-pattern=".*" \ - --build-config="cloudbuild.yaml" + --repository="projects/1234/locations/us-central1/connections/my\ + conn/repositories/myrepo" --branch-pattern=".*" \ + --build-config="cloudbuild.yaml" --region=us-central1 - To create a pull request trigger with a 1st-gen repository for main: + To create a pull request trigger with a 2nd-gen repository for main: $ gcloud alpha builds triggers create gitlab --name="my-trigger" \ --service-account="projects/my-project/serviceAccounts/my-byosa@\ my-project.iam.gserviceaccount.com" \ - --repository="projects/1234/locations/global/connections/myconn/\ - repositories/myrepo" --build-config="cloudbuild.yaml" + --repository="projects/1234/locations/us-central1/connections/my\ + conn/repositories/myrepo" --build-config="cloudbuild.yaml" \ + --pull-request-pattern="^main$" --region=us-central1 REQUIRED FLAGS Exactly one of these must be specified: @@ -66,7 +67,8 @@ REQUIRED FLAGS supported region name (e.g. us-central1). If unset, builds/region, which is the default region to use when working with Cloud Build resources, is used. If builds/region is unset, region is set to - global. + global. Note: Region must be specified in 2nd gen repo; global is + not supported. --repository=REPOSITORY Repository resource (2nd gen) to use, in the format @@ -147,7 +149,7 @@ REQUIRED FLAGS This flag argument must be specified if any of the other arguments in this group are specified. - --comment-control=COMMENT_CONTROL; default=CommentControlValueValuesEnum(COMMENTS_ENABLED, 1) + --comment-control=COMMENT_CONTROL; default="COMMENTS_ENABLED" Require a repository collaborator or owner to comment '/gcbrun' on a pull request before running the build. COMMENT_CONTROL must be one of: diff --git a/gcloud/alpha/builds/triggers/create/manual b/gcloud/alpha/builds/triggers/create/manual index 265f9b3c3..b9f5216e3 100644 --- a/gcloud/alpha/builds/triggers/create/manual +++ b/gcloud/alpha/builds/triggers/create/manual @@ -56,7 +56,8 @@ REQUIRED FLAGS supported region name (e.g. us-central1). If unset, builds/region, which is the default region to use when working with Cloud Build resources, is used. If builds/region is unset, region is set to - global. + global. Note: Region must be specified in 2nd gen repo; global is + not supported. --[no-]require-approval Require manual approval for triggered builds. Use diff --git a/gcloud/alpha/builds/triggers/create/pubsub b/gcloud/alpha/builds/triggers/create/pubsub index c67eb0f2f..8e8eab976 100644 --- a/gcloud/alpha/builds/triggers/create/pubsub +++ b/gcloud/alpha/builds/triggers/create/pubsub @@ -69,7 +69,8 @@ REQUIRED FLAGS supported region name (e.g. us-central1). If unset, builds/region, which is the default region to use when working with Cloud Build resources, is used. If builds/region is unset, region is set to - global. + global. Note: Region must be specified in 2nd gen repo; global is + not supported. --[no-]require-approval Require manual approval for triggered builds. Use diff --git a/gcloud/alpha/builds/triggers/create/webhook b/gcloud/alpha/builds/triggers/create/webhook index 80e461619..1e3f5a799 100644 --- a/gcloud/alpha/builds/triggers/create/webhook +++ b/gcloud/alpha/builds/triggers/create/webhook @@ -75,7 +75,8 @@ REQUIRED FLAGS supported region name (e.g. us-central1). If unset, builds/region, which is the default region to use when working with Cloud Build resources, is used. If builds/region is unset, region is set to - global. + global. Note: Region must be specified in 2nd gen repo; global is + not supported. --[no-]require-approval Require manual approval for triggered builds. Use diff --git a/gcloud/alpha/builds/triggers/import b/gcloud/alpha/builds/triggers/import index 880b3c363..e4b8ab5a4 100644 --- a/gcloud/alpha/builds/triggers/import +++ b/gcloud/alpha/builds/triggers/import @@ -25,6 +25,8 @@ OPTIONAL FLAGS supported region name (e.g. us-central1). If unset, builds/region, which is the default region to use when working with Cloud Build resources, is used. If builds/region is unset, region is set to global. + Note: Region must be specified in 2nd gen repo; global is not + supported. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/builds/triggers/list b/gcloud/alpha/builds/triggers/list index 2e6542d41..e3c59eae8 100644 --- a/gcloud/alpha/builds/triggers/list +++ b/gcloud/alpha/builds/triggers/list @@ -20,6 +20,8 @@ FLAGS supported region name (e.g. us-central1). If unset, builds/region, which is the default region to use when working with Cloud Build resources, is used. If builds/region is unset, region is set to global. + Note: Region must be specified in 2nd gen repo; global is not + supported. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/alpha/compute/disks/create b/gcloud/alpha/compute/disks/create index 95aa46194..04f16122a 100644 --- a/gcloud/alpha/compute/disks/create +++ b/gcloud/alpha/compute/disks/create @@ -73,8 +73,8 @@ FLAGS be one of: ARM64, X86_64. --confidential-compute - Create the disk in confidential compute mode, CMEK layer is required - and only applicable to HyperDisk series. + Creates the disk with confidential compute mode enabled. Encryption + with a Cloud KMS key is required to enable this option. --csek-key-file=FILE Path to a Customer-Supplied Encryption Key (CSEK) key file that maps diff --git a/gcloud/alpha/compute/health-checks/create/http b/gcloud/alpha/compute/health-checks/create/http index 6bcfe5de0..570dde509 100644 --- a/gcloud/alpha/compute/health-checks/create/http +++ b/gcloud/alpha/compute/health-checks/create/http @@ -9,7 +9,7 @@ SYNOPSIS [--healthy-threshold=HEALTHY_THRESHOLD; default=2] [--host=HOST] [--proxy-header=PROXY_HEADER; default="NONE"] [--request-path=REQUEST_PATH; default="/"] [--response=RESPONSE] - [--timeout=TIMEOUT; default="5s"] + [--source-regions=REGION,...,[...]] [--timeout=TIMEOUT; default="5s"] [--unhealthy-threshold=UNHEALTHY_THRESHOLD; default=2] [--weight-report-mode=WEIGHT_REPORT_MODE] [--global | --region=REGION] [--port=PORT; default=80 --port-name=PORT_NAME --use-serving-port] @@ -69,6 +69,16 @@ FLAGS empty, presence of specified string in first 1024 characters of response body determines health. Only ASCII characters allowed. + --source-regions=REGION,...,[...] + Defines the list of cloud regions from which health checks are + performed. This option can be specified only for health checks used + with DNS Routing Policies. If specified, --check-interval should be at + least 30 seconds. --proxy-header field and --request field (for TCP) + are not supported with this option. source-regions is only allowed for + global health checks. If this option is specified, then the health + check cannot be used with BackendService nor with managed instance + group autohealing. + --timeout=TIMEOUT; default="5s" If Google Compute Engine doesn't receive a healthy response from the instance by the time specified by the value of this flag, the health diff --git a/gcloud/alpha/compute/health-checks/create/https b/gcloud/alpha/compute/health-checks/create/https index 5e3d8204d..7feacd1af 100644 --- a/gcloud/alpha/compute/health-checks/create/https +++ b/gcloud/alpha/compute/health-checks/create/https @@ -9,7 +9,7 @@ SYNOPSIS [--healthy-threshold=HEALTHY_THRESHOLD; default=2] [--host=HOST] [--proxy-header=PROXY_HEADER; default="NONE"] [--request-path=REQUEST_PATH; default="/"] [--response=RESPONSE] - [--timeout=TIMEOUT; default="5s"] + [--source-regions=REGION,...,[...]] [--timeout=TIMEOUT; default="5s"] [--unhealthy-threshold=UNHEALTHY_THRESHOLD; default=2] [--weight-report-mode=WEIGHT_REPORT_MODE] [--global | --region=REGION] [--port=PORT; default=80 --port-name=PORT_NAME --use-serving-port] @@ -69,6 +69,16 @@ FLAGS empty, presence of specified string in first 1024 characters of response body determines health. Only ASCII characters allowed. + --source-regions=REGION,...,[...] + Defines the list of cloud regions from which health checks are + performed. This option can be specified only for health checks used + with DNS Routing Policies. If specified, --check-interval should be at + least 30 seconds. --proxy-header field and --request field (for TCP) + are not supported with this option. source-regions is only allowed for + global health checks. If this option is specified, then the health + check cannot be used with BackendService nor with managed instance + group autohealing. + --timeout=TIMEOUT; default="5s" If Google Compute Engine doesn't receive a healthy response from the instance by the time specified by the value of this flag, the health diff --git a/gcloud/alpha/compute/health-checks/create/tcp b/gcloud/alpha/compute/health-checks/create/tcp index 000f4248e..47ea7c435 100644 --- a/gcloud/alpha/compute/health-checks/create/tcp +++ b/gcloud/alpha/compute/health-checks/create/tcp @@ -8,7 +8,8 @@ SYNOPSIS [--description=DESCRIPTION] [--enable-logging] [--healthy-threshold=HEALTHY_THRESHOLD; default=2] [--proxy-header=PROXY_HEADER; default="NONE"] [--request=REQUEST] - [--response=RESPONSE] [--timeout=TIMEOUT; default="5s"] + [--response=RESPONSE] [--source-regions=REGION,...,[...]] + [--timeout=TIMEOUT; default="5s"] [--unhealthy-threshold=UNHEALTHY_THRESHOLD; default=2] [--global | --region=REGION] [--port=PORT; default=80 --port-name=PORT_NAME --use-serving-port] @@ -72,6 +73,16 @@ FLAGS successful handshake, only configure --response to match an explicit --request. + --source-regions=REGION,...,[...] + Defines the list of cloud regions from which health checks are + performed. This option can be specified only for health checks used + with DNS Routing Policies. If specified, --check-interval should be at + least 30 seconds. --proxy-header field and --request field (for TCP) + are not supported with this option. source-regions is only allowed for + global health checks. If this option is specified, then the health + check cannot be used with BackendService nor with managed instance + group autohealing. + --timeout=TIMEOUT; default="5s" If Google Compute Engine doesn't receive a healthy response from the instance by the time specified by the value of this flag, the health diff --git a/gcloud/alpha/compute/health-checks/update/http b/gcloud/alpha/compute/health-checks/update/http index 8fb4349a6..c5e5a9aa0 100644 --- a/gcloud/alpha/compute/health-checks/update/http +++ b/gcloud/alpha/compute/health-checks/update/http @@ -6,7 +6,8 @@ SYNOPSIS [--check-interval=CHECK_INTERVAL] [--description=DESCRIPTION] [--enable-logging] [--healthy-threshold=HEALTHY_THRESHOLD] [--host=HOST] [--proxy-header=PROXY_HEADER] - [--request-path=REQUEST_PATH] [--response=RESPONSE] [--timeout=TIMEOUT] + [--request-path=REQUEST_PATH] [--response=RESPONSE] + [--source-regions=REGION,...,[...]] [--timeout=TIMEOUT] [--unhealthy-threshold=UNHEALTHY_THRESHOLD] [--weight-report-mode=WEIGHT_REPORT_MODE] [--global | --region=REGION] [--port=PORT --port-name=PORT_NAME --use-serving-port] @@ -66,6 +67,16 @@ FLAGS empty, presence of specified string in first 1024 characters of response body determines health. Only ASCII characters allowed. + --source-regions=REGION,...,[...] + Defines the list of cloud regions from which health checks are + performed. This option can be specified only for health checks used + with DNS Routing Policies. If specified, --check-interval should be at + least 30 seconds. --proxy-header field and --request field (for TCP) + are not supported with this option. source-regions is only allowed for + global health checks. If this option is specified, then the health + check cannot be used with BackendService nor with managed instance + group autohealing. + --timeout=TIMEOUT If Google Compute Engine doesn't receive a healthy response from the instance by the time specified by the value of this flag, the health diff --git a/gcloud/alpha/compute/health-checks/update/https b/gcloud/alpha/compute/health-checks/update/https index 2155a4afa..4e1bb10b4 100644 --- a/gcloud/alpha/compute/health-checks/update/https +++ b/gcloud/alpha/compute/health-checks/update/https @@ -7,7 +7,8 @@ SYNOPSIS [--check-interval=CHECK_INTERVAL] [--description=DESCRIPTION] [--enable-logging] [--healthy-threshold=HEALTHY_THRESHOLD] [--host=HOST] [--proxy-header=PROXY_HEADER] - [--request-path=REQUEST_PATH] [--response=RESPONSE] [--timeout=TIMEOUT] + [--request-path=REQUEST_PATH] [--response=RESPONSE] + [--source-regions=REGION,...,[...]] [--timeout=TIMEOUT] [--unhealthy-threshold=UNHEALTHY_THRESHOLD] [--weight-report-mode=WEIGHT_REPORT_MODE] [--global | --region=REGION] [--port=PORT --port-name=PORT_NAME --use-serving-port] @@ -67,6 +68,16 @@ FLAGS empty, presence of specified string in first 1024 characters of response body determines health. Only ASCII characters allowed. + --source-regions=REGION,...,[...] + Defines the list of cloud regions from which health checks are + performed. This option can be specified only for health checks used + with DNS Routing Policies. If specified, --check-interval should be at + least 30 seconds. --proxy-header field and --request field (for TCP) + are not supported with this option. source-regions is only allowed for + global health checks. If this option is specified, then the health + check cannot be used with BackendService nor with managed instance + group autohealing. + --timeout=TIMEOUT If Google Compute Engine doesn't receive a healthy response from the instance by the time specified by the value of this flag, the health diff --git a/gcloud/alpha/compute/health-checks/update/tcp b/gcloud/alpha/compute/health-checks/update/tcp index 2d1d4daa5..b9236d6aa 100644 --- a/gcloud/alpha/compute/health-checks/update/tcp +++ b/gcloud/alpha/compute/health-checks/update/tcp @@ -6,7 +6,8 @@ SYNOPSIS [--check-interval=CHECK_INTERVAL] [--description=DESCRIPTION] [--enable-logging] [--healthy-threshold=HEALTHY_THRESHOLD] [--proxy-header=PROXY_HEADER] [--request=REQUEST] [--response=RESPONSE] - [--timeout=TIMEOUT] [--unhealthy-threshold=UNHEALTHY_THRESHOLD] + [--source-regions=REGION,...,[...]] [--timeout=TIMEOUT] + [--unhealthy-threshold=UNHEALTHY_THRESHOLD] [--global | --region=REGION] [--port=PORT --port-name=PORT_NAME --use-serving-port] [GCLOUD_WIDE_FLAG ...] @@ -70,6 +71,16 @@ FLAGS --request. Setting this to an empty string will clear any existing response value. + --source-regions=REGION,...,[...] + Defines the list of cloud regions from which health checks are + performed. This option can be specified only for health checks used + with DNS Routing Policies. If specified, --check-interval should be at + least 30 seconds. --proxy-header field and --request field (for TCP) + are not supported with this option. source-regions is only allowed for + global health checks. If this option is specified, then the health + check cannot be used with BackendService nor with managed instance + group autohealing. + --timeout=TIMEOUT If Google Compute Engine doesn't receive a healthy response from the instance by the time specified by the value of this flag, the health diff --git a/gcloud/alpha/compute/instance-templates/create b/gcloud/alpha/compute/instance-templates/create index fb4e862f6..da5f7cc9a 100644 --- a/gcloud/alpha/compute/instance-templates/create +++ b/gcloud/alpha/compute/instance-templates/create @@ -665,9 +665,9 @@ FLAGS queue-count Specifies the networking queue count for this interface. Both Rx and Tx queues will be set to this number. If it's not specified, a - default queue count will be assigned. For Virtio-net, each - interface will get min(floor(#vCPU / #vNIC), 32) queues. For gVNIC, - each interface will get min(floor(#vCPU / #vNIC / 2), 16) qeueus. + default queue count will be assigned. See + https://cloud.google.com/compute/docs/network-bandwidth#rx-tx for + more details. stack-type Specifies whether IPv6 is enabled on the interface. STACK_TYPE must diff --git a/gcloud/alpha/compute/instances/create b/gcloud/alpha/compute/instances/create index 3e657d17a..10f672f09 100644 --- a/gcloud/alpha/compute/instances/create +++ b/gcloud/alpha/compute/instances/create @@ -416,7 +416,8 @@ FLAGS confidential-compute If yes, the disk is created in confidential mode. The default value - is no. + is no. Encryption with a Cloud KMS key is required to enable this + option. replica-zones Required for each regional disk associated with the instance. @@ -1278,10 +1279,9 @@ FLAGS queue-count Specifies the networking queue count for this interface. Both Rx and Tx queues will be set to this number. If it's not specified, - a default queue count will be assigned. For Virtio-net, each - interface will get min(floor(#vCPU / #vNIC), 32) queues. For - gVNIC, each interface will get min(floor(#vCPU / #vNIC / 2), 16) - qeueus. + a default queue count will be assigned. See + https://cloud.google.com/compute/docs/network-bandwidth#rx-tx for + more details. stack-type Specifies whether IPv6 is enabled on the interface. STACK_TYPE diff --git a/gcloud/alpha/compute/instances/perform-maintenance b/gcloud/alpha/compute/instances/perform-maintenance index d0e1b73b0..579d0d3db 100644 --- a/gcloud/alpha/compute/instances/perform-maintenance +++ b/gcloud/alpha/compute/instances/perform-maintenance @@ -59,5 +59,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. These variants are also available: + + $ gcloud compute instances perform-maintenance + + $ gcloud beta compute instances perform-maintenance diff --git a/gcloud/alpha/container/clusters/create b/gcloud/alpha/container/clusters/create index af7c28eb4..9d558e317 100644 --- a/gcloud/alpha/container/clusters/create +++ b/gcloud/alpha/container/clusters/create @@ -1291,6 +1291,9 @@ FLAGS Sets the mode of the Kubernetes security posture API's workload vulnerability scanning. + To enable Advanced vulnerability insights mode explicitly set the flag + to --workload-vulnerability-scanning=enterprise. + To enable in standard mode explicitly set the flag to --workload-vulnerability-scanning=standard. diff --git a/gcloud/alpha/container/clusters/create-auto b/gcloud/alpha/container/clusters/create-auto index a87b6587c..33a4c69e3 100644 --- a/gcloud/alpha/container/clusters/create-auto +++ b/gcloud/alpha/container/clusters/create-auto @@ -363,6 +363,9 @@ FLAGS Sets the mode of the Kubernetes security posture API's workload vulnerability scanning. + To enable Advanced vulnerability insights mode explicitly set the flag + to --workload-vulnerability-scanning=enterprise. + To enable in standard mode explicitly set the flag to --workload-vulnerability-scanning=standard. diff --git a/gcloud/alpha/container/clusters/update b/gcloud/alpha/container/clusters/update index 181a5afec..3cc43c6a5 100644 --- a/gcloud/alpha/container/clusters/update +++ b/gcloud/alpha/container/clusters/update @@ -683,6 +683,9 @@ REQUIRED FLAGS Sets the mode of the Kubernetes security posture API's workload vulnerability scanning. + To enable Advanced vulnerability insights mode explicitly set the + flag to --workload-vulnerability-scanning=enterprise. + To enable in standard mode explicitly set the flag to --workload-vulnerability-scanning=standard. diff --git a/gcloud/alpha/netapp/storage-pools/create b/gcloud/alpha/netapp/storage-pools/create index 5c31d2feb..e2433d3c2 100644 --- a/gcloud/alpha/netapp/storage-pools/create +++ b/gcloud/alpha/netapp/storage-pools/create @@ -78,7 +78,7 @@ REQUIRED FLAGS --service-level=SERVICE_LEVEL The service level for the Cloud NetApp Storage Pool. For more details, see: - https://cloud.google.com/architecture/partners/netapp-cloud-volumes/service-levels + https://cloud.google.com/netapp/volumes/docs/configure-and-use/storage-pools/overview#service_levels SERVICE_LEVEL must be one of: diff --git a/gcloud/alpha/run/deploy b/gcloud/alpha/run/deploy index f2ab12482..8c2bdaa42 100644 --- a/gcloud/alpha/run/deploy +++ b/gcloud/alpha/run/deploy @@ -425,9 +425,10 @@ FLAGS Remove the VPC connector for this resource. --[no-]cpu-boost - Whether to allocate extra CPU to containers on startup. This can - reduce the perceived latency of a cold start request. Use --cpu-boost - to enable and --no-cpu-boost to disable. + Whether to allocate extra CPU to containers on startup to reduce the + perceived latency of a cold start request. Enabled by default when + unspecified on new services. Use --cpu-boost to enable and + --no-cpu-boost to disable. --[no-]cpu-throttling Whether to throttle the CPU when the container is not actively diff --git a/gcloud/alpha/run/services/update b/gcloud/alpha/run/services/update index 9026b1a8e..aa308c77e 100644 --- a/gcloud/alpha/run/services/update +++ b/gcloud/alpha/run/services/update @@ -309,9 +309,10 @@ FLAGS Remove the VPC connector for this resource. --[no-]cpu-boost - Whether to allocate extra CPU to containers on startup. This can - reduce the perceived latency of a cold start request. Use --cpu-boost - to enable and --no-cpu-boost to disable. + Whether to allocate extra CPU to containers on startup to reduce the + perceived latency of a cold start request. Enabled by default when + unspecified on new services. Use --cpu-boost to enable and + --no-cpu-boost to disable. --[no-]cpu-throttling Whether to throttle the CPU when the container is not actively diff --git a/gcloud/alpha/services/vpc-peerings/get-vpc-service-controls b/gcloud/alpha/services/vpc-peerings/get-vpc-service-controls new file mode 100644 index 000000000..5901f90ce --- /dev/null +++ b/gcloud/alpha/services/vpc-peerings/get-vpc-service-controls @@ -0,0 +1,71 @@ +NAME + gcloud alpha services vpc-peerings get-vpc-service-controls - get VPC state + of Service Controls for the peering connection + +SYNOPSIS + gcloud alpha services vpc-peerings get-vpc-service-controls + --network=NETWORK + [--service=SERVICE; default="servicenetworking.googleapis.com"] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) This command provides the state of the VPC Service Controls for a + connection. The state can be enabled or disabled. + + When enabled, Google Cloud makes the following route configuration changes + in the service producer VPC network: Google Cloud removes the IPv4 default + route (destination 0.0.0.0/0, next hop default internet gateway), Google + Cloud then creates an IPv4 route for destination 199.36.153.4/30 using the + default internet gateway next hop. + + When enabled, Google Cloud also creates Cloud DNS managed private zones and + authorizes those zones for the service producer VPC network. The zones + include googleapis.com, pkg.dev, gcr.io, and other necessary domains or + host names for Google APIs and services that are compatible with VPC + Service Controls. Record data in the zones resolves all host names to + 199.36.153.4, 199.36.153.5, 199.36.153.6, and 199.36.153.7. + + When disabled, Google Cloud makes the following route configuration changes + in the service producer VPC network: Google Cloud restores a default route + (destination 0.0.0.0/0, next hop default internet gateway), Google Cloud + also deletes the Cloud DNS managed private zones that provided the host + name overrides. + + While enabled, the service producer VPC network can still import static and + dynamic routes from the peered customer network if you enable custom route + export. These custom routes can include a default route. For this reason, + this command is not to be used solely as a means for preventing access to + the internet. + +EXAMPLES + To get the status of the VPC Service Controls for a connection peering a + network called my-network on the current project to a service called + your-service, run: + + $ gcloud alpha services vpc-peerings get-vpc-service-controls \ + --network=my-network --service=your-service + +REQUIRED FLAGS + --network=NETWORK + The network in the current project that is peered with the service. + +OPTIONAL FLAGS + --service=SERVICE; default="servicenetworking.googleapis.com" + The service to get VPC service controls for. + +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 services vpc-peerings get-vpc-service-controls + diff --git a/gcloud/alpha/services/vpc-peerings/help b/gcloud/alpha/services/vpc-peerings/help index b51648063..ab597e06b 100644 --- a/gcloud/alpha/services/vpc-peerings/help +++ b/gcloud/alpha/services/vpc-peerings/help @@ -34,6 +34,9 @@ COMMANDS enable-vpc-service-controls (ALPHA) Enable VPC Service Controls for the peering connection. + get-vpc-service-controls + (ALPHA) Get VPC state of Service Controls for the peering connection. + list (ALPHA) List connections to a service via VPC peering for a project network. diff --git a/gcloud/alpha/stacks/deploy b/gcloud/alpha/stacks/deploy new file mode 100644 index 000000000..57724206b --- /dev/null +++ b/gcloud/alpha/stacks/deploy @@ -0,0 +1,39 @@ +NAME + gcloud alpha stacks deploy - create or replace an application from a YAML + specification + +SYNOPSIS + gcloud alpha stacks deploy FILE [--region=REGION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create or replace an application from a YAML specification. + +EXAMPLES + To create an application from specification + + $ gcloud alpha stacks deploy stack.yaml + +POSITIONAL ARGUMENTS + FILE + The absolute path to the YAML file with an application definition to + update or deploy. + +FLAGS + --region=REGION + Region in which the resource can be found. Alternatively, set the + property [run/region]. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in 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/stacks/help b/gcloud/alpha/stacks/help new file mode 100644 index 000000000..8fafdc1c7 --- /dev/null +++ b/gcloud/alpha/stacks/help @@ -0,0 +1,47 @@ +NAME + gcloud alpha stacks - view and manage your Stacks resources + +SYNOPSIS + gcloud alpha stacks GROUP | COMMAND [--region=REGION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) This set of commands can be used to view and manage your Stacks + resources. + +EXAMPLES + To deploy your existing Stacks resources, run: + + $ gcloud alpha stacks deploy stacks.yaml + +FLAGS + --region=REGION + Region in which the resource can be found. Alternatively, set the + property [run/region]. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + resources + (ALPHA) Stacks resources command group. + + types + (ALPHA) View available Stacks Types. + +COMMANDS + COMMAND is one of the following: + + deploy + (ALPHA) Create or replace an application from a YAML specification. + +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/stacks/resources/delete b/gcloud/alpha/stacks/resources/delete new file mode 100644 index 000000000..ef261b2c8 --- /dev/null +++ b/gcloud/alpha/stacks/resources/delete @@ -0,0 +1,39 @@ +NAME + gcloud alpha stacks resources delete - delete a Stacks resource and its + associated bindings + +SYNOPSIS + gcloud alpha stacks resources delete NAME [--region=REGION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete a Stacks resource and its associated bindings. + +EXAMPLES + To delete a resources and the associated bindings + + $ gcloud alpha stacks resources delete my-resource + +POSITIONAL ARGUMENTS + NAME + Name of the integration. + +FLAGS + --region=REGION + Region in which the resource can be found. Alternatively, set the + property [run/region]. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in 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/stacks/resources/describe b/gcloud/alpha/stacks/resources/describe new file mode 100644 index 000000000..6ff0344e6 --- /dev/null +++ b/gcloud/alpha/stacks/resources/describe @@ -0,0 +1,38 @@ +NAME + gcloud alpha stacks resources describe - describe a Stacks resource + +SYNOPSIS + gcloud alpha stacks resources describe NAME [--region=REGION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe a Stacks resource. + +EXAMPLES + To describe an resource + + $ gcloud alpha stacks resources describe my-resource + +POSITIONAL ARGUMENTS + NAME + Name of the integration. + +FLAGS + --region=REGION + Region in which the resource can be found. Alternatively, set the + property [run/region]. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in 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/stacks/resources/export-graph b/gcloud/alpha/stacks/resources/export-graph new file mode 100644 index 000000000..349977da1 --- /dev/null +++ b/gcloud/alpha/stacks/resources/export-graph @@ -0,0 +1,63 @@ +NAME + gcloud alpha stacks resources export-graph - export a graph for Stacks + resources + +SYNOPSIS + gcloud alpha stacks resources export-graph [--region=REGION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Export a graph for Stacks resources. + +FLAGS + --region=REGION + Region in which the resource can be found. Alternatively, set the + property [run/region]. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in 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/stacks/resources/help b/gcloud/alpha/stacks/resources/help new file mode 100644 index 000000000..73fd9940a --- /dev/null +++ b/gcloud/alpha/stacks/resources/help @@ -0,0 +1,46 @@ +NAME + gcloud alpha stacks resources - stacks resources command group + +SYNOPSIS + gcloud alpha stacks resources COMMAND [--region=REGION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) This set of commands can be used to view Cloud Run resources. + +EXAMPLES + To list Stacks resources, run: + + $ gcloud alpha stacks resources list + +FLAGS + --region=REGION + Region in which the resource can be found. Alternatively, set the + property [run/region]. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + delete + (ALPHA) Delete a Stacks resource and its associated bindings. + + describe + (ALPHA) Describe a Stacks resource. + + export-graph + (ALPHA) Export a graph for Stacks resources. + + list + (ALPHA) List Stacks resources. + +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/stacks/resources/list b/gcloud/alpha/stacks/resources/list new file mode 100644 index 000000000..c56f4db2d --- /dev/null +++ b/gcloud/alpha/stacks/resources/list @@ -0,0 +1,82 @@ +NAME + gcloud alpha stacks resources list - list Stacks resources + +SYNOPSIS + gcloud alpha stacks resources list [--region=REGION] [--service=SERVICE] + [--type=TYPE] [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List Stacks resources. + +EXAMPLES + List all resources within the current project + + $ gcloud alpha stacks resources list + + List all resources of a particular type + + $ gcloud alpha stacks resources list --type=redis + + List all resources attached to a particular service + + $ gcloud alpha stacks resources list --service=my-service + +FLAGS + --region=REGION + Region in which the resource can be found. Alternatively, set the + property [run/region]. + + --service=SERVICE + Filter Integrations by Name of Cloud Run service. + + --type=TYPE + Filter Integrations by Type of Integration. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/stacks/types/describe b/gcloud/alpha/stacks/types/describe new file mode 100644 index 000000000..e8c277063 --- /dev/null +++ b/gcloud/alpha/stacks/types/describe @@ -0,0 +1,38 @@ +NAME + gcloud alpha stacks types describe - describes a Stacks type + +SYNOPSIS + gcloud alpha stacks types describe TYPE [--region=REGION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describes a Stacks type. + +EXAMPLES + To describe a Stacks type + + $ gcloud alpha stacks types describe [TYPE] + +POSITIONAL ARGUMENTS + TYPE + Type of the integration. + +FLAGS + --region=REGION + Region in which the resource can be found. Alternatively, set the + property [run/region]. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in 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/stacks/types/help b/gcloud/alpha/stacks/types/help new file mode 100644 index 000000000..26d5adb71 --- /dev/null +++ b/gcloud/alpha/stacks/types/help @@ -0,0 +1,39 @@ +NAME + gcloud alpha stacks types - view available Stacks Types + +SYNOPSIS + gcloud alpha stacks types COMMAND [--region=REGION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) This set of commands can be used to view Stacks Types. + +EXAMPLES + To list available Stacks types, run: + + $ gcloud alpha stacks types list + +FLAGS + --region=REGION + Region in which the resource can be found. Alternatively, set the + property [run/region]. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + (ALPHA) Describes a Stacks type. + + list + (ALPHA) Lists Stacks Types. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/stacks/types/list b/gcloud/alpha/stacks/types/list new file mode 100644 index 000000000..21cb68c3d --- /dev/null +++ b/gcloud/alpha/stacks/types/list @@ -0,0 +1,67 @@ +NAME + gcloud alpha stacks types list - lists Stacks Types + +SYNOPSIS + gcloud alpha stacks types list [--region=REGION] [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Lists Stacks Types. + +EXAMPLES + To list all types + + $ gcloud alpha stacks types list + +FLAGS + --region=REGION + Region in which the resource can be found. Alternatively, set the + property [run/region]. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in 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/storage/du b/gcloud/alpha/storage/du index b722b2933..03d98edeb 100644 --- a/gcloud/alpha/storage/du +++ b/gcloud/alpha/storage/du @@ -1,5 +1,5 @@ NAME - gcloud alpha storage du - displays the amount of space in bytes used up + gcloud alpha storage du - displays the amount of space in bytes used by storage resources SYNOPSIS @@ -12,8 +12,13 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Displays the amount of space in bytes used up by the objects in a - bucket, subdirectory, or project. + (ALPHA) Displays the amount of space in bytes used by the objects in a + bucket, subdirectory, or project. This command calculates the current space + usage by making a series of object listing requests, which can take a long + time for large buckets. If your bucket contains hundreds of thousands of + objects, or if you want to monitor your bucket size over time, use + Monitoring instead, as described in Get bucket size + (https://cloud.google.com/storage/docs/getting-bucket-size) EXAMPLES To list the size of each object in a bucket: @@ -64,8 +69,8 @@ FLAGS listed object. --exclude-name-pattern=EXCLUDE_NAME_PATTERN, -e EXCLUDE_NAME_PATTERN - Exclude a pattern from the report. Example: -e ".o" excludes any object - that ends in ".o". Can be specified multiple times. + Exclude a pattern from the report. Example: -e "*.o" excludes any + object that ends in ".o". Can be specified multiple times. --exclude-name-pattern-file=EXCLUDE_NAME_PATTERN_FILE, -X EXCLUDE_NAME_PATTERN_FILE Similar to -e, but excludes patterns from the given file. The patterns diff --git a/gcloud/alpha/storage/help b/gcloud/alpha/storage/help index d7ec741c0..883e49221 100644 --- a/gcloud/alpha/storage/help +++ b/gcloud/alpha/storage/help @@ -48,7 +48,7 @@ COMMANDS (ALPHA) Upload, download, and copy Cloud Storage objects. du - (ALPHA) Displays the amount of space in bytes used up storage + (ALPHA) Displays the amount of space in bytes used by storage resources. hash diff --git a/gcloud/app/help b/gcloud/app/help index 311b9b5d5..ff0b6ea51 100644 --- a/gcloud/app/help +++ b/gcloud/app/help @@ -64,6 +64,9 @@ GROUPS regions View regional availability of App Engine runtime environments. + runtimes + List runtimes available to Google App Engine. + services View and manage your App Engine services. diff --git a/gcloud/app/runtimes/help b/gcloud/app/runtimes/help new file mode 100644 index 000000000..7ebbc7539 --- /dev/null +++ b/gcloud/app/runtimes/help @@ -0,0 +1,25 @@ +NAME + gcloud app runtimes - list runtimes available to Google App Engine + +SYNOPSIS + gcloud app runtimes COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List runtimes available to Google App Engine. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + list + List the available runtimes. + +NOTES + This variant is also available: + + $ gcloud beta app runtimes + diff --git a/gcloud/app/runtimes/list b/gcloud/app/runtimes/list new file mode 100644 index 000000000..43a00633a --- /dev/null +++ b/gcloud/app/runtimes/list @@ -0,0 +1,67 @@ +NAME + gcloud app runtimes list - list the available runtimes + +SYNOPSIS + gcloud app runtimes list --environment=ENVIRONMENT [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + This command lists all the available runtimes and their current stages, for + example, GA, BETA or END OF SUPPORT. + +EXAMPLES + To list all the runtimes in the App Engine standard environment, run: + + $ gcloud app runtimes list --environment=standard + +REQUIRED FLAGS + --environment=ENVIRONMENT + Environment for the application. ENVIRONMENT must be (only one value is + supported): standard. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud beta app runtimes list + diff --git a/gcloud/beta/app/runtimes/help b/gcloud/beta/app/runtimes/help index 24536c6cc..ba62a48a3 100644 --- a/gcloud/beta/app/runtimes/help +++ b/gcloud/beta/app/runtimes/help @@ -16,8 +16,11 @@ COMMANDS COMMAND is one of the following: list - (BETA) List runtimes available. + (BETA) List the available runtimes. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud app runtimes diff --git a/gcloud/beta/app/runtimes/list b/gcloud/beta/app/runtimes/list index a10af44dd..af291ec87 100644 --- a/gcloud/beta/app/runtimes/list +++ b/gcloud/beta/app/runtimes/list @@ -1,5 +1,5 @@ NAME - gcloud beta app runtimes list - list runtimes available + gcloud beta app runtimes list - list the available runtimes SYNOPSIS gcloud beta app runtimes list --environment=ENVIRONMENT @@ -7,11 +7,11 @@ SYNOPSIS [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) This command lists all the runtimes available and their current - stages. + (BETA) This command lists all the available runtimes and their current + stages, for example, GA, BETA or END OF SUPPORT. EXAMPLES - To list all the runtimes for a given environment, run: + To list all the runtimes in the App Engine standard environment, run: $ gcloud beta app runtimes list --environment=standard @@ -61,5 +61,8 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud app runtimes list diff --git a/gcloud/beta/builds/cancel b/gcloud/beta/builds/cancel index d1c3f3044..cdb1ae49f 100644 --- a/gcloud/beta/builds/cancel +++ b/gcloud/beta/builds/cancel @@ -27,6 +27,8 @@ FLAGS supported region name (e.g. us-central1). If unset, builds/region, which is the default region to use when working with Cloud Build resources, is used. If builds/region is unset, region is set to global. + Note: Region must be specified in 2nd gen repo; global is not + supported. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/builds/describe b/gcloud/beta/builds/describe index 134727c0f..5117e0981 100644 --- a/gcloud/beta/builds/describe +++ b/gcloud/beta/builds/describe @@ -23,6 +23,8 @@ FLAGS supported region name (e.g. us-central1). If unset, builds/region, which is the default region to use when working with Cloud Build resources, is used. If builds/region is unset, region is set to global. + Note: Region must be specified in 2nd gen repo; global is not + supported. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/builds/list b/gcloud/beta/builds/list index f9d4fd585..c5c7a2825 100644 --- a/gcloud/beta/builds/list +++ b/gcloud/beta/builds/list @@ -27,6 +27,8 @@ FLAGS supported region name (e.g. us-central1). If unset, builds/region, which is the default region to use when working with Cloud Build resources, is used. If builds/region is unset, region is set to global. + Note: Region must be specified in 2nd gen repo; global is not + supported. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/beta/builds/log b/gcloud/beta/builds/log index e2b1dc2c4..dabd12598 100644 --- a/gcloud/beta/builds/log +++ b/gcloud/beta/builds/log @@ -29,6 +29,8 @@ FLAGS supported region name (e.g. us-central1). If unset, builds/region, which is the default region to use when working with Cloud Build resources, is used. If builds/region is unset, region is set to global. + Note: Region must be specified in 2nd gen repo; global is not + supported. --stream If a build is ongoing, stream the logs to stdout until the build diff --git a/gcloud/beta/builds/submit b/gcloud/beta/builds/submit index 21e261049..fd7e7203f 100644 --- a/gcloud/beta/builds/submit +++ b/gcloud/beta/builds/submit @@ -146,6 +146,8 @@ FLAGS supported region name (e.g. us-central1). If unset, builds/region, which is the default region to use when working with Cloud Build resources, is used. If builds/region is unset, region is set to global. + Note: Region must be specified in 2nd gen repo; global is not + supported. --revision=REVISION Revision to fetch from the Git repository such as a branch, a tag, a diff --git a/gcloud/beta/builds/triggers/create/bitbucketserver b/gcloud/beta/builds/triggers/create/bitbucketserver index e31a135f9..147d592f2 100644 --- a/gcloud/beta/builds/triggers/create/bitbucketserver +++ b/gcloud/beta/builds/triggers/create/bitbucketserver @@ -5,12 +5,8 @@ NAME SYNOPSIS gcloud beta builds triggers create bitbucketserver (--trigger-config=PATH - | [--bitbucket-server-config-resource=BITBUCKET_SERVER_CONFIG_RESOURCE --project-key=PROJECT_KEY --repo-slug=REPO_SLUG (--branch-pattern=REGEX | --tag-pattern=REGEX | [--pull-request-pattern=REGEX : --comment-control=COMMENT_CONTROL; default=CommentControlValueValuesEnum(COMMENTS_ENABLED, - 1)]) (--build-config=PATH | --inline-config=PATH - | [--dockerfile=DOCKERFILE : --dockerfile-dir=DOCKERFILE_DIR; - default="/" --dockerfile-image=DOCKERFILE_IMAGE]) - : --description=DESCRIPTION --ignored-files=[GLOB,...] - --included-files=[GLOB,...] --name=NAME --region=REGION + | [--bitbucket-server-config-resource=BITBUCKET_SERVER_CONFIG_RESOURCE --project-key=PROJECT_KEY --repo-slug=REPO_SLUG (--branch-pattern=REGEX | --tag-pattern=REGEX | [--pull-request-pattern=REGEX : --comment-control=COMMENT_CONTROL; default="COMMENTS_ENABLED"]) (--build-config=PATH | --inline-config=PATH | [--dockerfile=DOCKERFILE : --dockerfile-dir=DOCKERFILE_DIR; default="/" --dockerfile-image=DOCKERFILE_IMAGE]) : --description=DESCRIPTION --ignored-files=[GLOB, + ...] --included-files=[GLOB,...] --name=NAME --region=REGION --[no-]require-approval --service-account=SERVICE_ACCOUNT --substitutions=[KEY=VALUE,...]]) [GCLOUD_WIDE_FLAG ...] @@ -90,7 +86,8 @@ REQUIRED FLAGS supported region name (e.g. us-central1). If unset, builds/region, which is the default region to use when working with Cloud Build resources, is used. If builds/region is unset, region is set to - global. + global. Note: Region must be specified in 2nd gen repo; global is + not supported. --[no-]require-approval Require manual approval for triggered builds. Use @@ -167,7 +164,7 @@ REQUIRED FLAGS This flag argument must be specified if any of the other arguments in this group are specified. - --comment-control=COMMENT_CONTROL; default=CommentControlValueValuesEnum(COMMENTS_ENABLED, 1) + --comment-control=COMMENT_CONTROL; default="COMMENTS_ENABLED" Require a repository collaborator or owner to comment '/gcbrun' on a pull request before running the build. COMMENT_CONTROL must be one of: diff --git a/gcloud/beta/builds/triggers/create/cloud-source-repositories b/gcloud/beta/builds/triggers/create/cloud-source-repositories index fe3206199..c92373f2c 100644 --- a/gcloud/beta/builds/triggers/create/cloud-source-repositories +++ b/gcloud/beta/builds/triggers/create/cloud-source-repositories @@ -72,7 +72,8 @@ REQUIRED FLAGS supported region name (e.g. us-central1). If unset, builds/region, which is the default region to use when working with Cloud Build resources, is used. If builds/region is unset, region is set to - global. + global. Note: Region must be specified in 2nd gen repo; global is + not supported. --[no-]require-approval Require manual approval for triggered builds. Use diff --git a/gcloud/beta/builds/triggers/create/github b/gcloud/beta/builds/triggers/create/github index 6ecd888ea..ea8917a66 100644 --- a/gcloud/beta/builds/triggers/create/github +++ b/gcloud/beta/builds/triggers/create/github @@ -6,10 +6,9 @@ SYNOPSIS gcloud beta builds triggers create github (--trigger-config=PATH | [(--branch-pattern=REGEX | --tag-pattern=REGEX | [--pull-request-pattern=REGEX : --comment-control=COMMENT_CONTROL; - default=CommentControlValueValuesEnum(COMMENTS_ENABLED, - 1)]) (--build-config=PATH | --inline-config=PATH - | [--dockerfile=DOCKERFILE : --dockerfile-dir=DOCKERFILE_DIR; - default="/" + default="COMMENTS_ENABLED"]) (--build-config=PATH + | --inline-config=PATH | [--dockerfile=DOCKERFILE + : --dockerfile-dir=DOCKERFILE_DIR; default="/" --dockerfile-image=DOCKERFILE_IMAGE]) (--repository=REPOSITORY | [--repo-name=REPO_NAME --repo-owner=REPO_OWNER : --enterprise-config=ENTERPRISE_CONFIG]) : --description=DESCRIPTION @@ -47,7 +46,7 @@ EXAMPLES --repository=projects/my-project/locations/us-central1/\ connections/my-conn/repositories/my-repo \ --pull-request-pattern="^master$" \ - --build-config="cloudbuild.yaml" + --build-config="cloudbuild.yaml" --region=us-central1 REQUIRED FLAGS Exactly one of these must be specified: @@ -82,7 +81,8 @@ REQUIRED FLAGS supported region name (e.g. us-central1). If unset, builds/region, which is the default region to use when working with Cloud Build resources, is used. If builds/region is unset, region is set to - global. + global. Note: Region must be specified in 2nd gen repo; global is + not supported. --[no-]require-approval Require manual approval for triggered builds. Use @@ -159,7 +159,7 @@ REQUIRED FLAGS This flag argument must be specified if any of the other arguments in this group are specified. - --comment-control=COMMENT_CONTROL; default=CommentControlValueValuesEnum(COMMENTS_ENABLED, 1) + --comment-control=COMMENT_CONTROL; default="COMMENTS_ENABLED" Require a repository collaborator or owner to comment '/gcbrun' on a pull request before running the build. COMMENT_CONTROL must be one of: diff --git a/gcloud/beta/builds/triggers/create/gitlab b/gcloud/beta/builds/triggers/create/gitlab index 3f75ee54a..5ecc6a824 100644 --- a/gcloud/beta/builds/triggers/create/gitlab +++ b/gcloud/beta/builds/triggers/create/gitlab @@ -6,8 +6,8 @@ SYNOPSIS gcloud beta builds triggers create gitlab (--trigger-config=PATH | [(--branch-pattern=REGEX | --tag-pattern=REGEX | [--pull-request-pattern=REGEX : --comment-control=COMMENT_CONTROL; - default=CommentControlValueValuesEnum(COMMENTS_ENABLED, - 1)]) (--build-config=PATH | --inline-config=PATH + default="COMMENTS_ENABLED"]) (--build-config=PATH + | --inline-config=PATH | [--dockerfile=DOCKERFILE --dockerfile-image=DOCKERFILE_IMAGE : --dockerfile-dir=DOCKERFILE_DIR; default="/"]) : --description=DESCRIPTION --ignored-files=[GLOB,...] @@ -25,17 +25,18 @@ EXAMPLES $ gcloud beta builds triggers create gitlab --name="my-trigger" \ --service-account="projects/my-project/serviceAccounts/my-byosa@\ my-project.iam.gserviceaccount.com" \ - --repository="projects/1234/locations/global/connections/myconn/\ - repositories/myrepo" --branch-pattern=".*" \ - --build-config="cloudbuild.yaml" + --repository="projects/1234/locations/us-central1/connections/my\ + conn/repositories/myrepo" --branch-pattern=".*" \ + --build-config="cloudbuild.yaml" --region=us-central1 - To create a pull request trigger with a 1st-gen repository for main: + To create a pull request trigger with a 2nd-gen repository for main: $ gcloud beta builds triggers create gitlab --name="my-trigger" \ --service-account="projects/my-project/serviceAccounts/my-byosa@\ my-project.iam.gserviceaccount.com" \ - --repository="projects/1234/locations/global/connections/myconn/\ - repositories/myrepo" --build-config="cloudbuild.yaml" + --repository="projects/1234/locations/us-central1/connections/my\ + conn/repositories/myrepo" --build-config="cloudbuild.yaml" \ + --pull-request-pattern="^main$" --region=us-central1 REQUIRED FLAGS Exactly one of these must be specified: @@ -66,7 +67,8 @@ REQUIRED FLAGS supported region name (e.g. us-central1). If unset, builds/region, which is the default region to use when working with Cloud Build resources, is used. If builds/region is unset, region is set to - global. + global. Note: Region must be specified in 2nd gen repo; global is + not supported. --repository=REPOSITORY Repository resource (2nd gen) to use, in the format @@ -147,7 +149,7 @@ REQUIRED FLAGS This flag argument must be specified if any of the other arguments in this group are specified. - --comment-control=COMMENT_CONTROL; default=CommentControlValueValuesEnum(COMMENTS_ENABLED, 1) + --comment-control=COMMENT_CONTROL; default="COMMENTS_ENABLED" Require a repository collaborator or owner to comment '/gcbrun' on a pull request before running the build. COMMENT_CONTROL must be one of: diff --git a/gcloud/beta/builds/triggers/create/manual b/gcloud/beta/builds/triggers/create/manual index 85e023010..dcc60d20d 100644 --- a/gcloud/beta/builds/triggers/create/manual +++ b/gcloud/beta/builds/triggers/create/manual @@ -56,7 +56,8 @@ REQUIRED FLAGS supported region name (e.g. us-central1). If unset, builds/region, which is the default region to use when working with Cloud Build resources, is used. If builds/region is unset, region is set to - global. + global. Note: Region must be specified in 2nd gen repo; global is + not supported. --[no-]require-approval Require manual approval for triggered builds. Use diff --git a/gcloud/beta/builds/triggers/create/pubsub b/gcloud/beta/builds/triggers/create/pubsub index 65538b7b9..484aeb780 100644 --- a/gcloud/beta/builds/triggers/create/pubsub +++ b/gcloud/beta/builds/triggers/create/pubsub @@ -69,7 +69,8 @@ REQUIRED FLAGS supported region name (e.g. us-central1). If unset, builds/region, which is the default region to use when working with Cloud Build resources, is used. If builds/region is unset, region is set to - global. + global. Note: Region must be specified in 2nd gen repo; global is + not supported. --[no-]require-approval Require manual approval for triggered builds. Use diff --git a/gcloud/beta/builds/triggers/create/webhook b/gcloud/beta/builds/triggers/create/webhook index 116f3b9e3..1e4055963 100644 --- a/gcloud/beta/builds/triggers/create/webhook +++ b/gcloud/beta/builds/triggers/create/webhook @@ -75,7 +75,8 @@ REQUIRED FLAGS supported region name (e.g. us-central1). If unset, builds/region, which is the default region to use when working with Cloud Build resources, is used. If builds/region is unset, region is set to - global. + global. Note: Region must be specified in 2nd gen repo; global is + not supported. --[no-]require-approval Require manual approval for triggered builds. Use diff --git a/gcloud/beta/builds/triggers/import b/gcloud/beta/builds/triggers/import index 0919728db..743e2fd92 100644 --- a/gcloud/beta/builds/triggers/import +++ b/gcloud/beta/builds/triggers/import @@ -25,6 +25,8 @@ OPTIONAL FLAGS supported region name (e.g. us-central1). If unset, builds/region, which is the default region to use when working with Cloud Build resources, is used. If builds/region is unset, region is set to global. + Note: Region must be specified in 2nd gen repo; global is not + supported. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/builds/triggers/list b/gcloud/beta/builds/triggers/list index b8c424f81..ea4f61e96 100644 --- a/gcloud/beta/builds/triggers/list +++ b/gcloud/beta/builds/triggers/list @@ -20,6 +20,8 @@ FLAGS supported region name (e.g. us-central1). If unset, builds/region, which is the default region to use when working with Cloud Build resources, is used. If builds/region is unset, region is set to global. + Note: Region must be specified in 2nd gen repo; global is not + supported. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/beta/compute/disks/create b/gcloud/beta/compute/disks/create index 6e276f362..9c1b57713 100644 --- a/gcloud/beta/compute/disks/create +++ b/gcloud/beta/compute/disks/create @@ -67,8 +67,8 @@ FLAGS be one of: ARM64, X86_64. --confidential-compute - Create the disk in confidential compute mode, CMEK layer is required - and only applicable to HyperDisk series. + Creates the disk with confidential compute mode enabled. Encryption + with a Cloud KMS key is required to enable this option. --csek-key-file=FILE Path to a Customer-Supplied Encryption Key (CSEK) key file that maps @@ -91,9 +91,9 @@ FLAGS Enables one or more features for VM instances that use the image for their boot disks. See the descriptions of supported features at: https://cloud.google.com/compute/docs/images/create-delete-deprecate-private-images#guest-os-features. - GUEST_OS_FEATURE must be one of: GVNIC, MULTI_IP_SUBNET, SEV_CAPABLE, - SEV_LIVE_MIGRATABLE, SEV_LIVE_MIGRATABLE_V2, SEV_SNP_CAPABLE, - UEFI_COMPATIBLE, VIRTIO_SCSI_MULTIQUEUE, WINDOWS. + GUEST_OS_FEATURE must be one of: GVNIC, IDPF, MULTI_IP_SUBNET, + SEV_CAPABLE, SEV_LIVE_MIGRATABLE, SEV_LIVE_MIGRATABLE_V2, + SEV_SNP_CAPABLE, UEFI_COMPATIBLE, VIRTIO_SCSI_MULTIQUEUE, WINDOWS. --interface=INTERFACE Specifies the disk interface to use for attaching this disk. Valid diff --git a/gcloud/beta/compute/images/create b/gcloud/beta/compute/images/create index 1fe44613a..8c07c838c 100644 --- a/gcloud/beta/compute/images/create +++ b/gcloud/beta/compute/images/create @@ -151,9 +151,9 @@ OPTIONAL FLAGS Enables one or more features for VM instances that use the image for their boot disks. See the descriptions of supported features at: https://cloud.google.com/compute/docs/images/create-delete-deprecate-private-images#guest-os-features. - GUEST_OS_FEATURE must be one of: GVNIC, MULTI_IP_SUBNET, SEV_CAPABLE, - SEV_LIVE_MIGRATABLE, SEV_LIVE_MIGRATABLE_V2, SEV_SNP_CAPABLE, - UEFI_COMPATIBLE, VIRTIO_SCSI_MULTIQUEUE, WINDOWS. + GUEST_OS_FEATURE must be one of: GVNIC, IDPF, MULTI_IP_SUBNET, + SEV_CAPABLE, SEV_LIVE_MIGRATABLE, SEV_LIVE_MIGRATABLE_V2, + SEV_SNP_CAPABLE, UEFI_COMPATIBLE, VIRTIO_SCSI_MULTIQUEUE, WINDOWS. --key-exchange-key-file=[KEK_VALUE,...] Comma-separated list of file paths that point to X.509 certificates in diff --git a/gcloud/beta/compute/instance-templates/create b/gcloud/beta/compute/instance-templates/create index 1acde2f30..b0a37b580 100644 --- a/gcloud/beta/compute/instance-templates/create +++ b/gcloud/beta/compute/instance-templates/create @@ -636,9 +636,9 @@ FLAGS queue-count Specifies the networking queue count for this interface. Both Rx and Tx queues will be set to this number. If it's not specified, a - default queue count will be assigned. For Virtio-net, each - interface will get min(floor(#vCPU / #vNIC), 32) queues. For gVNIC, - each interface will get min(floor(#vCPU / #vNIC / 2), 16) qeueus. + default queue count will be assigned. See + https://cloud.google.com/compute/docs/network-bandwidth#rx-tx for + more details. stack-type Specifies whether IPv6 is enabled on the interface. STACK_TYPE must diff --git a/gcloud/beta/compute/instances/create b/gcloud/beta/compute/instances/create index 1dfb9737c..f1ad87d60 100644 --- a/gcloud/beta/compute/instances/create +++ b/gcloud/beta/compute/instances/create @@ -354,7 +354,8 @@ FLAGS confidential-compute If yes, the disk is created in confidential mode. The default value - is no. + is no. Encryption with a Cloud KMS key is required to enable this + option. replica-zones Required for each regional disk associated with the instance. @@ -687,9 +688,9 @@ FLAGS queue-count Specifies the networking queue count for this interface. Both Rx and Tx queues will be set to this number. If it's not specified, a - default queue count will be assigned. For Virtio-net, each - interface will get min(floor(#vCPU / #vNIC), 32) queues. For gVNIC, - each interface will get min(floor(#vCPU / #vNIC / 2), 16) qeueus. + default queue count will be assigned. See + https://cloud.google.com/compute/docs/network-bandwidth#rx-tx for + more details. stack-type Specifies whether IPv6 is enabled on the interface. STACK_TYPE must diff --git a/gcloud/beta/compute/instances/help b/gcloud/beta/compute/instances/help index 9479ea683..55b31bfa7 100644 --- a/gcloud/beta/compute/instances/help +++ b/gcloud/beta/compute/instances/help @@ -113,6 +113,9 @@ COMMANDS (BETA) Move an instance and its attached persistent disks between zones. + perform-maintenance + (BETA) Perform maintenance of Google Compute Engine instance. + remove-iam-policy-binding (BETA) Remove IAM policy binding from a Compute Engine instance. diff --git a/gcloud/beta/compute/instances/perform-maintenance b/gcloud/beta/compute/instances/perform-maintenance new file mode 100644 index 000000000..df53d9f9e --- /dev/null +++ b/gcloud/beta/compute/instances/perform-maintenance @@ -0,0 +1,65 @@ +NAME + gcloud beta compute instances perform-maintenance - perform maintenance of + Google Compute Engine instance + +SYNOPSIS + gcloud beta compute instances perform-maintenance INSTANCE_NAME + [--zone=ZONE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Perform maintenance of Google Compute Engine instance. + +EXAMPLES + To perform a customer trigged maintenance on an instance named + test-instance located in zone us-east1-d, run: + + $ gcloud beta compute instances perform-maintenance test-instance \ + --zone=us-east1-d + +POSITIONAL ARGUMENTS + INSTANCE_NAME + Name of the instance to operate on. For details on valid instance + names, refer to the criteria documented under the field 'name' at: + https://cloud.google.com/compute/docs/reference/rest/v1/instances + +FLAGS + --zone=ZONE + Zone of the instance to operate on. If not specified, you might be + prompted to select a zone (interactive mode only). gcloud attempts to + identify the appropriate zone by searching for resources in your + currently active project. If the zone cannot be determined, gcloud + prompts you for a selection with all available Google Cloud Platform + zones. + + To avoid prompting when this flag is omitted, the user can set the + compute/zone property: + + $ gcloud config set compute/zone ZONE + + A list of zones can be fetched by running: + + $ gcloud compute zones list + + To unset the property, run: + + $ gcloud config unset compute/zone + + Alternatively, the zone can be stored in the environment variable + CLOUDSDK_COMPUTE_ZONE. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud compute instances perform-maintenance + + $ gcloud alpha compute instances perform-maintenance + diff --git a/gcloud/beta/compute/instances/simulate-maintenance-event b/gcloud/beta/compute/instances/simulate-maintenance-event index e68e8f83c..95995b7fb 100644 --- a/gcloud/beta/compute/instances/simulate-maintenance-event +++ b/gcloud/beta/compute/instances/simulate-maintenance-event @@ -4,7 +4,9 @@ NAME SYNOPSIS gcloud beta compute instances simulate-maintenance-event INSTANCE_NAMES - [INSTANCE_NAMES ...] [--async] [--zone=ZONE] [GCLOUD_WIDE_FLAG ...] + [INSTANCE_NAMES ...] [--async] + [--with-extended-notifications=WITH_EXTENDED_NOTIFICATIONS] + [--zone=ZONE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) gcloud beta compute instances simulate-maintenance-event simulates a @@ -29,6 +31,10 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + --with-extended-notifications=WITH_EXTENDED_NOTIFICATIONS + Send an extended notification before simulating a host maintenance + event on a Compute Engine VM. + --zone=ZONE Zone of the instances to operate on. If not specified, you might be prompted to select a zone (interactive mode only). gcloud attempts to diff --git a/gcloud/beta/container/clusters/create b/gcloud/beta/container/clusters/create index ddd337ac6..2ac7afdd8 100644 --- a/gcloud/beta/container/clusters/create +++ b/gcloud/beta/container/clusters/create @@ -1258,6 +1258,9 @@ FLAGS Sets the mode of the Kubernetes security posture API's workload vulnerability scanning. + To enable Advanced vulnerability insights mode explicitly set the flag + to --workload-vulnerability-scanning=enterprise. + To enable in standard mode explicitly set the flag to --workload-vulnerability-scanning=standard. diff --git a/gcloud/beta/container/clusters/create-auto b/gcloud/beta/container/clusters/create-auto index 0744511fc..eeae587c6 100644 --- a/gcloud/beta/container/clusters/create-auto +++ b/gcloud/beta/container/clusters/create-auto @@ -363,6 +363,9 @@ FLAGS Sets the mode of the Kubernetes security posture API's workload vulnerability scanning. + To enable Advanced vulnerability insights mode explicitly set the flag + to --workload-vulnerability-scanning=enterprise. + To enable in standard mode explicitly set the flag to --workload-vulnerability-scanning=standard. diff --git a/gcloud/beta/container/clusters/update b/gcloud/beta/container/clusters/update index 90515a452..5d8b37c99 100644 --- a/gcloud/beta/container/clusters/update +++ b/gcloud/beta/container/clusters/update @@ -672,6 +672,9 @@ REQUIRED FLAGS Sets the mode of the Kubernetes security posture API's workload vulnerability scanning. + To enable Advanced vulnerability insights mode explicitly set the + flag to --workload-vulnerability-scanning=enterprise. + To enable in standard mode explicitly set the flag to --workload-vulnerability-scanning=standard. diff --git a/gcloud/beta/netapp/storage-pools/create b/gcloud/beta/netapp/storage-pools/create index 93c51bb68..c4ff0f941 100644 --- a/gcloud/beta/netapp/storage-pools/create +++ b/gcloud/beta/netapp/storage-pools/create @@ -78,7 +78,7 @@ REQUIRED FLAGS --service-level=SERVICE_LEVEL The service level for the Cloud NetApp Storage Pool. For more details, see: - https://cloud.google.com/architecture/partners/netapp-cloud-volumes/service-levels + https://cloud.google.com/netapp/volumes/docs/configure-and-use/storage-pools/overview#service_levels SERVICE_LEVEL must be one of: diff --git a/gcloud/beta/run/deploy b/gcloud/beta/run/deploy index eb8a824df..d55752f72 100644 --- a/gcloud/beta/run/deploy +++ b/gcloud/beta/run/deploy @@ -409,9 +409,10 @@ FLAGS Remove the VPC connector for this resource. --[no-]cpu-boost - Whether to allocate extra CPU to containers on startup. This can - reduce the perceived latency of a cold start request. Use --cpu-boost - to enable and --no-cpu-boost to disable. + Whether to allocate extra CPU to containers on startup to reduce the + perceived latency of a cold start request. Enabled by default when + unspecified on new services. Use --cpu-boost to enable and + --no-cpu-boost to disable. --[no-]cpu-throttling Whether to throttle the CPU when the container is not actively diff --git a/gcloud/beta/run/services/add-iam-policy-binding b/gcloud/beta/run/services/add-iam-policy-binding index eed046373..96295a7b1 100644 --- a/gcloud/beta/run/services/add-iam-policy-binding +++ b/gcloud/beta/run/services/add-iam-policy-binding @@ -5,6 +5,8 @@ NAME SYNOPSIS gcloud beta run services add-iam-policy-binding SERVICE --member=PRINCIPAL --role=ROLE [--platform=PLATFORM; default="managed"] + [--condition=[KEY=VALUE,...] + | --condition-from-file=CONDITION_FROM_FILE] [--region=REGION | --cluster=CLUSTER --cluster-location=CLUSTER_LOCATION | --context=CONTEXT --kubeconfig=KUBECONFIG] [GCLOUD_WIDE_FLAG ...] @@ -90,6 +92,43 @@ OPTIONAL FLAGS --kubeconfig and --context flags to specify a kubeconfig file and the context for connecting. + At most one of these can be specified: + + --condition=[KEY=VALUE,...] + A condition to include in the binding. When the condition is + explicitly specified as None (--condition=None), a binding without a + condition is added. When the condition is specified and is not None, + --role cannot be a basic role. Basic roles are roles/editor, + roles/owner, and roles/viewer. For more on conditions, refer to the + conditions overview guide: + https://cloud.google.com/iam/docs/conditions-overview + + When using the --condition flag, include the following key-value + pairs: + + expression + (Required) Condition expression that evaluates to True or False. + This uses a subset of Common Expression Language syntax. + + If the condition expression includes a comma, use a different + delimiter to separate the key-value pairs. Specify the delimiter + before listing the key-value pairs. For example, to specify a + colon (:) as the delimiter, do the following: + --condition=^:^title=TITLE:expression=EXPRESSION. For more + information, see + https://cloud.google.com/sdk/gcloud/reference/topic/escaping. + + title + (Required) A short string describing the purpose of the + expression. + + description + (Optional) Additional description for the expression. + + --condition-from-file=CONDITION_FROM_FILE + Path to a local JSON or YAML file that defines the condition. To see + available fields, see the help for --condition. + Arguments to locate resources, depending on the platform used. At most one of these can be specified: diff --git a/gcloud/beta/run/services/remove-iam-policy-binding b/gcloud/beta/run/services/remove-iam-policy-binding index 1ff898330..4a81b10ff 100644 --- a/gcloud/beta/run/services/remove-iam-policy-binding +++ b/gcloud/beta/run/services/remove-iam-policy-binding @@ -5,6 +5,8 @@ NAME SYNOPSIS gcloud beta run services remove-iam-policy-binding SERVICE --member=PRINCIPAL --role=ROLE [--platform=PLATFORM; default="managed"] + [--all | --condition=[KEY=VALUE,...] + | --condition-from-file=CONDITION_FROM_FILE] [--region=REGION | --cluster=CLUSTER --cluster-location=CLUSTER_LOCATION | --context=CONTEXT --kubeconfig=KUBECONFIG] [GCLOUD_WIDE_FLAG ...] @@ -91,6 +93,47 @@ OPTIONAL FLAGS --kubeconfig and --context flags to specify a kubeconfig file and the context for connecting. + At most one of these can be specified: + + --all + Remove all bindings with this role and principal, irrespective of any + conditions. + + --condition=[KEY=VALUE,...] + The condition of the binding that you want to remove. When the + condition is explicitly specified as None (--condition=None), a + binding without a condition is removed. Otherwise, only a binding + with a condition that exactly matches the specified condition + (including the optional description) is removed. For more on + conditions, refer to the conditions overview guide: + https://cloud.google.com/iam/docs/conditions-overview + + When using the --condition flag, include the following key-value + pairs: + + expression + (Required) Condition expression that evaluates to True or False. + This uses a subset of Common Expression Language syntax. + + If the condition expression includes a comma, use a different + delimiter to separate the key-value pairs. Specify the delimiter + before listing the key-value pairs. For example, to specify a + colon (:) as the delimiter, do the following: + --condition=^:^title=TITLE:expression=EXPRESSION. For more + information, see + https://cloud.google.com/sdk/gcloud/reference/topic/escaping. + + title + (Required) A short string describing the purpose of the + expression. + + description + (Optional) Additional description for the expression. + + --condition-from-file=CONDITION_FROM_FILE + Path to a local JSON or YAML file that defines the condition. To see + available fields, see the help for --condition. + Arguments to locate resources, depending on the platform used. At most one of these can be specified: diff --git a/gcloud/beta/run/services/update b/gcloud/beta/run/services/update index 1897024b2..df6dfd655 100644 --- a/gcloud/beta/run/services/update +++ b/gcloud/beta/run/services/update @@ -292,9 +292,10 @@ FLAGS Remove the VPC connector for this resource. --[no-]cpu-boost - Whether to allocate extra CPU to containers on startup. This can - reduce the perceived latency of a cold start request. Use --cpu-boost - to enable and --no-cpu-boost to disable. + Whether to allocate extra CPU to containers on startup to reduce the + perceived latency of a cold start request. Enabled by default when + unspecified on new services. Use --cpu-boost to enable and + --no-cpu-boost to disable. --[no-]cpu-throttling Whether to throttle the CPU when the container is not actively diff --git a/gcloud/beta/services/vpc-peerings/get-vpc-service-controls b/gcloud/beta/services/vpc-peerings/get-vpc-service-controls new file mode 100644 index 000000000..d64def9e8 --- /dev/null +++ b/gcloud/beta/services/vpc-peerings/get-vpc-service-controls @@ -0,0 +1,69 @@ +NAME + gcloud beta services vpc-peerings get-vpc-service-controls - get VPC state + of Service Controls for the peering connection + +SYNOPSIS + gcloud beta services vpc-peerings get-vpc-service-controls + --network=NETWORK + [--service=SERVICE; default="servicenetworking.googleapis.com"] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) This command provides the state of the VPC Service Controls for a + connection. The state can be enabled or disabled. + + When enabled, Google Cloud makes the following route configuration changes + in the service producer VPC network: Google Cloud removes the IPv4 default + route (destination 0.0.0.0/0, next hop default internet gateway), Google + Cloud then creates an IPv4 route for destination 199.36.153.4/30 using the + default internet gateway next hop. + + When enabled, Google Cloud also creates Cloud DNS managed private zones and + authorizes those zones for the service producer VPC network. The zones + include googleapis.com, pkg.dev, gcr.io, and other necessary domains or + host names for Google APIs and services that are compatible with VPC + Service Controls. Record data in the zones resolves all host names to + 199.36.153.4, 199.36.153.5, 199.36.153.6, and 199.36.153.7. + + When disabled, Google Cloud makes the following route configuration changes + in the service producer VPC network: Google Cloud restores a default route + (destination 0.0.0.0/0, next hop default internet gateway), Google Cloud + also deletes the Cloud DNS managed private zones that provided the host + name overrides. + + While enabled, the service producer VPC network can still import static and + dynamic routes from the peered customer network if you enable custom route + export. These custom routes can include a default route. For this reason, + this command is not to be used solely as a means for preventing access to + the internet. + +EXAMPLES + To get the status of the VPC Service Controls for a connection peering a + network called my-network on the current project to a service called + your-service, run: + + $ gcloud beta services vpc-peerings get-vpc-service-controls \ + --network=my-network --service=your-service + +REQUIRED FLAGS + --network=NETWORK + The network in the current project that is peered with the service. + +OPTIONAL FLAGS + --service=SERVICE; default="servicenetworking.googleapis.com" + The service to get VPC service controls for. + +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 services vpc-peerings get-vpc-service-controls + diff --git a/gcloud/beta/services/vpc-peerings/help b/gcloud/beta/services/vpc-peerings/help index e1a82b1d5..78ca5d35a 100644 --- a/gcloud/beta/services/vpc-peerings/help +++ b/gcloud/beta/services/vpc-peerings/help @@ -34,6 +34,9 @@ COMMANDS enable-vpc-service-controls (BETA) Enable VPC Service Controls for the peering connection. + get-vpc-service-controls + (BETA) Get VPC state of Service Controls for the peering connection. + list (BETA) List connections to a service via VPC peering for a project network. diff --git a/gcloud/builds/cancel b/gcloud/builds/cancel index 47d40eb67..77f3c4a14 100644 --- a/gcloud/builds/cancel +++ b/gcloud/builds/cancel @@ -27,6 +27,8 @@ FLAGS supported region name (e.g. us-central1). If unset, builds/region, which is the default region to use when working with Cloud Build resources, is used. If builds/region is unset, region is set to global. + Note: Region must be specified in 2nd gen repo; global is not + supported. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/builds/describe b/gcloud/builds/describe index 16d59e726..ad9cf30a3 100644 --- a/gcloud/builds/describe +++ b/gcloud/builds/describe @@ -23,6 +23,8 @@ FLAGS supported region name (e.g. us-central1). If unset, builds/region, which is the default region to use when working with Cloud Build resources, is used. If builds/region is unset, region is set to global. + Note: Region must be specified in 2nd gen repo; global is not + supported. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/builds/list b/gcloud/builds/list index 64bdc152e..2254493b5 100644 --- a/gcloud/builds/list +++ b/gcloud/builds/list @@ -27,6 +27,8 @@ FLAGS supported region name (e.g. us-central1). If unset, builds/region, which is the default region to use when working with Cloud Build resources, is used. If builds/region is unset, region is set to global. + Note: Region must be specified in 2nd gen repo; global is not + supported. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/builds/log b/gcloud/builds/log index ba1f32c61..ac7b3c47b 100644 --- a/gcloud/builds/log +++ b/gcloud/builds/log @@ -28,6 +28,8 @@ FLAGS supported region name (e.g. us-central1). If unset, builds/region, which is the default region to use when working with Cloud Build resources, is used. If builds/region is unset, region is set to global. + Note: Region must be specified in 2nd gen repo; global is not + supported. --stream If a build is ongoing, stream the logs to stdout until the build diff --git a/gcloud/builds/submit b/gcloud/builds/submit index 09c76b277..b306fb3b6 100644 --- a/gcloud/builds/submit +++ b/gcloud/builds/submit @@ -146,6 +146,8 @@ FLAGS supported region name (e.g. us-central1). If unset, builds/region, which is the default region to use when working with Cloud Build resources, is used. If builds/region is unset, region is set to global. + Note: Region must be specified in 2nd gen repo; global is not + supported. --revision=REVISION Revision to fetch from the Git repository such as a branch, a tag, a diff --git a/gcloud/builds/triggers/create/bitbucketserver b/gcloud/builds/triggers/create/bitbucketserver index 3e21d7b1f..3f9757116 100644 --- a/gcloud/builds/triggers/create/bitbucketserver +++ b/gcloud/builds/triggers/create/bitbucketserver @@ -5,12 +5,8 @@ NAME SYNOPSIS gcloud builds triggers create bitbucketserver (--trigger-config=PATH - | [--bitbucket-server-config-resource=BITBUCKET_SERVER_CONFIG_RESOURCE --project-key=PROJECT_KEY --repo-slug=REPO_SLUG (--branch-pattern=REGEX | --tag-pattern=REGEX | [--pull-request-pattern=REGEX : --comment-control=COMMENT_CONTROL; default=CommentControlValueValuesEnum(COMMENTS_ENABLED, - 1)]) (--build-config=PATH | --inline-config=PATH - | [--dockerfile=DOCKERFILE : --dockerfile-dir=DOCKERFILE_DIR; - default="/" --dockerfile-image=DOCKERFILE_IMAGE]) - : --description=DESCRIPTION --ignored-files=[GLOB,...] - --included-files=[GLOB,...] --name=NAME --region=REGION + | [--bitbucket-server-config-resource=BITBUCKET_SERVER_CONFIG_RESOURCE --project-key=PROJECT_KEY --repo-slug=REPO_SLUG (--branch-pattern=REGEX | --tag-pattern=REGEX | [--pull-request-pattern=REGEX : --comment-control=COMMENT_CONTROL; default="COMMENTS_ENABLED"]) (--build-config=PATH | --inline-config=PATH | [--dockerfile=DOCKERFILE : --dockerfile-dir=DOCKERFILE_DIR; default="/" --dockerfile-image=DOCKERFILE_IMAGE]) : --description=DESCRIPTION --ignored-files=[GLOB, + ...] --included-files=[GLOB,...] --name=NAME --region=REGION --[no-]require-approval --service-account=SERVICE_ACCOUNT --substitutions=[KEY=VALUE,...]]) [GCLOUD_WIDE_FLAG ...] @@ -90,7 +86,8 @@ REQUIRED FLAGS supported region name (e.g. us-central1). If unset, builds/region, which is the default region to use when working with Cloud Build resources, is used. If builds/region is unset, region is set to - global. + global. Note: Region must be specified in 2nd gen repo; global is + not supported. --[no-]require-approval Require manual approval for triggered builds. Use @@ -167,7 +164,7 @@ REQUIRED FLAGS This flag argument must be specified if any of the other arguments in this group are specified. - --comment-control=COMMENT_CONTROL; default=CommentControlValueValuesEnum(COMMENTS_ENABLED, 1) + --comment-control=COMMENT_CONTROL; default="COMMENTS_ENABLED" Require a repository collaborator or owner to comment '/gcbrun' on a pull request before running the build. COMMENT_CONTROL must be one of: diff --git a/gcloud/builds/triggers/create/cloud-source-repositories b/gcloud/builds/triggers/create/cloud-source-repositories index 33094c7d0..b04ab2b2b 100644 --- a/gcloud/builds/triggers/create/cloud-source-repositories +++ b/gcloud/builds/triggers/create/cloud-source-repositories @@ -72,7 +72,8 @@ REQUIRED FLAGS supported region name (e.g. us-central1). If unset, builds/region, which is the default region to use when working with Cloud Build resources, is used. If builds/region is unset, region is set to - global. + global. Note: Region must be specified in 2nd gen repo; global is + not supported. --[no-]require-approval Require manual approval for triggered builds. Use diff --git a/gcloud/builds/triggers/create/github b/gcloud/builds/triggers/create/github index 88ec43062..e428de6d9 100644 --- a/gcloud/builds/triggers/create/github +++ b/gcloud/builds/triggers/create/github @@ -6,10 +6,9 @@ SYNOPSIS gcloud builds triggers create github (--trigger-config=PATH | [(--branch-pattern=REGEX | --tag-pattern=REGEX | [--pull-request-pattern=REGEX : --comment-control=COMMENT_CONTROL; - default=CommentControlValueValuesEnum(COMMENTS_ENABLED, - 1)]) (--build-config=PATH | --inline-config=PATH - | [--dockerfile=DOCKERFILE : --dockerfile-dir=DOCKERFILE_DIR; - default="/" + default="COMMENTS_ENABLED"]) (--build-config=PATH + | --inline-config=PATH | [--dockerfile=DOCKERFILE + : --dockerfile-dir=DOCKERFILE_DIR; default="/" --dockerfile-image=DOCKERFILE_IMAGE]) (--repository=REPOSITORY | [--repo-name=REPO_NAME --repo-owner=REPO_OWNER : --enterprise-config=ENTERPRISE_CONFIG]) : --description=DESCRIPTION @@ -47,7 +46,7 @@ EXAMPLES --repository=projects/my-project/locations/us-central1/\ connections/my-conn/repositories/my-repo \ --pull-request-pattern="^master$" \ - --build-config="cloudbuild.yaml" + --build-config="cloudbuild.yaml" --region=us-central1 REQUIRED FLAGS Exactly one of these must be specified: @@ -82,7 +81,8 @@ REQUIRED FLAGS supported region name (e.g. us-central1). If unset, builds/region, which is the default region to use when working with Cloud Build resources, is used. If builds/region is unset, region is set to - global. + global. Note: Region must be specified in 2nd gen repo; global is + not supported. --[no-]require-approval Require manual approval for triggered builds. Use @@ -159,7 +159,7 @@ REQUIRED FLAGS This flag argument must be specified if any of the other arguments in this group are specified. - --comment-control=COMMENT_CONTROL; default=CommentControlValueValuesEnum(COMMENTS_ENABLED, 1) + --comment-control=COMMENT_CONTROL; default="COMMENTS_ENABLED" Require a repository collaborator or owner to comment '/gcbrun' on a pull request before running the build. COMMENT_CONTROL must be one of: diff --git a/gcloud/builds/triggers/create/gitlab b/gcloud/builds/triggers/create/gitlab index d40178503..1630267f2 100644 --- a/gcloud/builds/triggers/create/gitlab +++ b/gcloud/builds/triggers/create/gitlab @@ -6,8 +6,8 @@ SYNOPSIS gcloud builds triggers create gitlab (--trigger-config=PATH | [(--branch-pattern=REGEX | --tag-pattern=REGEX | [--pull-request-pattern=REGEX : --comment-control=COMMENT_CONTROL; - default=CommentControlValueValuesEnum(COMMENTS_ENABLED, - 1)]) (--build-config=PATH | --inline-config=PATH + default="COMMENTS_ENABLED"]) (--build-config=PATH + | --inline-config=PATH | [--dockerfile=DOCKERFILE --dockerfile-image=DOCKERFILE_IMAGE : --dockerfile-dir=DOCKERFILE_DIR; default="/"]) : --description=DESCRIPTION --ignored-files=[GLOB,...] @@ -25,17 +25,18 @@ EXAMPLES $ gcloud builds triggers create gitlab --name="my-trigger" \ --service-account="projects/my-project/serviceAccounts/my-byosa@\ my-project.iam.gserviceaccount.com" \ - --repository="projects/1234/locations/global/connections/myconn/\ - repositories/myrepo" --branch-pattern=".*" \ - --build-config="cloudbuild.yaml" + --repository="projects/1234/locations/us-central1/connections/my\ + conn/repositories/myrepo" --branch-pattern=".*" \ + --build-config="cloudbuild.yaml" --region=us-central1 - To create a pull request trigger with a 1st-gen repository for main: + To create a pull request trigger with a 2nd-gen repository for main: $ gcloud builds triggers create gitlab --name="my-trigger" \ --service-account="projects/my-project/serviceAccounts/my-byosa@\ my-project.iam.gserviceaccount.com" \ - --repository="projects/1234/locations/global/connections/myconn/\ - repositories/myrepo" --build-config="cloudbuild.yaml" + --repository="projects/1234/locations/us-central1/connections/my\ + conn/repositories/myrepo" --build-config="cloudbuild.yaml" \ + --pull-request-pattern="^main$" --region=us-central1 REQUIRED FLAGS Exactly one of these must be specified: @@ -66,7 +67,8 @@ REQUIRED FLAGS supported region name (e.g. us-central1). If unset, builds/region, which is the default region to use when working with Cloud Build resources, is used. If builds/region is unset, region is set to - global. + global. Note: Region must be specified in 2nd gen repo; global is + not supported. --repository=REPOSITORY Repository resource (2nd gen) to use, in the format @@ -147,7 +149,7 @@ REQUIRED FLAGS This flag argument must be specified if any of the other arguments in this group are specified. - --comment-control=COMMENT_CONTROL; default=CommentControlValueValuesEnum(COMMENTS_ENABLED, 1) + --comment-control=COMMENT_CONTROL; default="COMMENTS_ENABLED" Require a repository collaborator or owner to comment '/gcbrun' on a pull request before running the build. COMMENT_CONTROL must be one of: diff --git a/gcloud/builds/triggers/create/manual b/gcloud/builds/triggers/create/manual index 74dabde5e..a9789466e 100644 --- a/gcloud/builds/triggers/create/manual +++ b/gcloud/builds/triggers/create/manual @@ -56,7 +56,8 @@ REQUIRED FLAGS supported region name (e.g. us-central1). If unset, builds/region, which is the default region to use when working with Cloud Build resources, is used. If builds/region is unset, region is set to - global. + global. Note: Region must be specified in 2nd gen repo; global is + not supported. --[no-]require-approval Require manual approval for triggered builds. Use diff --git a/gcloud/builds/triggers/create/pubsub b/gcloud/builds/triggers/create/pubsub index f66c3269c..19f3bf2c9 100644 --- a/gcloud/builds/triggers/create/pubsub +++ b/gcloud/builds/triggers/create/pubsub @@ -67,7 +67,8 @@ REQUIRED FLAGS supported region name (e.g. us-central1). If unset, builds/region, which is the default region to use when working with Cloud Build resources, is used. If builds/region is unset, region is set to - global. + global. Note: Region must be specified in 2nd gen repo; global is + not supported. --[no-]require-approval Require manual approval for triggered builds. Use diff --git a/gcloud/builds/triggers/create/webhook b/gcloud/builds/triggers/create/webhook index 975884233..3d67f2b2d 100644 --- a/gcloud/builds/triggers/create/webhook +++ b/gcloud/builds/triggers/create/webhook @@ -73,7 +73,8 @@ REQUIRED FLAGS supported region name (e.g. us-central1). If unset, builds/region, which is the default region to use when working with Cloud Build resources, is used. If builds/region is unset, region is set to - global. + global. Note: Region must be specified in 2nd gen repo; global is + not supported. --[no-]require-approval Require manual approval for triggered builds. Use diff --git a/gcloud/builds/triggers/import b/gcloud/builds/triggers/import index 9806ab4cc..21f23f016 100644 --- a/gcloud/builds/triggers/import +++ b/gcloud/builds/triggers/import @@ -25,6 +25,8 @@ OPTIONAL FLAGS supported region name (e.g. us-central1). If unset, builds/region, which is the default region to use when working with Cloud Build resources, is used. If builds/region is unset, region is set to global. + Note: Region must be specified in 2nd gen repo; global is not + supported. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/builds/triggers/list b/gcloud/builds/triggers/list index fd7a15d03..d508cc897 100644 --- a/gcloud/builds/triggers/list +++ b/gcloud/builds/triggers/list @@ -20,6 +20,8 @@ FLAGS supported region name (e.g. us-central1). If unset, builds/region, which is the default region to use when working with Cloud Build resources, is used. If builds/region is unset, region is set to global. + Note: Region must be specified in 2nd gen repo; global is not + supported. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/compute/disks/create b/gcloud/compute/disks/create index 644f7b40d..a3e85acf1 100644 --- a/gcloud/compute/disks/create +++ b/gcloud/compute/disks/create @@ -3,8 +3,8 @@ NAME SYNOPSIS gcloud compute disks create DISK_NAME [DISK_NAME ...] - [--architecture=ARCHITECTURE] [--csek-key-file=FILE] - [--description=DESCRIPTION] + [--architecture=ARCHITECTURE] [--confidential-compute] + [--csek-key-file=FILE] [--description=DESCRIPTION] [--guest-os-features=[GUEST_OS_FEATURE,...]] [--labels=[KEY=VALUE,...]] [--licenses=[LICENSE,...]] [--primary-disk-project=PRIMARY_DISK_PROJECT] @@ -61,6 +61,10 @@ FLAGS https://cloud.google.com/compute/docs/cpu-platforms. ARCHITECTURE must be one of: ARM64, X86_64. + --confidential-compute + Creates the disk with confidential compute mode enabled. Encryption + with a Cloud KMS key is required to enable this option. + --csek-key-file=FILE Path to a Customer-Supplied Encryption Key (CSEK) key file that maps Compute Engine resources to user managed keys to be used when creating, @@ -77,9 +81,9 @@ FLAGS Enables one or more features for VM instances that use the image for their boot disks. See the descriptions of supported features at: https://cloud.google.com/compute/docs/images/create-delete-deprecate-private-images#guest-os-features. - GUEST_OS_FEATURE must be one of: GVNIC, MULTI_IP_SUBNET, SEV_CAPABLE, - SEV_LIVE_MIGRATABLE, SEV_LIVE_MIGRATABLE_V2, SEV_SNP_CAPABLE, - UEFI_COMPATIBLE, VIRTIO_SCSI_MULTIQUEUE, WINDOWS. + GUEST_OS_FEATURE must be one of: GVNIC, IDPF, MULTI_IP_SUBNET, + SEV_CAPABLE, SEV_LIVE_MIGRATABLE, SEV_LIVE_MIGRATABLE_V2, + SEV_SNP_CAPABLE, UEFI_COMPATIBLE, VIRTIO_SCSI_MULTIQUEUE, WINDOWS. --labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to add. diff --git a/gcloud/compute/images/create b/gcloud/compute/images/create index ceb86600f..f6df2a797 100644 --- a/gcloud/compute/images/create +++ b/gcloud/compute/images/create @@ -143,9 +143,9 @@ OPTIONAL FLAGS Enables one or more features for VM instances that use the image for their boot disks. See the descriptions of supported features at: https://cloud.google.com/compute/docs/images/create-delete-deprecate-private-images#guest-os-features. - GUEST_OS_FEATURE must be one of: GVNIC, MULTI_IP_SUBNET, SEV_CAPABLE, - SEV_LIVE_MIGRATABLE, SEV_LIVE_MIGRATABLE_V2, SEV_SNP_CAPABLE, - UEFI_COMPATIBLE, VIRTIO_SCSI_MULTIQUEUE, WINDOWS. + GUEST_OS_FEATURE must be one of: GVNIC, IDPF, MULTI_IP_SUBNET, + SEV_CAPABLE, SEV_LIVE_MIGRATABLE, SEV_LIVE_MIGRATABLE_V2, + SEV_SNP_CAPABLE, UEFI_COMPATIBLE, VIRTIO_SCSI_MULTIQUEUE, WINDOWS. --key-exchange-key-file=[KEK_VALUE,...] Comma-separated list of file paths that point to X.509 certificates in diff --git a/gcloud/compute/instance-templates/create b/gcloud/compute/instance-templates/create index 69abf4783..9babddc4c 100644 --- a/gcloud/compute/instance-templates/create +++ b/gcloud/compute/instance-templates/create @@ -574,9 +574,9 @@ FLAGS queue-count Specifies the networking queue count for this interface. Both Rx and Tx queues will be set to this number. If it's not specified, a - default queue count will be assigned. For Virtio-net, each - interface will get min(floor(#vCPU / #vNIC), 32) queues. For gVNIC, - each interface will get min(floor(#vCPU / #vNIC / 2), 16) qeueus. + default queue count will be assigned. See + https://cloud.google.com/compute/docs/network-bandwidth#rx-tx for + more details. stack-type Specifies whether IPv6 is enabled on the interface. STACK_TYPE must diff --git a/gcloud/compute/instances/create b/gcloud/compute/instances/create index c47f3779a..4d50a74fe 100644 --- a/gcloud/compute/instances/create +++ b/gcloud/compute/instances/create @@ -345,6 +345,11 @@ FLAGS ▸ https://compute.googleapis.com/compute/v1/projects/myproject/global/snapshots/snapshot ▸ snapshot + confidential-compute + If yes, the disk is created in confidential mode. The default value + is no. Encryption with a Cloud KMS key is required to enable this + option. + replica-zones Required for each regional disk associated with the instance. Specify the URLs of the zones where the disk should be replicated @@ -651,9 +656,9 @@ FLAGS queue-count Specifies the networking queue count for this interface. Both Rx and Tx queues will be set to this number. If it's not specified, a - default queue count will be assigned. For Virtio-net, each - interface will get min(floor(#vCPU / #vNIC), 32) queues. For gVNIC, - each interface will get min(floor(#vCPU / #vNIC / 2), 16) qeueus. + default queue count will be assigned. See + https://cloud.google.com/compute/docs/network-bandwidth#rx-tx for + more details. stack-type Specifies whether IPv6 is enabled on the interface. STACK_TYPE must diff --git a/gcloud/compute/instances/help b/gcloud/compute/instances/help index 0cfe11561..4f6ea7cfd 100644 --- a/gcloud/compute/instances/help +++ b/gcloud/compute/instances/help @@ -107,6 +107,9 @@ COMMANDS move Move an instance and its attached persistent disks between zones. + perform-maintenance + Perform maintenance of Google Compute Engine instance. + remove-iam-policy-binding Remove IAM policy binding from a Compute Engine instance. diff --git a/gcloud/compute/instances/perform-maintenance b/gcloud/compute/instances/perform-maintenance new file mode 100644 index 000000000..334b4d289 --- /dev/null +++ b/gcloud/compute/instances/perform-maintenance @@ -0,0 +1,64 @@ +NAME + gcloud compute instances perform-maintenance - perform maintenance of + Google Compute Engine instance + +SYNOPSIS + gcloud compute instances perform-maintenance INSTANCE_NAME [--zone=ZONE] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Perform maintenance of Google Compute Engine instance. + +EXAMPLES + To perform a customer trigged maintenance on an instance named + test-instance located in zone us-east1-d, run: + + $ gcloud compute instances perform-maintenance test-instance \ + --zone=us-east1-d + +POSITIONAL ARGUMENTS + INSTANCE_NAME + Name of the instance to operate on. For details on valid instance + names, refer to the criteria documented under the field 'name' at: + https://cloud.google.com/compute/docs/reference/rest/v1/instances + +FLAGS + --zone=ZONE + Zone of the instance to operate on. If not specified, you might be + prompted to select a zone (interactive mode only). gcloud attempts to + identify the appropriate zone by searching for resources in your + currently active project. If the zone cannot be determined, gcloud + prompts you for a selection with all available Google Cloud Platform + zones. + + To avoid prompting when this flag is omitted, the user can set the + compute/zone property: + + $ gcloud config set compute/zone ZONE + + A list of zones can be fetched by running: + + $ gcloud compute zones list + + To unset the property, run: + + $ gcloud config unset compute/zone + + Alternatively, the zone can be stored in the environment variable + CLOUDSDK_COMPUTE_ZONE. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha compute instances perform-maintenance + + $ gcloud beta compute instances perform-maintenance + diff --git a/gcloud/compute/instances/simulate-maintenance-event b/gcloud/compute/instances/simulate-maintenance-event index 9cf5f4466..744ab7496 100644 --- a/gcloud/compute/instances/simulate-maintenance-event +++ b/gcloud/compute/instances/simulate-maintenance-event @@ -4,7 +4,9 @@ NAME SYNOPSIS gcloud compute instances simulate-maintenance-event INSTANCE_NAMES - [INSTANCE_NAMES ...] [--async] [--zone=ZONE] [GCLOUD_WIDE_FLAG ...] + [INSTANCE_NAMES ...] [--async] + [--with-extended-notifications=WITH_EXTENDED_NOTIFICATIONS] + [--zone=ZONE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION gcloud compute instances simulate-maintenance-event simulates a host @@ -29,6 +31,10 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + --with-extended-notifications=WITH_EXTENDED_NOTIFICATIONS + Send an extended notification before simulating a host maintenance + event on a Compute Engine VM. + --zone=ZONE Zone of the instances to operate on. If not specified, you might be prompted to select a zone (interactive mode only). gcloud attempts to diff --git a/gcloud/container/clusters/create b/gcloud/container/clusters/create index 4668298bf..7f3536231 100644 --- a/gcloud/container/clusters/create +++ b/gcloud/container/clusters/create @@ -36,9 +36,11 @@ SYNOPSIS [--enable-service-externalips] [--enable-shielded-nodes] [--enable-stackdriver-kubernetes] [--enable-vertical-pod-autoscaling] [--fleet-project=PROJECT_ID_OR_NUMBER] [--gateway-api=GATEWAY_API] - [--image-type=IMAGE_TYPE] [--ipv6-access-type=IPV6_ACCESS_TYPE] - [--issue-client-certificate] [--labels=[KEY=VALUE,...]] - [--logging=[COMPONENT,...]] [--logging-variant=LOGGING_VARIANT] + [--image-type=IMAGE_TYPE] + [--in-transit-encryption=IN_TRANSIT_ENCRYPTION] + [--ipv6-access-type=IPV6_ACCESS_TYPE] [--issue-client-certificate] + [--labels=[KEY=VALUE,...]] [--logging=[COMPONENT,...]] + [--logging-variant=LOGGING_VARIANT] [--machine-type=MACHINE_TYPE, -m MACHINE_TYPE] [--max-nodes-per-pool=MAX_NODES_PER_POOL] [--max-pods-per-node=MAX_PODS_PER_NODE] @@ -602,6 +604,11 @@ FLAGS $ gcloud container get-server-config + --in-transit-encryption=IN_TRANSIT_ENCRYPTION + Enable Dataplane V2 in-transit encryption. Dataplane v2 in-transit + encryption is disabled by default. IN_TRANSIT_ENCRYPTION must be one + of: inter-node-transparent, none. + --ipv6-access-type=IPV6_ACCESS_TYPE IPv6 access type of the subnetwork. Defaults to 'external'. IPV6_ACCESS_TYPE must be one of: external, internal. @@ -1185,13 +1192,17 @@ FLAGS Sets the mode of the Kubernetes security posture API's workload vulnerability scanning. + To enable Advanced vulnerability insights mode explicitly set the flag + to --workload-vulnerability-scanning=enterprise. + To enable in standard mode explicitly set the flag to --workload-vulnerability-scanning=standard. To disable in an existing cluster, explicitly set the flag to --workload-vulnerability-scanning=disabled. - WORKLOAD_VULNERABILITY_SCANNING must be one of: disabled, standard. + WORKLOAD_VULNERABILITY_SCANNING must be one of: disabled, standard, + enterprise. Flags for Binary Authorization: diff --git a/gcloud/container/clusters/create-auto b/gcloud/container/clusters/create-auto index 90826698b..097d3140b 100644 --- a/gcloud/container/clusters/create-auto +++ b/gcloud/container/clusters/create-auto @@ -368,13 +368,17 @@ FLAGS Sets the mode of the Kubernetes security posture API's workload vulnerability scanning. + To enable Advanced vulnerability insights mode explicitly set the flag + to --workload-vulnerability-scanning=enterprise. + To enable in standard mode explicitly set the flag to --workload-vulnerability-scanning=standard. To disable in an existing cluster, explicitly set the flag to --workload-vulnerability-scanning=disabled. - WORKLOAD_VULNERABILITY_SCANNING must be one of: disabled, standard. + WORKLOAD_VULNERABILITY_SCANNING must be one of: disabled, standard, + enterprise. At most one of these can be specified: diff --git a/gcloud/container/clusters/update b/gcloud/container/clusters/update index a0211f302..3bc2f3e6e 100644 --- a/gcloud/container/clusters/update +++ b/gcloud/container/clusters/update @@ -21,8 +21,8 @@ SYNOPSIS | --enable-service-externalips | --enable-shielded-nodes | --enable-stackdriver-kubernetes | --enable-vertical-pod-autoscaling | --fleet-project=PROJECT_ID_OR_NUMBER | --gateway-api=GATEWAY_API - | --generate-password | --logging-variant=LOGGING_VARIANT - | --maintenance-window=START_TIME + | --generate-password | --in-transit-encryption=IN_TRANSIT_ENCRYPTION + | --logging-variant=LOGGING_VARIANT | --maintenance-window=START_TIME | --network-performance-configs=[PROPERTY1=VALUE1,...] | --node-locations=ZONE,[ZONE,...] | --notification-config=[pubsub=ENABLED|DISABLED, @@ -375,6 +375,11 @@ REQUIRED FLAGS Ask the server to generate a secure password and use that as the basic auth password, keeping the existing username. + --in-transit-encryption=IN_TRANSIT_ENCRYPTION + Enable Dataplane V2 in-transit encryption. Dataplane v2 in-transit + encryption is disabled by default. IN_TRANSIT_ENCRYPTION must be one + of: inter-node-transparent, none. + --logging-variant=LOGGING_VARIANT Specifies the logging variant that will be deployed on all the nodes in the cluster. Valid logging variants are MAX_THROUGHPUT, DEFAULT. @@ -641,13 +646,17 @@ REQUIRED FLAGS Sets the mode of the Kubernetes security posture API's workload vulnerability scanning. + To enable Advanced vulnerability insights mode explicitly set the + flag to --workload-vulnerability-scanning=enterprise. + To enable in standard mode explicitly set the flag to --workload-vulnerability-scanning=standard. To disable in an existing cluster, explicitly set the flag to --workload-vulnerability-scanning=disabled. - WORKLOAD_VULNERABILITY_SCANNING must be one of: disabled, standard. + WORKLOAD_VULNERABILITY_SCANNING must be one of: disabled, standard, + enterprise. --additional-pod-ipv4-ranges=NAME,[NAME,...] Additional IP address ranges(by name) for pods that need to be added diff --git a/gcloud/database-migration/conversion-workspaces/apply b/gcloud/database-migration/conversion-workspaces/apply index 743c5c371..f65e4e769 100644 --- a/gcloud/database-migration/conversion-workspaces/apply +++ b/gcloud/database-migration/conversion-workspaces/apply @@ -84,7 +84,7 @@ OPTIONAL FLAGS Waits for the operation in progress to complete before returning. --filter=FILTER - Filter the entities based on (AIP-160)[https://google.aip.dev/160] + Filter the entities based on AIP-160 (https://google.aip.dev/160) standard. Example: to filter all tables whose name start with "Employee" and are present under schema "Company", use filter as "Company.Employee* AND type=TABLE" diff --git a/gcloud/database-migration/conversion-workspaces/convert b/gcloud/database-migration/conversion-workspaces/convert index 59b6786d7..0f39ce078 100644 --- a/gcloud/database-migration/conversion-workspaces/convert +++ b/gcloud/database-migration/conversion-workspaces/convert @@ -56,7 +56,7 @@ FLAGS Auto commits the conversion workspace. --filter=FILTER - Filter the entities based on (AIP-160)[https://google.aip.dev/160] + Filter the entities based on AIP-160 (https://google.aip.dev/160) standard. Example: to filter all tables whose name start with "Employee" and are present under schema "Company", use filter as "Company.Employee* AND type=TABLE" diff --git a/gcloud/database-migration/conversion-workspaces/describe-ddls b/gcloud/database-migration/conversion-workspaces/describe-ddls index 1d152da9c..9e931ad7f 100644 --- a/gcloud/database-migration/conversion-workspaces/describe-ddls +++ b/gcloud/database-migration/conversion-workspaces/describe-ddls @@ -62,7 +62,7 @@ FLAGS latest commit are returned. --filter=FILTER - Filter the entities based on (AIP-160)[https://google.aip.dev/160] + Filter the entities based on AIP-160 (https://google.aip.dev/160) standard. Example: to filter all tables whose name start with "Employee" and are present under schema "Company", use filter as "Company.Employee* AND type=TABLE" diff --git a/gcloud/database-migration/conversion-workspaces/describe-entities b/gcloud/database-migration/conversion-workspaces/describe-entities index 05a8ae96c..3c87aa03d 100644 --- a/gcloud/database-migration/conversion-workspaces/describe-entities +++ b/gcloud/database-migration/conversion-workspaces/describe-entities @@ -62,7 +62,7 @@ OPTIONAL FLAGS latest commit are returned. --filter=FILTER - Filter the entities based on (AIP-160)[https://google.aip.dev/160] + Filter the entities based on AIP-160 (https://google.aip.dev/160) standard. Example: to filter all tables whose name start with "Employee" and are present under schema "Company", use filter as "Company.Employee* AND type=TABLE" diff --git a/gcloud/database-migration/conversion-workspaces/describe-issues b/gcloud/database-migration/conversion-workspaces/describe-issues index b7501eb80..f7316046f 100644 --- a/gcloud/database-migration/conversion-workspaces/describe-issues +++ b/gcloud/database-migration/conversion-workspaces/describe-issues @@ -56,7 +56,7 @@ FLAGS latest commit are returned. --filter=FILTER - Filter the entities based on (AIP-160)[https://google.aip.dev/160] + Filter the entities based on AIP-160 (https://google.aip.dev/160) standard. Example: to filter all tables whose name start with "Employee" and are present under schema "Company", use filter as "Company.Employee* AND type=TABLE" diff --git a/gcloud/database-migration/migration-jobs/create b/gcloud/database-migration/migration-jobs/create index 8896f88d0..06f324a1a 100644 --- a/gcloud/database-migration/migration-jobs/create +++ b/gcloud/database-migration/migration-jobs/create @@ -188,7 +188,7 @@ OPTIONAL FLAGS gs://[BUCKET_NAME]/[OBJECT_NAME]. --filter=FILTER - Filter the entities based on (AIP-160)[https://google.aip.dev/160] + Filter the entities based on AIP-160 (https://google.aip.dev/160) standard. Example: to filter all tables whose name start with "Employee" and are present under schema "Company", use filter as "Company.Employee* AND type=TABLE" diff --git a/gcloud/netapp/storage-pools/create b/gcloud/netapp/storage-pools/create index eadbbed53..8fab58c36 100644 --- a/gcloud/netapp/storage-pools/create +++ b/gcloud/netapp/storage-pools/create @@ -76,7 +76,7 @@ REQUIRED FLAGS --service-level=SERVICE_LEVEL The service level for the Cloud NetApp Storage Pool. For more details, see: - https://cloud.google.com/architecture/partners/netapp-cloud-volumes/service-levels + https://cloud.google.com/netapp/volumes/docs/configure-and-use/storage-pools/overview#service_levels SERVICE_LEVEL must be one of: diff --git a/gcloud/run/deploy b/gcloud/run/deploy index 3442d1cea..008c06a6e 100644 --- a/gcloud/run/deploy +++ b/gcloud/run/deploy @@ -388,9 +388,10 @@ FLAGS Remove the VPC connector for this resource. --[no-]cpu-boost - Whether to allocate extra CPU to containers on startup. This can - reduce the perceived latency of a cold start request. Use --cpu-boost - to enable and --no-cpu-boost to disable. + Whether to allocate extra CPU to containers on startup to reduce the + perceived latency of a cold start request. Enabled by default when + unspecified on new services. Use --cpu-boost to enable and + --no-cpu-boost to disable. --[no-]cpu-throttling Whether to throttle the CPU when the container is not actively diff --git a/gcloud/run/services/update b/gcloud/run/services/update index 5e39e0ea2..cc42289e5 100644 --- a/gcloud/run/services/update +++ b/gcloud/run/services/update @@ -220,9 +220,10 @@ FLAGS Remove the VPC connector for this resource. --[no-]cpu-boost - Whether to allocate extra CPU to containers on startup. This can - reduce the perceived latency of a cold start request. Use --cpu-boost - to enable and --no-cpu-boost to disable. + Whether to allocate extra CPU to containers on startup to reduce the + perceived latency of a cold start request. Enabled by default when + unspecified on new services. Use --cpu-boost to enable and + --no-cpu-boost to disable. --[no-]cpu-throttling Whether to throttle the CPU when the container is not actively diff --git a/gcloud/storage/du b/gcloud/storage/du index fc75a7364..a6a143e6b 100644 --- a/gcloud/storage/du +++ b/gcloud/storage/du @@ -1,5 +1,5 @@ NAME - gcloud storage du - displays the amount of space in bytes used up storage + gcloud storage du - displays the amount of space in bytes used by storage resources SYNOPSIS @@ -12,8 +12,13 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - Displays the amount of space in bytes used up by the objects in a bucket, - subdirectory, or project. + Displays the amount of space in bytes used by the objects in a bucket, + subdirectory, or project. This command calculates the current space usage + by making a series of object listing requests, which can take a long time + for large buckets. If your bucket contains hundreds of thousands of + objects, or if you want to monitor your bucket size over time, use + Monitoring instead, as described in Get bucket size + (https://cloud.google.com/storage/docs/getting-bucket-size) EXAMPLES To list the size of each object in a bucket: @@ -64,8 +69,8 @@ FLAGS listed object. --exclude-name-pattern=EXCLUDE_NAME_PATTERN, -e EXCLUDE_NAME_PATTERN - Exclude a pattern from the report. Example: -e ".o" excludes any object - that ends in ".o". Can be specified multiple times. + Exclude a pattern from the report. Example: -e "*.o" excludes any + object that ends in ".o". Can be specified multiple times. --exclude-name-pattern-file=EXCLUDE_NAME_PATTERN_FILE, -X EXCLUDE_NAME_PATTERN_FILE Similar to -e, but excludes patterns from the given file. The patterns diff --git a/gcloud/storage/help b/gcloud/storage/help index 3907b65f9..e1c2c43f5 100644 --- a/gcloud/storage/help +++ b/gcloud/storage/help @@ -45,7 +45,7 @@ COMMANDS Upload, download, and copy Cloud Storage objects. du - Displays the amount of space in bytes used up storage resources. + Displays the amount of space in bytes used by storage resources. hash Calculates hashes on local or cloud files.