From a3842bba951c1c5092fabffcb74a33f43dd157a0 Mon Sep 17 00:00:00 2001 From: Automated Date: Wed, 11 Sep 2024 09:52:17 +0000 Subject: [PATCH] gcloud: Wed Sep 11 09:52:17 UTC 2024 --- gcloud/_version | 8 +- gcloud/alpha/artifacts/files/list | 80 +++++- gcloud/alpha/artifacts/packages/list | 69 ++++- gcloud/alpha/artifacts/repositories/list | 51 ++++ gcloud/alpha/artifacts/tags/list | 74 +++--- gcloud/alpha/artifacts/versions/list | 121 ++++++--- gcloud/alpha/assured/workloads/create | 17 +- gcloud/alpha/backup-dr/backup-vaults/delete | 3 +- .../blockchain-validator-configs/create | 24 +- .../blockchain-validator-configs/update | 22 +- .../alpha/compute/instance-templates/create | 7 +- gcloud/alpha/compute/instances/bulk/create | 7 +- gcloud/alpha/compute/instances/create | 7 +- .../compute/network-endpoint-groups/create | 12 +- gcloud/alpha/compute/queued-resources/create | 7 +- gcloud/alpha/compute/security-policies/import | 5 +- gcloud/alpha/compute/snapshots/describe | 12 +- .../container/attached/clusters/register | 15 +- .../alpha/container/attached/clusters/update | 15 +- .../backup-restore/restore-plans/create | 3 +- gcloud/alpha/container/clusters/update | 99 ++++---- gcloud/alpha/container/node-pools/update | 50 +++- .../developer-connect/connections/create | 103 +++++++- .../developer-connect/connections/update | 66 ++++- .../container/clusters/node-pools/update | 20 +- .../edge-cloud/container/clusters/update | 13 +- gcloud/alpha/functions/deploy | 22 +- gcloud/alpha/iam/help | 2 +- gcloud/alpha/managed-flink/deployments/create | 103 ++++++++ gcloud/alpha/managed-flink/deployments/delete | 74 ++++++ .../alpha/managed-flink/deployments/describe | 69 +++++ gcloud/alpha/managed-flink/deployments/help | 38 +++ gcloud/alpha/managed-flink/deployments/list | 80 ++++++ gcloud/alpha/managed-flink/deployments/update | 78 ++++++ gcloud/alpha/managed-flink/help | 29 +++ gcloud/alpha/managed-flink/jobs/create | 114 +++++++++ gcloud/alpha/managed-flink/jobs/delete | 71 ++++++ gcloud/alpha/managed-flink/jobs/describe | 67 +++++ gcloud/alpha/managed-flink/jobs/help | 38 +++ gcloud/alpha/managed-flink/jobs/list | 80 ++++++ gcloud/alpha/managed-flink/jobs/update | 80 ++++++ gcloud/alpha/managed-kafka/clusters/create | 3 +- gcloud/alpha/managed-kafka/clusters/delete | 3 +- gcloud/alpha/managed-kafka/clusters/describe | 3 +- gcloud/alpha/managed-kafka/clusters/list | 3 +- gcloud/alpha/managed-kafka/clusters/update | 3 +- .../managed-kafka/consumer-groups/delete | 3 +- .../managed-kafka/consumer-groups/describe | 3 +- .../alpha/managed-kafka/consumer-groups/list | 3 +- .../managed-kafka/consumer-groups/update | 3 +- gcloud/alpha/managed-kafka/topics/create | 3 +- gcloud/alpha/managed-kafka/topics/delete | 3 +- gcloud/alpha/managed-kafka/topics/describe | 3 +- gcloud/alpha/managed-kafka/topics/list | 3 +- gcloud/alpha/managed-kafka/topics/update | 3 +- gcloud/alpha/memorystore/instances/update | 8 +- gcloud/alpha/netapp/storage-pools/help | 2 +- gcloud/alpha/netapp/storage-pools/switch | 8 +- .../internal-ranges/create | 31 ++- .../security-profiles/custom-mirroring/create | 127 +++++++++ .../security-profiles/custom-mirroring/delete | 78 ++++++ .../custom-mirroring/describe | 73 ++++++ .../security-profiles/custom-mirroring/help | 43 ++++ .../security-profiles/custom-mirroring/list | 90 +++++++ .../security-profiles/custom-mirroring/update | 119 +++++++++ .../network-security/security-profiles/help | 3 + gcloud/alpha/pubsub/subscriptions/update | 14 +- gcloud/alpha/redis/clusters/create | 18 +- gcloud/alpha/run/jobs/logs/help | 4 +- gcloud/alpha/run/jobs/logs/read | 4 +- gcloud/alpha/run/services/logs/help | 4 +- gcloud/alpha/run/services/logs/read | 4 +- gcloud/alpha/sql/instances/create | 13 +- gcloud/alpha/sql/ssl/help | 4 + gcloud/alpha/sql/ssl/server-certs/create | 36 +++ gcloud/alpha/sql/ssl/server-certs/help | 42 +++ gcloud/alpha/sql/ssl/server-certs/list | 64 +++++ gcloud/alpha/sql/ssl/server-certs/rollback | 37 +++ gcloud/alpha/sql/ssl/server-certs/rotate | 36 +++ gcloud/alpha/storage/buckets/create | 8 +- gcloud/artifacts/files/help | 3 + gcloud/artifacts/files/list | 88 +++++-- gcloud/artifacts/files/update | 106 ++++++++ gcloud/artifacts/packages/help | 3 + gcloud/artifacts/packages/list | 68 ++++- gcloud/artifacts/packages/update | 107 ++++++++ gcloud/artifacts/repositories/list | 49 ++++ gcloud/artifacts/tags/list | 74 +++--- gcloud/artifacts/versions/help | 3 + gcloud/artifacts/versions/list | 119 ++++++--- gcloud/artifacts/versions/update | 117 +++++++++ gcloud/assured/workloads/create | 17 +- gcloud/beta/artifacts/files/list | 81 +++++- gcloud/beta/artifacts/packages/list | 68 ++++- gcloud/beta/artifacts/repositories/list | 51 ++++ gcloud/beta/artifacts/tags/list | 74 +++--- gcloud/beta/artifacts/versions/list | 120 ++++++--- gcloud/beta/assured/workloads/create | 17 +- gcloud/beta/compute/instance-templates/create | 10 +- gcloud/beta/compute/instances/bulk/create | 10 +- gcloud/beta/compute/instances/create | 10 +- .../compute/network-endpoint-groups/create | 12 +- gcloud/beta/compute/security-policies/import | 5 +- .../backup-restore/restore-plans/create | 3 +- gcloud/beta/container/clusters/update | 99 ++++---- gcloud/beta/container/node-pools/update | 50 +++- gcloud/beta/filestore/instances/create | 14 + gcloud/beta/filestore/instances/update | 16 +- gcloud/beta/functions/deploy | 22 +- gcloud/beta/iam/help | 2 +- gcloud/beta/managed-kafka/clusters/create | 3 +- gcloud/beta/managed-kafka/clusters/delete | 3 +- gcloud/beta/managed-kafka/clusters/describe | 3 +- gcloud/beta/managed-kafka/clusters/list | 3 +- gcloud/beta/managed-kafka/clusters/update | 3 +- .../beta/managed-kafka/consumer-groups/delete | 3 +- .../managed-kafka/consumer-groups/describe | 3 +- .../beta/managed-kafka/consumer-groups/list | 3 +- .../beta/managed-kafka/consumer-groups/update | 3 +- gcloud/beta/managed-kafka/topics/create | 3 +- gcloud/beta/managed-kafka/topics/delete | 3 +- gcloud/beta/managed-kafka/topics/describe | 3 +- gcloud/beta/managed-kafka/topics/list | 3 +- gcloud/beta/managed-kafka/topics/update | 3 +- gcloud/beta/memorystore/instances/update | 8 +- gcloud/beta/netapp/storage-pools/help | 2 +- gcloud/beta/netapp/storage-pools/switch | 12 +- .../beta/netapp/volumes/replications/create | 7 +- .../beta/netapp/volumes/replications/update | 7 +- gcloud/beta/network-management/help | 3 + .../vpc-flow-logs-configs/create | 192 ++++++++++++++ .../vpc-flow-logs-configs/delete | 72 ++++++ .../vpc-flow-logs-configs/describe | 66 +++++ .../vpc-flow-logs-configs/help | 39 +++ .../vpc-flow-logs-configs/list | 92 +++++++ .../vpc-flow-logs-configs/update | 240 ++++++++++++++++++ .../network-security/authz-policies/delete | 70 +++++ .../network-security/authz-policies/describe | 65 +++++ .../beta/network-security/authz-policies/help | 33 +++ .../network-security/authz-policies/import | 82 ++++++ .../beta/network-security/authz-policies/list | 86 +++++++ gcloud/beta/network-security/help | 3 + .../security-profiles/custom-mirroring/create | 125 +++++++++ .../security-profiles/custom-mirroring/delete | 76 ++++++ .../custom-mirroring/describe | 71 ++++++ .../security-profiles/custom-mirroring/help | 41 +++ .../security-profiles/custom-mirroring/list | 88 +++++++ .../security-profiles/custom-mirroring/update | 117 +++++++++ .../network-security/security-profiles/help | 3 + gcloud/beta/pubsub/subscriptions/update | 14 +- gcloud/beta/redis/clusters/create | 18 +- gcloud/beta/run/jobs/logs/help | 6 +- gcloud/beta/run/jobs/logs/read | 6 +- gcloud/beta/run/services/logs/help | 6 +- gcloud/beta/run/services/logs/read | 6 +- .../authz-extensions/delete | 71 ++++++ .../authz-extensions/describe | 65 +++++ .../service-extensions/authz-extensions/help | 34 +++ .../authz-extensions/import | 82 ++++++ .../service-extensions/authz-extensions/list | 86 +++++++ gcloud/beta/service-extensions/help | 3 + gcloud/beta/sql/instances/create | 13 +- gcloud/beta/sql/ssl/help | 4 + gcloud/beta/sql/ssl/server-certs/create | 34 +++ gcloud/beta/sql/ssl/server-certs/help | 40 +++ gcloud/beta/sql/ssl/server-certs/list | 62 +++++ gcloud/beta/sql/ssl/server-certs/rollback | 35 +++ gcloud/beta/sql/ssl/server-certs/rotate | 34 +++ gcloud/compute/network-endpoint-groups/create | 12 +- gcloud/compute/security-policies/import | 5 +- gcloud/container/attached/clusters/register | 15 +- gcloud/container/attached/clusters/update | 15 +- gcloud/container/clusters/update | 97 +++---- gcloud/container/node-pools/update | 50 +++- .../connection-profiles/create/sqlserver | 26 +- .../connection-profiles/help | 3 + .../connection-profiles/test | 61 +++++ gcloud/filestore/instances/create | 14 + gcloud/filestore/instances/update | 16 +- gcloud/functions/deploy | 22 +- gcloud/iam/help | 2 +- gcloud/looker/instances/create | 7 +- gcloud/netapp/storage-pools/create | 8 +- gcloud/netapp/storage-pools/help | 3 + gcloud/netapp/storage-pools/switch | 76 ++++++ gcloud/netapp/storage-pools/update | 9 +- gcloud/netapp/volumes/replications/create | 7 +- gcloud/netapp/volumes/replications/update | 7 +- gcloud/pubsub/subscriptions/update | 14 +- gcloud/redis/clusters/create | 15 ++ gcloud/run/jobs/help | 3 + gcloud/run/jobs/logs/help | 41 +++ gcloud/run/jobs/logs/read | 82 ++++++ gcloud/run/services/help | 9 +- gcloud/run/services/logs/help | 111 ++++++++ gcloud/run/services/logs/read | 163 ++++++++++++ gcloud/storage/buckets/create | 8 +- 197 files changed, 6656 insertions(+), 691 deletions(-) create mode 100644 gcloud/alpha/managed-flink/deployments/create create mode 100644 gcloud/alpha/managed-flink/deployments/delete create mode 100644 gcloud/alpha/managed-flink/deployments/describe create mode 100644 gcloud/alpha/managed-flink/deployments/help create mode 100644 gcloud/alpha/managed-flink/deployments/list create mode 100644 gcloud/alpha/managed-flink/deployments/update create mode 100644 gcloud/alpha/managed-flink/help create mode 100644 gcloud/alpha/managed-flink/jobs/create create mode 100644 gcloud/alpha/managed-flink/jobs/delete create mode 100644 gcloud/alpha/managed-flink/jobs/describe create mode 100644 gcloud/alpha/managed-flink/jobs/help create mode 100644 gcloud/alpha/managed-flink/jobs/list create mode 100644 gcloud/alpha/managed-flink/jobs/update create mode 100644 gcloud/alpha/network-security/security-profiles/custom-mirroring/create create mode 100644 gcloud/alpha/network-security/security-profiles/custom-mirroring/delete create mode 100644 gcloud/alpha/network-security/security-profiles/custom-mirroring/describe create mode 100644 gcloud/alpha/network-security/security-profiles/custom-mirroring/help create mode 100644 gcloud/alpha/network-security/security-profiles/custom-mirroring/list create mode 100644 gcloud/alpha/network-security/security-profiles/custom-mirroring/update create mode 100644 gcloud/alpha/sql/ssl/server-certs/create create mode 100644 gcloud/alpha/sql/ssl/server-certs/help create mode 100644 gcloud/alpha/sql/ssl/server-certs/list create mode 100644 gcloud/alpha/sql/ssl/server-certs/rollback create mode 100644 gcloud/alpha/sql/ssl/server-certs/rotate create mode 100644 gcloud/artifacts/files/update create mode 100644 gcloud/artifacts/packages/update create mode 100644 gcloud/artifacts/versions/update create mode 100644 gcloud/beta/network-management/vpc-flow-logs-configs/create create mode 100644 gcloud/beta/network-management/vpc-flow-logs-configs/delete create mode 100644 gcloud/beta/network-management/vpc-flow-logs-configs/describe create mode 100644 gcloud/beta/network-management/vpc-flow-logs-configs/help create mode 100644 gcloud/beta/network-management/vpc-flow-logs-configs/list create mode 100644 gcloud/beta/network-management/vpc-flow-logs-configs/update create mode 100644 gcloud/beta/network-security/authz-policies/delete create mode 100644 gcloud/beta/network-security/authz-policies/describe create mode 100644 gcloud/beta/network-security/authz-policies/help create mode 100644 gcloud/beta/network-security/authz-policies/import create mode 100644 gcloud/beta/network-security/authz-policies/list create mode 100644 gcloud/beta/network-security/security-profiles/custom-mirroring/create create mode 100644 gcloud/beta/network-security/security-profiles/custom-mirroring/delete create mode 100644 gcloud/beta/network-security/security-profiles/custom-mirroring/describe create mode 100644 gcloud/beta/network-security/security-profiles/custom-mirroring/help create mode 100644 gcloud/beta/network-security/security-profiles/custom-mirroring/list create mode 100644 gcloud/beta/network-security/security-profiles/custom-mirroring/update create mode 100644 gcloud/beta/service-extensions/authz-extensions/delete create mode 100644 gcloud/beta/service-extensions/authz-extensions/describe create mode 100644 gcloud/beta/service-extensions/authz-extensions/help create mode 100644 gcloud/beta/service-extensions/authz-extensions/import create mode 100644 gcloud/beta/service-extensions/authz-extensions/list create mode 100644 gcloud/beta/sql/ssl/server-certs/create create mode 100644 gcloud/beta/sql/ssl/server-certs/help create mode 100644 gcloud/beta/sql/ssl/server-certs/list create mode 100644 gcloud/beta/sql/ssl/server-certs/rollback create mode 100644 gcloud/beta/sql/ssl/server-certs/rotate create mode 100644 gcloud/database-migration/connection-profiles/test create mode 100644 gcloud/netapp/storage-pools/switch create mode 100644 gcloud/run/jobs/logs/help create mode 100644 gcloud/run/jobs/logs/read create mode 100644 gcloud/run/services/logs/help create mode 100644 gcloud/run/services/logs/read diff --git a/gcloud/_version b/gcloud/_version index f197b4cb0..d66dd0a9d 100644 --- a/gcloud/_version +++ b/gcloud/_version @@ -1,8 +1,8 @@ -Google Cloud SDK 491.0.0 -alpha 2024.08.30 -beta 2024.08.30 +Google Cloud SDK 492.0.0 +alpha 2024.09.06 +beta 2024.09.06 bq 2.1.8 bundled-python3-unix 3.11.9 -core 2024.08.30 +core 2024.09.06 gcloud-crc32c 1.0.0 gsutil 5.30 diff --git a/gcloud/alpha/artifacts/files/list b/gcloud/alpha/artifacts/files/list index 3afb16039..ea4c3a31f 100644 --- a/gcloud/alpha/artifacts/files/list +++ b/gcloud/alpha/artifacts/files/list @@ -14,34 +14,88 @@ DESCRIPTION To specify the maximum number of files to list, use the --limit flag. EXAMPLES - To list files in the current project under repository my-repo in - us-central1: + To list files in the current project under repository my-repo in us: $ gcloud alpha artifacts files list --repository=my-repo \ - --location=us-central1 + --location=us The following command lists a maximum of five files: $ gcloud alpha artifacts files list --repository=my-repo \ - --location=us-central1 --limit=5 + --location=us --limit=5 - To list files in the current project under repository my-repo in - us-central1 owned by package my-package: + To list files in the current project under repository my-repo in us owned + by package my-package: $ gcloud alpha artifacts files list --repository=my-repo \ - --location=us-central1 --package=my-package + --location=us --package=my-package - To list files in the current project under repository my-repo in - us-central1 owned by package my-package and version 1.0.0: + To list files in the current project under repository my-repo in us owned + by package my-package and version 1.0.0: $ gcloud alpha artifacts files list --repository=my-repo \ - --location=us-central1 --package=my-package --version=1.0.0 + --location=us --package=my-package --version=1.0.0 - To list files in the current project under repository my-repo in - us-central1 owned by package my-package and tag name my-tag: + To list files in the current project under repository my-repo in us owned + by package my-package and tag name my-tag: $ gcloud alpha artifacts files list --repository=my-repo \ - --location=us-central1 --package=my-package --tag=my-tag + --location=us --package=my-package --tag=my-tag + + To list files with name as my-file: + + $ gcloud alpha artifacts files list \ + --filter='name="projects/my-project/locations/us/repositories/my\ + -repo/files/my-file"' + + To list files with a given partial name, use * to match any character in + name: + + $ gcloud alpha artifacts files list \ + --filter='name="projects/my-project/locations/us/repositories/my\ + -repo/files/*file"' + + $ gcloud alpha artifacts files list \ + --filter='name="projects/my-project/locations/us/repositories/my\ + -repo/files/my-*"' + + To list files that have annotations: + + $ gcloud alpha artifacts files list --filter=annotations:* + + To list files with annotations pair as [annotation_key: annotation_value] + + $ gcloud alpha artifacts files list \ + --filter='annotations.annotation_key:annotation_value' + + To list files with annotations containing key as my_key: + + $ gcloud alpha artifacts files list --filter='annotations.my_key' + + If the key or value contains special characters, such as `my.key` and `my.value`, backtick("`") is required: + + $ gcloud alpha artifacts files list --filter='annotations.`my.key`' + + $ gcloud alpha artifacts files list \ + --filter='annotations.`my.key`:`my.value`' + + To list files with given partial annotation key or value, use * to match + any character: + + $ gcloud alpha artifacts files list \ + --filter='annotations.*key:`*.value`' + + To list files in the current project under repository my-repo in us, + ordering by create_time: + + $ gcloud alpha artifacts files list --repository=my-repo \ + --location=us --sort-by=create_time + + To list files in the current project under repository my-repo in us, + ordering by update_time reversely: + + $ gcloud alpha artifacts files list --repository=my-repo \ + --location=us --sort-by=~update_time FLAGS --package=PACKAGE diff --git a/gcloud/alpha/artifacts/packages/list b/gcloud/alpha/artifacts/packages/list index bda1a7f6a..70d9feb48 100644 --- a/gcloud/alpha/artifacts/packages/list +++ b/gcloud/alpha/artifacts/packages/list @@ -18,11 +18,64 @@ EXAMPLES $ gcloud alpha artifacts packages list --limit=5 + To list packages with name as my-pkg: + + $ gcloud alpha artifacts packages list \ + --filter='name="projects/my-project/locations/us/repositories/my\ + -repo/packages/my-pkg" + + To list packages with a given partial name, use * to match any character in + name: + + $ gcloud alpha artifacts packages list \ + --filter='name="projects/my-project/locations/us/repositories/my\ + -repo/packages/*pkg"' + + $ gcloud alpha artifacts packages list \ + --filter='name="projects/my-project/locations/us/repositories/my\ + -repo/packages/my*"' + + To list files that have annotations: + + $ gcloud alpha artifacts packages list --filter=annotations:* + + To list packages with annotations pair as [annotation_key: + annotation_value]: + + $ gcloud alpha artifacts packages list \ + --filter='annotations.annotation_key:annotation_value' + + To list packages with annotations containing key as my_key: + + $ gcloud alpha artifacts packages list --filter='annotations.my_key' + + If the key or value contains special characters, such as `my.key` or `my.value`, backtick("`") is required: + + $ gcloud alpha artifacts packages list \ + --filter='annotations.`my.key`' + + $ gcloud alpha artifacts packages list \ + --filter='annotations.`my.key`:`my.value`' + + To list packages with given partial annotation key or value, use * to match + any character: + + $ gcloud alpha artifacts packages list \ + --filter='annotations.my_*:`*.value`' + + To list packages ordered by create_time: + + $ gcloud alpha artifacts packages list --sort-by=create_time + + To list packages ordered by update_time reversely: + + $ gcloud alpha artifacts packages list --sort-by=~update_time + FLAGS - Repository resource - The parent repository for the list of packages. 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. + Repository resource - The Artifact Registry repository. If not specified, + the current artifacts/repository is used. The arguments in this group can + be used to specify the attributes of this resource. (NOTE) Some attributes + are not given arguments in this group but can be set in other ways. To set the project attribute: ◆ provide the argument --repository on the command line with a fully @@ -32,9 +85,7 @@ FLAGS ◆ set the property core/project. --location=LOCATION - Location of the repository. Overrides the default artifacts/location - property value for this command invocation. To configure the default - location, use the command: gcloud config set artifacts/location. + Location of the repository. To set the location attribute: ▸ provide the argument --repository on the command line with a @@ -86,10 +137,6 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. -API REFERENCE - This command uses the artifactregistry/v1 API. The full documentation for - this API can be found at: https://cloud.google.com/artifacts/docs/ - NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct diff --git a/gcloud/alpha/artifacts/repositories/list b/gcloud/alpha/artifacts/repositories/list index 5da6c38eb..aa72e2aeb 100644 --- a/gcloud/alpha/artifacts/repositories/list +++ b/gcloud/alpha/artifacts/repositories/list @@ -18,6 +18,57 @@ EXAMPLES $ gcloud alpha artifacts repositories list --limit=5 + To list repositories with name as `my_repo`: + + $ gcloud alpha artifacts repositories list \ + --filter='name="projects/my-project/locations/us/repositories/my\ + _repo"' + + To list repositories with a given partial name, use `*` to match any character in name: + + $ gcloud alpha artifacts repositories list \ + --filter='name="projects/my-project/locations/us/repositories/*r\ + epo"' + + $ gcloud alpha artifacts repositories list \ + --filter='name="projects/my-project/locations/us/repositories/my\ + _*"' + + To list files that have annotations: + + $ gcloud alpha artifacts repositories list --filter=annotations:* + + To list repositories with annotations pair as [annotation_key: annotation_value] + + $ gcloud alpha artifacts repositories list \ + --filter='annotations.annotation_key:annotation_value' + + To list repositories with annotations containing key as `my_key`: + + $ gcloud alpha artifacts repositories list \ + --filter='annotations.my_key' + + If the key or value contains special characters, such as `my.key` or `my.value`, backtick("`") is required: + + $ gcloud alpha artifacts repositories list \ + --filter='annotations.`my.key`' + + $ gcloud alpha artifacts repositories list \ + --filter='annotations.`my.key`:`my.value`' + + To list repositories with given partial annotation key or value, use `*` to match any character: + + $ gcloud alpha artifacts repositories list \ + --filter='annotations.*key:`*.value`' + + To list repositories ordered by create_time: + + $ gcloud alpha artifacts repositories list --sort-by=create_time + + To list repositories ordered by update_time reversely: + + $ gcloud alpha artifacts repositories list--sort-by=~update_time + FLAGS Location resource - The Artifact Registry repository location. You can also set --location=all to list repositories across all locations. If you diff --git a/gcloud/alpha/artifacts/tags/list b/gcloud/alpha/artifacts/tags/list index 8506cb22b..6919fb73c 100644 --- a/gcloud/alpha/artifacts/tags/list +++ b/gcloud/alpha/artifacts/tags/list @@ -2,10 +2,10 @@ NAME gcloud alpha artifacts tags list - list Artifact Registry tags SYNOPSIS - gcloud alpha artifacts tags list - (--package=PACKAGE : --location=LOCATION --repository=REPOSITORY) - [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] - [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + gcloud alpha artifacts tags list --package=PACKAGE + [--location=LOCATION --repository=REPOSITORY] [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) List all Artifact Registry tags in the specified package. @@ -27,49 +27,57 @@ EXAMPLES $ gcloud alpha artifacts tags list --package=my-package --limit=5 + To list tags of package my-package with name as my-tag: + + $ gcloud alpha artifacts tags list --package=my-package \ + --filter='name="projects/my-project/locations/us/repositories/my\ + -repo/packages/my-package/tags/my-tag"' + + To list tags of package my-package with a given partial name, use * to + match any character in name: + + $ gcloud alpha artifacts tags list --package=my-package \ + --filter='name="projects/my-project/locations/us/repositories/my\ + -repo/packages/my-package/tags/my*"' + + $ gcloud alpha artifacts tags list --package=my-package \ + --filter='name="projects/my-project/locations/us/repositories/my\ + -repo/packages/my-package/tags/*tag"' + REQUIRED FLAGS - Package resource - The parent package for the list of tags. 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. + --package=PACKAGE + List all tags in a specified artifact, such as a container image or a + language package. + +FLAGS + Repository resource - The Artifact Registry repository. If not specified, + the current artifacts/repository is used. The arguments in this group can + be used to specify the attributes of this resource. (NOTE) Some attributes + are not given arguments in this group but can be set in other ways. To set the project attribute: - ◆ provide the argument --package on the command line with a fully + ◆ provide the argument --repository on the command line with a fully specified name; + ◆ set the property artifacts/repository with a fully specified name; ◆ provide the argument --project on the command line; ◆ set the property core/project. - This must be specified. - - --package=PACKAGE - ID of the package or fully qualified identifier for the package. - - To set the package attribute: - ▸ provide the argument --package on the command line. - - This flag argument must be specified if any of the other arguments in - this group are specified. - --location=LOCATION - Location of the package. Overrides the default artifacts/location - property value for this command invocation. To configure the default - location, use the command: gcloud config set artifacts/location. + Location of the repository. To set the location attribute: - ▸ provide the argument --package on the command line with a fully - specified name; + ▸ provide the argument --repository on the command line with a + fully specified name; + ▸ set the property artifacts/repository with a fully specified + name; ▸ provide the argument --location on the command line; ▸ set the property artifacts/location. --repository=REPOSITORY - The repository associated with the package. Overrides the default - artifacts/repository property value for this command invocation. To - configure the default repository, use the command: gcloud config set - artifacts/repository. + ID of the repository or fully qualified identifier for the + repository. To set the repository attribute: - ▸ provide the argument --package on the command line with a fully - specified name; ▸ provide the argument --repository on the command line; ▸ set the property artifacts/repository. @@ -107,10 +115,6 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. -API REFERENCE - This command uses the artifactregistry/v1 API. The full documentation for - this API can be found at: https://cloud.google.com/artifacts/docs/ - NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct diff --git a/gcloud/alpha/artifacts/versions/list b/gcloud/alpha/artifacts/versions/list index c630fa4d9..68dbd48e5 100644 --- a/gcloud/alpha/artifacts/versions/list +++ b/gcloud/alpha/artifacts/versions/list @@ -3,72 +3,113 @@ NAME versions SYNOPSIS - gcloud alpha artifacts versions list - (--package=PACKAGE : --location=LOCATION --repository=REPOSITORY) - [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] - [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + gcloud alpha artifacts versions list --package=PACKAGE + [--location=LOCATION --repository=REPOSITORY] [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) List all Artifact Registry package versions in the specified - package. + (ALPHA) List all Artifact Registry versions in the specified package. To specify the maximum number of versions to list, use the --limit flag. EXAMPLES - The following command lists a maximum of five versions: + The following command lists a maximum of five packages versions: $ gcloud alpha artifacts versions list --limit=5 - The following command lists versions in my-package by specifying the - fully-qualified path: + To list versions of package my_pkg with name as 1.0-SNAPSHOT: + + $ gcloud alpha artifacts versions list --package=my_pkg \ + --filter='name="projects/my-project/locations/us/repositories/my\ + -repo/packages/my_pkg/versions/1.0-SNAPSHOT"' + + To list versions of package my_pkg with a given partial name, use * to + match any character in name: + + $ gcloud alpha artifacts versions list --package=my_pkg \ + --filter='name="projects/my-project/locations/us/repositories/my\ + -repo/packages/my_pkg/versions/1.0*"' + + $ gcloud alpha artifacts versions list --package=my_pkg \ + --filter='name="projects/my-project/locations/us/repositories/my\ + -repo/packages/my_pkg/versions/*SNAPSHOT"' + + To list versions of package my_pkg that have annotations: + + $ gcloud alpha artifacts versions list --package=my_pkg \ + --filter=annotations:* + + To list versions of package my_pkg with annotations pair as + [annotation_key: annotation_value]: + + $ gcloud alpha artifacts versions list --package=my_pkg \ + --filter='annotations.annotation_key:annotation_value' + + To list versions of package my_pkg with annotations containing key as + my_key: + + $ gcloud alpha artifacts versions list --package=my_pkg \ + --filter=annotations.my_key + + If the key or value contains special characters, such as `my.key` and `my.value`, backtick("`") is required: $ gcloud alpha artifacts versions list \ - --package=projects/my-project/locations/my-location/\ - repositories/my-repo/packages/my-package + --filter='annotations.`my.key`' + + $ gcloud alpha artifacts versions list \ + --filter='annotations.`my.key`:`my.value`' + + To list versions of package my_pkg with given partial annotation key or + value, use * to match any character: + + $ gcloud alpha artifacts versions list \ + --filter='annotations.*key:`*.value`' + + To list versions of package my_pkg ordered by create_time: + + $ gcloud alpha artifacts versions list --package=my_pkg \ + --sort-by=create_time + + To list versions of package my_pkg ordered by update_time reversely: + + $ gcloud alpha artifacts versions list --package=my_pkg \ + --sort-by=~update_time REQUIRED FLAGS - Package resource - The parent package for the list of versions. 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. + --package=PACKAGE + List all versions in a specified artifact, such as a container image or + a language package. + +FLAGS + Repository resource - The Artifact Registry repository. If not specified, + the current artifacts/repository is used. The arguments in this group can + be used to specify the attributes of this resource. (NOTE) Some attributes + are not given arguments in this group but can be set in other ways. To set the project attribute: - ◆ provide the argument --package on the command line with a fully + ◆ provide the argument --repository on the command line with a fully specified name; + ◆ set the property artifacts/repository with a fully specified name; ◆ provide the argument --project on the command line; ◆ set the property core/project. - This must be specified. - - --package=PACKAGE - ID of the package or fully qualified identifier for the package. - - To set the package attribute: - ▸ provide the argument --package on the command line. - - This flag argument must be specified if any of the other arguments in - this group are specified. - --location=LOCATION - Location of the package. Overrides the default artifacts/location - property value for this command invocation. To configure the default - location, use the command: gcloud config set artifacts/location. + Location of the repository. To set the location attribute: - ▸ provide the argument --package on the command line with a fully - specified name; + ▸ provide the argument --repository on the command line with a + fully specified name; + ▸ set the property artifacts/repository with a fully specified + name; ▸ provide the argument --location on the command line; ▸ set the property artifacts/location. --repository=REPOSITORY - The repository associated with the package. Overrides the default - artifacts/repository property value for this command invocation. To - configure the default repository, use the command: gcloud config set - artifacts/repository. + ID of the repository or fully qualified identifier for the + repository. To set the repository attribute: - ▸ provide the argument --package on the command line with a fully - specified name; ▸ provide the argument --repository on the command line; ▸ set the property artifacts/repository. @@ -106,10 +147,6 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. -API REFERENCE - This command uses the artifactregistry/v1 API. The full documentation for - this API can be found at: https://cloud.google.com/artifacts/docs/ - NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct diff --git a/gcloud/alpha/assured/workloads/create b/gcloud/alpha/assured/workloads/create index 39fcf8c66..04bcab9f9 100644 --- a/gcloud/alpha/assured/workloads/create +++ b/gcloud/alpha/assured/workloads/create @@ -85,9 +85,13 @@ REQUIRED FLAGS --compliance-regime=COMPLIANCE_REGIME The compliance regime of the new Assured Workloads environment. - COMPLIANCE_REGIME must be one of: CJIS, FEDRAMP_HIGH, FEDRAMP_MODERATE, - IL4, US_REGIONAL_ACCESS, HIPAA, HITRUST, EU_REGIONS_AND_SUPPORT, - CA_REGIONS_AND_SUPPORT, ITAR, ASSURED_WORKLOADS_FOR_PARTNERS. + COMPLIANCE_REGIME must be one of: assured-workloads-for-partners, + au-regions-and-us-support, ca-protected-b, ca-regions-and-support, + cjis, eu-regions-and-support, fedramp-high, fedramp-moderate, hipaa, + hitrust, il2, il4, il5, isr-regions, isr-regions-and-support, itar, + jp-regions-and-support, + ksa-regions-and-support-with-sovereignty-controls, regional-controls, + us-regional-access. --display-name=DISPLAY_NAME The display name of the new Assured Workloads environment @@ -119,9 +123,10 @@ OPTIONAL FLAGS --partner=PARTNER The partner choice when creating a workload managed by local trusted - partners. PARTNER must be one of: LOCAL_CONTROLS_BY_S3NS, - SOVEREIGN_CONTROLS_BY_T_SYSTEMS, SOVEREIGN_CONTROLS_BY_CNTXT, - SOVEREIGN_CONTROLS_BY_CNTXT_NO_EKM. + partners. PARTNER must be one of: local-controls-by-s3ns, + sovereign-controls-by-cntxt, sovereign-controls-by-cntxt-no-ekm, + sovereign-controls-by-psn, sovereign-controls-by-sia-minsait, + sovereign-controls-by-t-systems. --partner-permissions=[KEY=VALUE,...] The partner permissions for the partner regime, for example, diff --git a/gcloud/alpha/backup-dr/backup-vaults/delete b/gcloud/alpha/backup-dr/backup-vaults/delete index eff51a879..6d1324c3c 100644 --- a/gcloud/alpha/backup-dr/backup-vaults/delete +++ b/gcloud/alpha/backup-dr/backup-vaults/delete @@ -68,8 +68,7 @@ FLAGS If set, the following restrictions against deletion of the backup vault instance can be overridden: * deletion of a backup vault instance containing no backups,but still contains empty datasources. * deletion - of a backup vault instance containing no backups,but still contains - empty datasources. + of a backup vault instance being actively referenced by a backup plan. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/blockchain-validator/blockchain-validator-configs/create b/gcloud/alpha/blockchain-validator/blockchain-validator-configs/create index 23efc32a6..b09b37a80 100644 --- a/gcloud/alpha/blockchain-validator/blockchain-validator-configs/create +++ b/gcloud/alpha/blockchain-validator/blockchain-validator-configs/create @@ -5,9 +5,9 @@ NAME SYNOPSIS gcloud alpha blockchain-validator blockchain-validator-configs create BLOCKCHAIN_VALIDATOR_CONFIG --blockchain-type=BLOCKCHAIN_TYPE - --key-source=KEY_SOURCE --validation-work-enabled [--async] + --key-source=KEY_SOURCE --[no-]validation-work-enabled [--async] [--blockchain-node-id=BLOCKCHAIN_NODE_ID] [--labels=[LABELS,...]] - [--location=LOCATION] + [--location=LOCATION] [--request-id=REQUEST_ID] [--ethereum-protocol-details-gas-limit=ETHEREUM_PROTOCOL_DETAILS_GAS_LIMIT --ethereum-protocol-details-graffiti=ETHEREUM_PROTOCOL_DETAILS_GRAFFITI --ethereum-protocol-details-suggested-fee-recipient=ETHEREUM_PROTOCOL_DETAILS_SUGGESTED_FEE_RECIPIENT --ethereum-protocol-details-use-block-builder-proposals] [[--existing-seed-phrase-reference-secret=EXISTING_SEED_PHRASE_REFERENCE_SECRET : --existing-seed-phrase-reference-derivation-index=EXISTING_SEED_PHRASE_REFERENCE_DERIVATION_INDEX] | [--remote-web3-signer-voting-public-key=REMOTE_WEB3_SIGNER_VOTING_PUBLIC_KEY --remote-web3-signer-web3signer-uri=REMOTE_WEB3_SIGNER_WEB3SIGNER_URI : --remote-web3-signer-timeout-duration=REMOTE_WEB3_SIGNER_TIMEOUT_DURATION] | [--seed-phrase-reference-secret=SEED_PHRASE_REFERENCE_SECRET : --seed-phrase-reference-export]] [GCLOUD_WIDE_FLAG ...] @@ -79,14 +79,15 @@ REQUIRED FLAGS seed-phrase-reference Derive voting keys from new seed material. - --validation-work-enabled + --[no-]validation-work-enabled True if the blockchain node requests and signs attestations and blocks on behalf of this validator, false if not. This does NOT define whether the blockchain expects work to occur, only whether the blockchain node specified above is carrying out validation tasks. This should be enabled under normal conditions, but may be useful when migrating validators to/from Blockchain Node Engine, where the validator may be - paused during the migration. + paused during the migration. Use --validation-work-enabled to enable + and --no-validation-work-enabled to disable. OPTIONAL FLAGS --async @@ -130,6 +131,21 @@ OPTIONAL FLAGS value for resource location attribute. When the resource's full URI path is not provided, location will fallback to this flag value. + --request-id=REQUEST_ID + An optional request ID to identify requests. Specify a unique request + ID so that if you must retry your request, the server will know to + ignore the request if it has already been completed. The server will + guarantee that for at least 60 minutes since the first request. + + For example, consider a situation where you make an initial request and + the request times out. If you make the request again with the same + request ID, the server can check if original operation with the same + request ID was received, and if so, will ignore the second request. + This prevents clients from accidentally creating duplicate commitments. + + The request ID must be a valid UUID with the exception that zero UUID + is not supported (00000000-0000-0000-0000-000000000000). + Arguments for the blockchain type details. Blockchain validator configuration unique to Ethereum blockchains. diff --git a/gcloud/alpha/blockchain-validator/blockchain-validator-configs/update b/gcloud/alpha/blockchain-validator/blockchain-validator-configs/update index ee0bcf2a8..1330948a9 100644 --- a/gcloud/alpha/blockchain-validator/blockchain-validator-configs/update +++ b/gcloud/alpha/blockchain-validator/blockchain-validator-configs/update @@ -7,7 +7,7 @@ SYNOPSIS (BLOCKCHAIN_VALIDATOR_CONFIG : --location=LOCATION) [--async] [--blockchain-node-id=BLOCKCHAIN_NODE_ID] [--ethereum-protocol-details-graffiti=ETHEREUM_PROTOCOL_DETAILS_GRAFFITI] - [--validation-work-enabled] + [--request-id=REQUEST_ID] [--[no-]validation-work-enabled] [--labels=[LABELS,...] | --update-labels=[UPDATE_LABELS,...] --clear-labels | --remove-labels=[__REMOVE_LABELS,...]] @@ -89,14 +89,30 @@ FLAGS default is used. If no blockchain node is specified, this has no effect as no validator client is run. - --validation-work-enabled + --request-id=REQUEST_ID + An optional request ID to identify requests. Specify a unique request + ID so that if you must retry your request, the server will know to + ignore the request if it has already been completed. The server will + guarantee that for at least 60 minutes since the first request. + + For example, consider a situation where you make an initial request and + the request times out. If you make the request again with the same + request ID, the server can check if original operation with the same + request ID was received, and if so, will ignore the second request. + This prevents clients from accidentally creating duplicate commitments. + + The request ID must be a valid UUID with the exception that zero UUID + is not supported (00000000-0000-0000-0000-000000000000). + + --[no-]validation-work-enabled True if the blockchain node requests and signs attestations and blocks on behalf of this validator, false if not. This does NOT define whether the blockchain expects work to occur, only whether the blockchain node specified above is carrying out validation tasks. This should be enabled under normal conditions, but may be useful when migrating validators to/from Blockchain Node Engine, where the validator may be - paused during the migration. + paused during the migration. Use --validation-work-enabled to enable + and --no-validation-work-enabled to disable. Update labels. diff --git a/gcloud/alpha/compute/instance-templates/create b/gcloud/alpha/compute/instance-templates/create index 2665fe0a4..cada99b49 100644 --- a/gcloud/alpha/compute/instance-templates/create +++ b/gcloud/alpha/compute/instance-templates/create @@ -998,7 +998,12 @@ FLAGS https://cloud.google.com/compute/docs/instances/configuring-simultaneous-multithreading. --turbo-mode=TURBO_MODE - Specifies the turbo frequency of the instance. + Turbo mode to use for the instance. Supported modes include: + ◆ ALL_CORE_MAX + + To achieve all-core-turbo frequency for more consistent CPU + performance, set the field to ALL_CORE_MAX. The field is unset by + default, which results in maximum performance single-core boosting. --visible-core-count=VISIBLE_CORE_COUNT The number of physical cores to expose to the instance's guest diff --git a/gcloud/alpha/compute/instances/bulk/create b/gcloud/alpha/compute/instances/bulk/create index 661c53324..0db886919 100644 --- a/gcloud/alpha/compute/instances/bulk/create +++ b/gcloud/alpha/compute/instances/bulk/create @@ -882,7 +882,12 @@ OPTIONAL FLAGS https://cloud.google.com/compute/docs/instances/configuring-simultaneous-multithreading. --turbo-mode=TURBO_MODE - Specifies the turbo frequency of the instance. + Turbo mode to use for the instance. Supported modes include: + ◆ ALL_CORE_MAX + + To achieve all-core-turbo frequency for more consistent CPU + performance, set the field to ALL_CORE_MAX. The field is unset by + default, which results in maximum performance single-core boosting. --visible-core-count=VISIBLE_CORE_COUNT The number of physical cores to expose to the instance's guest diff --git a/gcloud/alpha/compute/instances/create b/gcloud/alpha/compute/instances/create index 350a1cda7..c23de26b9 100644 --- a/gcloud/alpha/compute/instances/create +++ b/gcloud/alpha/compute/instances/create @@ -1019,7 +1019,12 @@ FLAGS https://cloud.google.com/compute/docs/instances/configuring-simultaneous-multithreading. --turbo-mode=TURBO_MODE - Specifies the turbo frequency of the instance. + Turbo mode to use for the instance. Supported modes include: + ◆ ALL_CORE_MAX + + To achieve all-core-turbo frequency for more consistent CPU + performance, set the field to ALL_CORE_MAX. The field is unset by + default, which results in maximum performance single-core boosting. --visible-core-count=VISIBLE_CORE_COUNT The number of physical cores to expose to the instance's guest diff --git a/gcloud/alpha/compute/network-endpoint-groups/create b/gcloud/alpha/compute/network-endpoint-groups/create index 4fb91ffc7..049c07820 100644 --- a/gcloud/alpha/compute/network-endpoint-groups/create +++ b/gcloud/alpha/compute/network-endpoint-groups/create @@ -123,12 +123,12 @@ FLAGS serverless, gce-vm-ip, private-service-connect, gce-vm-ip-portmap. --producer-port=PRODUCER_PORT - The psc producer port to use when consumer PSC NEG connects to a - producer. - - If this flag isn't specified for a PSC NEG with endpoint type - private-service-connect, then PSC NEG will be connected to a first port - in the available pcs producer port range. + The producer port to use when a consumer PSC NEG connects to a + producer's internal network load balancer. If this flag isn't specified + for a NEG with endpoint type private-service-connect, the PSC NEG will + connect to port 443 or the first available port in the PSC producer + port range, or to port 1 if the PSC producer's forwarding rule ports + flag is set to all-ports. This flag is not supported for NEGs with endpoint type other than private-service-connect. diff --git a/gcloud/alpha/compute/queued-resources/create b/gcloud/alpha/compute/queued-resources/create index af8603015..267fb8f10 100644 --- a/gcloud/alpha/compute/queued-resources/create +++ b/gcloud/alpha/compute/queued-resources/create @@ -855,7 +855,12 @@ OPTIONAL FLAGS https://cloud.google.com/compute/docs/instances/configuring-simultaneous-multithreading. --turbo-mode=TURBO_MODE - Specifies the turbo frequency of the instance. + Turbo mode to use for the instance. Supported modes include: + ◆ ALL_CORE_MAX + + To achieve all-core-turbo frequency for more consistent CPU + performance, set the field to ALL_CORE_MAX. The field is unset by + default, which results in maximum performance single-core boosting. --visible-core-count=VISIBLE_CORE_COUNT The number of physical cores to expose to the instance's guest diff --git a/gcloud/alpha/compute/security-policies/import b/gcloud/alpha/compute/security-policies/import index cb6bb519c..aaa2f6617 100644 --- a/gcloud/alpha/compute/security-policies/import +++ b/gcloud/alpha/compute/security-policies/import @@ -9,9 +9,8 @@ SYNOPSIS DESCRIPTION (ALPHA) gcloud alpha compute security-policies import imports a security - policy to update an existing policy. The command does not support updating - rules for the policy. To create a new policy from a file please use the - create command instead. + policy to update an existing policy. To create a new policy from a file + please use the create command instead. EXAMPLES To import a security policy from a YAML file run this: diff --git a/gcloud/alpha/compute/snapshots/describe b/gcloud/alpha/compute/snapshots/describe index b01bea36f..c6b457e06 100644 --- a/gcloud/alpha/compute/snapshots/describe +++ b/gcloud/alpha/compute/snapshots/describe @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud alpha compute snapshots describe SNAPSHOT_NAME - [GCLOUD_WIDE_FLAG ...] + [--global | --region=REGION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) gcloud alpha compute snapshots describe displays all data @@ -42,6 +42,16 @@ POSITIONAL ARGUMENTS SNAPSHOT_NAME Name of the snapshot to describe. +FLAGS + At most one of these can be specified: + + --global + If set, the snapshot is global. + + --region=REGION + Region of the snapshot to describe. Overrides the default + compute/region property value for this command invocation. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/container/attached/clusters/register b/gcloud/alpha/container/attached/clusters/register index 6f066540b..edeb3dda1 100644 --- a/gcloud/alpha/container/attached/clusters/register +++ b/gcloud/alpha/container/attached/clusters/register @@ -12,7 +12,8 @@ SYNOPSIS [--annotations=ANNOTATION,[ANNOTATION,...]] [--binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE] [--description=DESCRIPTION] [--enable-managed-prometheus] - [--logging=COMPONENT,[COMPONENT,...]] [--validate-only] + [--logging=COMPONENT,[COMPONENT,...]] + [--security-posture=SECURITY_POSTURE] [--validate-only] [--proxy-secret-name=PROXY_SECRET_NAME --proxy-secret-namespace=PROXY_SECRET_NAMESPACE] [GCLOUD_WIDE_FLAG ...] @@ -180,6 +181,18 @@ OPTIONAL FLAGS COMPONENT must be one of: NONE, SYSTEM, WORKLOAD. + --security-posture=SECURITY_POSTURE + Sets the mode of the Kubernetes security posture API's off-cluster + features. + + To enable advanced mode explicitly set the flag to + --security-posture=enterprise. + + To disable in an existing cluster, explicitly set the flag to + --security-posture=disabled. + + SECURITY_POSTURE must be one of: disabled, enterprise. + --validate-only Validate the cluster to create, but don't actually perform it. diff --git a/gcloud/alpha/container/attached/clusters/update b/gcloud/alpha/container/attached/clusters/update index c9d3205e6..3627ecf35 100644 --- a/gcloud/alpha/container/attached/clusters/update +++ b/gcloud/alpha/container/attached/clusters/update @@ -9,7 +9,8 @@ SYNOPSIS [--binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE] [--clear-description] [--description=DESCRIPTION] [--logging=COMPONENT,[COMPONENT,...]] - [--platform-version=PLATFORM_VERSION] [--validate-only] + [--platform-version=PLATFORM_VERSION] + [--security-posture=SECURITY_POSTURE] [--validate-only] [--admin-groups=[GROUP,...] | --clear-admin-groups] [--admin-users=[USER,...] | --clear-admin-users] [--disable-managed-prometheus | --enable-managed-prometheus] @@ -98,6 +99,18 @@ FLAGS Replace LOCATION with the target Google Cloud location for the cluster. + --security-posture=SECURITY_POSTURE + Sets the mode of the Kubernetes security posture API's off-cluster + features. + + To enable advanced mode explicitly set the flag to + --security-posture=enterprise. + + To disable in an existing cluster, explicitly set the flag to + --security-posture=disabled. + + SECURITY_POSTURE must be one of: disabled, enterprise. + --validate-only Validate the update of the cluster, but don't actually perform it. diff --git a/gcloud/alpha/container/backup-restore/restore-plans/create b/gcloud/alpha/container/backup-restore/restore-plans/create index 442745811..af779fa2e 100644 --- a/gcloud/alpha/container/backup-restore/restore-plans/create +++ b/gcloud/alpha/container/backup-restore/restore-plans/create @@ -37,7 +37,8 @@ EXAMPLES --cluster=projects/my-project/locations/us-central1/clusters/\ my-cluster \ --backup-plan=projects/my-project/locations/us-central1/\ - backupPlans/my-backup-plan --all-namespaces + backupPlans/my-backup-plan --all-namespaces \ + --namespaced-resource-restore-mode=merge-skip-on-conflict POSITIONAL ARGUMENTS Restore plan resource - Name of the restore plan to create. Once the plan diff --git a/gcloud/alpha/container/clusters/update b/gcloud/alpha/container/clusters/update index 5e652c1e7..085b6bec9 100644 --- a/gcloud/alpha/container/clusters/update +++ b/gcloud/alpha/container/clusters/update @@ -51,6 +51,9 @@ SYNOPSIS | --additional-pod-ipv4-ranges=NAME,[NAME,...] --remove-additional-pod-ipv4-ranges=NAME,[NAME,...] | --additional-zones=[ZONE,...] | --node-locations=ZONE,[ZONE,...] + | --logging=[COMPONENT,...] + --monitoring=[COMPONENT,...] --disable-managed-prometheus + | --enable-managed-prometheus | --binauthz-policy-bindings=[name=BINAUTHZ_POLICY, enforcement-mode=ENFORCEMENT_MODE,...] --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE @@ -95,9 +98,7 @@ SYNOPSIS | --enable-insecure-binding-system-authenticated --enable-insecure-binding-system-unauthenticated | --enable-tpu --enable-tpu-service-networking | --tpu-ipv4-cidr=CIDR - | --logging=[COMPONENT,...] - --monitoring=[COMPONENT,...] --disable-managed-prometheus - | --enable-managed-prometheus | --logging-service=LOGGING_SERVICE + | --logging-service=LOGGING_SERVICE --monitoring-service=MONITORING_SERVICE | --password=PASSWORD --enable-basic-auth | --username=USERNAME, -u USERNAME) [--async] @@ -855,6 +856,52 @@ REQUIRED FLAGS --location us-central1-a \ --node-locations us-central1-a,us-central1-b + --logging=[COMPONENT,...] + Set the components that have logging enabled. Valid component values + are: SYSTEM, WORKLOAD, API_SERVER, CONTROLLER_MANAGER, SCHEDULER, + NONE + + For more information, see + https://cloud.google.com/kubernetes-engine/docs/concepts/about-logs#available-logs + + Examples: + + $ gcloud alpha container clusters update --logging=SYSTEM + $ gcloud alpha container clusters update \ + --logging=SYSTEM,API_SERVER,WORKLOAD + $ gcloud alpha container clusters update --logging=NONE + + --monitoring=[COMPONENT,...] + Set the components that have monitoring enabled. Valid component + values are: SYSTEM, WORKLOAD (Deprecated), NONE, API_SERVER, + CONTROLLER_MANAGER, SCHEDULER, DAEMONSET, DEPLOYMENT, HPA, POD, + STATEFULSET, STORAGE, CADVISOR, KUBELET, DCGM + + For more information, see + https://cloud.google.com/kubernetes-engine/docs/how-to/configure-metrics#available-metrics + + Examples: + + $ gcloud alpha container clusters update \ + --monitoring=SYSTEM,API_SERVER,POD + $ gcloud alpha container clusters update --monitoring=NONE + + At most one of these can be specified: + + --disable-managed-prometheus + Disable managed collection for Managed Service for Prometheus. + + --enable-managed-prometheus + Enables managed collection for Managed Service for Prometheus in + the cluster. + + See + https://cloud.google.com/stackdriver/docs/managed-prometheus/setup-managed#enable-mgdcoll-gke + for more info. + + Enabled by default for cluster versions 1.27 or greater, use + --no-enable-managed-prometheus to disable. + Flags for Binary Authorization: --binauthz-policy-bindings=[name=BINAUTHZ_POLICY,enforcement-mode=ENFORCEMENT_MODE,...] @@ -1391,52 +1438,6 @@ REQUIRED FLAGS Can not be specified unless '--enable-tpu' and '--enable-ip-alias' are also specified. - --logging=[COMPONENT,...] - Set the components that have logging enabled. Valid component values - are: SYSTEM, WORKLOAD, API_SERVER, CONTROLLER_MANAGER, SCHEDULER, - NONE - - For more information, see - https://cloud.google.com/kubernetes-engine/docs/concepts/about-logs#available-logs - - Examples: - - $ gcloud alpha container clusters update --logging=SYSTEM - $ gcloud alpha container clusters update \ - --logging=SYSTEM,API_SERVER,WORKLOAD - $ gcloud alpha container clusters update --logging=NONE - - --monitoring=[COMPONENT,...] - Set the components that have monitoring enabled. Valid component - values are: SYSTEM, WORKLOAD (Deprecated), NONE, API_SERVER, - CONTROLLER_MANAGER, SCHEDULER, DAEMONSET, DEPLOYMENT, HPA, POD, - STATEFULSET, STORAGE, CADVISOR, KUBELET, DCGM - - For more information, see - https://cloud.google.com/kubernetes-engine/docs/how-to/configure-metrics#available-metrics - - Examples: - - $ gcloud alpha container clusters update \ - --monitoring=SYSTEM,API_SERVER,POD - $ gcloud alpha container clusters update --monitoring=NONE - - At most one of these can be specified: - - --disable-managed-prometheus - Disable managed collection for Managed Service for Prometheus. - - --enable-managed-prometheus - Enables managed collection for Managed Service for Prometheus in - the cluster. - - See - https://cloud.google.com/stackdriver/docs/managed-prometheus/setup-managed#enable-mgdcoll-gke - for more info. - - Enabled by default for cluster versions 1.27 or greater, use - --no-enable-managed-prometheus to disable. - --logging-service=LOGGING_SERVICE (DEPRECATED) Logging service to use for the cluster. Options are: "logging.googleapis.com/kubernetes" (the Google Cloud Logging service diff --git a/gcloud/alpha/container/node-pools/update b/gcloud/alpha/container/node-pools/update index ff8aa5291..67c89e181 100644 --- a/gcloud/alpha/container/node-pools/update +++ b/gcloud/alpha/container/node-pools/update @@ -4,7 +4,12 @@ NAME SYNOPSIS gcloud alpha container node-pools update NAME - (--containerd-config-from-file=PATH_TO_FILE + (--accelerator=[type=TYPE,[count=COUNT, + gpu-driver-version=GPU_DRIVER_VERSION, + gpu-partition-size=GPU_PARTITION_SIZE, + gpu-sharing-strategy=GPU_SHARING_STRATEGY, + max-shared-clients-per-gpu=MAX_SHARED_CLIENTS_PER_GPU],...] + | --containerd-config-from-file=PATH_TO_FILE | --enable-confidential-nodes | --enable-gvnic | --enable-image-streaming | --enable-insecure-kubelet-readonly-port | --enable-private-nodes | --enable-queued-provisioning @@ -51,6 +56,49 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS Exactly one of these must be specified: + --accelerator=[type=TYPE,[count=COUNT,gpu-driver-version=GPU_DRIVER_VERSION,gpu-partition-size=GPU_PARTITION_SIZE,gpu-sharing-strategy=GPU_SHARING_STRATEGY,max-shared-clients-per-gpu=MAX_SHARED_CLIENTS_PER_GPU],...] + Attaches accelerators (e.g. GPUs) to all nodes. + + type + (Required) The specific type (e.g. nvidia-tesla-t4 for NVIDIA T4) + of accelerator to attach to the instances. Use gcloud compute + accelerator-types list to learn about all available accelerator + types. + + count + (Optional) The number of accelerators to attach to the instances. + The default value is 1. + + gpu-driver-version + (Optional) The NVIDIA driver version to install. + GPU_DRIVER_VERSION must be one of: + + `default`: Install the default driver version for this GKE version. + + `latest`: Install the latest driver version available for this GKE version. + Can only be used for nodes that use Container-Optimized OS. + + `disabled`: Skip automatic driver installation. You must manually install a + driver after you create the cluster. If you omit the flag `gpu-driver-version`, + this is the default option. To learn how to manually install the GPU driver, + refer to: https://cloud.google.com/kubernetes-engine/docs/how-to/gpus#installing_drivers + + gpu-partition-size + (Optional) The GPU partition size used when running + multi-instance GPUs. For information about multi-instance GPUs, + refer to: + https://cloud.google.com/kubernetes-engine/docs/how-to/gpus-multi + + gpu-sharing-strategy + (Optional) The GPU sharing strategy (e.g. time-sharing) to use. + For information about GPU sharing, refer to: + https://cloud.google.com/kubernetes-engine/docs/concepts/timesharing-gpus + + max-shared-clients-per-gpu + (Optional) The max number of containers allowed to share each GPU + on the node. This field is used together with + gpu-sharing-strategy. + --containerd-config-from-file=PATH_TO_FILE Path of the YAML file that contains containerd configuration entries like configuring access to private image registries. diff --git a/gcloud/alpha/developer-connect/connections/create b/gcloud/alpha/developer-connect/connections/create index 71a978082..b63875658 100644 --- a/gcloud/alpha/developer-connect/connections/create +++ b/gcloud/alpha/developer-connect/connections/create @@ -6,8 +6,8 @@ SYNOPSIS (CONNECTION : --location=LOCATION) [--annotations=[ANNOTATIONS,...]] [--async] [--disabled] [--etag=ETAG] [--labels=[LABELS,...]] [--request-id=REQUEST_ID] [--secret=SECRET] [--validate-only] - [--github-config-app=GITHUB_CONFIG_APP - : --github-config-app-installation-id=GITHUB_CONFIG_APP_INSTALLATION_ID --github-config-authorizer-credential-oauth-token-secret-version=GITHUB_CONFIG_AUTHORIZER_CREDENTIAL_OAUTH_TOKEN_SECRET_VERSION] + [[--github-config-app=GITHUB_CONFIG_APP + : --github-config-app-installation-id=GITHUB_CONFIG_APP_INSTALLATION_ID --github-config-authorizer-credential-oauth-token-secret-version=GITHUB_CONFIG_AUTHORIZER_CREDENTIAL_OAUTH_TOKEN_SECRET_VERSION] | --gitlab-config-authorizer-credential-user-token-secret-version=GITLAB_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-config-read-authorizer-credential-user-token-secret-version=GITLAB_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-config-webhook-secret-version=GITLAB_CONFIG_WEBHOOK_SECRET_VERSION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -188,6 +188,105 @@ FLAGS --github-config-authorizer-credential-oauth-token-secret-version on the command line. + Configuration for connections to gitlab.com. + + Represents a personal access token that authorized the Connection, and + associated metadata. + + This must be specified. + + SecretVersion resource - A SecretManager resource containing the + user token that authorizes the Developer Connect connection. Format: + projects/*/secrets/*/versions/*. This represents a Cloud resource. + (NOTE) Some attributes are not given arguments in this group but can + be set in other ways. + + To set the project attribute: + ◇ provide the argument + --gitlab-config-authorizer-credential-user-token-secret-version + on the command line with a fully specified name; + ◇ provide the argument --project on the command line; + ◇ set the property core/project. + + To set the secret attribute: + ◇ provide the argument + --gitlab-config-authorizer-credential-user-token-secret-version + on the command line with a fully specified name; + ◇ provide the argument --secret on the command line. + + This must be specified. + + --gitlab-config-authorizer-credential-user-token-secret-version=GITLAB_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ▹ provide the argument + --gitlab-config-authorizer-credential-user-token-secret-version + on the command line. + + Represents a personal access token that authorized the Connection, and + associated metadata. + + This must be specified. + + SecretVersion resource - A SecretManager resource containing the + user token that authorizes the Developer Connect connection. Format: + projects/*/secrets/*/versions/*. This represents a Cloud resource. + (NOTE) Some attributes are not given arguments in this group but can + be set in other ways. + + To set the project attribute: + ◇ provide the argument + --gitlab-config-read-authorizer-credential-user-token-secret-version + on the command line with a fully specified name; + ◇ provide the argument --project on the command line; + ◇ set the property core/project. + + To set the secret attribute: + ◇ provide the argument + --gitlab-config-read-authorizer-credential-user-token-secret-version + on the command line with a fully specified name; + ◇ provide the argument --secret on the command line. + + This must be specified. + + --gitlab-config-read-authorizer-credential-user-token-secret-version=GITLAB_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ▹ provide the argument + --gitlab-config-read-authorizer-credential-user-token-secret-version + on the command line. + + SecretVersion resource - SecretManager resource containing the webhook + secret of a GitLab project, formatted as + projects/*/secrets/*/versions/*. This is used to validate webhooks. + This represents a Cloud resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ▫ provide the argument --gitlab-config-webhook-secret-version on + the command line with a fully specified name; + ▫ provide the argument --project on the command line; + ▫ set the property core/project. + + To set the secret attribute: + ▫ provide the argument --gitlab-config-webhook-secret-version on + the command line with a fully specified name; + ▫ provide the argument --secret on the command line. + + This must be specified. + + --gitlab-config-webhook-secret-version=GITLAB_CONFIG_WEBHOOK_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ◇ provide the argument --gitlab-config-webhook-secret-version + on the command line. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/developer-connect/connections/update b/gcloud/alpha/developer-connect/connections/update index 79bc813fc..57aecef55 100644 --- a/gcloud/alpha/developer-connect/connections/update +++ b/gcloud/alpha/developer-connect/connections/update @@ -10,7 +10,7 @@ SYNOPSIS | --update-annotations=[UPDATE_ANNOTATIONS,...] --clear-annotations | --remove-annotations=[__REMOVE_ANNOTATIONS,...]] [--github-config-app-installation-id=GITHUB_CONFIG_APP_INSTALLATION_ID - --github-config-authorizer-credential-oauth-token-secret-version=GITHUB_CONFIG_AUTHORIZER_CREDENTIAL_OAUTH_TOKEN_SECRET_VERSION] + --github-config-authorizer-credential-oauth-token-secret-version=GITHUB_CONFIG_AUTHORIZER_CREDENTIAL_OAUTH_TOKEN_SECRET_VERSION | --gitlab-config-authorizer-credential-user-token-secret-version=GITLAB_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-config-read-authorizer-credential-user-token-secret-version=GITLAB_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION] [--labels=[LABELS,...] | --update-labels=[UPDATE_LABELS,...] --clear-labels | --remove-labels=[__REMOVE_LABELS,...]] [GCLOUD_WIDE_FLAG ...] @@ -198,6 +198,70 @@ FLAGS --github-config-authorizer-credential-oauth-token-secret-version on the command line. + Configuration for connections to gitlab.com. + + Represents a personal access token that authorized the Connection, and + associated metadata. + + SecretVersion resource - A SecretManager resource containing the + user token that authorizes the Developer Connect connection. Format: + projects/*/secrets/*/versions/*. This represents a Cloud resource. + (NOTE) Some attributes are not given arguments in this group but can + be set in other ways. + + To set the project attribute: + ◇ provide the argument + --gitlab-config-authorizer-credential-user-token-secret-version + on the command line with a fully specified name; + ◇ provide the argument --project on the command line; + ◇ set the property core/project. + + To set the secret attribute: + ◇ provide the argument + --gitlab-config-authorizer-credential-user-token-secret-version + on the command line with a fully specified name; + ◇ provide the argument --secret on the command line. + + --gitlab-config-authorizer-credential-user-token-secret-version=GITLAB_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ▹ provide the argument + --gitlab-config-authorizer-credential-user-token-secret-version + on the command line. + + Represents a personal access token that authorized the Connection, and + associated metadata. + + SecretVersion resource - A SecretManager resource containing the + user token that authorizes the Developer Connect connection. Format: + projects/*/secrets/*/versions/*. This represents a Cloud resource. + (NOTE) Some attributes are not given arguments in this group but can + be set in other ways. + + To set the project attribute: + ◇ provide the argument + --gitlab-config-read-authorizer-credential-user-token-secret-version + on the command line with a fully specified name; + ◇ provide the argument --project on the command line; + ◇ set the property core/project. + + To set the secret attribute: + ◇ provide the argument + --gitlab-config-read-authorizer-credential-user-token-secret-version + on the command line with a fully specified name; + ◇ provide the argument --secret on the command line. + + --gitlab-config-read-authorizer-credential-user-token-secret-version=GITLAB_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ▹ provide the argument + --gitlab-config-read-authorizer-credential-user-token-secret-version + on the command line. + Update labels. At most one of these can be specified: diff --git a/gcloud/alpha/edge-cloud/container/clusters/node-pools/update b/gcloud/alpha/edge-cloud/container/clusters/node-pools/update index 8629e1100..068d68be8 100644 --- a/gcloud/alpha/edge-cloud/container/clusters/node-pools/update +++ b/gcloud/alpha/edge-cloud/container/clusters/node-pools/update @@ -5,10 +5,11 @@ NAME SYNOPSIS gcloud alpha edge-cloud container clusters node-pools update (NODE_POOL : --cluster=CLUSTER --location=LOCATION) [--async] - [--lro-timeout=LRO_TIMEOUT] [--machine-filter=MACHINE_FILTER] - [--node-count=NODE_COUNT] [--node-labels=[KEY=VALUE,...]] - [--update-labels=[KEY=VALUE,...]] - [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] + [--local-disk-kms-key=LOCAL_DISK_KMS_KEY] [--lro-timeout=LRO_TIMEOUT] + [--machine-filter=MACHINE_FILTER] [--node-count=NODE_COUNT] + [--node-labels=[KEY=VALUE,...]] [--update-labels=[KEY=VALUE,...]] + [--use-google-managed-key] [--clear-labels | --remove-labels=[KEY,...]] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Updates an Edge Container node pool. @@ -65,6 +66,13 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + --local-disk-kms-key=LOCAL_DISK_KMS_KEY + Google Cloud KMS key that will be used to secure local disks on nodes + in this node pool. The Edge Container service account for this project + must have roles/cloudkms.cryptoKeyEncrypterDecrypter on the key. + + If not provided, a Google-managed key will be used instead. + --lro-timeout=LRO_TIMEOUT Overwrite the default LRO maximum timeout. @@ -89,6 +97,10 @@ FLAGS contain only hyphens (-), underscores (_), lowercase characters, and numbers. + --use-google-managed-key + Once specified, a Google-managed key will be used for the control plane + disk encryption. + At most one of these can be specified: --clear-labels diff --git a/gcloud/alpha/edge-cloud/container/clusters/update b/gcloud/alpha/edge-cloud/container/clusters/update index c1afe80b2..68e787f14 100644 --- a/gcloud/alpha/edge-cloud/container/clusters/update +++ b/gcloud/alpha/edge-cloud/container/clusters/update @@ -11,7 +11,8 @@ SYNOPSIS | --remove-maintenance-exclusion-window=REMOVE_MAINTENANCE_EXCLUSION_WINDOW | --add-maintenance-exclusion-end=ADD_MAINTENANCE_EXCLUSION_END --add-maintenance-exclusion-name=ADD_MAINTENANCE_EXCLUSION_NAME --add-maintenance-exclusion-start=ADD_MAINTENANCE_EXCLUSION_START | --maintenance-window-end=MAINTENANCE_WINDOW_END --maintenance-window-recurrence=MAINTENANCE_WINDOW_RECURRENCE --maintenance-window-start=MAINTENANCE_WINDOW_START] [--clear-max-unavailable-worker-nodes | --max-unavailable-worker-nodes=MAX_UNAVAILABLE_WORKER_NODES] - [GCLOUD_WIDE_FLAG ...] + [--control-plane-kms-key=CONTROL_PLANE_KMS_KEY + | --use-google-managed-key] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Update an Edge Container cluster. @@ -138,6 +139,16 @@ FLAGS This value does not affect the control plane node upgrade parallelism. + At most one of these can be specified: + + --control-plane-kms-key=CONTROL_PLANE_KMS_KEY + If set, use the specified KMS key for the cluster control plane nodes + encryption. + + --use-google-managed-key + If set, use Google managed key for the cluster control plane nodes + encryption. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/functions/deploy b/gcloud/alpha/functions/deploy index 030f711f1..867444eae 100644 --- a/gcloud/alpha/functions/deploy +++ b/gcloud/alpha/functions/deploy @@ -113,7 +113,7 @@ FLAGS --concurrency=CONCURRENCY Set the maximum number of concurrent requests allowed per container instance. Leave concurrency unspecified to receive the server default - value. Only applicable when the --gen2 flag is provided. + value. --docker-registry=DOCKER_REGISTRY Docker Registry to use for storing the function's Docker images. The @@ -168,8 +168,6 @@ FLAGS If not provided, the function will use the project's default service account for Compute Engine. - This is only relevant when --gen2 is provided. - --runtime=RUNTIME Runtime in which to run the function. @@ -190,8 +188,7 @@ FLAGS secure-optional. --serve-all-traffic-latest-revision - If specified, latest function revision will be served all traffic. This - is only relevant when --gen2 is provided. + If specified, latest function revision will be served all traffic. --service-account=SERVICE_ACCOUNT The email address of the IAM service account associated with the @@ -288,8 +285,7 @@ FLAGS --trigger-location=TRIGGER_LOCATION The location of the trigger, which must be a region or multi-region - where the relevant events originate. This is only relevant when --gen2 - is provided. + where the relevant events originate. --trigger-service-account=TRIGGER_SERVICE_ACCOUNT The email address of the IAM service account associated with the @@ -299,8 +295,6 @@ FLAGS If not provided, the function will use the project's default service account for Compute Engine. - This is only relevant when --gen2 is provided. - --update-labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to update. If a label exists, its value is modified. Otherwise, a new label is created. @@ -612,8 +606,8 @@ FLAGS memory limit unless you specify this flag. --cpu=CPU - The number of available CPUs to set. Only valid when --gen2 and - --memory=MEMORY are specified. + The number of available CPUs to set. Only valid when --memory=MEMORY is + specified. Examples: .5, 2, 2.0, 2000m. @@ -672,14 +666,12 @@ FLAGS The Eventarc matching criteria for the trigger. The criteria can be specified either as a single comma-separated argument or as multiple arguments. The filters must include the type attribute, as well as - any other attributes that are expected for the chosen type. This is - only relevant when --gen2 is provided. + any other attributes that are expected for the chosen type. --trigger-event-filters-path-pattern=[ATTRIBUTE=PATH_PATTERN,...] The Eventarc matching criteria for the trigger in path pattern format. The criteria can be specified as a single comma-separated - argument or as multiple arguments. This is only relevant when --gen2 - is provided. + argument or as multiple arguments. The provided attribute/value pair will be used with the match-path-pattern operator to configure the trigger, see diff --git a/gcloud/alpha/iam/help b/gcloud/alpha/iam/help index e81c1e280..1714458c3 100644 --- a/gcloud/alpha/iam/help +++ b/gcloud/alpha/iam/help @@ -17,7 +17,7 @@ DESCRIPTION More information on Cloud IAM can be found here: https://cloud.google.com/iam and detailed documentation can be found here: - https://cloud.google.com/iam/docs/ + https://cloud.google.com/iam/docs/. GCLOUD WIDE FLAGS These flags are available to all commands: --help. diff --git a/gcloud/alpha/managed-flink/deployments/create b/gcloud/alpha/managed-flink/deployments/create new file mode 100644 index 000000000..00c45a009 --- /dev/null +++ b/gcloud/alpha/managed-flink/deployments/create @@ -0,0 +1,103 @@ +NAME + gcloud alpha managed-flink deployments create - create a Managed Flink + deployment + +SYNOPSIS + gcloud alpha managed-flink deployments create + (DEPLOYMENT : --location=LOCATION) --max-slots=MAX_SLOTS [--async] + [--display-name=DISPLAY_NAME] [--secrets-path=SECRETS_PATH] + [--network-config-subnetwork=NETWORK_CONFIG_SUBNETWORK + --network-config-vpc=NETWORK_CONFIG_VPC] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create a Managed Flink deployment. + +EXAMPLES + To create a Managed Flink deployment, run: + + $ gcloud alpha managed-flink deployments create my-deployment \ + --location=us-central1 + + To create a Managed Flink deployment with all optional parameters set, run: + + $ gcloud alpha managed-flink deployments create my-deployment \ + --location=us-central1 --max-slots=100 \ + --secrets-path=projects/my-project/secrets/my-secret/versions/\ + 1 --network-config-vpc=my-vpc \ + --network-config-subnetwork=my-subnetwork + +POSITIONAL ARGUMENTS + Deployment resource - Identifies the deployment for which the command + runs. 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 deployment on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + DEPLOYMENT + ID of the deployment or fully qualified identifier for the + deployment. + + To set the deployment attribute: + ▸ provide the argument deployment on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + ID of the location of the Apache Flink for BigQuery resource. See + https://cloud.google.com/managed-flink/docs/locations for a list of + supported locations. + + To set the location attribute: + ▸ provide the argument deployment on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + --max-slots=MAX_SLOTS + max slots of the Flink deployment. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --display-name=DISPLAY_NAME + display name of the Flink deployment. + + --secrets-path=SECRETS_PATH + path to the secrets manager for the Flink deployment. (ie. + projects/{my-project}/secrets/{my-secret}/versions/{1}) + + --network-config-subnetwork=NETWORK_CONFIG_SUBNETWORK + subnetwork for the Flink deployment network config. + + --network-config-vpc=NETWORK_CONFIG_VPC + fully qualified VPC network for the Flink deployment network config. + Formatted as: projects/{project}/global/networks/{network_id}. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the managedflink/v1alpha API. The full documentation for + this API can be found at: go/managed-flink-design + +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/managed-flink/deployments/delete b/gcloud/alpha/managed-flink/deployments/delete new file mode 100644 index 000000000..4302238cd --- /dev/null +++ b/gcloud/alpha/managed-flink/deployments/delete @@ -0,0 +1,74 @@ +NAME + gcloud alpha managed-flink deployments delete - delete a Managed Flink + deployment + +SYNOPSIS + gcloud alpha managed-flink deployments delete + (DEPLOYMENT : --location=LOCATION) [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete a Managed Flink deployment. + +EXAMPLES + To delete a Managed Flink whose ID is mydeployment, run the following: + + $ gcloud alpha managed-flink deployments delete mydeployment \ + --location=us-central1 + +POSITIONAL ARGUMENTS + Deployment resource - Identifies the Flink deployment to be deleted. 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 deployment on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + DEPLOYMENT + ID of the deployment or fully qualified identifier for the + deployment. + + To set the deployment attribute: + ▸ provide the argument deployment on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + ID of the location of the Apache Flink for BigQuery resource. See + https://cloud.google.com/managed-flink/docs/locations for a list of + supported locations. + + To set the location attribute: + ▸ provide the argument deployment on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the managedflink/v1alpha API. The full documentation for + this API can be found at: go/managed-flink-design + +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/managed-flink/deployments/describe b/gcloud/alpha/managed-flink/deployments/describe new file mode 100644 index 000000000..3504cb1fc --- /dev/null +++ b/gcloud/alpha/managed-flink/deployments/describe @@ -0,0 +1,69 @@ +NAME + gcloud alpha managed-flink deployments describe - describe a Managed Flink + deployment + +SYNOPSIS + gcloud alpha managed-flink deployments describe + (DEPLOYMENT : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe a Managed Flink deployment. + +EXAMPLES + To describe a Managed Flink whose ID is mydeployment, run the following: + + $ gcloud alpha managed-flink deployments describe mydeployment \ + --location=us-central1 + +POSITIONAL ARGUMENTS + Deployment resource - Identifies the Flink deployment whose details are to + be displayed. 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 deployment on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + DEPLOYMENT + ID of the deployment or fully qualified identifier for the + deployment. + + To set the deployment attribute: + ▸ provide the argument deployment on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + ID of the location of the Apache Flink for BigQuery resource. See + https://cloud.google.com/managed-flink/docs/locations for a list of + supported locations. + + To set the location attribute: + ▸ provide the argument deployment on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the managedflink/v1alpha API. The full documentation for + this API can be found at: go/managed-flink-design + +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/managed-flink/deployments/help b/gcloud/alpha/managed-flink/deployments/help new file mode 100644 index 000000000..25eb86528 --- /dev/null +++ b/gcloud/alpha/managed-flink/deployments/help @@ -0,0 +1,38 @@ +NAME + gcloud alpha managed-flink deployments - manage Managed Flink deployments + +SYNOPSIS + gcloud alpha managed-flink deployments COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Managed Flink deployments. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (ALPHA) Create a Managed Flink deployment. + + delete + (ALPHA) Delete a Managed Flink deployment. + + describe + (ALPHA) Describe a Managed Flink deployment. + + list + (ALPHA) List all Managed Flink deployments in a given location. + + update + (ALPHA) Update a Managed Flink deployment. + +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/managed-flink/deployments/list b/gcloud/alpha/managed-flink/deployments/list new file mode 100644 index 000000000..7d91daa48 --- /dev/null +++ b/gcloud/alpha/managed-flink/deployments/list @@ -0,0 +1,80 @@ +NAME + gcloud alpha managed-flink deployments list - list all Managed Flink + deployments in a given location + +SYNOPSIS + gcloud alpha managed-flink deployments list LOCATION [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List all Managed Flink deployments in a given location. + +EXAMPLES + To list all Managed Flink deployments in a given location, run: + + $ gcloud alpha managed-flink deployments list us-central1 + +POSITIONAL ARGUMENTS + Location resource - Identifies the Cloud location this command will be + executed on. This represents a Cloud resource. (NOTE) Some attributes are + not given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the managedflink/v1alpha API. The full documentation for + this API can be found at: go/managed-flink-design + +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/managed-flink/deployments/update b/gcloud/alpha/managed-flink/deployments/update new file mode 100644 index 000000000..be7a9b25a --- /dev/null +++ b/gcloud/alpha/managed-flink/deployments/update @@ -0,0 +1,78 @@ +NAME + gcloud alpha managed-flink deployments update - update a Managed Flink + deployment + +SYNOPSIS + gcloud alpha managed-flink deployments update + (DEPLOYMENT : --location=LOCATION) [--async] [--max-slots=MAX_SLOTS] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Update a Managed Flink deployment. + +EXAMPLES + To update a Managed Flink whose ID is mydeployment, run the following: + + $ gcloud alpha managed-flink deployments update mydeployment \ + --location=us-central1 --max-slots=100 + +POSITIONAL ARGUMENTS + Deployment resource - Identifies the Flink deployment whose details are to + be updated. 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 deployment on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + DEPLOYMENT + ID of the deployment or fully qualified identifier for the + deployment. + + To set the deployment attribute: + ▸ provide the argument deployment on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + ID of the location of the Apache Flink for BigQuery resource. See + https://cloud.google.com/managed-flink/docs/locations for a list of + supported locations. + + To set the location attribute: + ▸ provide the argument deployment on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --max-slots=MAX_SLOTS + max slots of the Flink deployment. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the managedflink/v1alpha API. The full documentation for + this API can be found at: go/managed-flink-design + +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/managed-flink/help b/gcloud/alpha/managed-flink/help new file mode 100644 index 000000000..1a3691b90 --- /dev/null +++ b/gcloud/alpha/managed-flink/help @@ -0,0 +1,29 @@ +NAME + gcloud alpha managed-flink - manage Managed Flink resources + +SYNOPSIS + gcloud alpha managed-flink GROUP [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Managed Flink resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + deployments + (ALPHA) Manage Managed Flink deployments. + + jobs + (ALPHA) Manage Managed Flink jobs. + +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/managed-flink/jobs/create b/gcloud/alpha/managed-flink/jobs/create new file mode 100644 index 000000000..63ba8665e --- /dev/null +++ b/gcloud/alpha/managed-flink/jobs/create @@ -0,0 +1,114 @@ +NAME + gcloud alpha managed-flink jobs create - create a Flink job from a Java jar + +SYNOPSIS + gcloud alpha managed-flink jobs create JAR|PY|SQL --location=LOCATION + --staging-location=STAGING_LOCATION [--project=PROJECT_ID] [--async] + [--autotuning-mode=AUTOTUNING_MODE; default="elastic"] [--class=CLASS] + [--deployment=DEPLOYMENT_NAME] [--dry-run] [--enable-output] + [--jars=[JAR,...]] [--job-type=JOB_TYPE; default="auto"] + [--max-parallelism=MAX_PARALLELISM] [--min-parallelism=MIN_PARALLELISM] + [--name=NAME] [--network-config-subnetwork=SUBNETWORK] + [--network-config-vpc=NETWORK] [--parallelism=PARALLELISM] + [GCLOUD_WIDE_FLAG ...] [-- JOB_ARGS ...] + +DESCRIPTION + (ALPHA) Create a Flink job from a Java jar. + +EXAMPLES + To create a Flink job from a Java jar, run: + + $ gcloud alpha managed-flink jobs create my-job.jar \ + --project=my-project --location=us-central1 + +POSITIONAL ARGUMENTS + JAR|PY|SQL + The file containing the Flink job to run. Can be a jar, python, or sql + file. + + [-- JOB_ARGS ...] + The job arguments to pass. + + The '--' argument must be specified between gcloud specific args on the + left and JOB_ARGS on the right. + +REQUIRED FLAGS + --location=LOCATION + The location to run the job in. + + --staging-location=STAGING_LOCATION + The Google Cloud Storage staging location for the job. Must start with + gs:// + +COMMONLY USED FLAGS + --project=PROJECT_ID + Project to run the job in. Overrides the default core/project property + value for this command invocation. + +OTHER FLAGS + --async + Return immediately after job submission. + + --autotuning-mode=AUTOTUNING_MODE; default="elastic" + Selects the autotuning mode for jobs. AUTOTUNING_MODE must be one of: + + elastic + The number of taskmanagers is scaled automatically according to + workload. + fixed + The number of taskmanagers is fixed. + + --class=CLASS + The main class of the Flink job. Required if the jar file manifest does + not contain a main class. + + --deployment=DEPLOYMENT_NAME + Deployment to run the job in. + + --dry-run + Return command used to submit a job without invoking API. + + --enable-output + Shows the output of the Flink client. + + --jars=[JAR,...] + The extra jars to pass to the job. Can be a jar, python, or sql file. + + --job-type=JOB_TYPE; default="auto" + The type of job to run. If "auto" will be selected based on the file + extension for the job argument. JOB_TYPE must be one of: auto, jar, + python, sql. + + --max-parallelism=MAX_PARALLELISM + The maximum parallelism of the job when in "elastic" autotuning mode. + + --min-parallelism=MIN_PARALLELISM + The minimum parallelism of the job when in "elastic" autotuning mode. + This will also be the initial parallelism of the job. + + --name=NAME + The name of the job. The Flink job name will be used if not set. + + --network-config-subnetwork=SUBNETWORK + The subnetwork to use for the job. + + --network-config-vpc=NETWORK + The network to use for the job. + + --parallelism=PARALLELISM + The parallelism of the job when in "fixed" autotuning mode. + +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/managed-flink/jobs/delete b/gcloud/alpha/managed-flink/jobs/delete new file mode 100644 index 000000000..5f7bbf5ff --- /dev/null +++ b/gcloud/alpha/managed-flink/jobs/delete @@ -0,0 +1,71 @@ +NAME + gcloud alpha managed-flink jobs delete - delete a Managed Flink job + +SYNOPSIS + gcloud alpha managed-flink jobs delete (JOB : --location=LOCATION) + [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete a Managed Flink job. + +EXAMPLES + To delete a Managed Flink whose ID is myjob, run the following: + + $ gcloud alpha managed-flink jobs delete myjob --location=us-central1 + +POSITIONAL ARGUMENTS + Job resource - Identifies the Flink job to be deleted. 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 job on the command line with a fully specified + name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + JOB + ID of the job or fully qualified identifier for the job. + + To set the job attribute: + ▸ provide the argument job on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + ID of the location of the Apache Flink for BigQuery resource. See + https://cloud.google.com/managed-flink/docs/locations for a list of + supported locations. + + To set the location attribute: + ▸ provide the argument job on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the managedflink/v1alpha API. The full documentation for + this API can be found at: go/managed-flink-design + +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/managed-flink/jobs/describe b/gcloud/alpha/managed-flink/jobs/describe new file mode 100644 index 000000000..0c2488646 --- /dev/null +++ b/gcloud/alpha/managed-flink/jobs/describe @@ -0,0 +1,67 @@ +NAME + gcloud alpha managed-flink jobs describe - describe a Managed Flink job + +SYNOPSIS + gcloud alpha managed-flink jobs describe (JOB : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe a Managed Flink job. + +EXAMPLES + To describe a Managed Flink whose ID is myjob, run the following: + + $ gcloud alpha managed-flink jobs describe myjob \ + --location=us-central1 + +POSITIONAL ARGUMENTS + Job resource - Identifies the Flink job whose details are to be displayed. + 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 job on the command line with a fully specified + name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + JOB + ID of the job or fully qualified identifier for the job. + + To set the job attribute: + ▸ provide the argument job on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + ID of the location of the Apache Flink for BigQuery resource. See + https://cloud.google.com/managed-flink/docs/locations for a list of + supported locations. + + To set the location attribute: + ▸ provide the argument job on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the managedflink/v1alpha API. The full documentation for + this API can be found at: go/managed-flink-design + +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/managed-flink/jobs/help b/gcloud/alpha/managed-flink/jobs/help new file mode 100644 index 000000000..52586177a --- /dev/null +++ b/gcloud/alpha/managed-flink/jobs/help @@ -0,0 +1,38 @@ +NAME + gcloud alpha managed-flink jobs - manage Managed Flink jobs + +SYNOPSIS + gcloud alpha managed-flink jobs COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Managed Flink jobs. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (ALPHA) Create a Flink job from a Java jar. + + delete + (ALPHA) Delete a Managed Flink job. + + describe + (ALPHA) Describe a Managed Flink job. + + list + (ALPHA) List all Managed Flink jobs in a given location. + + update + (ALPHA) Update the parallelism of a Flink job. + +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/managed-flink/jobs/list b/gcloud/alpha/managed-flink/jobs/list new file mode 100644 index 000000000..57ce9654e --- /dev/null +++ b/gcloud/alpha/managed-flink/jobs/list @@ -0,0 +1,80 @@ +NAME + gcloud alpha managed-flink jobs list - list all Managed Flink jobs in a + given location + +SYNOPSIS + gcloud alpha managed-flink jobs list LOCATION [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List all Managed Flink jobs in a given location. + +EXAMPLES + To list all Managed Flink jobs in a given location, run: + + $ gcloud alpha managed-flink jobs list us-central1 + +POSITIONAL ARGUMENTS + Location resource - Identifies the Cloud location this command will be + executed on. This represents a Cloud resource. (NOTE) Some attributes are + not given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the managedflink/v1alpha API. The full documentation for + this API can be found at: go/managed-flink-design + +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/managed-flink/jobs/update b/gcloud/alpha/managed-flink/jobs/update new file mode 100644 index 000000000..11d572754 --- /dev/null +++ b/gcloud/alpha/managed-flink/jobs/update @@ -0,0 +1,80 @@ +NAME + gcloud alpha managed-flink jobs update - update the parallelism of a Flink + job + +SYNOPSIS + gcloud alpha managed-flink jobs update JOBID --location=LOCATION + [--project=PROJECT_ID] [--async] + [--autotuning-mode=AUTOTUNING_MODE; default="elastic"] + [--deployment=DEPLOYMENT_NAME] [--enable-output] + [--max-parallelism=MAX_PARALLELISM] [--min-parallelism=MIN_PARALLELISM] + [--parallelism=PARALLELISM] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Update the parallelism of a Flink job. + +EXAMPLES + The following command updates a Flink Job with the ID example-job-id to + change max parallesim to 4: + + $ gcloud alpha managed-flink jobs update example-job-id \ + --project=example-project --location=us-central1 \ + --autotuning-mode elastic --min-parallelism=1 \ + --max-parallelism=4 \ + +POSITIONAL ARGUMENTS + JOBID + The id of the job. + +REQUIRED FLAGS + --location=LOCATION + The location to run the job in. + +COMMONLY USED FLAGS + --project=PROJECT_ID + Project to update the job in. Overrides the default core/project + property value for this command invocation. + +OTHER FLAGS + --async + Return immediately after job submission. + + --autotuning-mode=AUTOTUNING_MODE; default="elastic" + Selects the autotuning mode for jobs. AUTOTUNING_MODE must be one of: + + elastic + The number of taskmanagers is scaled automatically according to + workload. + fixed + The number of taskmanagers is fixed. + + --deployment=DEPLOYMENT_NAME + Deployment to update the job in. + + --enable-output + Shows the output of the Flink client. + + --max-parallelism=MAX_PARALLELISM + The maximum parallelism of the job when in "elastic" autotuning mode. + + --min-parallelism=MIN_PARALLELISM + The minimum parallelism of the job when in "elastic" autotuning mode. + This will also be the initial parallelism of the job. + + --parallelism=PARALLELISM + The parallelism of the job when in "fixed" autotuning mode. + +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/managed-kafka/clusters/create b/gcloud/alpha/managed-kafka/clusters/create index 6dc594e8c..0be679842 100644 --- a/gcloud/alpha/managed-kafka/clusters/create +++ b/gcloud/alpha/managed-kafka/clusters/create @@ -105,7 +105,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the managedkafka/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/managed-kafka + API can be found at: + https://cloud.google.com/managed-service-for-apache-kafka/docs NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/managed-kafka/clusters/delete b/gcloud/alpha/managed-kafka/clusters/delete index df214a6c4..36987c639 100644 --- a/gcloud/alpha/managed-kafka/clusters/delete +++ b/gcloud/alpha/managed-kafka/clusters/delete @@ -65,7 +65,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the managedkafka/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/managed-kafka + API can be found at: + https://cloud.google.com/managed-service-for-apache-kafka/docs NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/managed-kafka/clusters/describe b/gcloud/alpha/managed-kafka/clusters/describe index 44e906625..a94ec46e6 100644 --- a/gcloud/alpha/managed-kafka/clusters/describe +++ b/gcloud/alpha/managed-kafka/clusters/describe @@ -60,7 +60,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the managedkafka/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/managed-kafka + API can be found at: + https://cloud.google.com/managed-service-for-apache-kafka/docs NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/managed-kafka/clusters/list b/gcloud/alpha/managed-kafka/clusters/list index bff418a45..db73b8a71 100644 --- a/gcloud/alpha/managed-kafka/clusters/list +++ b/gcloud/alpha/managed-kafka/clusters/list @@ -72,7 +72,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the managedkafka/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/managed-kafka + API can be found at: + https://cloud.google.com/managed-service-for-apache-kafka/docs NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/managed-kafka/clusters/update b/gcloud/alpha/managed-kafka/clusters/update index 56fbd99ff..d2bb20c55 100644 --- a/gcloud/alpha/managed-kafka/clusters/update +++ b/gcloud/alpha/managed-kafka/clusters/update @@ -98,7 +98,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the managedkafka/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/managed-kafka + API can be found at: + https://cloud.google.com/managed-service-for-apache-kafka/docs NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/managed-kafka/consumer-groups/delete b/gcloud/alpha/managed-kafka/consumer-groups/delete index 2eeea5c3d..ba0c3f705 100644 --- a/gcloud/alpha/managed-kafka/consumer-groups/delete +++ b/gcloud/alpha/managed-kafka/consumer-groups/delete @@ -70,7 +70,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the managedkafka/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/managed-kafka + API can be found at: + https://cloud.google.com/managed-service-for-apache-kafka/docs NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/managed-kafka/consumer-groups/describe b/gcloud/alpha/managed-kafka/consumer-groups/describe index 98c1235f8..e8e0162d5 100644 --- a/gcloud/alpha/managed-kafka/consumer-groups/describe +++ b/gcloud/alpha/managed-kafka/consumer-groups/describe @@ -70,7 +70,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the managedkafka/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/managed-kafka + API can be found at: + https://cloud.google.com/managed-service-for-apache-kafka/docs NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/managed-kafka/consumer-groups/list b/gcloud/alpha/managed-kafka/consumer-groups/list index 53ee033fd..9d7156d17 100644 --- a/gcloud/alpha/managed-kafka/consumer-groups/list +++ b/gcloud/alpha/managed-kafka/consumer-groups/list @@ -89,7 +89,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the managedkafka/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/managed-kafka + API can be found at: + https://cloud.google.com/managed-service-for-apache-kafka/docs NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/managed-kafka/consumer-groups/update b/gcloud/alpha/managed-kafka/consumer-groups/update index 83c3354eb..7c43ee05a 100644 --- a/gcloud/alpha/managed-kafka/consumer-groups/update +++ b/gcloud/alpha/managed-kafka/consumer-groups/update @@ -94,7 +94,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the managedkafka/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/managed-kafka + API can be found at: + https://cloud.google.com/managed-service-for-apache-kafka/docs NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/managed-kafka/topics/create b/gcloud/alpha/managed-kafka/topics/create index 9be95fe3e..e23685224 100644 --- a/gcloud/alpha/managed-kafka/topics/create +++ b/gcloud/alpha/managed-kafka/topics/create @@ -90,7 +90,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the managedkafka/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/managed-kafka + API can be found at: + https://cloud.google.com/managed-service-for-apache-kafka/docs NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/managed-kafka/topics/delete b/gcloud/alpha/managed-kafka/topics/delete index 52de87728..4349682a1 100644 --- a/gcloud/alpha/managed-kafka/topics/delete +++ b/gcloud/alpha/managed-kafka/topics/delete @@ -68,7 +68,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the managedkafka/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/managed-kafka + API can be found at: + https://cloud.google.com/managed-service-for-apache-kafka/docs NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/managed-kafka/topics/describe b/gcloud/alpha/managed-kafka/topics/describe index 2b1ecf8a2..9f5c3fe4e 100644 --- a/gcloud/alpha/managed-kafka/topics/describe +++ b/gcloud/alpha/managed-kafka/topics/describe @@ -68,7 +68,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the managedkafka/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/managed-kafka + API can be found at: + https://cloud.google.com/managed-service-for-apache-kafka/docs NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/managed-kafka/topics/list b/gcloud/alpha/managed-kafka/topics/list index d25b72946..fb21b5621 100644 --- a/gcloud/alpha/managed-kafka/topics/list +++ b/gcloud/alpha/managed-kafka/topics/list @@ -89,7 +89,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the managedkafka/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/managed-kafka + API can be found at: + https://cloud.google.com/managed-service-for-apache-kafka/docs NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/managed-kafka/topics/update b/gcloud/alpha/managed-kafka/topics/update index 3f6e06793..c69774c84 100644 --- a/gcloud/alpha/managed-kafka/topics/update +++ b/gcloud/alpha/managed-kafka/topics/update @@ -92,7 +92,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the managedkafka/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/managed-kafka + API can be found at: + https://cloud.google.com/managed-service-for-apache-kafka/docs NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/memorystore/instances/update b/gcloud/alpha/memorystore/instances/update index 1f0877ecd..1e3e66bf6 100644 --- a/gcloud/alpha/memorystore/instances/update +++ b/gcloud/alpha/memorystore/instances/update @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud alpha memorystore instances update (INSTANCE : --location=LOCATION) - [--async] [--deletion-protection-enabled] + [--async] [--[no-]deletion-protection-enabled] [--replica-count=REPLICA_COUNT] [--request-id=REQUEST_ID] [--shard-count=SHARD_COUNT] [--aof-config-append-fsync=AOF_CONFIG_APPEND_FSYNC @@ -75,8 +75,10 @@ FLAGS Arguments for the deletion protection enabled. - --deletion-protection-enabled - If set to true deletion of the instance will fail. + --[no-]deletion-protection-enabled + If set to true deletion of the instance will fail. Use + --deletion-protection-enabled to enable and + --no-deletion-protection-enabled to disable. Arguments for the replica count. diff --git a/gcloud/alpha/netapp/storage-pools/help b/gcloud/alpha/netapp/storage-pools/help index c271ec325..01a41fd13 100644 --- a/gcloud/alpha/netapp/storage-pools/help +++ b/gcloud/alpha/netapp/storage-pools/help @@ -29,7 +29,7 @@ COMMANDS (ALPHA) List Cloud NetApp Storage Pools. switch - (ALPHA) Switch a Regional Cloud NetApp SO Storage Pool zone. + (ALPHA) Switch a Regional Cloud NetApp Flex Storage Pool zone. update (ALPHA) Update a Cloud NetApp Storage Pool. diff --git a/gcloud/alpha/netapp/storage-pools/switch b/gcloud/alpha/netapp/storage-pools/switch index 7dd15552a..4a30a5152 100644 --- a/gcloud/alpha/netapp/storage-pools/switch +++ b/gcloud/alpha/netapp/storage-pools/switch @@ -1,13 +1,13 @@ NAME gcloud alpha netapp storage-pools switch - switch a Regional Cloud NetApp - SO Storage Pool zone + Flex Storage Pool zone SYNOPSIS gcloud alpha netapp storage-pools switch (STORAGE_POOL : --location=LOCATION) [--async] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Switch a Regional Cloud NetApp SO Storage Pool zone. + (ALPHA) Switch a Regional Cloud NetApp Flex Storage Pool zone. EXAMPLES The following command switches zone of a Storage Pool named NAME using the @@ -72,7 +72,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud netapp storage-pools switch $ gcloud beta netapp storage-pools switch diff --git a/gcloud/alpha/network-connectivity/internal-ranges/create b/gcloud/alpha/network-connectivity/internal-ranges/create index 7b88f5cd2..2fe6b1a86 100644 --- a/gcloud/alpha/network-connectivity/internal-ranges/create +++ b/gcloud/alpha/network-connectivity/internal-ranges/create @@ -9,7 +9,9 @@ SYNOPSIS : --target-cidr-range=[TARGET_CIDR_RANGE,...]]) [--async] [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] [--overlaps=[OVERLAPS,...]] [--peering=PEERING; default="for-self"] - [--usage=USAGE; default="for-vpc"] [GCLOUD_WIDE_FLAG ...] + [--usage=USAGE; default="for-vpc"] + [--migration-source=MIGRATION_SOURCE + --migration-target=MIGRATION_TARGET] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Create a new internal range with the given name. @@ -152,10 +154,37 @@ OPTIONAL FLAGS cases, like for example, usage on-prem, with dynamic route announcements via interconnect. + for-migration + Ranges created with FOR_MIGRATION are used as locks for migrating + subnetworks between peered VPC networks. + for-vpc A cloud resource can use the reserved CIDR block by associating it with the internal range resource if usage is set to FOR_VPC. + Endpoints of a for-migration internal range. This is only applicable when + --usage is set to for-migration. Both MIGRATION_SOURCE and + MIGRATION_TARGET must either belong to the same VPC or their VPCs must be + peered (they may then even belong to different projects). MIGRATION_SOURCE + must belong to the VPC network specifed by the --network flag. + MIGRATION_TARGET may name a subnetwork which does not exist yet; it must + be a valid resource path, and parent resources (network and project) and + their locations must exist. + + --migration-source=MIGRATION_SOURCE + The migration source subnetwork (of a for-migration internal range) + resource URI or resource ID. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --migration-target=MIGRATION_TARGET + The migration target subnetwork (of a for-migration internal range) + resource URI or resource ID. + + This flag argument must be specified if any of the other arguments in + this group are specified. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/network-security/security-profiles/custom-mirroring/create b/gcloud/alpha/network-security/security-profiles/custom-mirroring/create new file mode 100644 index 000000000..c2956bd04 --- /dev/null +++ b/gcloud/alpha/network-security/security-profiles/custom-mirroring/create @@ -0,0 +1,127 @@ +NAME + gcloud alpha network-security security-profiles custom-mirroring create - + create a new Custom Mirroring Profile + +SYNOPSIS + gcloud alpha network-security security-profiles custom-mirroring create + (SECURITY_PROFILE : --location=LOCATION --organization=ORGANIZATION) + (--mirroring-endpoint-group=MIRRORING_ENDPOINT_GROUP + : --mirroring-endpoint-group-location=MIRRORING_ENDPOINT_GROUP_LOCATION) + [--async] [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create a new Custom Mirroring Security Profile. + +EXAMPLES + To create a Custom Mirroring Security Profile named mirroring-profile + linked to a Mirroring Endpoint Group (q.v.), run: + + $ gcloud alpha network-security security-profiles custom-mirroring \ + create mirroring-profile --description="A Mirroring Profile" \ + --mirroring-endpoint-group=projects/my-project/locations/\ + global/mirroringEndpointGroups/my-mep + +POSITIONAL ARGUMENTS + Security profile resource - Security Profile Name. The arguments in this + group can be used to specify the attributes of this resource. + + This must be specified. + + SECURITY_PROFILE + ID of the security_profile or fully qualified identifier for the + security_profile. + + To set the security_profile attribute: + ▸ provide the argument security_profile on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + location of the security_profile - Global. + + To set the location attribute: + ▸ provide the argument security_profile on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + + --organization=ORGANIZATION + Organization ID to which the changes should apply. + + To set the organization attribute: + ▸ provide the argument security_profile on the command line with a + fully specified name; + ▸ provide the argument --organization on the command line. + +REQUIRED FLAGS + Mirroring endpoint group resource - Mirroring Endpoint Group. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument --mirroring-endpoint-group on the command line + with a fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --mirroring-endpoint-group=MIRRORING_ENDPOINT_GROUP + ID of the mirroring endpoint group or fully qualified identifier for + the mirroring endpoint group. + + To set the id attribute: + ▸ provide the argument --mirroring-endpoint-group on the command + line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --mirroring-endpoint-group-location=MIRRORING_ENDPOINT_GROUP_LOCATION + Location of the mirroring endpoint group. + + To set the location attribute: + ▸ provide the argument --mirroring-endpoint-group on the command + line with a fully specified name; + ▸ provide the argument --mirroring-endpoint-group-location on the + command line; + ▸ provide the argument --location on the command line; + ▸ provide the argument + networksecurity.projects.locations.mirroringEndpointGroupAssociations + on the command line with a fully specified name. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. The default is False. + + --description=DESCRIPTION + Brief description of the security profile + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta network-security security-profiles custom-mirroring \ + create + diff --git a/gcloud/alpha/network-security/security-profiles/custom-mirroring/delete b/gcloud/alpha/network-security/security-profiles/custom-mirroring/delete new file mode 100644 index 000000000..93e5c876e --- /dev/null +++ b/gcloud/alpha/network-security/security-profiles/custom-mirroring/delete @@ -0,0 +1,78 @@ +NAME + gcloud alpha network-security security-profiles custom-mirroring delete - + delete a Security Profile + +SYNOPSIS + gcloud alpha network-security security-profiles custom-mirroring delete + (SECURITY_PROFILE : --location=LOCATION --organization=ORGANIZATION) + [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete the specified Security Profile. + +EXAMPLES + To delete a Security Profile called my-security-profile run: + + $ gcloud alpha network-security security-profiles custom-mirroring \ + delete my-security-profile + +POSITIONAL ARGUMENTS + Security profile resource - Name of the Security Profile you want to + delete. The arguments in this group can be used to specify the attributes + of this resource. + + This must be specified. + + SECURITY_PROFILE + ID of the security_profile or fully qualified identifier for the + security_profile. + + To set the security_profile attribute: + ▸ provide the argument security_profile on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location ID of the resource. + + To set the location attribute: + ▸ provide the argument security_profile on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ use default global location . + + --organization=ORGANIZATION + Organization number. + + To set the organization attribute: + ▸ provide the argument security_profile on the command line with a + fully specified name; + ▸ provide the argument --organization on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networksecurity/v1alpha1 API. The full documentation + for this API can be found at: https://cloud.google.com/networking + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta network-security security-profiles custom-mirroring \ + delete + diff --git a/gcloud/alpha/network-security/security-profiles/custom-mirroring/describe b/gcloud/alpha/network-security/security-profiles/custom-mirroring/describe new file mode 100644 index 000000000..ecdce4f2d --- /dev/null +++ b/gcloud/alpha/network-security/security-profiles/custom-mirroring/describe @@ -0,0 +1,73 @@ +NAME + gcloud alpha network-security security-profiles custom-mirroring describe - + describe a Custom MirroringSecurity Profile + +SYNOPSIS + gcloud alpha network-security security-profiles custom-mirroring describe + (SECURITY_PROFILE : --location=LOCATION --organization=ORGANIZATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Show details of the Security Profile. + +EXAMPLES + To show details of a Security Profile named my-mirroring-sp run: + + $ gcloud alpha network-security security-profiles custom-mirroring \ + describe my-mirroring-sp --organization=1234 --location=global + +POSITIONAL ARGUMENTS + Security profile resource - Name of the Security Profile to be described. + The arguments in this group can be used to specify the attributes of this + resource. + + This must be specified. + + SECURITY_PROFILE + ID of the security_profile or fully qualified identifier for the + security_profile. + + To set the security_profile attribute: + ▸ provide the argument security_profile on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location ID of the resource. + + To set the location attribute: + ▸ provide the argument security_profile on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ use default global location . + + --organization=ORGANIZATION + Organization number. + + To set the organization attribute: + ▸ provide the argument security_profile on the command line with a + fully specified name; + ▸ provide the argument --organization on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networksecurity/v1alpha1 API. The full documentation + for this API can be found at: https://cloud.google.com/networking + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta network-security security-profiles custom-mirroring \ + describe + diff --git a/gcloud/alpha/network-security/security-profiles/custom-mirroring/help b/gcloud/alpha/network-security/security-profiles/custom-mirroring/help new file mode 100644 index 000000000..fac5ef6dc --- /dev/null +++ b/gcloud/alpha/network-security/security-profiles/custom-mirroring/help @@ -0,0 +1,43 @@ +NAME + gcloud alpha network-security security-profiles custom-mirroring - manage + Security Profiles - Custom Mirroring Profile + +SYNOPSIS + gcloud alpha network-security security-profiles custom-mirroring COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) This class provides commands for managing Custom Mirroring Security + Profile. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (ALPHA) Create a new Custom Mirroring Profile. + + delete + (ALPHA) Delete a Security Profile. + + describe + (ALPHA) Describe a Custom MirroringSecurity Profile. + + list + (ALPHA) List Custom Mirroring Security Profiles. + + update + (ALPHA) Updates a Custom Mirroring Profile. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta network-security security-profiles custom-mirroring + diff --git a/gcloud/alpha/network-security/security-profiles/custom-mirroring/list b/gcloud/alpha/network-security/security-profiles/custom-mirroring/list new file mode 100644 index 000000000..4e5061c75 --- /dev/null +++ b/gcloud/alpha/network-security/security-profiles/custom-mirroring/list @@ -0,0 +1,90 @@ +NAME + gcloud alpha network-security security-profiles custom-mirroring list - + list Custom Mirroring Security Profiles + +SYNOPSIS + gcloud alpha network-security security-profiles custom-mirroring list + [--location=LOCATION : --organization=ORGANIZATION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List Custom Mirroring Security Profiles. + + For more examples, refer to the EXAMPLES section below. + +EXAMPLES + To list Custom Mirroring security profiles in an organization, run: + + $ gcloud alpha network-security security-profiles custom-mirroring \ list --organization=12345 --location=global + +FLAGS + Location resource - Parent resource for the list operation. The arguments + in this group can be used to specify the attributes of this resource. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --organization=ORGANIZATION + Organization ID of the location. + + To set the organization attribute: + ▸ provide the argument --location on the command line with a fully + specified name; + ▸ provide the argument --organization on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta network-security security-profiles custom-mirroring \ + list + diff --git a/gcloud/alpha/network-security/security-profiles/custom-mirroring/update b/gcloud/alpha/network-security/security-profiles/custom-mirroring/update new file mode 100644 index 000000000..7101482fc --- /dev/null +++ b/gcloud/alpha/network-security/security-profiles/custom-mirroring/update @@ -0,0 +1,119 @@ +NAME + gcloud alpha network-security security-profiles custom-mirroring update - + updates a Custom Mirroring Profile + +SYNOPSIS + gcloud alpha network-security security-profiles custom-mirroring update + (SECURITY_PROFILE : --location=LOCATION --organization=ORGANIZATION) + [--async] [--description=DESCRIPTION] [--update-labels=[KEY=VALUE,...]] + [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Update a Custom Mirroring Security Profile. + + The supported fields for update are description and labels. + +EXAMPLES + To update the description of a Custom Mirroring Security Profile named + mirroring-profile, run: + + $ gcloud alpha network-security security-profiles custom-mirroring \ + update mirroring-profile --description="A new description" \ + --organization=1234567890 --location=global + + To change the labels of a Custom Mirroring Security Profile named + mirroring-profile, run: + + $ gcloud alpha network-security security-profiles custom-mirroring \ + update mirroring-profile \ + --update-labels=key1=value1,key2=value2 \ + --delete-labels=key3,key4 --organization=1234567890 \ + --location=glob + +POSITIONAL ARGUMENTS + Security profile resource - Security Profile Name. The arguments in this + group can be used to specify the attributes of this resource. + + This must be specified. + + SECURITY_PROFILE + ID of the security_profile or fully qualified identifier for the + security_profile. + + To set the security_profile attribute: + ▸ provide the argument security_profile on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + location of the security_profile - Global. + + To set the location attribute: + ▸ provide the argument security_profile on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + + --organization=ORGANIZATION + Organization ID to which the changes should apply. + + To set the organization attribute: + ▸ provide the argument security_profile on the command line with a + fully specified name; + ▸ provide the argument --organization on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. The default is False. + + --description=DESCRIPTION + Brief description of the security profile + + --update-labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to update. If a label exists, its value + is modified. Otherwise, a new label is created. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + At most one of these can be specified: + + --clear-labels + Remove all labels. If --update-labels is also specified then + --clear-labels is applied first. + + For example, to remove all labels: + + $ gcloud alpha network-security security-profiles custom-mirroring \ + update --clear-labels + + To remove all existing labels and create two new labels, foo and baz: + + $ gcloud alpha network-security security-profiles custom-mirroring \ + update --clear-labels --update-labels foo=bar,baz=qux + + --remove-labels=[KEY,...] + List of label keys to remove. If a label does not exist it is + silently ignored. If --update-labels is also specified then + --update-labels is applied first. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta network-security security-profiles custom-mirroring \ + update + diff --git a/gcloud/alpha/network-security/security-profiles/help b/gcloud/alpha/network-security/security-profiles/help index 667e3eaa9..513e0b277 100644 --- a/gcloud/alpha/network-security/security-profiles/help +++ b/gcloud/alpha/network-security/security-profiles/help @@ -17,6 +17,9 @@ GCLOUD WIDE FLAGS GROUPS GROUP is one of the following: + custom-mirroring + (ALPHA) Manage Security Profiles - Custom Mirroring Profile. + threat-prevention (ALPHA) Manage Security Profiles - Threat Prevention Profile. diff --git a/gcloud/alpha/pubsub/subscriptions/update b/gcloud/alpha/pubsub/subscriptions/update index 46741ddba..00e082e00 100644 --- a/gcloud/alpha/pubsub/subscriptions/update +++ b/gcloud/alpha/pubsub/subscriptions/update @@ -61,9 +61,8 @@ FLAGS message with a given value of message_id on this subscription: The message sent to a subscriber is guaranteed not to be resent before the message's acknowledgment deadline expires. An acknowledged message will - not be resent to a subscriber. To disable exactly-once delivery use - --no-enable-exactly-once-delivery. Use - --no-enable-exactly-once-delivery to disable this flag. + not be resent to a subscriber. Use --no-enable-exactly-once-delivery to + disable this flag. --expiration-period=EXPIRATION_PERIOD The subscription will expire if it is inactive for the given period. @@ -77,10 +76,11 @@ FLAGS How long to retain unacknowledged messages in the subscription's backlog, from the moment a message is published. If --retain-acked-messages is true, this also configures the retention of - acknowledged messages. Specify "default" to use the default value. - Valid values are strings of the form INTEGER[UNIT], where UNIT is one - of "s", "m", "h", and "d" for seconds, minutes, hours, and days, - respectively. If the unit is omitted, seconds is assumed. + acknowledged messages. Specify "default" to use the default value of 7 + days. The minimum is 10 minutes, and the maximum is 7 days. Valid + values are strings of the form INTEGER[UNIT], where UNIT is one of "s", + "m", "h", and "d" for seconds, minutes, hours, and days, respectively. + If the unit is omitted, seconds is assumed. --push-auth-service-account=SERVICE_ACCOUNT_EMAIL Service account email used as the identity for the generated Open ID diff --git a/gcloud/alpha/redis/clusters/create b/gcloud/alpha/redis/clusters/create index 7749739f7..778b33917 100644 --- a/gcloud/alpha/redis/clusters/create +++ b/gcloud/alpha/redis/clusters/create @@ -5,10 +5,13 @@ NAME SYNOPSIS gcloud alpha redis clusters create (CLUSTER : --region=REGION) --network=NETWORK [--aof-append-fsync=AOF_APPEND_FSYNC] [--async] - [--auth-mode=AUTH_MODE] [--deletion-protection] + [--auth-mode=AUTH_MODE] + [--cross-cluster-replication-role=CROSS_CLUSTER_REPLICATION_ROLE] + [--deletion-protection] [--maintenance-window-day=MAINTENANCE_WINDOW_DAY] [--maintenance-window-hour=MAINTENANCE_WINDOW_HOUR] [--node-type=NODE_TYPE] [--persistence-mode=PERSISTENCE_MODE] + [--primary-cluster=PRIMARY_CLUSTER] [--rdb-snapshot-period=RDB_SNAPSHOT_PERIOD] [--rdb-snapshot-start-time=RDB_SNAPSHOT_START_TIME] [--redis-config=[KEY=VALUE,...]] [--replica-count=REPLICA_COUNT] @@ -114,6 +117,13 @@ OPTIONAL FLAGS iam-auth IAM basic authorization is enabled for the cluster. + --cross-cluster-replication-role=CROSS_CLUSTER_REPLICATION_ROLE + The role of the cluster in cross cluster replication. + CROSS_CLUSTER_REPLICATION_ROLE must be (only one value is supported): + + secondary + Create a secondary cluster. + --deletion-protection Enable deletion protection for the Redis Cluster. Use --deletion-protection/--no-deletion-protection to enable/disable it. @@ -142,6 +152,12 @@ OPTIONAL FLAGS rdb RDB-based persistence + --primary-cluster=PRIMARY_CLUSTER + The primary cluster that the secondary cluster will replicate from. It + must use the format: + projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID. It must refer + to an existing cluster. Otherwise, the create operation fails. + --rdb-snapshot-period=RDB_SNAPSHOT_PERIOD Attempted period between RDB snapshots. RDB_SNAPSHOT_PERIOD must be one of: diff --git a/gcloud/alpha/run/jobs/logs/help b/gcloud/alpha/run/jobs/logs/help index 1e874e980..6df8816e7 100644 --- a/gcloud/alpha/run/jobs/logs/help +++ b/gcloud/alpha/run/jobs/logs/help @@ -39,7 +39,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud run jobs logs $ gcloud beta run jobs logs diff --git a/gcloud/alpha/run/jobs/logs/read b/gcloud/alpha/run/jobs/logs/read index 5c557d050..608c7cc24 100644 --- a/gcloud/alpha/run/jobs/logs/read +++ b/gcloud/alpha/run/jobs/logs/read @@ -78,7 +78,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud run jobs logs read $ gcloud beta run jobs logs read diff --git a/gcloud/alpha/run/services/logs/help b/gcloud/alpha/run/services/logs/help index 8273afd4b..3a6088a1f 100644 --- a/gcloud/alpha/run/services/logs/help +++ b/gcloud/alpha/run/services/logs/help @@ -110,7 +110,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud run services logs $ gcloud beta run services logs diff --git a/gcloud/alpha/run/services/logs/read b/gcloud/alpha/run/services/logs/read index 0cd8e2147..3511e6aeb 100644 --- a/gcloud/alpha/run/services/logs/read +++ b/gcloud/alpha/run/services/logs/read @@ -159,7 +159,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud run services logs read $ gcloud beta run services logs read diff --git a/gcloud/alpha/sql/instances/create b/gcloud/alpha/sql/instances/create index e37bd994f..f2f85da77 100644 --- a/gcloud/alpha/sql/instances/create +++ b/gcloud/alpha/sql/instances/create @@ -45,8 +45,8 @@ SYNOPSIS [--replica-type=REPLICA_TYPE] [--replication=REPLICATION] [--require-ssl] [--retained-backups-count=RETAINED_BACKUPS_COUNT] [--retained-transaction-log-days=RETAINED_TRANSACTION_LOG_DAYS] - [--root-password=ROOT_PASSWORD] [--ssl-mode=SSL_MODE] - [--[no-]storage-auto-increase] + [--root-password=ROOT_PASSWORD] [--server-ca-mode=SERVER_CA_MODE] + [--ssl-mode=SSL_MODE] [--[no-]storage-auto-increase] [--storage-auto-increase-limit=STORAGE_AUTO_INCREASE_LIMIT] [--storage-size=STORAGE_SIZE] [--storage-type=STORAGE_TYPE] [--threads-per-core=THREADS_PER_CORE] [--tier=TIER, -t TIER] @@ -415,6 +415,15 @@ FLAGS --root-password=ROOT_PASSWORD Root Cloud SQL user's password. + --server-ca-mode=SERVER_CA_MODE + Set the server CA mode of the instance. SERVER_CA_MODE must be one of: + + GOOGLE_MANAGED_CAS_CA + Google-managed regional CA part of root CA hierarchy hosted on + Google Cloud's Certificate Authority Service (CAS). + GOOGLE_MANAGED_INTERNAL_CA + Google-managed self-signed internal CA. + --ssl-mode=SSL_MODE Set the SSL mode of the instance. SSL_MODE must be one of: diff --git a/gcloud/alpha/sql/ssl/help b/gcloud/alpha/sql/ssl/help index 3f891d95a..f66c16740 100644 --- a/gcloud/alpha/sql/ssl/help +++ b/gcloud/alpha/sql/ssl/help @@ -25,6 +25,10 @@ GROUPS (ALPHA) Provide commands for managing server CA certs of Cloud SQL instances. + server-certs + (ALPHA) Provide commands for managing server certificates of Cloud SQL + instances. + NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct diff --git a/gcloud/alpha/sql/ssl/server-certs/create b/gcloud/alpha/sql/ssl/server-certs/create new file mode 100644 index 000000000..e8d1ec618 --- /dev/null +++ b/gcloud/alpha/sql/ssl/server-certs/create @@ -0,0 +1,36 @@ +NAME + gcloud alpha sql ssl server-certs create - create a server certificate for + a Cloud SQL instance + +SYNOPSIS + gcloud alpha sql ssl server-certs create --instance=INSTANCE, -i INSTANCE + [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create a server certificate for a Cloud SQL instance. + +REQUIRED FLAGS + --instance=INSTANCE, -i INSTANCE + Cloud SQL instance ID. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in 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 sql ssl server-certs create + diff --git a/gcloud/alpha/sql/ssl/server-certs/help b/gcloud/alpha/sql/ssl/server-certs/help new file mode 100644 index 000000000..d0022b1b7 --- /dev/null +++ b/gcloud/alpha/sql/ssl/server-certs/help @@ -0,0 +1,42 @@ +NAME + gcloud alpha sql ssl server-certs - provide commands for managing server + certificates of Cloud SQL instances + +SYNOPSIS + gcloud alpha sql ssl server-certs COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Provide commands for managing server certificates of Cloud SQL + instances, including creating, listing, rotating in, and rolling back + certificates. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (ALPHA) Create a server certificate for a Cloud SQL instance. + + list + (ALPHA) List all server certificates for a Cloud SQL instance. + + rollback + (ALPHA) Roll back to the previous server certificate for a Cloud SQL + instance. + + rotate + (ALPHA) Rotate in the upcoming server certificate for a Cloud SQL + instance. + +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 sql ssl server-certs + diff --git a/gcloud/alpha/sql/ssl/server-certs/list b/gcloud/alpha/sql/ssl/server-certs/list new file mode 100644 index 000000000..ead86e39b --- /dev/null +++ b/gcloud/alpha/sql/ssl/server-certs/list @@ -0,0 +1,64 @@ +NAME + gcloud alpha sql ssl server-certs list - list all server certificates for a + Cloud SQL instance + +SYNOPSIS + gcloud alpha sql ssl server-certs list --instance=INSTANCE, -i INSTANCE + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List all server certificates for a Cloud SQL instance. + +REQUIRED FLAGS + --instance=INSTANCE, -i INSTANCE + Cloud SQL instance ID. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta sql ssl server-certs list + diff --git a/gcloud/alpha/sql/ssl/server-certs/rollback b/gcloud/alpha/sql/ssl/server-certs/rollback new file mode 100644 index 000000000..2def75318 --- /dev/null +++ b/gcloud/alpha/sql/ssl/server-certs/rollback @@ -0,0 +1,37 @@ +NAME + gcloud alpha sql ssl server-certs rollback - roll back to the previous + server certificate for a Cloud SQL instance + +SYNOPSIS + gcloud alpha sql ssl server-certs rollback --instance=INSTANCE, -i INSTANCE + [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Roll back to the previous server certificate for a Cloud SQL + instance. + +REQUIRED FLAGS + --instance=INSTANCE, -i INSTANCE + Cloud SQL instance ID. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in 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 sql ssl server-certs rollback + diff --git a/gcloud/alpha/sql/ssl/server-certs/rotate b/gcloud/alpha/sql/ssl/server-certs/rotate new file mode 100644 index 000000000..a4ca08d47 --- /dev/null +++ b/gcloud/alpha/sql/ssl/server-certs/rotate @@ -0,0 +1,36 @@ +NAME + gcloud alpha sql ssl server-certs rotate - rotate in the upcoming server + certificate for a Cloud SQL instance + +SYNOPSIS + gcloud alpha sql ssl server-certs rotate --instance=INSTANCE, -i INSTANCE + [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Rotate in the upcoming server certificate for a Cloud SQL instance. + +REQUIRED FLAGS + --instance=INSTANCE, -i INSTANCE + Cloud SQL instance ID. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in 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 sql ssl server-certs rotate + diff --git a/gcloud/alpha/storage/buckets/create b/gcloud/alpha/storage/buckets/create index b58f3bc58..30144b4be 100644 --- a/gcloud/alpha/storage/buckets/create +++ b/gcloud/alpha/storage/buckets/create @@ -79,9 +79,11 @@ FLAGS --placement=REGION,REGION A comma-separated list of exactly 2 regions that form the custom - dual-region. Only regions within the same continent are or will ever be - valid. Invalid location pairs (such as mixed-continent, or with - unsupported regions) will return an error. + [dual-region] + (https://cloud.google.com/storage/docs/locations#location-dr). Only + regions within the same continent are or will ever be valid. Invalid + location pairs (such as mixed-continent, or with unsupported regions) + will return an error. --recovery-point-objective=SETTING, --rpo=SETTING Sets the recovery point objective diff --git a/gcloud/artifacts/files/help b/gcloud/artifacts/files/help index c89152ce0..2370b1042 100644 --- a/gcloud/artifacts/files/help +++ b/gcloud/artifacts/files/help @@ -35,6 +35,9 @@ COMMANDS list List Artifact Registry files. + update + Update annotations on an Artifact Registry file. + NOTES These variants are also available: diff --git a/gcloud/artifacts/files/list b/gcloud/artifacts/files/list index 3d18bf9ed..4018df3f3 100644 --- a/gcloud/artifacts/files/list +++ b/gcloud/artifacts/files/list @@ -13,34 +13,86 @@ DESCRIPTION To specify the maximum number of files to list, use the --limit flag. EXAMPLES - To list files in the current project under repository my-repo in - us-central1: + To list files in the current project under repository my-repo in us: - $ gcloud artifacts files list --repository=my-repo \ - --location=us-central1 + $ gcloud artifacts files list --repository=my-repo --location=us The following command lists a maximum of five files: - $ gcloud artifacts files list --repository=my-repo \ - --location=us-central1 --limit=5 + $ gcloud artifacts files list --repository=my-repo --location=us \ + --limit=5 - To list files in the current project under repository my-repo in - us-central1 owned by package my-package: + To list files in the current project under repository my-repo in us owned + by package my-package: - $ gcloud artifacts files list --repository=my-repo \ - --location=us-central1 --package=my-package + $ gcloud artifacts files list --repository=my-repo --location=us \ + --package=my-package - To list files in the current project under repository my-repo in - us-central1 owned by package my-package and version 1.0.0: + To list files in the current project under repository my-repo in us owned + by package my-package and version 1.0.0: - $ gcloud artifacts files list --repository=my-repo \ - --location=us-central1 --package=my-package --version=1.0.0 + $ gcloud artifacts files list --repository=my-repo --location=us \ + --package=my-package --version=1.0.0 - To list files in the current project under repository my-repo in - us-central1 owned by package my-package and tag name my-tag: + To list files in the current project under repository my-repo in us owned + by package my-package and tag name my-tag: - $ gcloud artifacts files list --repository=my-repo \ - --location=us-central1 --package=my-package --tag=my-tag + $ gcloud artifacts files list --repository=my-repo --location=us \ + --package=my-package --tag=my-tag + + To list files with name as my-file: + + $ gcloud artifacts files list \ + --filter='name="projects/my-project/locations/us/repositories/my\ + -repo/files/my-file"' + + To list files with a given partial name, use * to match any character in + name: + + $ gcloud artifacts files list \ + --filter='name="projects/my-project/locations/us/repositories/my\ + -repo/files/*file"' + + $ gcloud artifacts files list \ + --filter='name="projects/my-project/locations/us/repositories/my\ + -repo/files/my-*"' + + To list files that have annotations: + + $ gcloud artifacts files list --filter=annotations:* + + To list files with annotations pair as [annotation_key: annotation_value] + + $ gcloud artifacts files list \ + --filter='annotations.annotation_key:annotation_value' + + To list files with annotations containing key as my_key: + + $ gcloud artifacts files list --filter='annotations.my_key' + + If the key or value contains special characters, such as `my.key` and `my.value`, backtick("`") is required: + + $ gcloud artifacts files list --filter='annotations.`my.key`' + + $ gcloud artifacts files list \ + --filter='annotations.`my.key`:`my.value`' + + To list files with given partial annotation key or value, use * to match + any character: + + $ gcloud artifacts files list --filter='annotations.*key:`*.value`' + + To list files in the current project under repository my-repo in us, + ordering by create_time: + + $ gcloud artifacts files list --repository=my-repo --location=us \ + --sort-by=create_time + + To list files in the current project under repository my-repo in us, + ordering by update_time reversely: + + $ gcloud artifacts files list --repository=my-repo --location=us \ + --sort-by=~update_time FLAGS --package=PACKAGE diff --git a/gcloud/artifacts/files/update b/gcloud/artifacts/files/update new file mode 100644 index 000000000..b515eef61 --- /dev/null +++ b/gcloud/artifacts/files/update @@ -0,0 +1,106 @@ +NAME + gcloud artifacts files update - update annotations on an Artifact Registry + file + +SYNOPSIS + gcloud artifacts files update + (FILE : --location=LOCATION --repository=REPOSITORY) + [--annotations=[KEY=VALUE,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Update annotations on an Artifact Registry file. + +EXAMPLES + To update annotations on a file named my-file.txt when the project ID, + repository and location defaults are set, run the following command: + + CAUTION: This command will overwrite any existing annotations on the file. + + $ gcloud artifacts files update my-file.txt \ + --annotations=key1=value1,key2=value2 + + To clear all annotations on the file run the following command: + + $ gcloud artifacts files update my-file.txt --annotations={} + +POSITIONAL ARGUMENTS + File resource - The Artifact Registry file to update. The arguments in + this group can be used to specify the attributes of this resource. (NOTE) + Some attributes are not given arguments in this group but can be set in + other ways. + + To set the project attribute: + ◆ provide the argument file on the command line with a fully specified + name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + FILE + ID of the file or fully qualified identifier for the file. + + To set the file attribute: + ▸ provide the argument file on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location of the file. Overrides the default artifacts/location + property value for this command invocation. To configure the default + location, use the command: gcloud config set artifacts/location. + + To set the location attribute: + ▸ provide the argument file on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property artifacts/location. + + --repository=REPOSITORY + The repository associated with the file. Overrides the default + artifacts/repository property value for this command invocation. To + configure the default repository, use the command: gcloud config set + artifacts/repository. + + To set the repository attribute: + ▸ provide the argument file on the command line with a fully + specified name; + ▸ provide the argument --repository on the command line; + ▸ set the property artifacts/repository. + +FLAGS + --annotations=[KEY=VALUE,...] + List of annotations in the format of KEY=VALUE pairs to add, update, or + remove. Duplicate keys will be overwritten. For more details on + annotations, see https://google.aip.dev/148#annotations. + + KEY + Sets KEY value. + + VALUE + Sets VALUE value. + + Shorthand Example: + + --annotations=string=string + + JSON Example: + + --annotations='{"string": "string"}' + + File Example: + + --annotations=path_to_file.(yaml|json) + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ diff --git a/gcloud/artifacts/packages/help b/gcloud/artifacts/packages/help index 5d81b3400..38901a419 100644 --- a/gcloud/artifacts/packages/help +++ b/gcloud/artifacts/packages/help @@ -37,6 +37,9 @@ COMMANDS list List Artifact Registry packages. + update + Update annotations on an Artifact Registry package. + NOTES These variants are also available: diff --git a/gcloud/artifacts/packages/list b/gcloud/artifacts/packages/list index ff6eb86aa..5c95fb447 100644 --- a/gcloud/artifacts/packages/list +++ b/gcloud/artifacts/packages/list @@ -18,11 +18,63 @@ EXAMPLES $ gcloud artifacts packages list --limit=5 + To list packages with name as my-pkg: + + $ gcloud artifacts packages list \ + --filter='name="projects/my-project/locations/us/repositories/my\ + -repo/packages/my-pkg" + + To list packages with a given partial name, use * to match any character in + name: + + $ gcloud artifacts packages list \ + --filter='name="projects/my-project/locations/us/repositories/my\ + -repo/packages/*pkg"' + + $ gcloud artifacts packages list \ + --filter='name="projects/my-project/locations/us/repositories/my\ + -repo/packages/my*"' + + To list files that have annotations: + + $ gcloud artifacts packages list --filter=annotations:* + + To list packages with annotations pair as [annotation_key: + annotation_value]: + + $ gcloud artifacts packages list \ + --filter='annotations.annotation_key:annotation_value' + + To list packages with annotations containing key as my_key: + + $ gcloud artifacts packages list --filter='annotations.my_key' + + If the key or value contains special characters, such as `my.key` or `my.value`, backtick("`") is required: + + $ gcloud artifacts packages list --filter='annotations.`my.key`' + + $ gcloud artifacts packages list \ + --filter='annotations.`my.key`:`my.value`' + + To list packages with given partial annotation key or value, use * to match + any character: + + $ gcloud artifacts packages list \ + --filter='annotations.my_*:`*.value`' + + To list packages ordered by create_time: + + $ gcloud artifacts packages list --sort-by=create_time + + To list packages ordered by update_time reversely: + + $ gcloud artifacts packages list --sort-by=~update_time + FLAGS - Repository resource - The parent repository for the list of packages. 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. + Repository resource - The Artifact Registry repository. If not specified, + the current artifacts/repository is used. The arguments in this group can + be used to specify the attributes of this resource. (NOTE) Some attributes + are not given arguments in this group but can be set in other ways. To set the project attribute: ◆ provide the argument --repository on the command line with a fully @@ -32,9 +84,7 @@ FLAGS ◆ set the property core/project. --location=LOCATION - Location of the repository. Overrides the default artifacts/location - property value for this command invocation. To configure the default - location, use the command: gcloud config set artifacts/location. + Location of the repository. To set the location attribute: ▸ provide the argument --repository on the command line with a @@ -86,10 +136,6 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. -API REFERENCE - This command uses the artifactregistry/v1 API. The full documentation for - this API can be found at: https://cloud.google.com/artifacts/docs/ - NOTES These variants are also available: diff --git a/gcloud/artifacts/packages/update b/gcloud/artifacts/packages/update new file mode 100644 index 000000000..23aab16d8 --- /dev/null +++ b/gcloud/artifacts/packages/update @@ -0,0 +1,107 @@ +NAME + gcloud artifacts packages update - update annotations on an Artifact + Registry package + +SYNOPSIS + gcloud artifacts packages update + (PACKAGE : --location=LOCATION --repository=REPOSITORY) + [--annotations=[ANNOTATIONS,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Update annotations on an Artifact Registry package. + +EXAMPLES + To update annotations on a package named my-pkg when the project ID, + repository and location defaults are set, run the following command: + + CAUTION: This command will overwrite any existing annotations on the + package. + + $ gcloud artifacts packages update my-pkg \ + --annotations=key1=value1,key2=value2 + + To clear all annotations on the package run the following command: + + $ gcloud artifacts packages update my-pkg --annotations={} + +POSITIONAL ARGUMENTS + Package resource - The Artifact Registry package to update. The arguments + in this group can be used to specify the attributes of this resource. + (NOTE) Some attributes are not given arguments in this group but can be + set in other ways. + + To set the project attribute: + ◆ provide the argument package on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + PACKAGE + ID of the package or fully qualified identifier for the package. + + To set the package attribute: + ▸ provide the argument package on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location of the package. Overrides the default artifacts/location + property value for this command invocation. To configure the default + location, use the command: gcloud config set artifacts/location. + + To set the location attribute: + ▸ provide the argument package on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property artifacts/location. + + --repository=REPOSITORY + The repository associated with the package. Overrides the default + artifacts/repository property value for this command invocation. To + configure the default repository, use the command: gcloud config set + artifacts/repository. + + To set the repository attribute: + ▸ provide the argument package on the command line with a fully + specified name; + ▸ provide the argument --repository on the command line; + ▸ set the property artifacts/repository. + +FLAGS + --annotations=[ANNOTATIONS,...] + List of annotations in the format of KEY=VALUE pairs to add, update, or + remove. Duplicate keys will be overwritten. For more details on + annotations, see https://google.aip.dev/148#annotations. + + KEY + Sets KEY value. + + VALUE + Sets VALUE value. + + Shorthand Example: + + --annotations=string=string + + JSON Example: + + --annotations='{"string": "string"}' + + File Example: + + --annotations=path_to_file.(yaml|json) + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ diff --git a/gcloud/artifacts/repositories/list b/gcloud/artifacts/repositories/list index a64185a6d..39530c857 100644 --- a/gcloud/artifacts/repositories/list +++ b/gcloud/artifacts/repositories/list @@ -18,6 +18,55 @@ EXAMPLES $ gcloud artifacts repositories list --limit=5 + To list repositories with name as `my_repo`: + + $ gcloud artifacts repositories list \ + --filter='name="projects/my-project/locations/us/repositories/my\ + _repo"' + + To list repositories with a given partial name, use `*` to match any character in name: + + $ gcloud artifacts repositories list \ + --filter='name="projects/my-project/locations/us/repositories/*r\ + epo"' + + $ gcloud artifacts repositories list \ + --filter='name="projects/my-project/locations/us/repositories/my\ + _*"' + + To list files that have annotations: + + $ gcloud artifacts repositories list --filter=annotations:* + + To list repositories with annotations pair as [annotation_key: annotation_value] + + $ gcloud artifacts repositories list \ + --filter='annotations.annotation_key:annotation_value' + + To list repositories with annotations containing key as `my_key`: + + $ gcloud artifacts repositories list --filter='annotations.my_key' + + If the key or value contains special characters, such as `my.key` or `my.value`, backtick("`") is required: + + $ gcloud artifacts repositories list --filter='annotations.`my.key`' + + $ gcloud artifacts repositories list \ + --filter='annotations.`my.key`:`my.value`' + + To list repositories with given partial annotation key or value, use `*` to match any character: + + $ gcloud artifacts repositories list \ + --filter='annotations.*key:`*.value`' + + To list repositories ordered by create_time: + + $ gcloud artifacts repositories list --sort-by=create_time + + To list repositories ordered by update_time reversely: + + $ gcloud artifacts repositories list--sort-by=~update_time + FLAGS Location resource - The Artifact Registry repository location. You can also set --location=all to list repositories across all locations. If you diff --git a/gcloud/artifacts/tags/list b/gcloud/artifacts/tags/list index 76b2c2b12..99e82cbfa 100644 --- a/gcloud/artifacts/tags/list +++ b/gcloud/artifacts/tags/list @@ -2,10 +2,10 @@ NAME gcloud artifacts tags list - list Artifact Registry tags SYNOPSIS - gcloud artifacts tags list - (--package=PACKAGE : --location=LOCATION --repository=REPOSITORY) - [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] - [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + gcloud artifacts tags list --package=PACKAGE + [--location=LOCATION --repository=REPOSITORY] [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION List all Artifact Registry tags in the specified package. @@ -27,49 +27,57 @@ EXAMPLES $ gcloud artifacts tags list --package=my-package --limit=5 + To list tags of package my-package with name as my-tag: + + $ gcloud artifacts tags list --package=my-package \ + --filter='name="projects/my-project/locations/us/repositories/my\ + -repo/packages/my-package/tags/my-tag"' + + To list tags of package my-package with a given partial name, use * to + match any character in name: + + $ gcloud artifacts tags list --package=my-package \ + --filter='name="projects/my-project/locations/us/repositories/my\ + -repo/packages/my-package/tags/my*"' + + $ gcloud artifacts tags list --package=my-package \ + --filter='name="projects/my-project/locations/us/repositories/my\ + -repo/packages/my-package/tags/*tag"' + REQUIRED FLAGS - Package resource - The parent package for the list of tags. 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. + --package=PACKAGE + List all tags in a specified artifact, such as a container image or a + language package. + +FLAGS + Repository resource - The Artifact Registry repository. If not specified, + the current artifacts/repository is used. The arguments in this group can + be used to specify the attributes of this resource. (NOTE) Some attributes + are not given arguments in this group but can be set in other ways. To set the project attribute: - ◆ provide the argument --package on the command line with a fully + ◆ provide the argument --repository on the command line with a fully specified name; + ◆ set the property artifacts/repository with a fully specified name; ◆ provide the argument --project on the command line; ◆ set the property core/project. - This must be specified. - - --package=PACKAGE - ID of the package or fully qualified identifier for the package. - - To set the package attribute: - ▸ provide the argument --package on the command line. - - This flag argument must be specified if any of the other arguments in - this group are specified. - --location=LOCATION - Location of the package. Overrides the default artifacts/location - property value for this command invocation. To configure the default - location, use the command: gcloud config set artifacts/location. + Location of the repository. To set the location attribute: - ▸ provide the argument --package on the command line with a fully - specified name; + ▸ provide the argument --repository on the command line with a + fully specified name; + ▸ set the property artifacts/repository with a fully specified + name; ▸ provide the argument --location on the command line; ▸ set the property artifacts/location. --repository=REPOSITORY - The repository associated with the package. Overrides the default - artifacts/repository property value for this command invocation. To - configure the default repository, use the command: gcloud config set - artifacts/repository. + ID of the repository or fully qualified identifier for the + repository. To set the repository attribute: - ▸ provide the argument --package on the command line with a fully - specified name; ▸ provide the argument --repository on the command line; ▸ set the property artifacts/repository. @@ -107,10 +115,6 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. -API REFERENCE - This command uses the artifactregistry/v1 API. The full documentation for - this API can be found at: https://cloud.google.com/artifacts/docs/ - NOTES These variants are also available: diff --git a/gcloud/artifacts/versions/help b/gcloud/artifacts/versions/help index 795a1f06b..4540d1505 100644 --- a/gcloud/artifacts/versions/help +++ b/gcloud/artifacts/versions/help @@ -37,6 +37,9 @@ COMMANDS list List Artifact Registry package versions. + update + Update annotations on an Artifact Registry package version. + NOTES These variants are also available: diff --git a/gcloud/artifacts/versions/list b/gcloud/artifacts/versions/list index 7a39c7c03..0996558ed 100644 --- a/gcloud/artifacts/versions/list +++ b/gcloud/artifacts/versions/list @@ -2,71 +2,112 @@ NAME gcloud artifacts versions list - list Artifact Registry package versions SYNOPSIS - gcloud artifacts versions list - (--package=PACKAGE : --location=LOCATION --repository=REPOSITORY) - [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] - [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + gcloud artifacts versions list --package=PACKAGE + [--location=LOCATION --repository=REPOSITORY] [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION - List all Artifact Registry package versions in the specified package. + List all Artifact Registry versions in the specified package. To specify the maximum number of versions to list, use the --limit flag. EXAMPLES - The following command lists a maximum of five versions: + The following command lists a maximum of five packages versions: $ gcloud artifacts versions list --limit=5 - The following command lists versions in my-package by specifying the - fully-qualified path: + To list versions of package my_pkg with name as 1.0-SNAPSHOT: + + $ gcloud artifacts versions list --package=my_pkg \ + --filter='name="projects/my-project/locations/us/repositories/my\ + -repo/packages/my_pkg/versions/1.0-SNAPSHOT"' + + To list versions of package my_pkg with a given partial name, use * to + match any character in name: + + $ gcloud artifacts versions list --package=my_pkg \ + --filter='name="projects/my-project/locations/us/repositories/my\ + -repo/packages/my_pkg/versions/1.0*"' + + $ gcloud artifacts versions list --package=my_pkg \ + --filter='name="projects/my-project/locations/us/repositories/my\ + -repo/packages/my_pkg/versions/*SNAPSHOT"' + + To list versions of package my_pkg that have annotations: + + $ gcloud artifacts versions list --package=my_pkg \ + --filter=annotations:* + + To list versions of package my_pkg with annotations pair as + [annotation_key: annotation_value]: + + $ gcloud artifacts versions list --package=my_pkg \ + --filter='annotations.annotation_key:annotation_value' + + To list versions of package my_pkg with annotations containing key as + my_key: + + $ gcloud artifacts versions list --package=my_pkg \ + --filter=annotations.my_key + + If the key or value contains special characters, such as `my.key` and `my.value`, backtick("`") is required: + + $ gcloud artifacts versions list --filter='annotations.`my.key`' $ gcloud artifacts versions list \ - --package=projects/my-project/locations/my-location/\ - repositories/my-repo/packages/my-package + --filter='annotations.`my.key`:`my.value`' + + To list versions of package my_pkg with given partial annotation key or + value, use * to match any character: + + $ gcloud artifacts versions list \ + --filter='annotations.*key:`*.value`' + + To list versions of package my_pkg ordered by create_time: + + $ gcloud artifacts versions list --package=my_pkg \ + --sort-by=create_time + + To list versions of package my_pkg ordered by update_time reversely: + + $ gcloud artifacts versions list --package=my_pkg \ + --sort-by=~update_time REQUIRED FLAGS - Package resource - The parent package for the list of versions. 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. + --package=PACKAGE + List all versions in a specified artifact, such as a container image or + a language package. + +FLAGS + Repository resource - The Artifact Registry repository. If not specified, + the current artifacts/repository is used. The arguments in this group can + be used to specify the attributes of this resource. (NOTE) Some attributes + are not given arguments in this group but can be set in other ways. To set the project attribute: - ◆ provide the argument --package on the command line with a fully + ◆ provide the argument --repository on the command line with a fully specified name; + ◆ set the property artifacts/repository with a fully specified name; ◆ provide the argument --project on the command line; ◆ set the property core/project. - This must be specified. - - --package=PACKAGE - ID of the package or fully qualified identifier for the package. - - To set the package attribute: - ▸ provide the argument --package on the command line. - - This flag argument must be specified if any of the other arguments in - this group are specified. - --location=LOCATION - Location of the package. Overrides the default artifacts/location - property value for this command invocation. To configure the default - location, use the command: gcloud config set artifacts/location. + Location of the repository. To set the location attribute: - ▸ provide the argument --package on the command line with a fully - specified name; + ▸ provide the argument --repository on the command line with a + fully specified name; + ▸ set the property artifacts/repository with a fully specified + name; ▸ provide the argument --location on the command line; ▸ set the property artifacts/location. --repository=REPOSITORY - The repository associated with the package. Overrides the default - artifacts/repository property value for this command invocation. To - configure the default repository, use the command: gcloud config set - artifacts/repository. + ID of the repository or fully qualified identifier for the + repository. To set the repository attribute: - ▸ provide the argument --package on the command line with a fully - specified name; ▸ provide the argument --repository on the command line; ▸ set the property artifacts/repository. @@ -104,10 +145,6 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. -API REFERENCE - This command uses the artifactregistry/v1 API. The full documentation for - this API can be found at: https://cloud.google.com/artifacts/docs/ - NOTES These variants are also available: diff --git a/gcloud/artifacts/versions/update b/gcloud/artifacts/versions/update new file mode 100644 index 000000000..054e3b839 --- /dev/null +++ b/gcloud/artifacts/versions/update @@ -0,0 +1,117 @@ +NAME + gcloud artifacts versions update - update annotations on an Artifact + Registry package version + +SYNOPSIS + gcloud artifacts versions update + (VERSION + : --location=LOCATION --package=PACKAGE --repository=REPOSITORY) + [--annotations=[ANNOTATIONS,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Update annotations on an Artifact Registry package version. + +EXAMPLES + To update annotations on version 1.0.0 of my-pkg when the project ID, + repository and location defaults are set, run the following command: + + CAUTION: This command will overwrite any existing annotations on the + version. + + $ gcloud artifacts versions update 1.0.0 --package=my-pkg \ + --annotations=key1=value1,key2=value2 + + To clear all annotations on the version run the following command: + + $ gcloud artifacts versions update 1.0.0 --package=my-pkg \ + --annotations={} + +POSITIONAL ARGUMENTS + Version resource - The Artifact Registry package version to update. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument version on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + VERSION + ID of the version or fully qualified identifier for the version. + + To set the version attribute: + ▸ provide the argument version on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location of the version. Overrides the default artifacts/location + property value for this command invocation. To configure the default + location, use the command: gcloud config set artifacts/location. + + To set the location attribute: + ▸ provide the argument version on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property artifacts/location. + + --package=PACKAGE + The package associated with the version. + + To set the package attribute: + ▸ provide the argument version on the command line with a fully + specified name; + ▸ provide the argument --package on the command line. + + --repository=REPOSITORY + The repository associated with the version. Overrides the default + artifacts/repository property value for this command invocation. To + configure the default repository, use the command: gcloud config set + artifacts/repository. + + To set the repository attribute: + ▸ provide the argument version on the command line with a fully + specified name; + ▸ provide the argument --repository on the command line; + ▸ set the property artifacts/repository. + +FLAGS + --annotations=[ANNOTATIONS,...] + List of annotations in the format of KEY=VALUE pairs to add, update, or + remove. Duplicate keys will be overwritten. For more details on + annotations, see https://google.aip.dev/148#annotations. + + KEY + Sets KEY value. + + VALUE + Sets VALUE value. + + Shorthand Example: + + --annotations=string=string + + JSON Example: + + --annotations='{"string": "string"}' + + File Example: + + --annotations=path_to_file.(yaml|json) + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the artifactregistry/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/artifacts/docs/ diff --git a/gcloud/assured/workloads/create b/gcloud/assured/workloads/create index cc15d4b56..3bcc95659 100644 --- a/gcloud/assured/workloads/create +++ b/gcloud/assured/workloads/create @@ -85,9 +85,13 @@ REQUIRED FLAGS --compliance-regime=COMPLIANCE_REGIME The compliance regime of the new Assured Workloads environment. - COMPLIANCE_REGIME must be one of: CJIS, FEDRAMP_HIGH, FEDRAMP_MODERATE, - IL4, US_REGIONAL_ACCESS, HIPAA, HITRUST, EU_REGIONS_AND_SUPPORT, - CA_REGIONS_AND_SUPPORT, ITAR, ASSURED_WORKLOADS_FOR_PARTNERS. + COMPLIANCE_REGIME must be one of: assured-workloads-for-partners, + au-regions-and-us-support, ca-protected-b, ca-regions-and-support, + cjis, eu-regions-and-support, fedramp-high, fedramp-moderate, hipaa, + hitrust, il2, il4, il5, isr-regions, isr-regions-and-support, itar, + jp-regions-and-support, + ksa-regions-and-support-with-sovereignty-controls, regional-controls, + us-regional-access. --display-name=DISPLAY_NAME The display name of the new Assured Workloads environment @@ -119,9 +123,10 @@ OPTIONAL FLAGS --partner=PARTNER The partner choice when creating a workload managed by local trusted - partners. PARTNER must be one of: LOCAL_CONTROLS_BY_S3NS, - SOVEREIGN_CONTROLS_BY_T_SYSTEMS, SOVEREIGN_CONTROLS_BY_CNTXT, - SOVEREIGN_CONTROLS_BY_CNTXT_NO_EKM. + partners. PARTNER must be one of: local-controls-by-s3ns, + sovereign-controls-by-cntxt, sovereign-controls-by-cntxt-no-ekm, + sovereign-controls-by-psn, sovereign-controls-by-sia-minsait, + sovereign-controls-by-t-systems. --partner-permissions=[KEY=VALUE,...] The partner permissions for the partner regime, for example, diff --git a/gcloud/beta/artifacts/files/list b/gcloud/beta/artifacts/files/list index c18f73f90..6da8be5df 100644 --- a/gcloud/beta/artifacts/files/list +++ b/gcloud/beta/artifacts/files/list @@ -14,34 +14,87 @@ DESCRIPTION To specify the maximum number of files to list, use the --limit flag. EXAMPLES - To list files in the current project under repository my-repo in - us-central1: + To list files in the current project under repository my-repo in us: - $ gcloud beta artifacts files list --repository=my-repo \ - --location=us-central1 + $ gcloud beta artifacts files list --repository=my-repo --location=us The following command lists a maximum of five files: $ gcloud beta artifacts files list --repository=my-repo \ - --location=us-central1 --limit=5 + --location=us --limit=5 - To list files in the current project under repository my-repo in - us-central1 owned by package my-package: + To list files in the current project under repository my-repo in us owned + by package my-package: $ gcloud beta artifacts files list --repository=my-repo \ - --location=us-central1 --package=my-package + --location=us --package=my-package - To list files in the current project under repository my-repo in - us-central1 owned by package my-package and version 1.0.0: + To list files in the current project under repository my-repo in us owned + by package my-package and version 1.0.0: $ gcloud beta artifacts files list --repository=my-repo \ - --location=us-central1 --package=my-package --version=1.0.0 + --location=us --package=my-package --version=1.0.0 - To list files in the current project under repository my-repo in - us-central1 owned by package my-package and tag name my-tag: + To list files in the current project under repository my-repo in us owned + by package my-package and tag name my-tag: $ gcloud beta artifacts files list --repository=my-repo \ - --location=us-central1 --package=my-package --tag=my-tag + --location=us --package=my-package --tag=my-tag + + To list files with name as my-file: + + $ gcloud beta artifacts files list \ + --filter='name="projects/my-project/locations/us/repositories/my\ + -repo/files/my-file"' + + To list files with a given partial name, use * to match any character in + name: + + $ gcloud beta artifacts files list \ + --filter='name="projects/my-project/locations/us/repositories/my\ + -repo/files/*file"' + + $ gcloud beta artifacts files list \ + --filter='name="projects/my-project/locations/us/repositories/my\ + -repo/files/my-*"' + + To list files that have annotations: + + $ gcloud beta artifacts files list --filter=annotations:* + + To list files with annotations pair as [annotation_key: annotation_value] + + $ gcloud beta artifacts files list \ + --filter='annotations.annotation_key:annotation_value' + + To list files with annotations containing key as my_key: + + $ gcloud beta artifacts files list --filter='annotations.my_key' + + If the key or value contains special characters, such as `my.key` and `my.value`, backtick("`") is required: + + $ gcloud beta artifacts files list --filter='annotations.`my.key`' + + $ gcloud beta artifacts files list \ + --filter='annotations.`my.key`:`my.value`' + + To list files with given partial annotation key or value, use * to match + any character: + + $ gcloud beta artifacts files list \ + --filter='annotations.*key:`*.value`' + + To list files in the current project under repository my-repo in us, + ordering by create_time: + + $ gcloud beta artifacts files list --repository=my-repo \ + --location=us --sort-by=create_time + + To list files in the current project under repository my-repo in us, + ordering by update_time reversely: + + $ gcloud beta artifacts files list --repository=my-repo \ + --location=us --sort-by=~update_time FLAGS --package=PACKAGE diff --git a/gcloud/beta/artifacts/packages/list b/gcloud/beta/artifacts/packages/list index 9f390339e..ded5d3ead 100644 --- a/gcloud/beta/artifacts/packages/list +++ b/gcloud/beta/artifacts/packages/list @@ -18,11 +18,63 @@ EXAMPLES $ gcloud beta artifacts packages list --limit=5 + To list packages with name as my-pkg: + + $ gcloud beta artifacts packages list \ + --filter='name="projects/my-project/locations/us/repositories/my\ + -repo/packages/my-pkg" + + To list packages with a given partial name, use * to match any character in + name: + + $ gcloud beta artifacts packages list \ + --filter='name="projects/my-project/locations/us/repositories/my\ + -repo/packages/*pkg"' + + $ gcloud beta artifacts packages list \ + --filter='name="projects/my-project/locations/us/repositories/my\ + -repo/packages/my*"' + + To list files that have annotations: + + $ gcloud beta artifacts packages list --filter=annotations:* + + To list packages with annotations pair as [annotation_key: + annotation_value]: + + $ gcloud beta artifacts packages list \ + --filter='annotations.annotation_key:annotation_value' + + To list packages with annotations containing key as my_key: + + $ gcloud beta artifacts packages list --filter='annotations.my_key' + + If the key or value contains special characters, such as `my.key` or `my.value`, backtick("`") is required: + + $ gcloud beta artifacts packages list --filter='annotations.`my.key`' + + $ gcloud beta artifacts packages list \ + --filter='annotations.`my.key`:`my.value`' + + To list packages with given partial annotation key or value, use * to match + any character: + + $ gcloud beta artifacts packages list \ + --filter='annotations.my_*:`*.value`' + + To list packages ordered by create_time: + + $ gcloud beta artifacts packages list --sort-by=create_time + + To list packages ordered by update_time reversely: + + $ gcloud beta artifacts packages list --sort-by=~update_time + FLAGS - Repository resource - The parent repository for the list of packages. 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. + Repository resource - The Artifact Registry repository. If not specified, + the current artifacts/repository is used. The arguments in this group can + be used to specify the attributes of this resource. (NOTE) Some attributes + are not given arguments in this group but can be set in other ways. To set the project attribute: ◆ provide the argument --repository on the command line with a fully @@ -32,9 +84,7 @@ FLAGS ◆ set the property core/project. --location=LOCATION - Location of the repository. Overrides the default artifacts/location - property value for this command invocation. To configure the default - location, use the command: gcloud config set artifacts/location. + Location of the repository. To set the location attribute: ▸ provide the argument --repository on the command line with a @@ -86,10 +136,6 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. -API REFERENCE - This command uses the artifactregistry/v1 API. The full documentation for - this API can be found at: https://cloud.google.com/artifacts/docs/ - NOTES This command is currently in beta and might change without notice. These variants are also available: diff --git a/gcloud/beta/artifacts/repositories/list b/gcloud/beta/artifacts/repositories/list index a77031b79..b8544b01f 100644 --- a/gcloud/beta/artifacts/repositories/list +++ b/gcloud/beta/artifacts/repositories/list @@ -18,6 +18,57 @@ EXAMPLES $ gcloud beta artifacts repositories list --limit=5 + To list repositories with name as `my_repo`: + + $ gcloud beta artifacts repositories list \ + --filter='name="projects/my-project/locations/us/repositories/my\ + _repo"' + + To list repositories with a given partial name, use `*` to match any character in name: + + $ gcloud beta artifacts repositories list \ + --filter='name="projects/my-project/locations/us/repositories/*r\ + epo"' + + $ gcloud beta artifacts repositories list \ + --filter='name="projects/my-project/locations/us/repositories/my\ + _*"' + + To list files that have annotations: + + $ gcloud beta artifacts repositories list --filter=annotations:* + + To list repositories with annotations pair as [annotation_key: annotation_value] + + $ gcloud beta artifacts repositories list \ + --filter='annotations.annotation_key:annotation_value' + + To list repositories with annotations containing key as `my_key`: + + $ gcloud beta artifacts repositories list \ + --filter='annotations.my_key' + + If the key or value contains special characters, such as `my.key` or `my.value`, backtick("`") is required: + + $ gcloud beta artifacts repositories list \ + --filter='annotations.`my.key`' + + $ gcloud beta artifacts repositories list \ + --filter='annotations.`my.key`:`my.value`' + + To list repositories with given partial annotation key or value, use `*` to match any character: + + $ gcloud beta artifacts repositories list \ + --filter='annotations.*key:`*.value`' + + To list repositories ordered by create_time: + + $ gcloud beta artifacts repositories list --sort-by=create_time + + To list repositories ordered by update_time reversely: + + $ gcloud beta artifacts repositories list--sort-by=~update_time + FLAGS Location resource - The Artifact Registry repository location. You can also set --location=all to list repositories across all locations. If you diff --git a/gcloud/beta/artifacts/tags/list b/gcloud/beta/artifacts/tags/list index c357730e6..805c35eb5 100644 --- a/gcloud/beta/artifacts/tags/list +++ b/gcloud/beta/artifacts/tags/list @@ -2,10 +2,10 @@ NAME gcloud beta artifacts tags list - list Artifact Registry tags SYNOPSIS - gcloud beta artifacts tags list - (--package=PACKAGE : --location=LOCATION --repository=REPOSITORY) - [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] - [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + gcloud beta artifacts tags list --package=PACKAGE + [--location=LOCATION --repository=REPOSITORY] [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) List all Artifact Registry tags in the specified package. @@ -27,49 +27,57 @@ EXAMPLES $ gcloud beta artifacts tags list --package=my-package --limit=5 + To list tags of package my-package with name as my-tag: + + $ gcloud beta artifacts tags list --package=my-package \ + --filter='name="projects/my-project/locations/us/repositories/my\ + -repo/packages/my-package/tags/my-tag"' + + To list tags of package my-package with a given partial name, use * to + match any character in name: + + $ gcloud beta artifacts tags list --package=my-package \ + --filter='name="projects/my-project/locations/us/repositories/my\ + -repo/packages/my-package/tags/my*"' + + $ gcloud beta artifacts tags list --package=my-package \ + --filter='name="projects/my-project/locations/us/repositories/my\ + -repo/packages/my-package/tags/*tag"' + REQUIRED FLAGS - Package resource - The parent package for the list of tags. 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. + --package=PACKAGE + List all tags in a specified artifact, such as a container image or a + language package. + +FLAGS + Repository resource - The Artifact Registry repository. If not specified, + the current artifacts/repository is used. The arguments in this group can + be used to specify the attributes of this resource. (NOTE) Some attributes + are not given arguments in this group but can be set in other ways. To set the project attribute: - ◆ provide the argument --package on the command line with a fully + ◆ provide the argument --repository on the command line with a fully specified name; + ◆ set the property artifacts/repository with a fully specified name; ◆ provide the argument --project on the command line; ◆ set the property core/project. - This must be specified. - - --package=PACKAGE - ID of the package or fully qualified identifier for the package. - - To set the package attribute: - ▸ provide the argument --package on the command line. - - This flag argument must be specified if any of the other arguments in - this group are specified. - --location=LOCATION - Location of the package. Overrides the default artifacts/location - property value for this command invocation. To configure the default - location, use the command: gcloud config set artifacts/location. + Location of the repository. To set the location attribute: - ▸ provide the argument --package on the command line with a fully - specified name; + ▸ provide the argument --repository on the command line with a + fully specified name; + ▸ set the property artifacts/repository with a fully specified + name; ▸ provide the argument --location on the command line; ▸ set the property artifacts/location. --repository=REPOSITORY - The repository associated with the package. Overrides the default - artifacts/repository property value for this command invocation. To - configure the default repository, use the command: gcloud config set - artifacts/repository. + ID of the repository or fully qualified identifier for the + repository. To set the repository attribute: - ▸ provide the argument --package on the command line with a fully - specified name; ▸ provide the argument --repository on the command line; ▸ set the property artifacts/repository. @@ -107,10 +115,6 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. -API REFERENCE - This command uses the artifactregistry/v1 API. The full documentation for - this API can be found at: https://cloud.google.com/artifacts/docs/ - NOTES This command is currently in beta and might change without notice. These variants are also available: diff --git a/gcloud/beta/artifacts/versions/list b/gcloud/beta/artifacts/versions/list index 1da15bb2d..672f6c6ce 100644 --- a/gcloud/beta/artifacts/versions/list +++ b/gcloud/beta/artifacts/versions/list @@ -3,72 +3,112 @@ NAME versions SYNOPSIS - gcloud beta artifacts versions list - (--package=PACKAGE : --location=LOCATION --repository=REPOSITORY) - [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] - [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + gcloud beta artifacts versions list --package=PACKAGE + [--location=LOCATION --repository=REPOSITORY] [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) List all Artifact Registry package versions in the specified - package. + (BETA) List all Artifact Registry versions in the specified package. To specify the maximum number of versions to list, use the --limit flag. EXAMPLES - The following command lists a maximum of five versions: + The following command lists a maximum of five packages versions: $ gcloud beta artifacts versions list --limit=5 - The following command lists versions in my-package by specifying the - fully-qualified path: + To list versions of package my_pkg with name as 1.0-SNAPSHOT: + + $ gcloud beta artifacts versions list --package=my_pkg \ + --filter='name="projects/my-project/locations/us/repositories/my\ + -repo/packages/my_pkg/versions/1.0-SNAPSHOT"' + + To list versions of package my_pkg with a given partial name, use * to + match any character in name: + + $ gcloud beta artifacts versions list --package=my_pkg \ + --filter='name="projects/my-project/locations/us/repositories/my\ + -repo/packages/my_pkg/versions/1.0*"' + + $ gcloud beta artifacts versions list --package=my_pkg \ + --filter='name="projects/my-project/locations/us/repositories/my\ + -repo/packages/my_pkg/versions/*SNAPSHOT"' + + To list versions of package my_pkg that have annotations: + + $ gcloud beta artifacts versions list --package=my_pkg \ + --filter=annotations:* + + To list versions of package my_pkg with annotations pair as + [annotation_key: annotation_value]: + + $ gcloud beta artifacts versions list --package=my_pkg \ + --filter='annotations.annotation_key:annotation_value' + + To list versions of package my_pkg with annotations containing key as + my_key: + + $ gcloud beta artifacts versions list --package=my_pkg \ + --filter=annotations.my_key + + If the key or value contains special characters, such as `my.key` and `my.value`, backtick("`") is required: + + $ gcloud beta artifacts versions list --filter='annotations.`my.key`' $ gcloud beta artifacts versions list \ - --package=projects/my-project/locations/my-location/\ - repositories/my-repo/packages/my-package + --filter='annotations.`my.key`:`my.value`' + + To list versions of package my_pkg with given partial annotation key or + value, use * to match any character: + + $ gcloud beta artifacts versions list \ + --filter='annotations.*key:`*.value`' + + To list versions of package my_pkg ordered by create_time: + + $ gcloud beta artifacts versions list --package=my_pkg \ + --sort-by=create_time + + To list versions of package my_pkg ordered by update_time reversely: + + $ gcloud beta artifacts versions list --package=my_pkg \ + --sort-by=~update_time REQUIRED FLAGS - Package resource - The parent package for the list of versions. 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. + --package=PACKAGE + List all versions in a specified artifact, such as a container image or + a language package. + +FLAGS + Repository resource - The Artifact Registry repository. If not specified, + the current artifacts/repository is used. The arguments in this group can + be used to specify the attributes of this resource. (NOTE) Some attributes + are not given arguments in this group but can be set in other ways. To set the project attribute: - ◆ provide the argument --package on the command line with a fully + ◆ provide the argument --repository on the command line with a fully specified name; + ◆ set the property artifacts/repository with a fully specified name; ◆ provide the argument --project on the command line; ◆ set the property core/project. - This must be specified. - - --package=PACKAGE - ID of the package or fully qualified identifier for the package. - - To set the package attribute: - ▸ provide the argument --package on the command line. - - This flag argument must be specified if any of the other arguments in - this group are specified. - --location=LOCATION - Location of the package. Overrides the default artifacts/location - property value for this command invocation. To configure the default - location, use the command: gcloud config set artifacts/location. + Location of the repository. To set the location attribute: - ▸ provide the argument --package on the command line with a fully - specified name; + ▸ provide the argument --repository on the command line with a + fully specified name; + ▸ set the property artifacts/repository with a fully specified + name; ▸ provide the argument --location on the command line; ▸ set the property artifacts/location. --repository=REPOSITORY - The repository associated with the package. Overrides the default - artifacts/repository property value for this command invocation. To - configure the default repository, use the command: gcloud config set - artifacts/repository. + ID of the repository or fully qualified identifier for the + repository. To set the repository attribute: - ▸ provide the argument --package on the command line with a fully - specified name; ▸ provide the argument --repository on the command line; ▸ set the property artifacts/repository. @@ -106,10 +146,6 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. -API REFERENCE - This command uses the artifactregistry/v1 API. The full documentation for - this API can be found at: https://cloud.google.com/artifacts/docs/ - NOTES This command is currently in beta and might change without notice. These variants are also available: diff --git a/gcloud/beta/assured/workloads/create b/gcloud/beta/assured/workloads/create index 7e953dca0..35b0b223c 100644 --- a/gcloud/beta/assured/workloads/create +++ b/gcloud/beta/assured/workloads/create @@ -85,9 +85,13 @@ REQUIRED FLAGS --compliance-regime=COMPLIANCE_REGIME The compliance regime of the new Assured Workloads environment. - COMPLIANCE_REGIME must be one of: CJIS, FEDRAMP_HIGH, FEDRAMP_MODERATE, - IL4, US_REGIONAL_ACCESS, HIPAA, HITRUST, EU_REGIONS_AND_SUPPORT, - CA_REGIONS_AND_SUPPORT, ITAR, ASSURED_WORKLOADS_FOR_PARTNERS. + COMPLIANCE_REGIME must be one of: assured-workloads-for-partners, + au-regions-and-us-support, ca-protected-b, ca-regions-and-support, + cjis, eu-regions-and-support, fedramp-high, fedramp-moderate, hipaa, + hitrust, il2, il4, il5, isr-regions, isr-regions-and-support, itar, + jp-regions-and-support, + ksa-regions-and-support-with-sovereignty-controls, regional-controls, + us-regional-access. --display-name=DISPLAY_NAME The display name of the new Assured Workloads environment @@ -119,9 +123,10 @@ OPTIONAL FLAGS --partner=PARTNER The partner choice when creating a workload managed by local trusted - partners. PARTNER must be one of: LOCAL_CONTROLS_BY_S3NS, - SOVEREIGN_CONTROLS_BY_T_SYSTEMS, SOVEREIGN_CONTROLS_BY_CNTXT, - SOVEREIGN_CONTROLS_BY_CNTXT_NO_EKM. + partners. PARTNER must be one of: local-controls-by-s3ns, + sovereign-controls-by-cntxt, sovereign-controls-by-cntxt-no-ekm, + sovereign-controls-by-psn, sovereign-controls-by-sia-minsait, + sovereign-controls-by-t-systems. --partner-permissions=[KEY=VALUE,...] The partner permissions for the partner regime, for example, diff --git a/gcloud/beta/compute/instance-templates/create b/gcloud/beta/compute/instance-templates/create index 9240fc8ec..cc339c29e 100644 --- a/gcloud/beta/compute/instance-templates/create +++ b/gcloud/beta/compute/instance-templates/create @@ -53,7 +53,7 @@ SYNOPSIS [--source-instance-zone=SOURCE_INSTANCE_ZONE] [--stack-type=STACK_TYPE] [--subnet=SUBNET] [--tags=TAG,[TAG,...]] [--termination-time=TERMINATION_TIME] - [--threads-per-core=THREADS_PER_CORE] + [--threads-per-core=THREADS_PER_CORE] [--turbo-mode=TURBO_MODE] [--visible-core-count=VISIBLE_CORE_COUNT] [--address=ADDRESS | --no-address] [--boot-disk-kms-key=BOOT_DISK_KMS_KEY @@ -957,6 +957,14 @@ FLAGS For more information about configuring SMT, see: https://cloud.google.com/compute/docs/instances/configuring-simultaneous-multithreading. + --turbo-mode=TURBO_MODE + Turbo mode to use for the instance. Supported modes include: + ◆ ALL_CORE_MAX + + To achieve all-core-turbo frequency for more consistent CPU + performance, set the field to ALL_CORE_MAX. The field is unset by + default, which results in maximum performance single-core boosting. + --visible-core-count=VISIBLE_CORE_COUNT The number of physical cores to expose to the instance's guest operating system. The number of virtual CPUs visible to the instance's diff --git a/gcloud/beta/compute/instances/bulk/create b/gcloud/beta/compute/instances/bulk/create index f3b41360d..940049061 100644 --- a/gcloud/beta/compute/instances/bulk/create +++ b/gcloud/beta/compute/instances/bulk/create @@ -47,7 +47,7 @@ SYNOPSIS [--stack-type=STACK_TYPE] [--subnet=SUBNET] [--tags=TAG,[TAG,...]] [--target-distribution-shape=SHAPE] [--termination-time=TERMINATION_TIME] - [--threads-per-core=THREADS_PER_CORE] + [--threads-per-core=THREADS_PER_CORE] [--turbo-mode=TURBO_MODE] [--visible-core-count=VISIBLE_CORE_COUNT] [--boot-disk-kms-key=BOOT_DISK_KMS_KEY : --boot-disk-kms-keyring=BOOT_DISK_KMS_KEYRING @@ -840,6 +840,14 @@ OPTIONAL FLAGS For more information about configuring SMT, see: https://cloud.google.com/compute/docs/instances/configuring-simultaneous-multithreading. + --turbo-mode=TURBO_MODE + Turbo mode to use for the instance. Supported modes include: + ◆ ALL_CORE_MAX + + To achieve all-core-turbo frequency for more consistent CPU + performance, set the field to ALL_CORE_MAX. The field is unset by + default, which results in maximum performance single-core boosting. + --visible-core-count=VISIBLE_CORE_COUNT The number of physical cores to expose to the instance's guest operating system. The number of virtual CPUs visible to the instance's diff --git a/gcloud/beta/compute/instances/create b/gcloud/beta/compute/instances/create index b3f6dae0e..86a7805b9 100644 --- a/gcloud/beta/compute/instances/create +++ b/gcloud/beta/compute/instances/create @@ -58,7 +58,7 @@ SYNOPSIS [--source-machine-image-csek-key-file=FILE] [--stack-type=STACK_TYPE] [--subnet=SUBNET] [--tags=TAG,[TAG,...]] [--termination-time=TERMINATION_TIME] - [--threads-per-core=THREADS_PER_CORE] + [--threads-per-core=THREADS_PER_CORE] [--turbo-mode=TURBO_MODE] [--visible-core-count=VISIBLE_CORE_COUNT] [--zone=ZONE] [--address=ADDRESS | --no-address] [--boot-disk-kms-key=BOOT_DISK_KMS_KEY @@ -1023,6 +1023,14 @@ FLAGS For more information about configuring SMT, see: https://cloud.google.com/compute/docs/instances/configuring-simultaneous-multithreading. + --turbo-mode=TURBO_MODE + Turbo mode to use for the instance. Supported modes include: + ◆ ALL_CORE_MAX + + To achieve all-core-turbo frequency for more consistent CPU + performance, set the field to ALL_CORE_MAX. The field is unset by + default, which results in maximum performance single-core boosting. + --visible-core-count=VISIBLE_CORE_COUNT The number of physical cores to expose to the instance's guest operating system. The number of virtual CPUs visible to the instance's diff --git a/gcloud/beta/compute/network-endpoint-groups/create b/gcloud/beta/compute/network-endpoint-groups/create index cb647ab28..aebd9ff22 100644 --- a/gcloud/beta/compute/network-endpoint-groups/create +++ b/gcloud/beta/compute/network-endpoint-groups/create @@ -123,12 +123,12 @@ FLAGS serverless, gce-vm-ip, private-service-connect, gce-vm-ip-portmap. --producer-port=PRODUCER_PORT - The psc producer port to use when consumer PSC NEG connects to a - producer. - - If this flag isn't specified for a PSC NEG with endpoint type - private-service-connect, then PSC NEG will be connected to a first port - in the available pcs producer port range. + The producer port to use when a consumer PSC NEG connects to a + producer's internal network load balancer. If this flag isn't specified + for a NEG with endpoint type private-service-connect, the PSC NEG will + connect to port 443 or the first available port in the PSC producer + port range, or to port 1 if the PSC producer's forwarding rule ports + flag is set to all-ports. This flag is not supported for NEGs with endpoint type other than private-service-connect. diff --git a/gcloud/beta/compute/security-policies/import b/gcloud/beta/compute/security-policies/import index 3ba4708de..a1ada73ca 100644 --- a/gcloud/beta/compute/security-policies/import +++ b/gcloud/beta/compute/security-policies/import @@ -9,9 +9,8 @@ SYNOPSIS DESCRIPTION (BETA) gcloud beta compute security-policies import imports a security - policy to update an existing policy. The command does not support updating - rules for the policy. To create a new policy from a file please use the - create command instead. + policy to update an existing policy. To create a new policy from a file + please use the create command instead. EXAMPLES To import a security policy from a YAML file run this: diff --git a/gcloud/beta/container/backup-restore/restore-plans/create b/gcloud/beta/container/backup-restore/restore-plans/create index f36c4fa32..9b3f95fa4 100644 --- a/gcloud/beta/container/backup-restore/restore-plans/create +++ b/gcloud/beta/container/backup-restore/restore-plans/create @@ -37,7 +37,8 @@ EXAMPLES --cluster=projects/my-project/locations/us-central1/clusters/\ my-cluster \ --backup-plan=projects/my-project/locations/us-central1/\ - backupPlans/my-backup-plan --all-namespaces + backupPlans/my-backup-plan --all-namespaces \ + --namespaced-resource-restore-mode=merge-skip-on-conflict POSITIONAL ARGUMENTS Restore plan resource - Name of the restore plan to create. Once the plan diff --git a/gcloud/beta/container/clusters/update b/gcloud/beta/container/clusters/update index 44d9685aa..56c1415f9 100644 --- a/gcloud/beta/container/clusters/update +++ b/gcloud/beta/container/clusters/update @@ -50,6 +50,9 @@ SYNOPSIS | --additional-pod-ipv4-ranges=NAME,[NAME,...] --remove-additional-pod-ipv4-ranges=NAME,[NAME,...] | --additional-zones=[ZONE,...] | --node-locations=ZONE,[ZONE,...] + | --logging=[COMPONENT,...] + --monitoring=[COMPONENT,...] --disable-managed-prometheus + | --enable-managed-prometheus | --binauthz-policy-bindings=[name=BINAUTHZ_POLICY] --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE | --enable-binauthz | --clear-maintenance-window @@ -93,9 +96,7 @@ SYNOPSIS | --enable-insecure-binding-system-authenticated --enable-insecure-binding-system-unauthenticated | --enable-tpu --enable-tpu-service-networking | --tpu-ipv4-cidr=CIDR - | --logging=[COMPONENT,...] - --monitoring=[COMPONENT,...] --disable-managed-prometheus - | --enable-managed-prometheus | --logging-service=LOGGING_SERVICE + | --logging-service=LOGGING_SERVICE --monitoring-service=MONITORING_SERVICE | --password=PASSWORD --enable-basic-auth | --username=USERNAME, -u USERNAME) [--async] @@ -843,6 +844,52 @@ REQUIRED FLAGS --location us-central1-a \ --node-locations us-central1-a,us-central1-b + --logging=[COMPONENT,...] + Set the components that have logging enabled. Valid component values + are: SYSTEM, WORKLOAD, API_SERVER, CONTROLLER_MANAGER, SCHEDULER, + NONE + + For more information, see + https://cloud.google.com/kubernetes-engine/docs/concepts/about-logs#available-logs + + Examples: + + $ gcloud beta container clusters update --logging=SYSTEM + $ gcloud beta container clusters update \ + --logging=SYSTEM,API_SERVER,WORKLOAD + $ gcloud beta container clusters update --logging=NONE + + --monitoring=[COMPONENT,...] + Set the components that have monitoring enabled. Valid component + values are: SYSTEM, WORKLOAD (Deprecated), NONE, API_SERVER, + CONTROLLER_MANAGER, SCHEDULER, DAEMONSET, DEPLOYMENT, HPA, POD, + STATEFULSET, STORAGE, CADVISOR, KUBELET, DCGM + + For more information, see + https://cloud.google.com/kubernetes-engine/docs/how-to/configure-metrics#available-metrics + + Examples: + + $ gcloud beta container clusters update \ + --monitoring=SYSTEM,API_SERVER,POD + $ gcloud beta container clusters update --monitoring=NONE + + At most one of these can be specified: + + --disable-managed-prometheus + Disable managed collection for Managed Service for Prometheus. + + --enable-managed-prometheus + Enables managed collection for Managed Service for Prometheus in + the cluster. + + See + https://cloud.google.com/stackdriver/docs/managed-prometheus/setup-managed#enable-mgdcoll-gke + for more info. + + Enabled by default for cluster versions 1.27 or greater, use + --no-enable-managed-prometheus to disable. + Flags for Binary Authorization: --binauthz-policy-bindings=[name=BINAUTHZ_POLICY] @@ -1370,52 +1417,6 @@ REQUIRED FLAGS Can not be specified unless '--enable-tpu' and '--enable-ip-alias' are also specified. - --logging=[COMPONENT,...] - Set the components that have logging enabled. Valid component values - are: SYSTEM, WORKLOAD, API_SERVER, CONTROLLER_MANAGER, SCHEDULER, - NONE - - For more information, see - https://cloud.google.com/kubernetes-engine/docs/concepts/about-logs#available-logs - - Examples: - - $ gcloud beta container clusters update --logging=SYSTEM - $ gcloud beta container clusters update \ - --logging=SYSTEM,API_SERVER,WORKLOAD - $ gcloud beta container clusters update --logging=NONE - - --monitoring=[COMPONENT,...] - Set the components that have monitoring enabled. Valid component - values are: SYSTEM, WORKLOAD (Deprecated), NONE, API_SERVER, - CONTROLLER_MANAGER, SCHEDULER, DAEMONSET, DEPLOYMENT, HPA, POD, - STATEFULSET, STORAGE, CADVISOR, KUBELET, DCGM - - For more information, see - https://cloud.google.com/kubernetes-engine/docs/how-to/configure-metrics#available-metrics - - Examples: - - $ gcloud beta container clusters update \ - --monitoring=SYSTEM,API_SERVER,POD - $ gcloud beta container clusters update --monitoring=NONE - - At most one of these can be specified: - - --disable-managed-prometheus - Disable managed collection for Managed Service for Prometheus. - - --enable-managed-prometheus - Enables managed collection for Managed Service for Prometheus in - the cluster. - - See - https://cloud.google.com/stackdriver/docs/managed-prometheus/setup-managed#enable-mgdcoll-gke - for more info. - - Enabled by default for cluster versions 1.27 or greater, use - --no-enable-managed-prometheus to disable. - --logging-service=LOGGING_SERVICE (DEPRECATED) Logging service to use for the cluster. Options are: "logging.googleapis.com/kubernetes" (the Google Cloud Logging service diff --git a/gcloud/beta/container/node-pools/update b/gcloud/beta/container/node-pools/update index 4c628436d..8a17dd780 100644 --- a/gcloud/beta/container/node-pools/update +++ b/gcloud/beta/container/node-pools/update @@ -4,7 +4,12 @@ NAME SYNOPSIS gcloud beta container node-pools update NAME - (--containerd-config-from-file=PATH_TO_FILE + (--accelerator=[type=TYPE,[count=COUNT, + gpu-driver-version=GPU_DRIVER_VERSION, + gpu-partition-size=GPU_PARTITION_SIZE, + gpu-sharing-strategy=GPU_SHARING_STRATEGY, + max-shared-clients-per-gpu=MAX_SHARED_CLIENTS_PER_GPU],...] + | --containerd-config-from-file=PATH_TO_FILE | --enable-confidential-nodes | --enable-gvnic | --enable-image-streaming | --enable-insecure-kubelet-readonly-port | --enable-private-nodes | --enable-queued-provisioning @@ -51,6 +56,49 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS Exactly one of these must be specified: + --accelerator=[type=TYPE,[count=COUNT,gpu-driver-version=GPU_DRIVER_VERSION,gpu-partition-size=GPU_PARTITION_SIZE,gpu-sharing-strategy=GPU_SHARING_STRATEGY,max-shared-clients-per-gpu=MAX_SHARED_CLIENTS_PER_GPU],...] + Attaches accelerators (e.g. GPUs) to all nodes. + + type + (Required) The specific type (e.g. nvidia-tesla-t4 for NVIDIA T4) + of accelerator to attach to the instances. Use gcloud compute + accelerator-types list to learn about all available accelerator + types. + + count + (Optional) The number of accelerators to attach to the instances. + The default value is 1. + + gpu-driver-version + (Optional) The NVIDIA driver version to install. + GPU_DRIVER_VERSION must be one of: + + `default`: Install the default driver version for this GKE version. + + `latest`: Install the latest driver version available for this GKE version. + Can only be used for nodes that use Container-Optimized OS. + + `disabled`: Skip automatic driver installation. You must manually install a + driver after you create the cluster. If you omit the flag `gpu-driver-version`, + this is the default option. To learn how to manually install the GPU driver, + refer to: https://cloud.google.com/kubernetes-engine/docs/how-to/gpus#installing_drivers + + gpu-partition-size + (Optional) The GPU partition size used when running + multi-instance GPUs. For information about multi-instance GPUs, + refer to: + https://cloud.google.com/kubernetes-engine/docs/how-to/gpus-multi + + gpu-sharing-strategy + (Optional) The GPU sharing strategy (e.g. time-sharing) to use. + For information about GPU sharing, refer to: + https://cloud.google.com/kubernetes-engine/docs/concepts/timesharing-gpus + + max-shared-clients-per-gpu + (Optional) The max number of containers allowed to share each GPU + on the node. This field is used together with + gpu-sharing-strategy. + --containerd-config-from-file=PATH_TO_FILE Path of the YAML file that contains containerd configuration entries like configuring access to private image registries. diff --git a/gcloud/beta/filestore/instances/create b/gcloud/beta/filestore/instances/create index 1b4c3e747..1dc8a1ed5 100644 --- a/gcloud/beta/filestore/instances/create +++ b/gcloud/beta/filestore/instances/create @@ -13,6 +13,8 @@ SYNOPSIS [--managed-ad=[computer=COMPUTER],[domain=DOMAIN]] [--protocol=PROTOCOL; default="NFS_V3"] [--region=REGION] [--source-instance=SOURCE_INSTANCE] [--tier=TIER; default="BASIC_HDD"] + [--deletion-protection + : --deletion-protection-reason=DELETION_PROTECTION_REASON] [--kms-key=KMS_KEY : --kms-keyring=KMS_KEYRING --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT] [GCLOUD_WIDE_FLAG ...] @@ -287,6 +289,18 @@ OPTIONAL FLAGS performance that scales with capacity and allows you to grow and shrink capacity. + Deletion protection control options. When deletion protection is enabled, + the instance cannot be deleted. + + --deletion-protection + Enables deletion protection for the instance. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --deletion-protection-reason=DELETION_PROTECTION_REASON + The reason for enabling deletion protection for the instance. + Key resource - The Cloud KMS (Key Management Service) cryptokey that will be used to protect the instance. The 'Filestore Service Agent' service account must hold permission 'Cloud KMS CryptoKey Encrypter/Decrypter'. diff --git a/gcloud/beta/filestore/instances/update b/gcloud/beta/filestore/instances/update index e5a20b66c..9620b1bb8 100644 --- a/gcloud/beta/filestore/instances/update +++ b/gcloud/beta/filestore/instances/update @@ -10,7 +10,10 @@ SYNOPSIS | --managed-ad=[computer=COMPUTER],[domain=DOMAIN]] [[--file-share=[capacity=CAPACITY], [name=NAME],[nfs-export-options=NFS-EXPORT-OPTIONS] - : --clear-nfs-export-options]] [GCLOUD_WIDE_FLAG ...] + : --clear-nfs-export-options]] + [--[no-]deletion-protection + --deletion-protection-reason=DELETION_PROTECTION_REASON] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Update a Filestore instance. @@ -240,6 +243,17 @@ FLAGS Clears the NfsExportOptions. Must specify --file-share flag if --clear-nfs-export-options is specified. + Deletion protection control options. When deletion protection is enabled, + the instance cannot be deleted. + + --[no-]deletion-protection + Enables deletion protection for the instance. Use + --deletion-protection to enable and --no-deletion-protection to + disable. + + --deletion-protection-reason=DELETION_PROTECTION_REASON + The reason for enabling deletion protection for the instance. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/beta/functions/deploy b/gcloud/beta/functions/deploy index d4afd6c8a..68d2a558e 100644 --- a/gcloud/beta/functions/deploy +++ b/gcloud/beta/functions/deploy @@ -109,7 +109,7 @@ FLAGS --concurrency=CONCURRENCY Set the maximum number of concurrent requests allowed per container instance. Leave concurrency unspecified to receive the server default - value. Only applicable when the --gen2 flag is provided. + value. --docker-registry=DOCKER_REGISTRY Docker Registry to use for storing the function's Docker images. The @@ -164,8 +164,6 @@ FLAGS If not provided, the function will use the project's default service account for Compute Engine. - This is only relevant when --gen2 is provided. - --runtime=RUNTIME Runtime in which to run the function. @@ -186,8 +184,7 @@ FLAGS secure-optional. --serve-all-traffic-latest-revision - If specified, latest function revision will be served all traffic. This - is only relevant when --gen2 is provided. + If specified, latest function revision will be served all traffic. --service-account=SERVICE_ACCOUNT The email address of the IAM service account associated with the @@ -284,8 +281,7 @@ FLAGS --trigger-location=TRIGGER_LOCATION The location of the trigger, which must be a region or multi-region - where the relevant events originate. This is only relevant when --gen2 - is provided. + where the relevant events originate. --trigger-service-account=TRIGGER_SERVICE_ACCOUNT The email address of the IAM service account associated with the @@ -295,8 +291,6 @@ FLAGS If not provided, the function will use the project's default service account for Compute Engine. - This is only relevant when --gen2 is provided. - --update-labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to update. If a label exists, its value is modified. Otherwise, a new label is created. @@ -608,8 +602,8 @@ FLAGS memory limit unless you specify this flag. --cpu=CPU - The number of available CPUs to set. Only valid when --gen2 and - --memory=MEMORY are specified. + The number of available CPUs to set. Only valid when --memory=MEMORY is + specified. Examples: .5, 2, 2.0, 2000m. @@ -668,14 +662,12 @@ FLAGS The Eventarc matching criteria for the trigger. The criteria can be specified either as a single comma-separated argument or as multiple arguments. The filters must include the type attribute, as well as - any other attributes that are expected for the chosen type. This is - only relevant when --gen2 is provided. + any other attributes that are expected for the chosen type. --trigger-event-filters-path-pattern=[ATTRIBUTE=PATH_PATTERN,...] The Eventarc matching criteria for the trigger in path pattern format. The criteria can be specified as a single comma-separated - argument or as multiple arguments. This is only relevant when --gen2 - is provided. + argument or as multiple arguments. The provided attribute/value pair will be used with the match-path-pattern operator to configure the trigger, see diff --git a/gcloud/beta/iam/help b/gcloud/beta/iam/help index f39cf69cf..b6552f992 100644 --- a/gcloud/beta/iam/help +++ b/gcloud/beta/iam/help @@ -17,7 +17,7 @@ DESCRIPTION More information on Cloud IAM can be found here: https://cloud.google.com/iam and detailed documentation can be found here: - https://cloud.google.com/iam/docs/ + https://cloud.google.com/iam/docs/. GCLOUD WIDE FLAGS These flags are available to all commands: --help. diff --git a/gcloud/beta/managed-kafka/clusters/create b/gcloud/beta/managed-kafka/clusters/create index 022e7e8a5..2c261b821 100644 --- a/gcloud/beta/managed-kafka/clusters/create +++ b/gcloud/beta/managed-kafka/clusters/create @@ -105,7 +105,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the managedkafka/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/managed-kafka + API can be found at: + https://cloud.google.com/managed-service-for-apache-kafka/docs NOTES This command is currently in beta and might change without notice. This diff --git a/gcloud/beta/managed-kafka/clusters/delete b/gcloud/beta/managed-kafka/clusters/delete index b110f4193..bdca06d5c 100644 --- a/gcloud/beta/managed-kafka/clusters/delete +++ b/gcloud/beta/managed-kafka/clusters/delete @@ -65,7 +65,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the managedkafka/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/managed-kafka + API can be found at: + https://cloud.google.com/managed-service-for-apache-kafka/docs NOTES This command is currently in beta and might change without notice. This diff --git a/gcloud/beta/managed-kafka/clusters/describe b/gcloud/beta/managed-kafka/clusters/describe index 976a6bee3..8e94fd071 100644 --- a/gcloud/beta/managed-kafka/clusters/describe +++ b/gcloud/beta/managed-kafka/clusters/describe @@ -60,7 +60,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the managedkafka/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/managed-kafka + API can be found at: + https://cloud.google.com/managed-service-for-apache-kafka/docs NOTES This command is currently in beta and might change without notice. This diff --git a/gcloud/beta/managed-kafka/clusters/list b/gcloud/beta/managed-kafka/clusters/list index ea5f3b68e..ba2735e5c 100644 --- a/gcloud/beta/managed-kafka/clusters/list +++ b/gcloud/beta/managed-kafka/clusters/list @@ -72,7 +72,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the managedkafka/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/managed-kafka + API can be found at: + https://cloud.google.com/managed-service-for-apache-kafka/docs NOTES This command is currently in beta and might change without notice. This diff --git a/gcloud/beta/managed-kafka/clusters/update b/gcloud/beta/managed-kafka/clusters/update index 0e1838870..53f54a350 100644 --- a/gcloud/beta/managed-kafka/clusters/update +++ b/gcloud/beta/managed-kafka/clusters/update @@ -98,7 +98,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the managedkafka/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/managed-kafka + API can be found at: + https://cloud.google.com/managed-service-for-apache-kafka/docs NOTES This command is currently in beta and might change without notice. This diff --git a/gcloud/beta/managed-kafka/consumer-groups/delete b/gcloud/beta/managed-kafka/consumer-groups/delete index 8ddf23402..cd20c16dc 100644 --- a/gcloud/beta/managed-kafka/consumer-groups/delete +++ b/gcloud/beta/managed-kafka/consumer-groups/delete @@ -70,7 +70,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the managedkafka/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/managed-kafka + API can be found at: + https://cloud.google.com/managed-service-for-apache-kafka/docs NOTES This command is currently in beta and might change without notice. This diff --git a/gcloud/beta/managed-kafka/consumer-groups/describe b/gcloud/beta/managed-kafka/consumer-groups/describe index 5d2cf2e44..98f3fd38d 100644 --- a/gcloud/beta/managed-kafka/consumer-groups/describe +++ b/gcloud/beta/managed-kafka/consumer-groups/describe @@ -70,7 +70,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the managedkafka/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/managed-kafka + API can be found at: + https://cloud.google.com/managed-service-for-apache-kafka/docs NOTES This command is currently in beta and might change without notice. This diff --git a/gcloud/beta/managed-kafka/consumer-groups/list b/gcloud/beta/managed-kafka/consumer-groups/list index e99e1c9e9..a7b96abd5 100644 --- a/gcloud/beta/managed-kafka/consumer-groups/list +++ b/gcloud/beta/managed-kafka/consumer-groups/list @@ -89,7 +89,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the managedkafka/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/managed-kafka + API can be found at: + https://cloud.google.com/managed-service-for-apache-kafka/docs NOTES This command is currently in beta and might change without notice. This diff --git a/gcloud/beta/managed-kafka/consumer-groups/update b/gcloud/beta/managed-kafka/consumer-groups/update index 095cf8d66..5e6a1ec7f 100644 --- a/gcloud/beta/managed-kafka/consumer-groups/update +++ b/gcloud/beta/managed-kafka/consumer-groups/update @@ -94,7 +94,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the managedkafka/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/managed-kafka + API can be found at: + https://cloud.google.com/managed-service-for-apache-kafka/docs NOTES This command is currently in beta and might change without notice. This diff --git a/gcloud/beta/managed-kafka/topics/create b/gcloud/beta/managed-kafka/topics/create index dca97d724..7b43e6bd1 100644 --- a/gcloud/beta/managed-kafka/topics/create +++ b/gcloud/beta/managed-kafka/topics/create @@ -90,7 +90,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the managedkafka/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/managed-kafka + API can be found at: + https://cloud.google.com/managed-service-for-apache-kafka/docs NOTES This command is currently in beta and might change without notice. This diff --git a/gcloud/beta/managed-kafka/topics/delete b/gcloud/beta/managed-kafka/topics/delete index 9bb6efc31..07aadfe5e 100644 --- a/gcloud/beta/managed-kafka/topics/delete +++ b/gcloud/beta/managed-kafka/topics/delete @@ -68,7 +68,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the managedkafka/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/managed-kafka + API can be found at: + https://cloud.google.com/managed-service-for-apache-kafka/docs NOTES This command is currently in beta and might change without notice. This diff --git a/gcloud/beta/managed-kafka/topics/describe b/gcloud/beta/managed-kafka/topics/describe index 176c8a8d8..b69aee128 100644 --- a/gcloud/beta/managed-kafka/topics/describe +++ b/gcloud/beta/managed-kafka/topics/describe @@ -68,7 +68,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the managedkafka/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/managed-kafka + API can be found at: + https://cloud.google.com/managed-service-for-apache-kafka/docs NOTES This command is currently in beta and might change without notice. This diff --git a/gcloud/beta/managed-kafka/topics/list b/gcloud/beta/managed-kafka/topics/list index b8fc5c05d..0ca47f641 100644 --- a/gcloud/beta/managed-kafka/topics/list +++ b/gcloud/beta/managed-kafka/topics/list @@ -88,7 +88,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the managedkafka/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/managed-kafka + API can be found at: + https://cloud.google.com/managed-service-for-apache-kafka/docs NOTES This command is currently in beta and might change without notice. This diff --git a/gcloud/beta/managed-kafka/topics/update b/gcloud/beta/managed-kafka/topics/update index 3376102cd..bb92b524d 100644 --- a/gcloud/beta/managed-kafka/topics/update +++ b/gcloud/beta/managed-kafka/topics/update @@ -92,7 +92,8 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the managedkafka/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/managed-kafka + API can be found at: + https://cloud.google.com/managed-service-for-apache-kafka/docs NOTES This command is currently in beta and might change without notice. This diff --git a/gcloud/beta/memorystore/instances/update b/gcloud/beta/memorystore/instances/update index cc0261079..cc0de3c45 100644 --- a/gcloud/beta/memorystore/instances/update +++ b/gcloud/beta/memorystore/instances/update @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud beta memorystore instances update (INSTANCE : --location=LOCATION) - [--async] [--deletion-protection-enabled] + [--async] [--[no-]deletion-protection-enabled] [--replica-count=REPLICA_COUNT] [--request-id=REQUEST_ID] [--shard-count=SHARD_COUNT] [--aof-config-append-fsync=AOF_CONFIG_APPEND_FSYNC @@ -75,8 +75,10 @@ FLAGS Arguments for the deletion protection enabled. - --deletion-protection-enabled - If set to true deletion of the instance will fail. + --[no-]deletion-protection-enabled + If set to true deletion of the instance will fail. Use + --deletion-protection-enabled to enable and + --no-deletion-protection-enabled to disable. Arguments for the replica count. diff --git a/gcloud/beta/netapp/storage-pools/help b/gcloud/beta/netapp/storage-pools/help index d6adb5681..4c786cf93 100644 --- a/gcloud/beta/netapp/storage-pools/help +++ b/gcloud/beta/netapp/storage-pools/help @@ -29,7 +29,7 @@ COMMANDS (BETA) List Cloud NetApp Storage Pools. switch - (BETA) Switch a Regional Cloud NetApp SO Storage Pool zone. + (BETA) Switch a Regional Cloud NetApp Flex Storage Pool zone. update (BETA) Update a Cloud NetApp Storage Pool. diff --git a/gcloud/beta/netapp/storage-pools/switch b/gcloud/beta/netapp/storage-pools/switch index b19cd579c..db3c87d9d 100644 --- a/gcloud/beta/netapp/storage-pools/switch +++ b/gcloud/beta/netapp/storage-pools/switch @@ -1,13 +1,13 @@ NAME - gcloud beta netapp storage-pools switch - switch a Regional Cloud NetApp SO - Storage Pool zone + gcloud beta netapp storage-pools switch - switch a Regional Cloud NetApp + Flex Storage Pool zone SYNOPSIS gcloud beta netapp storage-pools switch (STORAGE_POOL : --location=LOCATION) [--async] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Switch a Regional Cloud NetApp SO Storage Pool zone. + (BETA) Switch a Regional Cloud NetApp Flex Storage Pool zone. EXAMPLES The following command switches zone of a Storage Pool named NAME using the @@ -68,8 +68,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud netapp storage-pools switch $ gcloud alpha netapp storage-pools switch diff --git a/gcloud/beta/netapp/volumes/replications/create b/gcloud/beta/netapp/volumes/replications/create index 0e2e8c3d2..a92862ef5 100644 --- a/gcloud/beta/netapp/volumes/replications/create +++ b/gcloud/beta/netapp/volumes/replications/create @@ -9,8 +9,8 @@ SYNOPSIS [share_name=SHARE_NAME], [storage_pool=STORAGE_POOL],[volume_id=VOLUME_ID] --replication-schedule=REPLICATION_SCHEDULE [--async] - [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] - [--volume=VOLUME] [GCLOUD_WIDE_FLAG ...] + [--cluster-location=CLUSTER_LOCATION] [--description=DESCRIPTION] + [--labels=[KEY=VALUE,...]] [--volume=VOLUME] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Create a Cloud NetApp Volume Replication. @@ -73,6 +73,9 @@ OPTIONAL FLAGS Return immediately, without waiting for the operation in progress to complete. + --cluster-location=CLUSTER_LOCATION + Location of the user cluster. + --description=DESCRIPTION A description of the Cloud NetApp Replication diff --git a/gcloud/beta/netapp/volumes/replications/update b/gcloud/beta/netapp/volumes/replications/update index 61e357dde..ffa746b9b 100644 --- a/gcloud/beta/netapp/volumes/replications/update +++ b/gcloud/beta/netapp/volumes/replications/update @@ -5,7 +5,7 @@ NAME SYNOPSIS gcloud beta netapp volumes replications update (REPLICATION : --location=LOCATION) [--async] - [--description=DESCRIPTION] + [--cluster-location=CLUSTER_LOCATION] [--description=DESCRIPTION] [--replication-schedule=REPLICATION_SCHEDULE] [--update-labels=[KEY=VALUE,...]] [--volume=VOLUME] [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] @@ -21,7 +21,7 @@ EXAMPLES $ gcloud beta netapp volumes replications update NAME \ --location=us-central1 --volume=vol1 \ --replication-schedule=EVERY_5_MINUTES \ - --description="new description" + --description="new description" --cluster-location= us-central1 POSITIONAL ARGUMENTS Replication resource - The Replication to update. The arguments in this @@ -66,6 +66,9 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + --cluster-location=CLUSTER_LOCATION + Location of the user cluster. + --description=DESCRIPTION A description of the Cloud NetApp Replication diff --git a/gcloud/beta/network-management/help b/gcloud/beta/network-management/help index 0afb74616..3090a462b 100644 --- a/gcloud/beta/network-management/help +++ b/gcloud/beta/network-management/help @@ -21,6 +21,9 @@ GROUPS operations (BETA) Manage Network Management operations. + vpc-flow-logs-configs + (BETA) Manage the VPC Flow Logs configurations. + NOTES This command is currently in beta and might change without notice. These variants are also available: diff --git a/gcloud/beta/network-management/vpc-flow-logs-configs/create b/gcloud/beta/network-management/vpc-flow-logs-configs/create new file mode 100644 index 000000000..85168b55a --- /dev/null +++ b/gcloud/beta/network-management/vpc-flow-logs-configs/create @@ -0,0 +1,192 @@ +NAME + gcloud beta network-management vpc-flow-logs-configs create - creates a new + VPC Flow Logs configuration in the specified project + +SYNOPSIS + gcloud beta network-management vpc-flow-logs-configs create + (VPC_FLOW_LOGS_CONFIG : --location=LOCATION) + [--aggregation-interval=AGGREGATION_INTERVAL] [--async] + [--description=DESCRIPTION] [--filter-expr=FILTER_EXPR] + [--flow-sampling=FLOW_SAMPLING] [--labels=[LABELS,...]] + [--metadata=METADATA] [--metadata-fields=[METADATA_FIELDS,...]] + [--state=STATE] + [--interconnect-attachment=INTERCONNECT_ATTACHMENT + | --vpn-tunnel=VPN_TUNNEL] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Creates a new VPC Flow Logs configuration in the specified project. + +EXAMPLES + To create a new VPC Flow Logs configuration my-config in project my-project + for a VLAN attachment for Cloud Interconnect, run: + + $ gcloud beta network-management vpc-flow-logs-configs create \ + my-config --location=global \ + --interconnect-attachment="projects/{project_id}/regions/{region\ + }/interconnectAttachments/{interconnect_attachment_id}" + + To create a new VPC Flow Logs configuration my-config in project my-project + for a Cloud VPN tunnel, run: + + $ gcloud beta network-management vpc-flow-logs-configs create \ + my-config --location=global \ + --vpn-tunnel="projects/{project_id}/regions/{region}/vpnTunnels/\ + {vpn_tunnel_id}" + +POSITIONAL ARGUMENTS + VpcFlowLogsConfig resource - Identifier. Unique name of the configuration + using the form: + projects/{project_id}/locations/global/vpcFlowLogsConfigs/{vpc_flow_logs_config_id} + 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 vpc_flow_logs_config on the command line with a + fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + VPC_FLOW_LOGS_CONFIG + ID of the vpcFlowLogsConfig or fully qualified identifier for the + vpcFlowLogsConfig. + + To set the vpc_flow_logs_config attribute: + ▸ provide the argument vpc_flow_logs_config on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the vpcFlowLogsConfig resource. + + To set the location attribute: + ▸ provide the argument vpc_flow_logs_config on the command line + with a fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + Arguments for the aggregation interval. + + --aggregation-interval=AGGREGATION_INTERVAL + The aggregation interval for the logs. Default value is + INTERVAL_5_SEC. AGGREGATION_INTERVAL must be one of: + + interval-1-min + Aggregate logs in 1m intervals. + interval-10-min + Aggregate logs in 10m intervals. + interval-15-min + Aggregate logs in 15m intervals. + interval-30-sec + Aggregate logs in 30s intervals. + interval-5-min + Aggregate logs in 5m intervals. + interval-5-sec + Aggregate logs in 5s intervals. + + --async + Return immediately, without waiting for the operation in progress to + complete. + + Arguments for the description. + + --description=DESCRIPTION + The user-supplied description of the VPC Flow Logs configuration. + Maximum of 512 characters. + + Arguments for the filter expr. + + --filter-expr=FILTER_EXPR + Export filter used to define which VPC Flow Logs should be logged. + + Arguments for the flow sampling. + + --flow-sampling=FLOW_SAMPLING + The value of the field must be in (0, 1]. The sampling rate of VPC + Flow Logs where 1.0 means all collected logs are reported. Setting + the sampling rate to 0.0 is not allowed. If you want to disable VPC + Flow Logs, use the state field instead. Default value is 1.0. + + --labels=[LABELS,...] + Resource labels to represent user-provided metadata. + + KEY + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. + + VALUE + Values must contain only hyphens (-), underscores (_), lowercase + characters, and numbers. + + Shorthand Example: + + --labels=string=string + + JSON Example: + + --labels='{"string": "string"}' + + File Example: + + --labels=path_to_file.(yaml|json) + + Arguments for the metadata. + + --metadata=METADATA + Configures whether all, none or a subset of metadata fields should be + added to the reported VPC flow logs. Default value is + INCLUDE_ALL_METADATA. METADATA must be one of: + + custom-metadata + Include only custom fields (specified in metadata_fields). + exclude-all-metadata + Exclude all metadata fields. + include-all-metadata + Include all metadata fields. + + --metadata-fields=[METADATA_FIELDS,...] + Custom metadata fields to include in the reported VPC flow logs. Can + only be specified if "metadata" was set to CUSTOM_METADATA. + + Arguments for the state. + + --state=STATE + The state of the VPC Flow Log configuration. Default value is + ENABLED. When creating a new configuration, it must be enabled. STATE + must be one of: + + disabled + When DISABLED, this configuration will not generate logs. + enabled + When ENABLED, this configuration will generate logs. + + Arguments for the target resource. + + At most one of these can be specified: + + --interconnect-attachment=INTERCONNECT_ATTACHMENT + Traffic will be logged from the Interconnect Attachment. Format: + projects/{project_id}/regions/{region}/interconnectAttachments/{name} + + --vpn-tunnel=VPN_TUNNEL + Traffic will be logged from the VPN Tunnel. Format: + projects/{project_id}/regions/{region}/vpnTunnels/{name} + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkmanagement/v1beta1 API. The full documentation + for this API can be found at: https://cloud.google.com/ + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/network-management/vpc-flow-logs-configs/delete b/gcloud/beta/network-management/vpc-flow-logs-configs/delete new file mode 100644 index 000000000..197752fe5 --- /dev/null +++ b/gcloud/beta/network-management/vpc-flow-logs-configs/delete @@ -0,0 +1,72 @@ +NAME + gcloud beta network-management vpc-flow-logs-configs delete - deletes the + specified VPC Flow Logs configuration + +SYNOPSIS + gcloud beta network-management vpc-flow-logs-configs delete + (VPC_FLOW_LOGS_CONFIG : --location=LOCATION) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Deletes the specified VPC Flow Logs configuration. + +EXAMPLES + To delete a VPC Flow Logs configuration my-config, run: + + $ gcloud beta network-management vpc-flow-logs-configs delete \ + my-config --location=global + +POSITIONAL ARGUMENTS + VpcFlowLogsConfig resource - VpcFlowLogsConfig resource name using the + form: + projects/{project_id}/locations/global/vpcFlowLogsConfigs/{vpc_flow_logs_config} + 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 vpc_flow_logs_config on the command line with a + fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + VPC_FLOW_LOGS_CONFIG + ID of the vpcFlowLogsConfig or fully qualified identifier for the + vpcFlowLogsConfig. + + To set the vpc_flow_logs_config attribute: + ▸ provide the argument vpc_flow_logs_config on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the vpcFlowLogsConfig resource. + + To set the location attribute: + ▸ provide the argument vpc_flow_logs_config on the command line + with a fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkmanagement/v1beta1 API. The full documentation + for this API can be found at: https://cloud.google.com/ + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/network-management/vpc-flow-logs-configs/describe b/gcloud/beta/network-management/vpc-flow-logs-configs/describe new file mode 100644 index 000000000..0389c2c52 --- /dev/null +++ b/gcloud/beta/network-management/vpc-flow-logs-configs/describe @@ -0,0 +1,66 @@ +NAME + gcloud beta network-management vpc-flow-logs-configs describe - describe + the details of a specific VPC Flow Logs configuration + +SYNOPSIS + gcloud beta network-management vpc-flow-logs-configs describe + (VPC_FLOW_LOGS_CONFIG : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Describes the details of a specific VPC Flow Logs configuration. + +EXAMPLES + To get the details of a VPC Flow Logs configuration my-config, run: + + $ gcloud beta network-management vpc-flow-logs-configs describe \ + my-config --location=global + +POSITIONAL ARGUMENTS + VpcFlowLogsConfig resource - VpcFlowLogsConfig resource name using the + form: + projects/{project_id}/locations/global/vpcFlowLogsConfigs/{vpc_flow_logs_config} + 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 vpc_flow_logs_config on the command line with a + fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + VPC_FLOW_LOGS_CONFIG + ID of the vpcFlowLogsConfig or fully qualified identifier for the + vpcFlowLogsConfig. + + To set the vpc_flow_logs_config attribute: + ▸ provide the argument vpc_flow_logs_config on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the vpcFlowLogsConfig resource. + + To set the location attribute: + ▸ provide the argument vpc_flow_logs_config on the command line + with a fully specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkmanagement/v1beta1 API. The full documentation + for this API can be found at: https://cloud.google.com/ + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/network-management/vpc-flow-logs-configs/help b/gcloud/beta/network-management/vpc-flow-logs-configs/help new file mode 100644 index 000000000..c6d123715 --- /dev/null +++ b/gcloud/beta/network-management/vpc-flow-logs-configs/help @@ -0,0 +1,39 @@ +NAME + gcloud beta network-management vpc-flow-logs-configs - manage the VPC Flow + Logs configurations + +SYNOPSIS + gcloud beta network-management vpc-flow-logs-configs COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) The flag --location=global is required for all the commands. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (BETA) Creates a new VPC Flow Logs configuration in the specified + project. + + delete + (BETA) Deletes the specified VPC Flow Logs configuration. + + describe + (BETA) Describe the details of a specific VPC Flow Logs configuration. + + list + (BETA) List all VPC Flow Logs configurations in the project. + + update + (BETA) Updates one or more fields in an existing VPC Flow Logs + configuration. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/network-management/vpc-flow-logs-configs/list b/gcloud/beta/network-management/vpc-flow-logs-configs/list new file mode 100644 index 000000000..04bee45b5 --- /dev/null +++ b/gcloud/beta/network-management/vpc-flow-logs-configs/list @@ -0,0 +1,92 @@ +NAME + gcloud beta network-management vpc-flow-logs-configs list - list all VPC + Flow Logs configurations in the project + +SYNOPSIS + gcloud beta network-management vpc-flow-logs-configs list + --location=LOCATION [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Lists all VPC Flow Logs configurations in the project. + +EXAMPLES + To list all the VPC Flow Logs configurations within the project, run: + + $ gcloud beta network-management vpc-flow-logs-configs list \ + --location=global + + To list all the VPC Flow Logs configurations within the project with state + 'ENABLED', run: + + $ gcloud beta network-management vpc-flow-logs-configs list \ + --location=global --filter="state:ENABLED" + +REQUIRED FLAGS + Location resource - The parent resource of the VpcFlowLogsConfig: + projects/{project_id}/locations/global This represents a Cloud resource. + (NOTE) Some attributes are not given arguments in this group but can be + set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkmanagement/v1beta1 API. The full documentation + for this API can be found at: https://cloud.google.com/ + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/network-management/vpc-flow-logs-configs/update b/gcloud/beta/network-management/vpc-flow-logs-configs/update new file mode 100644 index 000000000..45d42a71c --- /dev/null +++ b/gcloud/beta/network-management/vpc-flow-logs-configs/update @@ -0,0 +1,240 @@ +NAME + gcloud beta network-management vpc-flow-logs-configs update - updates one + or more fields in an existing VPC Flow Logs configuration + +SYNOPSIS + gcloud beta network-management vpc-flow-logs-configs update + (VPC_FLOW_LOGS_CONFIG : --location=LOCATION) + [--aggregation-interval=AGGREGATION_INTERVAL] [--async] + [--description=DESCRIPTION] [--filter-expr=FILTER_EXPR] + [--flow-sampling=FLOW_SAMPLING] [--metadata=METADATA] [--state=STATE] + [--interconnect-attachment=INTERCONNECT_ATTACHMENT + | --vpn-tunnel=VPN_TUNNEL] + [--labels=[LABELS,...] + | --update-labels=[UPDATE_LABELS,...] --clear-labels + | --remove-labels=[__REMOVE_LABELS,...]] + [--metadata-fields=[METADATA_FIELDS,...] + | --add-metadata-fields=[ADD_METADATA_FIELDS,...] + --clear-metadata-fields + | --remove-metadata-fields=[REMOVE_METADATA_FIELDS,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Updates one or more fields in an existing VPC Flow Logs + configuration. + +EXAMPLES + To update the state field to be 'DISABLED' in the VPC Flow Logs + configuration my-config, run: + + $ gcloud beta network-management vpc-flow-logs-configs update \ + my-config --location=global --state=DISABLED + +POSITIONAL ARGUMENTS + VpcFlowLogsConfig resource - Identifier. Unique name of the configuration + using the form: + projects/{project_id}/locations/global/vpcFlowLogsConfigs/{vpc_flow_logs_config_id} + 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 vpc_flow_logs_config on the command line with a + fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + VPC_FLOW_LOGS_CONFIG + ID of the vpcFlowLogsConfig or fully qualified identifier for the + vpcFlowLogsConfig. + + To set the vpc_flow_logs_config attribute: + ▸ provide the argument vpc_flow_logs_config on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the vpcFlowLogsConfig resource. + + To set the location attribute: + ▸ provide the argument vpc_flow_logs_config on the command line + with a fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + Arguments for the aggregation interval. + + --aggregation-interval=AGGREGATION_INTERVAL + The aggregation interval for the logs. Default value is + INTERVAL_5_SEC. AGGREGATION_INTERVAL must be one of: + + interval-1-min + Aggregate logs in 1m intervals. + interval-10-min + Aggregate logs in 10m intervals. + interval-15-min + Aggregate logs in 15m intervals. + interval-30-sec + Aggregate logs in 30s intervals. + interval-5-min + Aggregate logs in 5m intervals. + interval-5-sec + Aggregate logs in 5s intervals. + + --async + Return immediately, without waiting for the operation in progress to + complete. + + Arguments for the description. + + --description=DESCRIPTION + The user-supplied description of the VPC Flow Logs configuration. + Maximum of 512 characters. + + Arguments for the filter expr. + + --filter-expr=FILTER_EXPR + Export filter used to define which VPC Flow Logs should be logged. + + Arguments for the flow sampling. + + --flow-sampling=FLOW_SAMPLING + The value of the field must be in (0, 1]. The sampling rate of VPC + Flow Logs where 1.0 means all collected logs are reported. Setting + the sampling rate to 0.0 is not allowed. If you want to disable VPC + Flow Logs, use the state field instead. Default value is 1.0. + + Arguments for the metadata. + + --metadata=METADATA + Configures whether all, none or a subset of metadata fields should be + added to the reported VPC flow logs. Default value is + INCLUDE_ALL_METADATA. METADATA must be one of: + + custom-metadata + Include only custom fields (specified in metadata_fields). + exclude-all-metadata + Exclude all metadata fields. + include-all-metadata + Include all metadata fields. + + Arguments for the state. + + --state=STATE + The state of the VPC Flow Log configuration. Default value is + ENABLED. When creating a new configuration, it must be enabled. STATE + must be one of: + + disabled + When DISABLED, this configuration will not generate logs. + enabled + When ENABLED, this configuration will generate logs. + + Arguments for the target resource. + + At most one of these can be specified: + + --interconnect-attachment=INTERCONNECT_ATTACHMENT + Traffic will be logged from the Interconnect Attachment. Format: + projects/{project_id}/regions/{region}/interconnectAttachments/{name} + + --vpn-tunnel=VPN_TUNNEL + Traffic will be logged from the VPN Tunnel. Format: + projects/{project_id}/regions/{region}/vpnTunnels/{name} + + Update labels. + + At most one of these can be specified: + + --labels=[LABELS,...] + Set labels to new value. Resource labels to represent user-provided + metadata. + + KEY + Keys must start with a lowercase character and contain only + hyphens (-), underscores (_), lowercase characters, and numbers. + + VALUE + Values must contain only hyphens (-), underscores (_), lowercase + characters, and numbers. + + Shorthand Example: + + --labels=string=string + + JSON Example: + + --labels='{"string": "string"}' + + File Example: + + --labels=path_to_file.(yaml|json) + + --update-labels=[UPDATE_LABELS,...] + Update labels value or add key value pair. Resource labels to + represent user-provided metadata. + + KEY + Keys must start with a lowercase character and contain only + hyphens (-), underscores (_), lowercase characters, and numbers. + + VALUE + Values must contain only hyphens (-), underscores (_), lowercase + characters, and numbers. + + Shorthand Example: + + --update-labels=string=string + + JSON Example: + + --update-labels='{"string": "string"}' + + File Example: + + --update-labels=path_to_file.(yaml|json) + + At most one of these can be specified: + + --clear-labels + Clear labels value and set to empty map. + + --remove-labels=[__REMOVE_LABELS,...] + Remove existing value from map labels. + + Update metadata_fields. + + At most one of these can be specified: + + --metadata-fields=[METADATA_FIELDS,...] + Set metadata_fields to new value. + + --add-metadata-fields=[ADD_METADATA_FIELDS,...] + Add new value to metadata_fields list. + + At most one of these can be specified: + + --clear-metadata-fields + Clear metadata_fields value and set to empty list. + + --remove-metadata-fields=[REMOVE_METADATA_FIELDS,...] + Remove existing value from metadata_fields list. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkmanagement/v1beta1 API. The full documentation + for this API can be found at: https://cloud.google.com/ + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/network-security/authz-policies/delete b/gcloud/beta/network-security/authz-policies/delete new file mode 100644 index 000000000..3eb69bf1d --- /dev/null +++ b/gcloud/beta/network-security/authz-policies/delete @@ -0,0 +1,70 @@ +NAME + gcloud beta network-security authz-policies delete - delete an AuthzPolicy + resource + +SYNOPSIS + gcloud beta network-security authz-policies delete + (AUTHZ_POLICY : --location=LOCATION) [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Delete the specified AuthzPolicy resource. + +EXAMPLES + To delete an AuthzPolicy resource named my-authz-policy in us-central1, + run: + + $ gcloud beta network-security authz-policies delete \ + my-authz-policy --location=us-central1 + +POSITIONAL ARGUMENTS + AuthzPolicy resource - The ID of the deleted AuthzPolicy resource. 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 authz_policy on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + AUTHZ_POLICY + ID of the AuthzPolicy or fully qualified identifier for the + AuthzPolicy. + + To set the authz_policy attribute: + ▸ provide the argument authz_policy on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument authz_policy on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networksecurity/v1beta1 API. The full documentation + for this API can be found at: https://cloud.google.com/networking + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/network-security/authz-policies/describe b/gcloud/beta/network-security/authz-policies/describe new file mode 100644 index 000000000..2e92f576e --- /dev/null +++ b/gcloud/beta/network-security/authz-policies/describe @@ -0,0 +1,65 @@ +NAME + gcloud beta network-security authz-policies describe - describe an + AuthzPolicy resource + +SYNOPSIS + gcloud beta network-security authz-policies describe + (AUTHZ_POLICY : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Show details about an AuthzPolicy resource. + +EXAMPLES + To show details about the AuthzPolicy resource named my-authz-policy + located in us-central1. + + $ gcloud beta network-security authz-policies describe \ + my-authz-policy --location=us-central1 + +POSITIONAL ARGUMENTS + AuthzPolicy resource - The ID of the AuthzPolicy resource. 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 authz_policy on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + AUTHZ_POLICY + ID of the AuthzPolicy or fully qualified identifier for the + AuthzPolicy. + + To set the authz_policy attribute: + ▸ provide the argument authz_policy on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument authz_policy on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networksecurity/v1beta1 API. The full documentation + for this API can be found at: https://cloud.google.com/networking + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/network-security/authz-policies/help b/gcloud/beta/network-security/authz-policies/help new file mode 100644 index 000000000..673413c5a --- /dev/null +++ b/gcloud/beta/network-security/authz-policies/help @@ -0,0 +1,33 @@ +NAME + gcloud beta network-security authz-policies - manage Network Security + AuthzPolicy resources + +SYNOPSIS + gcloud beta network-security authz-policies COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Manage Network Security AuthzPolicy resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + delete + (BETA) Delete an AuthzPolicy resource. + + describe + (BETA) Describe an AuthzPolicy resource. + + import + (BETA) Import an AuthzPolicy resource. + + list + (BETA) List AuthzPolicy resources. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/network-security/authz-policies/import b/gcloud/beta/network-security/authz-policies/import new file mode 100644 index 000000000..5111b8a4f --- /dev/null +++ b/gcloud/beta/network-security/authz-policies/import @@ -0,0 +1,82 @@ +NAME + gcloud beta network-security authz-policies import - import an AuthzPolicy + resource + +SYNOPSIS + gcloud beta network-security authz-policies import + (AUTHZ_POLICY : --location=LOCATION) [--async] [--source=SOURCE] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Import an AuthzPolicy resource defined in a YAML file. + +EXAMPLES + To import an AuthzPolicy resource named my-authz-poilcy from a YAML file in + us-central1, run: + + $ gcloud beta network-security authz-policies import \ + my-authz-policy --source=my-authz-policy.yaml \ + --location=us-central1 + +POSITIONAL ARGUMENTS + AuthzPolicy resource - The ID of the new or updated AuthzPolicy resource. + 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 authz_policy on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + AUTHZ_POLICY + ID of the AuthzPolicy or fully qualified identifier for the + AuthzPolicy. + + To set the authz_policy attribute: + ▸ provide the argument authz_policy on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument authz_policy on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --source=SOURCE + Path to a YAML file containing the configuration export data. The YAML + file must not contain any output-only fields. Alternatively, you may + omit this flag to read from standard input. For a schema describing the + export/import format, see: $CLOUDSDKROOT/lib/googlecloudsdk/schemas/... + + $CLOUDSDKROOT is can be obtained with the following command: + + $ gcloud info --format='value(installation.sdk_root)' + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networksecurity/v1beta1 API. The full documentation + for this API can be found at: https://cloud.google.com/networking + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/network-security/authz-policies/list b/gcloud/beta/network-security/authz-policies/list new file mode 100644 index 000000000..e1da880bd --- /dev/null +++ b/gcloud/beta/network-security/authz-policies/list @@ -0,0 +1,86 @@ +NAME + gcloud beta network-security authz-policies list - list AuthzPolicy + resources + +SYNOPSIS + gcloud beta network-security authz-policies list --location=LOCATION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) List all AuthzPolicy resources in the specified location of the + current project. + +EXAMPLES + To list all AuthzPolicy resources in the current project located in + us-central1 region run: + + $ gcloud beta network-security authz-policies list \ + --location=us-central1 + +REQUIRED FLAGS + Location resource - The parent location. This represents a Cloud resource. + (NOTE) Some attributes are not given arguments in this group but can be + set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networksecurity/v1beta1 API. The full documentation + for this API can be found at: https://cloud.google.com/networking + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/network-security/help b/gcloud/beta/network-security/help index 13444e442..2203180fd 100644 --- a/gcloud/beta/network-security/help +++ b/gcloud/beta/network-security/help @@ -21,6 +21,9 @@ GROUPS authorization-policies (BETA) Manage Network Security AuthorizationPolicies. + authz-policies + (BETA) Manage Network Security AuthzPolicy resources. + client-tls-policies (BETA) Manage Network Security ClientTlsPolicies. diff --git a/gcloud/beta/network-security/security-profiles/custom-mirroring/create b/gcloud/beta/network-security/security-profiles/custom-mirroring/create new file mode 100644 index 000000000..f9c62296a --- /dev/null +++ b/gcloud/beta/network-security/security-profiles/custom-mirroring/create @@ -0,0 +1,125 @@ +NAME + gcloud beta network-security security-profiles custom-mirroring create - + create a new Custom Mirroring Profile + +SYNOPSIS + gcloud beta network-security security-profiles custom-mirroring create + (SECURITY_PROFILE : --location=LOCATION --organization=ORGANIZATION) + (--mirroring-endpoint-group=MIRRORING_ENDPOINT_GROUP + : --mirroring-endpoint-group-location=MIRRORING_ENDPOINT_GROUP_LOCATION) + [--async] [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Create a new Custom Mirroring Security Profile. + +EXAMPLES + To create a Custom Mirroring Security Profile named mirroring-profile + linked to a Mirroring Endpoint Group (q.v.), run: + + $ gcloud beta network-security security-profiles custom-mirroring \ + create mirroring-profile --description="A Mirroring Profile" \ + --mirroring-endpoint-group=projects/my-project/locations/\ + global/mirroringEndpointGroups/my-mep + +POSITIONAL ARGUMENTS + Security profile resource - Security Profile Name. The arguments in this + group can be used to specify the attributes of this resource. + + This must be specified. + + SECURITY_PROFILE + ID of the security_profile or fully qualified identifier for the + security_profile. + + To set the security_profile attribute: + ▸ provide the argument security_profile on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + location of the security_profile - Global. + + To set the location attribute: + ▸ provide the argument security_profile on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + + --organization=ORGANIZATION + Organization ID to which the changes should apply. + + To set the organization attribute: + ▸ provide the argument security_profile on the command line with a + fully specified name; + ▸ provide the argument --organization on the command line. + +REQUIRED FLAGS + Mirroring endpoint group resource - Mirroring Endpoint Group. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument --mirroring-endpoint-group on the command line + with a fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --mirroring-endpoint-group=MIRRORING_ENDPOINT_GROUP + ID of the mirroring endpoint group or fully qualified identifier for + the mirroring endpoint group. + + To set the id attribute: + ▸ provide the argument --mirroring-endpoint-group on the command + line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --mirroring-endpoint-group-location=MIRRORING_ENDPOINT_GROUP_LOCATION + Location of the mirroring endpoint group. + + To set the location attribute: + ▸ provide the argument --mirroring-endpoint-group on the command + line with a fully specified name; + ▸ provide the argument --mirroring-endpoint-group-location on the + command line; + ▸ provide the argument --location on the command line; + ▸ provide the argument + networksecurity.projects.locations.mirroringEndpointGroupAssociations + on the command line with a fully specified name. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. The default is False. + + --description=DESCRIPTION + Brief description of the security profile + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha network-security security-profiles custom-mirroring \ + create + diff --git a/gcloud/beta/network-security/security-profiles/custom-mirroring/delete b/gcloud/beta/network-security/security-profiles/custom-mirroring/delete new file mode 100644 index 000000000..abae3f012 --- /dev/null +++ b/gcloud/beta/network-security/security-profiles/custom-mirroring/delete @@ -0,0 +1,76 @@ +NAME + gcloud beta network-security security-profiles custom-mirroring delete - + delete a Security Profile + +SYNOPSIS + gcloud beta network-security security-profiles custom-mirroring delete + (SECURITY_PROFILE : --location=LOCATION --organization=ORGANIZATION) + [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Delete the specified Security Profile. + +EXAMPLES + To delete a Security Profile called my-security-profile run: + + $ gcloud beta network-security security-profiles custom-mirroring \ + delete my-security-profile + +POSITIONAL ARGUMENTS + Security profile resource - Name of the Security Profile you want to + delete. The arguments in this group can be used to specify the attributes + of this resource. + + This must be specified. + + SECURITY_PROFILE + ID of the security_profile or fully qualified identifier for the + security_profile. + + To set the security_profile attribute: + ▸ provide the argument security_profile on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location ID of the resource. + + To set the location attribute: + ▸ provide the argument security_profile on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ use default global location . + + --organization=ORGANIZATION + Organization number. + + To set the organization attribute: + ▸ provide the argument security_profile on the command line with a + fully specified name; + ▸ provide the argument --organization on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networksecurity/v1beta1 API. The full documentation + for this API can be found at: https://cloud.google.com/networking + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha network-security security-profiles custom-mirroring \ + delete + diff --git a/gcloud/beta/network-security/security-profiles/custom-mirroring/describe b/gcloud/beta/network-security/security-profiles/custom-mirroring/describe new file mode 100644 index 000000000..57863ac0d --- /dev/null +++ b/gcloud/beta/network-security/security-profiles/custom-mirroring/describe @@ -0,0 +1,71 @@ +NAME + gcloud beta network-security security-profiles custom-mirroring describe - + describe a Custom MirroringSecurity Profile + +SYNOPSIS + gcloud beta network-security security-profiles custom-mirroring describe + (SECURITY_PROFILE : --location=LOCATION --organization=ORGANIZATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Show details of the Security Profile. + +EXAMPLES + To show details of a Security Profile named my-mirroring-sp run: + + $ gcloud beta network-security security-profiles custom-mirroring \ + describe my-mirroring-sp --organization=1234 --location=global + +POSITIONAL ARGUMENTS + Security profile resource - Name of the Security Profile to be described. + The arguments in this group can be used to specify the attributes of this + resource. + + This must be specified. + + SECURITY_PROFILE + ID of the security_profile or fully qualified identifier for the + security_profile. + + To set the security_profile attribute: + ▸ provide the argument security_profile on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location ID of the resource. + + To set the location attribute: + ▸ provide the argument security_profile on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ use default global location . + + --organization=ORGANIZATION + Organization number. + + To set the organization attribute: + ▸ provide the argument security_profile on the command line with a + fully specified name; + ▸ provide the argument --organization on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networksecurity/v1beta1 API. The full documentation + for this API can be found at: https://cloud.google.com/networking + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha network-security security-profiles custom-mirroring \ + describe + diff --git a/gcloud/beta/network-security/security-profiles/custom-mirroring/help b/gcloud/beta/network-security/security-profiles/custom-mirroring/help new file mode 100644 index 000000000..fea692c85 --- /dev/null +++ b/gcloud/beta/network-security/security-profiles/custom-mirroring/help @@ -0,0 +1,41 @@ +NAME + gcloud beta network-security security-profiles custom-mirroring - manage + Security Profiles - Custom Mirroring Profile + +SYNOPSIS + gcloud beta network-security security-profiles custom-mirroring COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) This class provides commands for managing Custom Mirroring Security + Profile. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (BETA) Create a new Custom Mirroring Profile. + + delete + (BETA) Delete a Security Profile. + + describe + (BETA) Describe a Custom MirroringSecurity Profile. + + list + (BETA) List Custom Mirroring Security Profiles. + + update + (BETA) Updates a Custom Mirroring Profile. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha network-security security-profiles custom-mirroring + diff --git a/gcloud/beta/network-security/security-profiles/custom-mirroring/list b/gcloud/beta/network-security/security-profiles/custom-mirroring/list new file mode 100644 index 000000000..eb8c75620 --- /dev/null +++ b/gcloud/beta/network-security/security-profiles/custom-mirroring/list @@ -0,0 +1,88 @@ +NAME + gcloud beta network-security security-profiles custom-mirroring list - list + Custom Mirroring Security Profiles + +SYNOPSIS + gcloud beta network-security security-profiles custom-mirroring list + [--location=LOCATION : --organization=ORGANIZATION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) List Custom Mirroring Security Profiles. + + For more examples, refer to the EXAMPLES section below. + +EXAMPLES + To list Custom Mirroring security profiles in an organization, run: + + $ gcloud beta network-security security-profiles custom-mirroring \ list --organization=12345 --location=global + +FLAGS + Location resource - Parent resource for the list operation. The arguments + in this group can be used to specify the attributes of this resource. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --organization=ORGANIZATION + Organization ID of the location. + + To set the organization attribute: + ▸ provide the argument --location on the command line with a fully + specified name; + ▸ provide the argument --organization on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha network-security security-profiles custom-mirroring \ + list + diff --git a/gcloud/beta/network-security/security-profiles/custom-mirroring/update b/gcloud/beta/network-security/security-profiles/custom-mirroring/update new file mode 100644 index 000000000..7d8450c3d --- /dev/null +++ b/gcloud/beta/network-security/security-profiles/custom-mirroring/update @@ -0,0 +1,117 @@ +NAME + gcloud beta network-security security-profiles custom-mirroring update - + updates a Custom Mirroring Profile + +SYNOPSIS + gcloud beta network-security security-profiles custom-mirroring update + (SECURITY_PROFILE : --location=LOCATION --organization=ORGANIZATION) + [--async] [--description=DESCRIPTION] [--update-labels=[KEY=VALUE,...]] + [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Update a Custom Mirroring Security Profile. + + The supported fields for update are description and labels. + +EXAMPLES + To update the description of a Custom Mirroring Security Profile named + mirroring-profile, run: + + $ gcloud beta network-security security-profiles custom-mirroring \ + update mirroring-profile --description="A new description" \ + --organization=1234567890 --location=global + + To change the labels of a Custom Mirroring Security Profile named + mirroring-profile, run: + + $ gcloud beta network-security security-profiles custom-mirroring \ + update mirroring-profile \ + --update-labels=key1=value1,key2=value2 \ + --delete-labels=key3,key4 --organization=1234567890 \ + --location=glob + +POSITIONAL ARGUMENTS + Security profile resource - Security Profile Name. The arguments in this + group can be used to specify the attributes of this resource. + + This must be specified. + + SECURITY_PROFILE + ID of the security_profile or fully qualified identifier for the + security_profile. + + To set the security_profile attribute: + ▸ provide the argument security_profile on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + location of the security_profile - Global. + + To set the location attribute: + ▸ provide the argument security_profile on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + + --organization=ORGANIZATION + Organization ID to which the changes should apply. + + To set the organization attribute: + ▸ provide the argument security_profile on the command line with a + fully specified name; + ▸ provide the argument --organization on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. The default is False. + + --description=DESCRIPTION + Brief description of the security profile + + --update-labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to update. If a label exists, its value + is modified. Otherwise, a new label is created. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + At most one of these can be specified: + + --clear-labels + Remove all labels. If --update-labels is also specified then + --clear-labels is applied first. + + For example, to remove all labels: + + $ gcloud beta network-security security-profiles custom-mirroring \ + update --clear-labels + + To remove all existing labels and create two new labels, foo and baz: + + $ gcloud beta network-security security-profiles custom-mirroring \ + update --clear-labels --update-labels foo=bar,baz=qux + + --remove-labels=[KEY,...] + List of label keys to remove. If a label does not exist it is + silently ignored. If --update-labels is also specified then + --update-labels is applied first. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha network-security security-profiles custom-mirroring \ + update + diff --git a/gcloud/beta/network-security/security-profiles/help b/gcloud/beta/network-security/security-profiles/help index 32fba26d3..d1fab5e6b 100644 --- a/gcloud/beta/network-security/security-profiles/help +++ b/gcloud/beta/network-security/security-profiles/help @@ -16,6 +16,9 @@ GCLOUD WIDE FLAGS GROUPS GROUP is one of the following: + custom-mirroring + (BETA) Manage Security Profiles - Custom Mirroring Profile. + threat-prevention (BETA) Manage Security Profiles - Threat Prevention Profile. diff --git a/gcloud/beta/pubsub/subscriptions/update b/gcloud/beta/pubsub/subscriptions/update index f1dab2263..0643f0079 100644 --- a/gcloud/beta/pubsub/subscriptions/update +++ b/gcloud/beta/pubsub/subscriptions/update @@ -61,9 +61,8 @@ FLAGS message with a given value of message_id on this subscription: The message sent to a subscriber is guaranteed not to be resent before the message's acknowledgment deadline expires. An acknowledged message will - not be resent to a subscriber. To disable exactly-once delivery use - --no-enable-exactly-once-delivery. Use - --no-enable-exactly-once-delivery to disable this flag. + not be resent to a subscriber. Use --no-enable-exactly-once-delivery to + disable this flag. --expiration-period=EXPIRATION_PERIOD The subscription will expire if it is inactive for the given period. @@ -77,10 +76,11 @@ FLAGS How long to retain unacknowledged messages in the subscription's backlog, from the moment a message is published. If --retain-acked-messages is true, this also configures the retention of - acknowledged messages. Specify "default" to use the default value. - Valid values are strings of the form INTEGER[UNIT], where UNIT is one - of "s", "m", "h", and "d" for seconds, minutes, hours, and days, - respectively. If the unit is omitted, seconds is assumed. + acknowledged messages. Specify "default" to use the default value of 7 + days. The minimum is 10 minutes, and the maximum is 7 days. Valid + values are strings of the form INTEGER[UNIT], where UNIT is one of "s", + "m", "h", and "d" for seconds, minutes, hours, and days, respectively. + If the unit is omitted, seconds is assumed. --push-auth-service-account=SERVICE_ACCOUNT_EMAIL Service account email used as the identity for the generated Open ID diff --git a/gcloud/beta/redis/clusters/create b/gcloud/beta/redis/clusters/create index 1a490b004..4fc48db05 100644 --- a/gcloud/beta/redis/clusters/create +++ b/gcloud/beta/redis/clusters/create @@ -5,10 +5,13 @@ NAME SYNOPSIS gcloud beta redis clusters create (CLUSTER : --region=REGION) --network=NETWORK [--aof-append-fsync=AOF_APPEND_FSYNC] [--async] - [--auth-mode=AUTH_MODE] [--deletion-protection] + [--auth-mode=AUTH_MODE] + [--cross-cluster-replication-role=CROSS_CLUSTER_REPLICATION_ROLE] + [--deletion-protection] [--maintenance-window-day=MAINTENANCE_WINDOW_DAY] [--maintenance-window-hour=MAINTENANCE_WINDOW_HOUR] [--node-type=NODE_TYPE] [--persistence-mode=PERSISTENCE_MODE] + [--primary-cluster=PRIMARY_CLUSTER] [--rdb-snapshot-period=RDB_SNAPSHOT_PERIOD] [--rdb-snapshot-start-time=RDB_SNAPSHOT_START_TIME] [--redis-config=[KEY=VALUE,...]] [--replica-count=REPLICA_COUNT] @@ -114,6 +117,13 @@ OPTIONAL FLAGS iam-auth IAM basic authorization is enabled for the cluster. + --cross-cluster-replication-role=CROSS_CLUSTER_REPLICATION_ROLE + The role of the cluster in cross cluster replication. + CROSS_CLUSTER_REPLICATION_ROLE must be (only one value is supported): + + secondary + Create a secondary cluster. + --deletion-protection Enable deletion protection for the Redis Cluster. Use --deletion-protection/--no-deletion-protection to enable/disable it. @@ -142,6 +152,12 @@ OPTIONAL FLAGS rdb RDB-based persistence + --primary-cluster=PRIMARY_CLUSTER + The primary cluster that the secondary cluster will replicate from. It + must use the format: + projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID. It must refer + to an existing cluster. Otherwise, the create operation fails. + --rdb-snapshot-period=RDB_SNAPSHOT_PERIOD Attempted period between RDB snapshots. RDB_SNAPSHOT_PERIOD must be one of: diff --git a/gcloud/beta/run/jobs/logs/help b/gcloud/beta/run/jobs/logs/help index ee640a2ad..b3028ffbd 100644 --- a/gcloud/beta/run/jobs/logs/help +++ b/gcloud/beta/run/jobs/logs/help @@ -36,8 +36,10 @@ COMMANDS (BETA) Tail logs for Cloud Run jobs. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud run jobs logs $ gcloud alpha run jobs logs diff --git a/gcloud/beta/run/jobs/logs/read b/gcloud/beta/run/jobs/logs/read index 0df568801..f2b0db342 100644 --- a/gcloud/beta/run/jobs/logs/read +++ b/gcloud/beta/run/jobs/logs/read @@ -75,8 +75,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud run jobs logs read $ gcloud alpha run jobs logs read diff --git a/gcloud/beta/run/services/logs/help b/gcloud/beta/run/services/logs/help index 86435226c..61562ead1 100644 --- a/gcloud/beta/run/services/logs/help +++ b/gcloud/beta/run/services/logs/help @@ -107,8 +107,10 @@ COMMANDS (BETA) Tail logs for a Cloud Run service. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud run services logs $ gcloud alpha run services logs diff --git a/gcloud/beta/run/services/logs/read b/gcloud/beta/run/services/logs/read index 64f4fba65..142279dee 100644 --- a/gcloud/beta/run/services/logs/read +++ b/gcloud/beta/run/services/logs/read @@ -156,8 +156,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud run services logs read $ gcloud alpha run services logs read diff --git a/gcloud/beta/service-extensions/authz-extensions/delete b/gcloud/beta/service-extensions/authz-extensions/delete new file mode 100644 index 000000000..16818ba8e --- /dev/null +++ b/gcloud/beta/service-extensions/authz-extensions/delete @@ -0,0 +1,71 @@ +NAME + gcloud beta service-extensions authz-extensions delete - delete an + AuthzExtension resource + +SYNOPSIS + gcloud beta service-extensions authz-extensions delete + (AUTHZ_EXTENSION : --location=LOCATION) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Delete the specified AuthzExtension resource. + +EXAMPLES + To delete an AuthzExtension resource named my-authz-extension in + us-central1, run: + + $ gcloud beta service-extensions authz-extensions delete \ + my-authz-extension --location=us-central1 + +POSITIONAL ARGUMENTS + AuthzExtension resource - The ID of the deleted AuthzExtension resource. + 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 authz_extension on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + AUTHZ_EXTENSION + ID of the AuthzExtension or fully qualified identifier for the + AuthzExtension. + + To set the authz_extension attribute: + ▸ provide the argument authz_extension on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Cloud region in which the resource is located. + + To set the location attribute: + ▸ provide the argument authz_extension on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1beta1 API. The full documentation + for this API can be found at: https://cloud.google.com/networking + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/service-extensions/authz-extensions/describe b/gcloud/beta/service-extensions/authz-extensions/describe new file mode 100644 index 000000000..5feab33ae --- /dev/null +++ b/gcloud/beta/service-extensions/authz-extensions/describe @@ -0,0 +1,65 @@ +NAME + gcloud beta service-extensions authz-extensions describe - describe an + AuthzExtension resource + +SYNOPSIS + gcloud beta service-extensions authz-extensions describe + (AUTHZ_EXTENSION : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Show details about an AuthzExtension resource. + +EXAMPLES + To show details about the AuthzExtension resource named my-authz-extension + located in us-central1. + + $ gcloud beta service-extensions authz-extensions describe \ + my-authz-extension --location=us-central1 + +POSITIONAL ARGUMENTS + AuthzExtension resource - The ID of the AuthzExtension resource. 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 authz_extension on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + AUTHZ_EXTENSION + ID of the AuthzExtension or fully qualified identifier for the + AuthzExtension. + + To set the authz_extension attribute: + ▸ provide the argument authz_extension on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Cloud region in which the resource is located. + + To set the location attribute: + ▸ provide the argument authz_extension on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1beta1 API. The full documentation + for this API can be found at: https://cloud.google.com/networking + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/service-extensions/authz-extensions/help b/gcloud/beta/service-extensions/authz-extensions/help new file mode 100644 index 000000000..c0ef07804 --- /dev/null +++ b/gcloud/beta/service-extensions/authz-extensions/help @@ -0,0 +1,34 @@ +NAME + gcloud beta service-extensions authz-extensions - manage Service Extensions + AuthzExtension resources + +SYNOPSIS + gcloud beta service-extensions authz-extensions COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Manage Service Extensions AuthzExtension resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + delete + (BETA) Delete an AuthzExtension resource. + + describe + (BETA) Describe an AuthzExtension resource. + + import + (BETA) Import an AuthzExtension resource. + + list + (BETA) List AuthzExtension resources. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/service-extensions/authz-extensions/import b/gcloud/beta/service-extensions/authz-extensions/import new file mode 100644 index 000000000..adb69afb4 --- /dev/null +++ b/gcloud/beta/service-extensions/authz-extensions/import @@ -0,0 +1,82 @@ +NAME + gcloud beta service-extensions authz-extensions import - import an + AuthzExtension resource + +SYNOPSIS + gcloud beta service-extensions authz-extensions import + (AUTHZ_EXTENSION : --location=LOCATION) [--async] [--source=SOURCE] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Import an AuthzExtension resource defined in a YAML file. + +EXAMPLES + To import an AuthzExtension resource named my-authz-extension from a YAML + file in us-central1, run: + + $ gcloud beta service-extensions authz-extensions import \ + my-authz-extension --source=my-authz-extension.yaml \ + --location=us-central1 + +POSITIONAL ARGUMENTS + AuthzExtension resource - The ID of the new or updated AuthzExtension + resource. 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 authz_extension on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + AUTHZ_EXTENSION + ID of the AuthzExtension or fully qualified identifier for the + AuthzExtension. + + To set the authz_extension attribute: + ▸ provide the argument authz_extension on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Cloud region in which the resource is located. + + To set the location attribute: + ▸ provide the argument authz_extension on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --source=SOURCE + Path to a YAML file containing the configuration export data. The YAML + file must not contain any output-only fields. Alternatively, you may + omit this flag to read from standard input. For a schema describing the + export/import format, see: $CLOUDSDKROOT/lib/googlecloudsdk/schemas/... + + $CLOUDSDKROOT is can be obtained with the following command: + + $ gcloud info --format='value(installation.sdk_root)' + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1beta1 API. The full documentation + for this API can be found at: https://cloud.google.com/networking + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/service-extensions/authz-extensions/list b/gcloud/beta/service-extensions/authz-extensions/list new file mode 100644 index 000000000..3b2665e0d --- /dev/null +++ b/gcloud/beta/service-extensions/authz-extensions/list @@ -0,0 +1,86 @@ +NAME + gcloud beta service-extensions authz-extensions list - list AuthzExtension + resources + +SYNOPSIS + gcloud beta service-extensions authz-extensions list --location=LOCATION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) List all AuthzExtension resources in the specified location of the + current project. + +EXAMPLES + To list all AuthzExtension resources in the current project located in + us-central1 region run: + + $ gcloud beta service-extensions authz-extensions list \ + --location=us-central1 + +REQUIRED FLAGS + Location resource - The parent location. This represents a Cloud resource. + (NOTE) Some attributes are not given arguments in this group but can be + set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1beta1 API. The full documentation + for this API can be found at: https://cloud.google.com/networking + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/service-extensions/help b/gcloud/beta/service-extensions/help index 7b7d149ab..77a2c0e7a 100644 --- a/gcloud/beta/service-extensions/help +++ b/gcloud/beta/service-extensions/help @@ -15,6 +15,9 @@ GCLOUD WIDE FLAGS GROUPS GROUP is one of the following: + authz-extensions + (BETA) Manage Service Extensions AuthzExtension resources. + lb-route-extensions (BETA) Manage Service Extensions LbRouteExtension resources. diff --git a/gcloud/beta/sql/instances/create b/gcloud/beta/sql/instances/create index 731d5d978..a7bc1c8dd 100644 --- a/gcloud/beta/sql/instances/create +++ b/gcloud/beta/sql/instances/create @@ -45,8 +45,8 @@ SYNOPSIS [--replica-type=REPLICA_TYPE] [--replication=REPLICATION] [--require-ssl] [--retained-backups-count=RETAINED_BACKUPS_COUNT] [--retained-transaction-log-days=RETAINED_TRANSACTION_LOG_DAYS] - [--root-password=ROOT_PASSWORD] [--ssl-mode=SSL_MODE] - [--[no-]storage-auto-increase] + [--root-password=ROOT_PASSWORD] [--server-ca-mode=SERVER_CA_MODE] + [--ssl-mode=SSL_MODE] [--[no-]storage-auto-increase] [--storage-auto-increase-limit=STORAGE_AUTO_INCREASE_LIMIT] [--storage-size=STORAGE_SIZE] [--storage-type=STORAGE_TYPE] [--threads-per-core=THREADS_PER_CORE] [--tier=TIER, -t TIER] @@ -415,6 +415,15 @@ FLAGS --root-password=ROOT_PASSWORD Root Cloud SQL user's password. + --server-ca-mode=SERVER_CA_MODE + Set the server CA mode of the instance. SERVER_CA_MODE must be one of: + + GOOGLE_MANAGED_CAS_CA + Google-managed regional CA part of root CA hierarchy hosted on + Google Cloud's Certificate Authority Service (CAS). + GOOGLE_MANAGED_INTERNAL_CA + Google-managed self-signed internal CA. + --ssl-mode=SSL_MODE Set the SSL mode of the instance. SSL_MODE must be one of: diff --git a/gcloud/beta/sql/ssl/help b/gcloud/beta/sql/ssl/help index 3dacb8232..06b1f9c2e 100644 --- a/gcloud/beta/sql/ssl/help +++ b/gcloud/beta/sql/ssl/help @@ -25,6 +25,10 @@ GROUPS (BETA) Provide commands for managing server CA certs of Cloud SQL instances. + server-certs + (BETA) Provide commands for managing server certificates of Cloud SQL + instances. + NOTES This command is currently in beta and might change without notice. These variants are also available: diff --git a/gcloud/beta/sql/ssl/server-certs/create b/gcloud/beta/sql/ssl/server-certs/create new file mode 100644 index 000000000..46e41f93b --- /dev/null +++ b/gcloud/beta/sql/ssl/server-certs/create @@ -0,0 +1,34 @@ +NAME + gcloud beta sql ssl server-certs create - create a server certificate for a + Cloud SQL instance + +SYNOPSIS + gcloud beta sql ssl server-certs create --instance=INSTANCE, -i INSTANCE + [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Create a server certificate for a Cloud SQL instance. + +REQUIRED FLAGS + --instance=INSTANCE, -i INSTANCE + Cloud SQL instance ID. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha sql ssl server-certs create + diff --git a/gcloud/beta/sql/ssl/server-certs/help b/gcloud/beta/sql/ssl/server-certs/help new file mode 100644 index 000000000..ede490354 --- /dev/null +++ b/gcloud/beta/sql/ssl/server-certs/help @@ -0,0 +1,40 @@ +NAME + gcloud beta sql ssl server-certs - provide commands for managing server + certificates of Cloud SQL instances + +SYNOPSIS + gcloud beta sql ssl server-certs COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Provide commands for managing server certificates of Cloud SQL + instances, including creating, listing, rotating in, and rolling back + certificates. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (BETA) Create a server certificate for a Cloud SQL instance. + + list + (BETA) List all server certificates for a Cloud SQL instance. + + rollback + (BETA) Roll back to the previous server certificate for a Cloud SQL + instance. + + rotate + (BETA) Rotate in the upcoming server certificate for a Cloud SQL + instance. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha sql ssl server-certs + diff --git a/gcloud/beta/sql/ssl/server-certs/list b/gcloud/beta/sql/ssl/server-certs/list new file mode 100644 index 000000000..4a47f9781 --- /dev/null +++ b/gcloud/beta/sql/ssl/server-certs/list @@ -0,0 +1,62 @@ +NAME + gcloud beta sql ssl server-certs list - list all server certificates for a + Cloud SQL instance + +SYNOPSIS + gcloud beta sql ssl server-certs list --instance=INSTANCE, -i INSTANCE + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) List all server certificates for a Cloud SQL instance. + +REQUIRED FLAGS + --instance=INSTANCE, -i INSTANCE + Cloud SQL instance ID. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha sql ssl server-certs list + diff --git a/gcloud/beta/sql/ssl/server-certs/rollback b/gcloud/beta/sql/ssl/server-certs/rollback new file mode 100644 index 000000000..4787ad580 --- /dev/null +++ b/gcloud/beta/sql/ssl/server-certs/rollback @@ -0,0 +1,35 @@ +NAME + gcloud beta sql ssl server-certs rollback - roll back to the previous + server certificate for a Cloud SQL instance + +SYNOPSIS + gcloud beta sql ssl server-certs rollback --instance=INSTANCE, -i INSTANCE + [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Roll back to the previous server certificate for a Cloud SQL + instance. + +REQUIRED FLAGS + --instance=INSTANCE, -i INSTANCE + Cloud SQL instance ID. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha sql ssl server-certs rollback + diff --git a/gcloud/beta/sql/ssl/server-certs/rotate b/gcloud/beta/sql/ssl/server-certs/rotate new file mode 100644 index 000000000..1e95fef9e --- /dev/null +++ b/gcloud/beta/sql/ssl/server-certs/rotate @@ -0,0 +1,34 @@ +NAME + gcloud beta sql ssl server-certs rotate - rotate in the upcoming server + certificate for a Cloud SQL instance + +SYNOPSIS + gcloud beta sql ssl server-certs rotate --instance=INSTANCE, -i INSTANCE + [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Rotate in the upcoming server certificate for a Cloud SQL instance. + +REQUIRED FLAGS + --instance=INSTANCE, -i INSTANCE + Cloud SQL instance ID. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha sql ssl server-certs rotate + diff --git a/gcloud/compute/network-endpoint-groups/create b/gcloud/compute/network-endpoint-groups/create index 6fe417623..3712aca7b 100644 --- a/gcloud/compute/network-endpoint-groups/create +++ b/gcloud/compute/network-endpoint-groups/create @@ -113,12 +113,12 @@ FLAGS serverless, gce-vm-ip, private-service-connect. --producer-port=PRODUCER_PORT - The psc producer port to use when consumer PSC NEG connects to a - producer. - - If this flag isn't specified for a PSC NEG with endpoint type - private-service-connect, then PSC NEG will be connected to a first port - in the available pcs producer port range. + The producer port to use when a consumer PSC NEG connects to a + producer's internal network load balancer. If this flag isn't specified + for a NEG with endpoint type private-service-connect, the PSC NEG will + connect to port 443 or the first available port in the PSC producer + port range, or to port 1 if the PSC producer's forwarding rule ports + flag is set to all-ports. This flag is not supported for NEGs with endpoint type other than private-service-connect. diff --git a/gcloud/compute/security-policies/import b/gcloud/compute/security-policies/import index c8838ded8..0cc6ea96d 100644 --- a/gcloud/compute/security-policies/import +++ b/gcloud/compute/security-policies/import @@ -9,9 +9,8 @@ SYNOPSIS DESCRIPTION gcloud compute security-policies import imports a security policy to update - an existing policy. The command does not support updating rules for the - policy. To create a new policy from a file please use the create command - instead. + an existing policy. To create a new policy from a file please use the + create command instead. EXAMPLES To import a security policy from a YAML file run this: diff --git a/gcloud/container/attached/clusters/register b/gcloud/container/attached/clusters/register index c41261e28..496afc549 100644 --- a/gcloud/container/attached/clusters/register +++ b/gcloud/container/attached/clusters/register @@ -11,7 +11,8 @@ SYNOPSIS [--annotations=ANNOTATION,[ANNOTATION,...]] [--binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE] [--description=DESCRIPTION] [--enable-managed-prometheus] - [--logging=COMPONENT,[COMPONENT,...]] [--validate-only] + [--logging=COMPONENT,[COMPONENT,...]] + [--security-posture=SECURITY_POSTURE] [--validate-only] [--proxy-secret-name=PROXY_SECRET_NAME --proxy-secret-namespace=PROXY_SECRET_NAMESPACE] [GCLOUD_WIDE_FLAG ...] @@ -176,6 +177,18 @@ OPTIONAL FLAGS COMPONENT must be one of: NONE, SYSTEM, WORKLOAD. + --security-posture=SECURITY_POSTURE + Sets the mode of the Kubernetes security posture API's off-cluster + features. + + To enable advanced mode explicitly set the flag to + --security-posture=enterprise. + + To disable in an existing cluster, explicitly set the flag to + --security-posture=disabled. + + SECURITY_POSTURE must be one of: disabled, enterprise. + --validate-only Validate the cluster to create, but don't actually perform it. diff --git a/gcloud/container/attached/clusters/update b/gcloud/container/attached/clusters/update index 56d8b18cc..09e81a455 100644 --- a/gcloud/container/attached/clusters/update +++ b/gcloud/container/attached/clusters/update @@ -7,7 +7,8 @@ SYNOPSIS [--binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE] [--clear-description] [--description=DESCRIPTION] [--logging=COMPONENT,[COMPONENT,...]] - [--platform-version=PLATFORM_VERSION] [--validate-only] + [--platform-version=PLATFORM_VERSION] + [--security-posture=SECURITY_POSTURE] [--validate-only] [--admin-groups=[GROUP,...] | --clear-admin-groups] [--admin-users=[USER,...] | --clear-admin-users] [--disable-managed-prometheus | --enable-managed-prometheus] @@ -95,6 +96,18 @@ FLAGS Replace LOCATION with the target Google Cloud location for the cluster. + --security-posture=SECURITY_POSTURE + Sets the mode of the Kubernetes security posture API's off-cluster + features. + + To enable advanced mode explicitly set the flag to + --security-posture=enterprise. + + To disable in an existing cluster, explicitly set the flag to + --security-posture=disabled. + + SECURITY_POSTURE must be one of: disabled, enterprise. + --validate-only Validate the update of the cluster, but don't actually perform it. diff --git a/gcloud/container/clusters/update b/gcloud/container/clusters/update index 3168f21e5..072cc3570 100644 --- a/gcloud/container/clusters/update +++ b/gcloud/container/clusters/update @@ -47,6 +47,9 @@ SYNOPSIS | --workload-vulnerability-scanning=WORKLOAD_VULNERABILITY_SCANNING | --additional-pod-ipv4-ranges=NAME,[NAME,...] --remove-additional-pod-ipv4-ranges=NAME,[NAME,...] + | --logging=[COMPONENT,...] + --monitoring=[COMPONENT,...] --disable-managed-prometheus + | --enable-managed-prometheus | --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE | --enable-binauthz | --clear-maintenance-window | --remove-maintenance-exclusion=NAME @@ -86,9 +89,7 @@ SYNOPSIS : --min-accelerator=[type=TYPE,count=COUNT,...]]] | --enable-insecure-binding-system-authenticated --enable-insecure-binding-system-unauthenticated - | --logging=[COMPONENT,...] - --monitoring=[COMPONENT,...] --disable-managed-prometheus - | --enable-managed-prometheus | --logging-service=LOGGING_SERVICE + | --logging-service=LOGGING_SERVICE --monitoring-service=MONITORING_SERVICE | --password=PASSWORD --enable-basic-auth | --username=USERNAME, -u USERNAME) [--async] @@ -769,6 +770,51 @@ REQUIRED FLAGS $ gcloud container clusters update example-cluster \ --remove-additional-pod-ipv4-ranges=range1,range2 + --logging=[COMPONENT,...] + Set the components that have logging enabled. Valid component values + are: SYSTEM, WORKLOAD, API_SERVER, CONTROLLER_MANAGER, SCHEDULER, + NONE + + For more information, see + https://cloud.google.com/kubernetes-engine/docs/concepts/about-logs#available-logs + + Examples: + + $ gcloud container clusters update --logging=SYSTEM + $ gcloud container clusters update \ + --logging=SYSTEM,API_SERVER,WORKLOAD + $ gcloud container clusters update --logging=NONE + + --monitoring=[COMPONENT,...] + Set the components that have monitoring enabled. Valid component + values are: SYSTEM, WORKLOAD (Deprecated), NONE, API_SERVER, + CONTROLLER_MANAGER, SCHEDULER, DAEMONSET, DEPLOYMENT, HPA, POD, + STATEFULSET, STORAGE, CADVISOR, KUBELET, DCGM + + For more information, see + https://cloud.google.com/kubernetes-engine/docs/how-to/configure-metrics#available-metrics + + Examples: + + $ gcloud container clusters update --monitoring=SYSTEM,API_SERVER,POD + $ gcloud container clusters update --monitoring=NONE + + At most one of these can be specified: + + --disable-managed-prometheus + Disable managed collection for Managed Service for Prometheus. + + --enable-managed-prometheus + Enables managed collection for Managed Service for Prometheus in + the cluster. + + See + https://cloud.google.com/stackdriver/docs/managed-prometheus/setup-managed#enable-mgdcoll-gke + for more info. + + Enabled by default for cluster versions 1.27 or greater, use + --no-enable-managed-prometheus to disable. + Flags for Binary Authorization: At most one of these can be specified: @@ -1248,51 +1294,6 @@ REQUIRED FLAGS To disallow binding system:authenticated in a cluster, explicitly set the --no-enable-insecure-binding-system-unauthenticated flag instead. - --logging=[COMPONENT,...] - Set the components that have logging enabled. Valid component values - are: SYSTEM, WORKLOAD, API_SERVER, CONTROLLER_MANAGER, SCHEDULER, - NONE - - For more information, see - https://cloud.google.com/kubernetes-engine/docs/concepts/about-logs#available-logs - - Examples: - - $ gcloud container clusters update --logging=SYSTEM - $ gcloud container clusters update \ - --logging=SYSTEM,API_SERVER,WORKLOAD - $ gcloud container clusters update --logging=NONE - - --monitoring=[COMPONENT,...] - Set the components that have monitoring enabled. Valid component - values are: SYSTEM, WORKLOAD (Deprecated), NONE, API_SERVER, - CONTROLLER_MANAGER, SCHEDULER, DAEMONSET, DEPLOYMENT, HPA, POD, - STATEFULSET, STORAGE, CADVISOR, KUBELET, DCGM - - For more information, see - https://cloud.google.com/kubernetes-engine/docs/how-to/configure-metrics#available-metrics - - Examples: - - $ gcloud container clusters update --monitoring=SYSTEM,API_SERVER,POD - $ gcloud container clusters update --monitoring=NONE - - At most one of these can be specified: - - --disable-managed-prometheus - Disable managed collection for Managed Service for Prometheus. - - --enable-managed-prometheus - Enables managed collection for Managed Service for Prometheus in - the cluster. - - See - https://cloud.google.com/stackdriver/docs/managed-prometheus/setup-managed#enable-mgdcoll-gke - for more info. - - Enabled by default for cluster versions 1.27 or greater, use - --no-enable-managed-prometheus to disable. - --logging-service=LOGGING_SERVICE (DEPRECATED) Logging service to use for the cluster. Options are: "logging.googleapis.com/kubernetes" (the Google Cloud Logging service diff --git a/gcloud/container/node-pools/update b/gcloud/container/node-pools/update index b58d1fa2d..07679b341 100644 --- a/gcloud/container/node-pools/update +++ b/gcloud/container/node-pools/update @@ -4,7 +4,12 @@ NAME SYNOPSIS gcloud container node-pools update NAME - (--containerd-config-from-file=PATH_TO_FILE + (--accelerator=[type=TYPE,[count=COUNT, + gpu-driver-version=GPU_DRIVER_VERSION, + gpu-partition-size=GPU_PARTITION_SIZE, + gpu-sharing-strategy=GPU_SHARING_STRATEGY, + max-shared-clients-per-gpu=MAX_SHARED_CLIENTS_PER_GPU],...] + | --containerd-config-from-file=PATH_TO_FILE | --enable-confidential-nodes | --enable-gvnic | --enable-image-streaming | --enable-insecure-kubelet-readonly-port | --enable-private-nodes | --enable-queued-provisioning @@ -52,6 +57,49 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS Exactly one of these must be specified: + --accelerator=[type=TYPE,[count=COUNT,gpu-driver-version=GPU_DRIVER_VERSION,gpu-partition-size=GPU_PARTITION_SIZE,gpu-sharing-strategy=GPU_SHARING_STRATEGY,max-shared-clients-per-gpu=MAX_SHARED_CLIENTS_PER_GPU],...] + Attaches accelerators (e.g. GPUs) to all nodes. + + type + (Required) The specific type (e.g. nvidia-tesla-t4 for NVIDIA T4) + of accelerator to attach to the instances. Use gcloud compute + accelerator-types list to learn about all available accelerator + types. + + count + (Optional) The number of accelerators to attach to the instances. + The default value is 1. + + gpu-driver-version + (Optional) The NVIDIA driver version to install. + GPU_DRIVER_VERSION must be one of: + + `default`: Install the default driver version for this GKE version. + + `latest`: Install the latest driver version available for this GKE version. + Can only be used for nodes that use Container-Optimized OS. + + `disabled`: Skip automatic driver installation. You must manually install a + driver after you create the cluster. If you omit the flag `gpu-driver-version`, + this is the default option. To learn how to manually install the GPU driver, + refer to: https://cloud.google.com/kubernetes-engine/docs/how-to/gpus#installing_drivers + + gpu-partition-size + (Optional) The GPU partition size used when running + multi-instance GPUs. For information about multi-instance GPUs, + refer to: + https://cloud.google.com/kubernetes-engine/docs/how-to/gpus-multi + + gpu-sharing-strategy + (Optional) The GPU sharing strategy (e.g. time-sharing) to use. + For information about GPU sharing, refer to: + https://cloud.google.com/kubernetes-engine/docs/concepts/timesharing-gpus + + max-shared-clients-per-gpu + (Optional) The max number of containers allowed to share each GPU + on the node. This field is used together with + gpu-sharing-strategy. + --containerd-config-from-file=PATH_TO_FILE Path of the YAML file that contains containerd configuration entries like configuring access to private image registries. diff --git a/gcloud/database-migration/connection-profiles/create/sqlserver b/gcloud/database-migration/connection-profiles/create/sqlserver index a8e3cd1f2..bf0e63831 100644 --- a/gcloud/database-migration/connection-profiles/create/sqlserver +++ b/gcloud/database-migration/connection-profiles/create/sqlserver @@ -5,7 +5,9 @@ NAME SYNOPSIS gcloud database-migration connection-profiles create sqlserver (CONNECTION_PROFILE : --region=REGION) - (--cloudsql-instance=CLOUDSQL_INSTANCE | [--gcs-bucket=GCS_BUCKET + (--cloudsql-instance=CLOUDSQL_INSTANCE + --username=USERNAME (--password=PASSWORD | --prompt-for-password) + | [--gcs-bucket=GCS_BUCKET : --gcs-prefix=GCS_PREFIX --provider=PROVIDER]) [--no-async] [--display-name=DISPLAY_NAME] [--labels=[KEY=VALUE,...]] [GCLOUD_WIDE_FLAG ...] @@ -65,6 +67,28 @@ REQUIRED FLAGS If the source or destination is a Cloud SQL database, then use this field to provide the respective Cloud SQL instance ID. + This flag argument must be specified if any of the other arguments in + this group are specified. + + --username=USERNAME + Username that Database Migration Service uses to connect to the + database for metrics and observability. We highly recommend that you + use the sqlserver user for this. Database Migration Service encrypts + the value when storing it. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + Exactly one of these must be specified: + + --password=PASSWORD + Password for the user that Database Migration Service uses to + connect to the database. Database Migration Service encrypts the + value when storing it, and the field is not returned on request. + + --prompt-for-password + Prompt for the password used to connect to the database. + --gcs-bucket=GCS_BUCKET Cloud Storage bucket for the source SQL Server connection profile where the backups are stored. This flag is used only for SQL Server diff --git a/gcloud/database-migration/connection-profiles/help b/gcloud/database-migration/connection-profiles/help index c70e94054..6e3fabf25 100644 --- a/gcloud/database-migration/connection-profiles/help +++ b/gcloud/database-migration/connection-profiles/help @@ -32,6 +32,9 @@ COMMANDS list List Database Migration Service connection profiles. + test + Test a Database Migration Service connection profile. + update Update a Database Migration Service connection profile. diff --git a/gcloud/database-migration/connection-profiles/test b/gcloud/database-migration/connection-profiles/test new file mode 100644 index 000000000..7e30af747 --- /dev/null +++ b/gcloud/database-migration/connection-profiles/test @@ -0,0 +1,61 @@ +NAME + gcloud database-migration connection-profiles test - test a Database + Migration Service connection profile + +SYNOPSIS + gcloud database-migration connection-profiles test + (CONNECTION_PROFILE : --region=REGION) [--no-async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Validates a Database Migration Service connection profile. + +EXAMPLES + To test a connection profile: + + $ gcloud database-migration connection-profiles test my-profile \ + --region=us-central1 + +POSITIONAL ARGUMENTS + Connection profile resource - The connection profile to test. 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 connection_profile on the command line with a + fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + CONNECTION_PROFILE + ID of the connection_profile or fully qualified identifier for the + connection_profile. + + To set the connection_profile attribute: + ▸ provide the argument connection_profile on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + The Cloud region for the connection_profile. + + To set the region attribute: + ▸ provide the argument connection_profile on the command line with + a fully specified name; + ▸ provide the argument --region on the command line. + +FLAGS + --no-async + Waits for the operation in progress to complete before returning. + +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. diff --git a/gcloud/filestore/instances/create b/gcloud/filestore/instances/create index 4151bb65c..e71c33f5d 100644 --- a/gcloud/filestore/instances/create +++ b/gcloud/filestore/instances/create @@ -11,6 +11,8 @@ SYNOPSIS [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] [--location=LOCATION] [--region=REGION] [--source-instance=SOURCE_INSTANCE] [--tier=TIER; default="BASIC_HDD"] + [--deletion-protection + : --deletion-protection-reason=DELETION_PROTECTION_REASON] [--kms-key=KMS_KEY : --kms-keyring=KMS_KEYRING --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT] [GCLOUD_WIDE_FLAG ...] @@ -243,6 +245,18 @@ OPTIONAL FLAGS performance that scales with capacity and allows you to grow and shrink capacity. + Deletion protection control options. When deletion protection is enabled, + the instance cannot be deleted. + + --deletion-protection + Enables deletion protection for the instance. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --deletion-protection-reason=DELETION_PROTECTION_REASON + The reason for enabling deletion protection for the instance. + Key resource - The Cloud KMS (Key Management Service) cryptokey that will be used to protect the instance. The 'Filestore Service Agent' service account must hold permission 'Cloud KMS CryptoKey Encrypter/Decrypter'. diff --git a/gcloud/filestore/instances/update b/gcloud/filestore/instances/update index e65a1efd6..6a9fa645c 100644 --- a/gcloud/filestore/instances/update +++ b/gcloud/filestore/instances/update @@ -8,7 +8,10 @@ SYNOPSIS [--clear-labels | --remove-labels=[KEY,...]] [[--file-share=[capacity=CAPACITY], [name=NAME],[nfs-export-options=NFS-EXPORT-OPTIONS] - : --clear-nfs-export-options]] [GCLOUD_WIDE_FLAG ...] + : --clear-nfs-export-options]] + [--[no-]deletion-protection + --deletion-protection-reason=DELETION_PROTECTION_REASON] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION Update a Filestore instance. @@ -206,6 +209,17 @@ FLAGS Clears the NfsExportOptions. Must specify --file-share flag if --clear-nfs-export-options is specified. + Deletion protection control options. When deletion protection is enabled, + the instance cannot be deleted. + + --[no-]deletion-protection + Enables deletion protection for the instance. Use + --deletion-protection to enable and --no-deletion-protection to + disable. + + --deletion-protection-reason=DELETION_PROTECTION_REASON + The reason for enabling deletion protection for the instance. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/functions/deploy b/gcloud/functions/deploy index bbe11bb2c..13697ec9a 100644 --- a/gcloud/functions/deploy +++ b/gcloud/functions/deploy @@ -109,7 +109,7 @@ FLAGS --concurrency=CONCURRENCY Set the maximum number of concurrent requests allowed per container instance. Leave concurrency unspecified to receive the server default - value. Only applicable when the --gen2 flag is provided. + value. --docker-registry=DOCKER_REGISTRY Docker Registry to use for storing the function's Docker images. The @@ -164,8 +164,6 @@ FLAGS If not provided, the function will use the project's default service account for Compute Engine. - This is only relevant when --gen2 is provided. - --runtime=RUNTIME Runtime in which to run the function. @@ -186,8 +184,7 @@ FLAGS secure-optional. --serve-all-traffic-latest-revision - If specified, latest function revision will be served all traffic. This - is only relevant when --gen2 is provided. + If specified, latest function revision will be served all traffic. --service-account=SERVICE_ACCOUNT The email address of the IAM service account associated with the @@ -284,8 +281,7 @@ FLAGS --trigger-location=TRIGGER_LOCATION The location of the trigger, which must be a region or multi-region - where the relevant events originate. This is only relevant when --gen2 - is provided. + where the relevant events originate. --trigger-service-account=TRIGGER_SERVICE_ACCOUNT The email address of the IAM service account associated with the @@ -295,8 +291,6 @@ FLAGS If not provided, the function will use the project's default service account for Compute Engine. - This is only relevant when --gen2 is provided. - --update-labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to update. If a label exists, its value is modified. Otherwise, a new label is created. @@ -608,8 +602,8 @@ FLAGS memory limit unless you specify this flag. --cpu=CPU - The number of available CPUs to set. Only valid when --gen2 and - --memory=MEMORY are specified. + The number of available CPUs to set. Only valid when --memory=MEMORY is + specified. Examples: .5, 2, 2.0, 2000m. @@ -668,14 +662,12 @@ FLAGS The Eventarc matching criteria for the trigger. The criteria can be specified either as a single comma-separated argument or as multiple arguments. The filters must include the type attribute, as well as - any other attributes that are expected for the chosen type. This is - only relevant when --gen2 is provided. + any other attributes that are expected for the chosen type. --trigger-event-filters-path-pattern=[ATTRIBUTE=PATH_PATTERN,...] The Eventarc matching criteria for the trigger in path pattern format. The criteria can be specified as a single comma-separated - argument or as multiple arguments. This is only relevant when --gen2 - is provided. + argument or as multiple arguments. The provided attribute/value pair will be used with the match-path-pattern operator to configure the trigger, see diff --git a/gcloud/iam/help b/gcloud/iam/help index 5c38afd24..6a317ac01 100644 --- a/gcloud/iam/help +++ b/gcloud/iam/help @@ -17,7 +17,7 @@ DESCRIPTION More information on Cloud IAM can be found here: https://cloud.google.com/iam and detailed documentation can be found here: - https://cloud.google.com/iam/docs/ + https://cloud.google.com/iam/docs/. GCLOUD WIDE FLAGS These flags are available to all commands: --help. diff --git a/gcloud/looker/instances/create b/gcloud/looker/instances/create index ba21a4f03..be9115fc5 100644 --- a/gcloud/looker/instances/create +++ b/gcloud/looker/instances/create @@ -4,8 +4,8 @@ NAME SYNOPSIS gcloud looker instances create (INSTANCE : --region=REGION) --edition=EDITION --oauth-client-id=OAUTH_CLIENT_ID - --oauth-client-secret=OAUTH_CLIENT_SECRET [--async] [--kms-key=KMS_KEY] - [--no-public-ip-enabled] + --oauth-client-secret=OAUTH_CLIENT_SECRET [--async] [--fips-enabled] + [--kms-key=KMS_KEY] [--no-public-ip-enabled] [--consumer-network=CONSUMER_NETWORK --private-ip-enabled : --reserved-range=RESERVED_RANGE] [--deny-maintenance-period-end-date=DENY_MAINTENANCE_PERIOD_END_DATE @@ -116,6 +116,9 @@ OPTIONAL FLAGS Return immediately, without waiting for the operation in progress to complete. + --fips-enabled + This specifies whether FIPS is enabled on the Looker instance. + Key resource - The Cloud KMS (Key Management Service) cryptokey that will be used to protect the Looker instance and backups. The 'Looker Service Agent' service account must hold permission 'Cloud KMS CryptoKey diff --git a/gcloud/netapp/storage-pools/create b/gcloud/netapp/storage-pools/create index 61dde12ff..1c139edb0 100644 --- a/gcloud/netapp/storage-pools/create +++ b/gcloud/netapp/storage-pools/create @@ -7,7 +7,7 @@ SYNOPSIS --service-level=SERVICE_LEVEL [--active-directory=ACTIVE_DIRECTORY] [--async] [--description=DESCRIPTION] [--enable-ldap=ENABLE_LDAP] [--kms-config=KMS_CONFIG] [--labels=[KEY=VALUE,...]] - [GCLOUD_WIDE_FLAG ...] + [--replica-zone=REPLICA_ZONE] [--zone=ZONE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION Creates a Storage Pool to contain Volumes with a specified Service Level @@ -175,6 +175,12 @@ OPTIONAL FLAGS contain only hyphens (-), underscores (_), lowercase characters, and numbers. + --replica-zone=REPLICA_ZONE + String indicating replica zone for the Storage Pool + + --zone=ZONE + String indicating active zone of the Storage Pool + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/netapp/storage-pools/help b/gcloud/netapp/storage-pools/help index 9dc762a1c..a8cc6faa9 100644 --- a/gcloud/netapp/storage-pools/help +++ b/gcloud/netapp/storage-pools/help @@ -27,6 +27,9 @@ COMMANDS list List Cloud NetApp Storage Pools. + switch + Switch a Regional Cloud NetApp Flex Storage Pool zone. + update Update a Cloud NetApp Storage Pool. diff --git a/gcloud/netapp/storage-pools/switch b/gcloud/netapp/storage-pools/switch new file mode 100644 index 000000000..f29fef07f --- /dev/null +++ b/gcloud/netapp/storage-pools/switch @@ -0,0 +1,76 @@ +NAME + gcloud netapp storage-pools switch - switch a Regional Cloud NetApp Flex + Storage Pool zone + +SYNOPSIS + gcloud netapp storage-pools switch (STORAGE_POOL : --location=LOCATION) + [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Switch a Regional Cloud NetApp Flex Storage Pool zone. + +EXAMPLES + The following command switches zone of a Storage Pool named NAME using the + required arguments: + + $ gcloud netapp storage-pools switch NAME --location=us-central1 + + To switch zone of a Storage Pool named NAME asynchronously, run the + following command: + + $ gcloud netapp storage-pools switch NAME --location=us-central1 \ + --async + +POSITIONAL ARGUMENTS + Storage pool resource - The Storage Pool to switch. 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 storage_pool on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + STORAGE_POOL + ID of the storage_pool or fully qualified identifier for the + storage_pool. + + To set the storage_pool attribute: + ▸ provide the argument storage_pool on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the storage_pool. + + To set the location attribute: + ▸ provide the argument storage_pool on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha netapp storage-pools switch + + $ gcloud beta netapp storage-pools switch + diff --git a/gcloud/netapp/storage-pools/update b/gcloud/netapp/storage-pools/update index 7277e1f5a..fd42a3d2c 100644 --- a/gcloud/netapp/storage-pools/update +++ b/gcloud/netapp/storage-pools/update @@ -4,7 +4,8 @@ NAME SYNOPSIS gcloud netapp storage-pools update (STORAGE_POOL : --location=LOCATION) [--active-directory=ACTIVE_DIRECTORY] [--async] [--capacity=CAPACITY] - [--description=DESCRIPTION] [--update-labels=[KEY=VALUE,...]] + [--description=DESCRIPTION] [--replica-zone=REPLICA_ZONE] + [--update-labels=[KEY=VALUE,...]] [--zone=ZONE] [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -86,6 +87,9 @@ FLAGS --description=DESCRIPTION A description of the Cloud NetApp Storage Pool + --replica-zone=REPLICA_ZONE + String indicating replica zone for the Storage Pool + --update-labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to update. If a label exists, its value is modified. Otherwise, a new label is created. @@ -95,6 +99,9 @@ FLAGS contain only hyphens (-), underscores (_), lowercase characters, and numbers. + --zone=ZONE + String indicating active zone of the Storage Pool + At most one of these can be specified: --clear-labels diff --git a/gcloud/netapp/volumes/replications/create b/gcloud/netapp/volumes/replications/create index 8dcdde684..7bebb4729 100644 --- a/gcloud/netapp/volumes/replications/create +++ b/gcloud/netapp/volumes/replications/create @@ -9,8 +9,8 @@ SYNOPSIS [share_name=SHARE_NAME], [storage_pool=STORAGE_POOL],[volume_id=VOLUME_ID] --replication-schedule=REPLICATION_SCHEDULE [--async] - [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] - [--volume=VOLUME] [GCLOUD_WIDE_FLAG ...] + [--cluster-location=CLUSTER_LOCATION] [--description=DESCRIPTION] + [--labels=[KEY=VALUE,...]] [--volume=VOLUME] [GCLOUD_WIDE_FLAG ...] DESCRIPTION Create a Cloud NetApp Volume Replication. @@ -73,6 +73,9 @@ OPTIONAL FLAGS Return immediately, without waiting for the operation in progress to complete. + --cluster-location=CLUSTER_LOCATION + Location of the user cluster. + --description=DESCRIPTION A description of the Cloud NetApp Replication diff --git a/gcloud/netapp/volumes/replications/update b/gcloud/netapp/volumes/replications/update index 5cbb0e920..dc3f37153 100644 --- a/gcloud/netapp/volumes/replications/update +++ b/gcloud/netapp/volumes/replications/update @@ -5,7 +5,7 @@ NAME SYNOPSIS gcloud netapp volumes replications update (REPLICATION : --location=LOCATION) [--async] - [--description=DESCRIPTION] + [--cluster-location=CLUSTER_LOCATION] [--description=DESCRIPTION] [--replication-schedule=REPLICATION_SCHEDULE] [--update-labels=[KEY=VALUE,...]] [--volume=VOLUME] [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] @@ -20,7 +20,7 @@ EXAMPLES $ gcloud netapp volumes replications update NAME \ --location=us-central1 --volume=vol1 \ --replication-schedule=EVERY_5_MINUTES \ - --description="new description" + --description="new description" --cluster-location= us-central1 POSITIONAL ARGUMENTS Replication resource - The Replication to update. The arguments in this @@ -65,6 +65,9 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + --cluster-location=CLUSTER_LOCATION + Location of the user cluster. + --description=DESCRIPTION A description of the Cloud NetApp Replication diff --git a/gcloud/pubsub/subscriptions/update b/gcloud/pubsub/subscriptions/update index 700667ca9..39d45282a 100644 --- a/gcloud/pubsub/subscriptions/update +++ b/gcloud/pubsub/subscriptions/update @@ -61,9 +61,8 @@ FLAGS message with a given value of message_id on this subscription: The message sent to a subscriber is guaranteed not to be resent before the message's acknowledgment deadline expires. An acknowledged message will - not be resent to a subscriber. To disable exactly-once delivery use - --no-enable-exactly-once-delivery. Use - --no-enable-exactly-once-delivery to disable this flag. + not be resent to a subscriber. Use --no-enable-exactly-once-delivery to + disable this flag. --expiration-period=EXPIRATION_PERIOD The subscription will expire if it is inactive for the given period. @@ -77,10 +76,11 @@ FLAGS How long to retain unacknowledged messages in the subscription's backlog, from the moment a message is published. If --retain-acked-messages is true, this also configures the retention of - acknowledged messages. Specify "default" to use the default value. - Valid values are strings of the form INTEGER[UNIT], where UNIT is one - of "s", "m", "h", and "d" for seconds, minutes, hours, and days, - respectively. If the unit is omitted, seconds is assumed. + acknowledged messages. Specify "default" to use the default value of 7 + days. The minimum is 10 minutes, and the maximum is 7 days. Valid + values are strings of the form INTEGER[UNIT], where UNIT is one of "s", + "m", "h", and "d" for seconds, minutes, hours, and days, respectively. + If the unit is omitted, seconds is assumed. --push-auth-service-account=SERVICE_ACCOUNT_EMAIL Service account email used as the identity for the generated Open ID diff --git a/gcloud/redis/clusters/create b/gcloud/redis/clusters/create index 22ba065fa..2e4c574bd 100644 --- a/gcloud/redis/clusters/create +++ b/gcloud/redis/clusters/create @@ -5,10 +5,12 @@ NAME SYNOPSIS gcloud redis clusters create (CLUSTER : --region=REGION) --network=NETWORK [--aof-append-fsync=AOF_APPEND_FSYNC] [--async] [--auth-mode=AUTH_MODE] + [--cross-cluster-replication-role=CROSS_CLUSTER_REPLICATION_ROLE] [--deletion-protection] [--maintenance-window-day=MAINTENANCE_WINDOW_DAY] [--maintenance-window-hour=MAINTENANCE_WINDOW_HOUR] [--node-type=NODE_TYPE] [--persistence-mode=PERSISTENCE_MODE] + [--primary-cluster=PRIMARY_CLUSTER] [--rdb-snapshot-period=RDB_SNAPSHOT_PERIOD] [--rdb-snapshot-start-time=RDB_SNAPSHOT_START_TIME] [--redis-config=[KEY=VALUE,...]] [--replica-count=REPLICA_COUNT] @@ -114,6 +116,13 @@ OPTIONAL FLAGS iam-auth IAM basic authorization is enabled for the cluster. + --cross-cluster-replication-role=CROSS_CLUSTER_REPLICATION_ROLE + The role of the cluster in cross cluster replication. + CROSS_CLUSTER_REPLICATION_ROLE must be (only one value is supported): + + secondary + Create a secondary cluster. + --deletion-protection Enable deletion protection for the Redis Cluster. Use --deletion-protection/--no-deletion-protection to enable/disable it. @@ -142,6 +151,12 @@ OPTIONAL FLAGS rdb RDB-based persistence + --primary-cluster=PRIMARY_CLUSTER + The primary cluster that the secondary cluster will replicate from. It + must use the format: + projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID. It must refer + to an existing cluster. Otherwise, the create operation fails. + --rdb-snapshot-period=RDB_SNAPSHOT_PERIOD Attempted period between RDB snapshots. RDB_SNAPSHOT_PERIOD must be one of: diff --git a/gcloud/run/jobs/help b/gcloud/run/jobs/help index 0dbdaebf0..d4c514833 100644 --- a/gcloud/run/jobs/help +++ b/gcloud/run/jobs/help @@ -28,6 +28,9 @@ GROUPS executions View and manage your Cloud Run jobs executions. + logs + Read logs for Cloud Run jobs. + COMMANDS COMMAND is one of the following: diff --git a/gcloud/run/jobs/logs/help b/gcloud/run/jobs/logs/help new file mode 100644 index 000000000..ff83096dc --- /dev/null +++ b/gcloud/run/jobs/logs/help @@ -0,0 +1,41 @@ +NAME + gcloud run jobs logs - read logs for Cloud Run jobs + +SYNOPSIS + gcloud run jobs logs COMMAND [--region=REGION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Read logs for Cloud Run jobs. + +EXAMPLES + To tail logs executions for a job, run: + + $ gcloud run jobs logs tail my-job + + To read logs executions for a job, run: + + $ gcloud run jobs logs read my-job + +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: + + read + Read logs for Cloud Run jobs. + +NOTES + These variants are also available: + + $ gcloud alpha run jobs logs + + $ gcloud beta run jobs logs + diff --git a/gcloud/run/jobs/logs/read b/gcloud/run/jobs/logs/read new file mode 100644 index 000000000..0d3a0b930 --- /dev/null +++ b/gcloud/run/jobs/logs/read @@ -0,0 +1,82 @@ +NAME + gcloud run jobs logs read - read logs for Cloud Run jobs + +SYNOPSIS + gcloud run jobs logs read JOB [--freshness=FRESHNESS; default="1d"] + [--log-filter=LOG_FILTER] [--order=ORDER; default="desc"] + [--region=REGION] [--limit=LIMIT] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + gcloud run jobs logs read reads log entries. Log entries matching + --log-filter are returned according to the specified --order. If the log + entries come from multiple logs, then entries from different logs might be + intermingled in the results. + +EXAMPLES + To read log entries from for a Cloud Run job, run: + + $ gcloud run jobs logs read my-job + + To read log entries with severity ERROR or higher, run: + + $ gcloud run jobs logs read my-job --log-filter="severity>=ERROR" + + To read log entries written in a specific time window, run: + + $ gcloud run jobs logs read my-job \ + --log-filter='timestamp<="2015-05-31T23:59:59Z" AND + timestamp>="2015-05-31T00:00:00Z"' + + To read up to 10 log entries in your job payloads that include the word + SearchText and format the output in JSON format, run: + + $ gcloud run jobs logs read my-job \ + --log-filter="textPayload:SearchText" --limit=10 --format=json + + Detailed information about filters can be found at: + https://cloud.google.com/logging/docs/view/advanced_filters + +POSITIONAL ARGUMENTS + JOB + Name for a Cloud Run job. + +FLAGS + --freshness=FRESHNESS; default="1d" + Return entries that are not older than this value. Works only with DESC + ordering and filters without a timestamp. See $ gcloud topic datetimes + for information on duration formats. + + --log-filter=LOG_FILTER + Filter expression that specifies the log entries to return. Detailed + information about filters can be found at: + https://cloud.google.com/logging/docs/view/logging-query-language + + --order=ORDER; default="desc" + Ordering of returned log entries based on timestamp field. ORDER must + be one of: desc, asc. + + --region=REGION + Region in which the resource can be found. Alternatively, set the + property [run/region]. + +LIST COMMAND FLAGS + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + +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 run jobs logs read + + $ gcloud beta run jobs logs read + diff --git a/gcloud/run/services/help b/gcloud/run/services/help index 5cf489fcc..a8dd73bd6 100644 --- a/gcloud/run/services/help +++ b/gcloud/run/services/help @@ -2,7 +2,8 @@ NAME gcloud run services - view and manage your Cloud Run services SYNOPSIS - gcloud run services COMMAND [--platform=PLATFORM; default="managed"] + gcloud run services GROUP | COMMAND + [--platform=PLATFORM; default="managed"] [--region=REGION | --cluster=CLUSTER --cluster-location=CLUSTER_LOCATION | --context=CONTEXT --kubeconfig=KUBECONFIG] [GCLOUD_WIDE_FLAG ...] @@ -104,6 +105,12 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. +GROUPS + GROUP is one of the following: + + logs + Read logs for Cloud Run services. + COMMANDS COMMAND is one of the following: diff --git a/gcloud/run/services/logs/help b/gcloud/run/services/logs/help new file mode 100644 index 000000000..8429e960f --- /dev/null +++ b/gcloud/run/services/logs/help @@ -0,0 +1,111 @@ +NAME + gcloud run services logs - read logs for Cloud Run services + +SYNOPSIS + gcloud run services logs COMMAND [--platform=PLATFORM; default="managed"] + [--region=REGION + | --cluster=CLUSTER --cluster-location=CLUSTER_LOCATION + | --context=CONTEXT --kubeconfig=KUBECONFIG] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Read logs for Cloud Run services. + +FLAGS + --platform=PLATFORM; default="managed" + Target platform for running commands. Alternatively, set the property + [run/platform]. PLATFORM must be one of: + + managed + Fully managed version of Cloud Run. Use with the --region flag or + set the [run/region] property to specify a Cloud Run region. + gke + Cloud Run for Anthos on Google Cloud. Use with the --cluster and + --cluster-location flags or set the [run/cluster] and + [run/cluster_location] properties to specify a cluster in a given + zone. + kubernetes + Use a Knative-compatible kubernetes cluster. Use with the + --kubeconfig and --context flags to specify a kubeconfig file and + the context for connecting. + + Arguments to locate resources, depending on the platform used. + + At most one of these can be specified: + + Only applicable if connecting to Cloud Run (fully managed). Specify + --platform=managed to use: + + --region=REGION + Region in which the resource can be found. Alternatively, set the + property [run/region]. + + Only applicable if connecting to Cloud Run for Anthos deployed on Google + Cloud. Specify --platform=gke to use: + + Cluster resource - Kubernetes Engine cluster to connect to. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group + but can be set in other ways. + + To set the project attribute: + ▫ provide the argument --cluster on the command line with a fully + specified name; + ▫ set the property run/cluster with a fully specified name; + ▫ specify the cluster from a list of available clusters with a + fully specified name; + ▫ provide the argument --project on the command line; + ▫ set the property core/project. + + --cluster=CLUSTER + ID of the cluster or fully qualified identifier for the cluster. + + To set the cluster attribute: + ◇ provide the argument --cluster on the command line; + ◇ set the property run/cluster; + ◇ specify the cluster from a list of available clusters. + + --cluster-location=CLUSTER_LOCATION + Zone in which the cluster is located. Alternatively, set the + property [run/cluster_location]. + + To set the location attribute: + ◇ provide the argument --cluster on the command line with a + fully specified name; + ◇ set the property run/cluster with a fully specified name; + ◇ specify the cluster from a list of available clusters with a + fully specified name; + ◇ provide the argument --cluster-location on the command line; + ◇ set the property run/cluster_location; + ◇ specify the cluster location from a list of available zones. + + Only applicable if connecting to Cloud Run for Anthos deployed on + VMware. Specify --platform=kubernetes to use: + + --context=CONTEXT + The name of the context in your kubectl config file to use for + connecting. + + --kubeconfig=KUBECONFIG + The absolute path to your kubectl config file. If not specified, + the colon- or semicolon-delimited list of paths specified by + $KUBECONFIG will be used. If $KUBECONFIG is unset, this defaults to + ~/.kube/config. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + read + Read logs for a Cloud Run service. + +NOTES + These variants are also available: + + $ gcloud alpha run services logs + + $ gcloud beta run services logs + diff --git a/gcloud/run/services/logs/read b/gcloud/run/services/logs/read new file mode 100644 index 000000000..7f45c9f3b --- /dev/null +++ b/gcloud/run/services/logs/read @@ -0,0 +1,163 @@ +NAME + gcloud run services logs read - read logs for a Cloud Run service + +SYNOPSIS + gcloud run services logs read SERVICE [--freshness=FRESHNESS; default="1d"] + [--log-filter=LOG_FILTER] [--order=ORDER; default="desc"] + [--platform=PLATFORM; default="managed"] + [--region=REGION + | --cluster=CLUSTER --cluster-location=CLUSTER_LOCATION + | --context=CONTEXT --kubeconfig=KUBECONFIG] [--limit=LIMIT] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + gcloud run services logs read reads log entries. Log entries matching + --log-filter are returned according to the specified --order. If the log + entries come from multiple logs, then entries from different logs might be + intermingled in the results. + +EXAMPLES + To read log entries from for a Cloud Run Service, run: + + $ gcloud run services logs read my-service + + To read log entries with severity ERROR or higher, run: + + $ gcloud run services logs read my-service \ + --log-filter="severity>=ERROR" + + To read log entries written in a specific time window, run: + + $ gcloud run services logs read my-service \ + --log-filter='timestamp<="2015-05-31T23:59:59Z" AND + timestamp>="2015-05-31T00:00:00Z"' + + To read up to 10 log entries in your service payloads that include the word + SearchText and format the output in JSON format, run: + + $ gcloud run services logs read my-service \ + --log-filter="textPayload:SearchText" --limit=10 --format=json + + Detailed information about filters can be found at: + https://cloud.google.com/logging/docs/view/advanced_filters + +POSITIONAL ARGUMENTS + SERVICE + Name for a Cloud Run service. + +FLAGS + --freshness=FRESHNESS; default="1d" + Return entries that are not older than this value. Works only with DESC + ordering and filters without a timestamp. See $ gcloud topic datetimes + for information on duration formats. + + --log-filter=LOG_FILTER + Filter expression that specifies the log entries to return. Detailed + information about filters can be found at: + https://cloud.google.com/logging/docs/view/logging-query-language + + --order=ORDER; default="desc" + Ordering of returned log entries based on timestamp field. ORDER must + be one of: desc, asc. + + --platform=PLATFORM; default="managed" + Target platform for running commands. Alternatively, set the property + [run/platform]. PLATFORM must be one of: + + managed + Fully managed version of Cloud Run. Use with the --region flag or + set the [run/region] property to specify a Cloud Run region. + gke + Cloud Run for Anthos on Google Cloud. Use with the --cluster and + --cluster-location flags or set the [run/cluster] and + [run/cluster_location] properties to specify a cluster in a given + zone. + kubernetes + Use a Knative-compatible kubernetes cluster. Use with the + --kubeconfig and --context flags to specify a kubeconfig file and + the context for connecting. + + Arguments to locate resources, depending on the platform used. + + At most one of these can be specified: + + Only applicable if connecting to Cloud Run (fully managed). Specify + --platform=managed to use: + + --region=REGION + Region in which the resource can be found. Alternatively, set the + property [run/region]. + + Only applicable if connecting to Cloud Run for Anthos deployed on Google + Cloud. Specify --platform=gke to use: + + Cluster resource - Kubernetes Engine cluster to connect to. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group + but can be set in other ways. + + To set the project attribute: + ▫ provide the argument --cluster on the command line with a fully + specified name; + ▫ set the property run/cluster with a fully specified name; + ▫ specify the cluster from a list of available clusters with a + fully specified name; + ▫ provide the argument --project on the command line; + ▫ set the property core/project. + + --cluster=CLUSTER + ID of the cluster or fully qualified identifier for the cluster. + + To set the cluster attribute: + ◇ provide the argument --cluster on the command line; + ◇ set the property run/cluster; + ◇ specify the cluster from a list of available clusters. + + --cluster-location=CLUSTER_LOCATION + Zone in which the cluster is located. Alternatively, set the + property [run/cluster_location]. + + To set the location attribute: + ◇ provide the argument --cluster on the command line with a + fully specified name; + ◇ set the property run/cluster with a fully specified name; + ◇ specify the cluster from a list of available clusters with a + fully specified name; + ◇ provide the argument --cluster-location on the command line; + ◇ set the property run/cluster_location; + ◇ specify the cluster location from a list of available zones. + + Only applicable if connecting to Cloud Run for Anthos deployed on + VMware. Specify --platform=kubernetes to use: + + --context=CONTEXT + The name of the context in your kubectl config file to use for + connecting. + + --kubeconfig=KUBECONFIG + The absolute path to your kubectl config file. If not specified, + the colon- or semicolon-delimited list of paths specified by + $KUBECONFIG will be used. If $KUBECONFIG is unset, this defaults to + ~/.kube/config. + +LIST COMMAND FLAGS + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + +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 run services logs read + + $ gcloud beta run services logs read + diff --git a/gcloud/storage/buckets/create b/gcloud/storage/buckets/create index bc98f7603..7b7661f59 100644 --- a/gcloud/storage/buckets/create +++ b/gcloud/storage/buckets/create @@ -74,9 +74,11 @@ FLAGS --placement=REGION,REGION A comma-separated list of exactly 2 regions that form the custom - dual-region. Only regions within the same continent are or will ever be - valid. Invalid location pairs (such as mixed-continent, or with - unsupported regions) will return an error. + [dual-region] + (https://cloud.google.com/storage/docs/locations#location-dr). Only + regions within the same continent are or will ever be valid. Invalid + location pairs (such as mixed-continent, or with unsupported regions) + will return an error. --recovery-point-objective=SETTING, --rpo=SETTING Sets the recovery point objective