From 4a036681b150155acd5fc8a32a0c323b353a8583 Mon Sep 17 00:00:00 2001 From: Automated Date: Wed, 15 Jan 2025 09:50:59 +0000 Subject: [PATCH] gcloud: Wed Jan 15 09:50:59 UTC 2025 --- gcloud/_version | 8 +- gcloud/alpha/builds/submit | 14 +- .../compute/firewall-policies/rules/create | 16 + .../compute/firewall-policies/rules/update | 16 + .../cross-site-networks/describe | 31 ++ .../interconnects/cross-site-networks/help | 3 + .../groups/get-operational-status | 31 ++ .../alpha/compute/interconnects/groups/help | 4 + .../compute/interconnects/wire-groups/help | 3 + .../compute/interconnects/wire-groups/list | 73 ++++ gcloud/alpha/container/clusters/create | 81 +++-- gcloud/alpha/container/node-pools/create | 81 +++-- gcloud/alpha/container/node-pools/update | 88 +++-- gcloud/alpha/filestore/instances/create | 3 +- gcloud/alpha/logging/buckets/update | 27 ++ .../security-profile-groups/create | 319 ++++++++++-------- .../security-profile-groups/update | 137 +++++--- .../network-security/security-profiles/help | 3 + .../network-security/security-profiles/import | 86 +++++ gcloud/alpha/quotas/help | 4 +- gcloud/alpha/quotas/info/describe | 12 +- gcloud/alpha/quotas/info/help | 4 +- gcloud/alpha/quotas/info/list | 21 +- gcloud/alpha/quotas/preferences/create | 14 +- gcloud/alpha/quotas/preferences/describe | 9 +- gcloud/alpha/quotas/preferences/help | 4 +- gcloud/alpha/quotas/preferences/list | 14 +- gcloud/alpha/quotas/preferences/update | 10 +- gcloud/alpha/redis/clusters/create | 9 +- gcloud/alpha/run/services/update | 20 +- gcloud/alpha/source-manager/help | 3 + .../repos/add-iam-policy-binding | 99 ++++++ gcloud/alpha/source-manager/repos/create | 95 ++++++ gcloud/alpha/source-manager/repos/delete | 71 ++++ gcloud/alpha/source-manager/repos/describe | 71 ++++ .../alpha/source-manager/repos/get-iam-policy | 98 ++++++ gcloud/alpha/source-manager/repos/help | 52 +++ gcloud/alpha/source-manager/repos/list | 69 ++++ .../repos/remove-iam-policy-binding | 100 ++++++ .../alpha/source-manager/repos/set-iam-policy | 78 +++++ gcloud/alpha/spanner/instances/create | 8 +- gcloud/alpha/spanner/instances/update | 8 +- .../storage/batch-operations/jobs/cancel | 27 +- .../storage/batch-operations/jobs/create | 42 +-- .../storage/batch-operations/jobs/delete | 27 +- .../storage/batch-operations/jobs/describe | 34 +- .../alpha/storage/batch-operations/jobs/list | 30 +- gcloud/alpha/workstations/configs/create | 17 +- gcloud/alpha/workstations/configs/update | 6 +- gcloud/artifacts/files/describe | 2 + gcloud/beta/builds/submit | 14 +- .../compute/firewall-policies/rules/create | 16 + .../compute/firewall-policies/rules/update | 16 + gcloud/beta/container/clusters/create | 81 +++-- gcloud/beta/container/node-pools/create | 81 +++-- gcloud/beta/container/node-pools/update | 88 +++-- gcloud/beta/filestore/instances/create | 3 +- gcloud/beta/logging/buckets/update | 27 ++ .../beta/netapp/volumes/replications/create | 41 ++- .../regional-endpoints/create | 3 +- .../connectivity-tests/create | 6 +- .../connectivity-tests/update | 6 +- gcloud/beta/quotas/adjuster/help | 23 ++ gcloud/beta/quotas/adjuster/settings/describe | 31 ++ gcloud/beta/quotas/adjuster/settings/help | 28 ++ gcloud/beta/quotas/adjuster/settings/update | 42 +++ gcloud/beta/quotas/help | 34 ++ gcloud/beta/quotas/info/describe | 55 +++ gcloud/beta/quotas/info/help | 46 +++ gcloud/beta/quotas/info/list | 89 +++++ gcloud/beta/quotas/preferences/create | 97 ++++++ gcloud/beta/quotas/preferences/describe | 53 +++ gcloud/beta/quotas/preferences/help | 43 +++ gcloud/beta/quotas/preferences/list | 92 +++++ gcloud/beta/quotas/preferences/update | 109 ++++++ gcloud/beta/redis/clusters/create | 9 +- gcloud/beta/run/services/update | 20 +- gcloud/beta/source-manager/help | 3 + .../repos/add-iam-policy-binding | 97 ++++++ gcloud/beta/source-manager/repos/create | 93 +++++ gcloud/beta/source-manager/repos/delete | 69 ++++ gcloud/beta/source-manager/repos/describe | 69 ++++ .../beta/source-manager/repos/get-iam-policy | 96 ++++++ gcloud/beta/source-manager/repos/help | 49 +++ gcloud/beta/source-manager/repos/list | 67 ++++ .../repos/remove-iam-policy-binding | 98 ++++++ .../beta/source-manager/repos/set-iam-policy | 76 +++++ gcloud/beta/spanner/instances/create | 8 +- gcloud/beta/spanner/instances/update | 8 +- gcloud/beta/workstations/configs/create | 17 +- gcloud/beta/workstations/configs/update | 6 +- gcloud/builds/submit | 14 +- gcloud/compute/firewall-policies/rules/create | 16 + gcloud/compute/firewall-policies/rules/update | 16 + gcloud/container/clusters/create | 81 +++-- gcloud/container/node-pools/create | 81 +++-- gcloud/container/node-pools/update | 88 +++-- .../connection-profiles/create/sqlserver | 4 +- .../connection-profiles/update | 5 + .../conversion-workspaces/create | 39 +-- .../conversion-workspaces/delete | 2 +- .../conversion-workspaces/describe-ddls | 47 ++- .../conversion-workspaces/describe-entities | 44 ++- .../conversion-workspaces/describe-issues | 43 ++- .../conversion-workspaces/import-rules | 12 +- gcloud/database-migration/help | 3 + .../database-migration/migration-jobs/create | 10 +- .../migration-jobs/fetch-source-objects | 52 +++ gcloud/database-migration/migration-jobs/help | 4 + .../database-migration/migration-jobs/promote | 11 +- .../database-migration/migration-jobs/restart | 16 +- .../database-migration/migration-jobs/update | 11 +- gcloud/database-migration/objects/help | 23 ++ gcloud/database-migration/objects/list | 93 +++++ gcloud/database-migration/objects/lookup | 65 ++++ gcloud/filestore/instances/create | 3 +- gcloud/logging/buckets/update | 27 ++ gcloud/netapp/volumes/replications/create | 41 ++- .../regional-endpoints/create | 3 +- .../connectivity-tests/create | 6 +- .../connectivity-tests/update | 6 +- gcloud/spanner/instances/create | 51 ++- gcloud/spanner/instances/update | 33 +- gcloud/workbench/instances/update | 5 +- gcloud/workstations/configs/create | 17 +- gcloud/workstations/configs/update | 6 +- 126 files changed, 4290 insertions(+), 679 deletions(-) create mode 100644 gcloud/alpha/compute/interconnects/cross-site-networks/describe create mode 100644 gcloud/alpha/compute/interconnects/groups/get-operational-status create mode 100644 gcloud/alpha/compute/interconnects/wire-groups/list create mode 100644 gcloud/alpha/network-security/security-profiles/import create mode 100644 gcloud/alpha/source-manager/repos/add-iam-policy-binding create mode 100644 gcloud/alpha/source-manager/repos/create create mode 100644 gcloud/alpha/source-manager/repos/delete create mode 100644 gcloud/alpha/source-manager/repos/describe create mode 100644 gcloud/alpha/source-manager/repos/get-iam-policy create mode 100644 gcloud/alpha/source-manager/repos/help create mode 100644 gcloud/alpha/source-manager/repos/list create mode 100644 gcloud/alpha/source-manager/repos/remove-iam-policy-binding create mode 100644 gcloud/alpha/source-manager/repos/set-iam-policy create mode 100644 gcloud/beta/quotas/adjuster/help create mode 100644 gcloud/beta/quotas/adjuster/settings/describe create mode 100644 gcloud/beta/quotas/adjuster/settings/help create mode 100644 gcloud/beta/quotas/adjuster/settings/update create mode 100644 gcloud/beta/quotas/help create mode 100644 gcloud/beta/quotas/info/describe create mode 100644 gcloud/beta/quotas/info/help create mode 100644 gcloud/beta/quotas/info/list create mode 100644 gcloud/beta/quotas/preferences/create create mode 100644 gcloud/beta/quotas/preferences/describe create mode 100644 gcloud/beta/quotas/preferences/help create mode 100644 gcloud/beta/quotas/preferences/list create mode 100644 gcloud/beta/quotas/preferences/update create mode 100644 gcloud/beta/source-manager/repos/add-iam-policy-binding create mode 100644 gcloud/beta/source-manager/repos/create create mode 100644 gcloud/beta/source-manager/repos/delete create mode 100644 gcloud/beta/source-manager/repos/describe create mode 100644 gcloud/beta/source-manager/repos/get-iam-policy create mode 100644 gcloud/beta/source-manager/repos/help create mode 100644 gcloud/beta/source-manager/repos/list create mode 100644 gcloud/beta/source-manager/repos/remove-iam-policy-binding create mode 100644 gcloud/beta/source-manager/repos/set-iam-policy create mode 100644 gcloud/database-migration/migration-jobs/fetch-source-objects create mode 100644 gcloud/database-migration/objects/help create mode 100644 gcloud/database-migration/objects/list create mode 100644 gcloud/database-migration/objects/lookup diff --git a/gcloud/_version b/gcloud/_version index b7abfd6b2..b49c71b46 100644 --- a/gcloud/_version +++ b/gcloud/_version @@ -1,8 +1,8 @@ -Google Cloud SDK 505.0.0 -alpha 2025.01.03 -beta 2025.01.03 +Google Cloud SDK 506.0.0 +alpha 2025.01.10 +beta 2025.01.10 bq 2.1.11 bundled-python3-unix 3.11.9 -core 2025.01.03 +core 2025.01.10 gcloud-crc32c 1.0.0 gsutil 5.33 diff --git a/gcloud/alpha/builds/submit b/gcloud/alpha/builds/submit index fb4b66cad..a0db4f2f7 100644 --- a/gcloud/alpha/builds/submit +++ b/gcloud/alpha/builds/submit @@ -222,13 +222,13 @@ FLAGS The YAML or JSON file to use as the build configuration file. --pack=[builder=BUILDER],[env=ENV],[image=IMAGE] - Uses CNCF buildpack (https://buildpacks.io/) to create image. The - "image" key/value must be provided. The image name must be in the - gcr.io or pkg.dev namespace. By default gcr.io/buildpacks/builder - will be used. To specify your own builder image use the optional - "builder" key/value argument. To pass environment variables to the - builder use the optional "env" key/value argument where value is a - list of key values using escaping + Uses CNCF buildpack (https://buildpacks.io/) to create the app image. + The app "image" key/value must be provided. The app image name must + be in the gcr.io or pkg.dev namespace. To specify your own builder + image use the optional "builder" key/value argument. By default + gcr.io/buildpacks/builder is used. To pass environment variables to + the builder use the optional "env" key/value argument where value is + a list of key values using escaping (https://cloud.google.com/sdk/gcloud/reference/topic/escaping) if necessary. diff --git a/gcloud/alpha/compute/firewall-policies/rules/create b/gcloud/alpha/compute/firewall-policies/rules/create index 7b1ab2bf4..cac26a57a 100644 --- a/gcloud/alpha/compute/firewall-policies/rules/create +++ b/gcloud/alpha/compute/firewall-policies/rules/create @@ -19,8 +19,10 @@ SYNOPSIS [--src-network-scope=SRC_NETWORK_SCOPE] [--src-networks=[SRC_NETWORKS,...]] [--src-region-codes=[SOURCE_REGION_CODES,...]] + [--src-secure-tags=[SOURCE_SECURE_TAGS,...]] [--src-threat-intelligence=[SOURCE_THREAT_INTELLIGENCE_LISTS,...]] [--target-resources=[TARGET_RESOURCES,...]] + [--target-secure-tags=[TARGET_SECURE_TAGS,...]] [--target-service-accounts=[TARGET_SERVICE_ACCOUNTS,...]] [--[no-]tls-inspect] [GCLOUD_WIDE_FLAG ...] @@ -142,6 +144,16 @@ OPTIONAL FLAGS DIRECTION is ingress. Cannot be specified when the source network scope is NON_INTERNET, VPC_NETWORK or INTRA_VPC. + --src-secure-tags=[SOURCE_SECURE_TAGS,...] + A list of instance secure tags indicating the set of instances on the + network to which the rule applies if all other fields match. Either + --src-ip-ranges or --src-secure-tags must be specified for ingress + traffic. If both --src-ip-ranges and --src-secure-tags are specified, + an inbound connection is allowed if either the range of the source + matches --src-ip-ranges or the tag of the source matches + --src-secure-tags. Secure Tags can be assigned to instances during + instance creation. + --src-threat-intelligence=[SOURCE_THREAT_INTELLIGENCE_LISTS,...] Source Threat Intelligence lists to match for this rule. Can only be specified if DIRECTION is ingress. Cannot be specified when the source @@ -152,6 +164,10 @@ OPTIONAL FLAGS --target-resources=[TARGET_RESOURCES,...] List of URLs of target resources to which the rule is applied. + --target-secure-tags=[TARGET_SECURE_TAGS,...] + An optional, list of target secure tags with a name of the format + tagValues/ or full namespaced name + --target-service-accounts=[TARGET_SERVICE_ACCOUNTS,...] List of target service accounts for the rule. diff --git a/gcloud/alpha/compute/firewall-policies/rules/update b/gcloud/alpha/compute/firewall-policies/rules/update index 0de13277c..928153fe6 100644 --- a/gcloud/alpha/compute/firewall-policies/rules/update +++ b/gcloud/alpha/compute/firewall-policies/rules/update @@ -20,8 +20,10 @@ SYNOPSIS [--src-network-scope=SRC_NETWORK_SCOPE] [--src-networks=[SRC_NETWORKS,...]] [--src-region-codes=[SOURCE_REGION_CODES,...]] + [--src-secure-tags=[SOURCE_SECURE_TAGS,...]] [--src-threat-intelligence=[SOURCE_THREAT_INTELLIGENCE_LISTS,...]] [--target-resources=[TARGET_RESOURCES,...]] + [--target-secure-tags=[TARGET_SECURE_TAGS,...]] [--target-service-accounts=[TARGET_SERVICE_ACCOUNTS,...]] [--[no-]tls-inspect] [GCLOUD_WIDE_FLAG ...] @@ -147,6 +149,16 @@ OPTIONAL FLAGS DIRECTION is ingress. Cannot be specified when the source network scope is NON_INTERNET, VPC_NETWORK or INTRA_VPC. + --src-secure-tags=[SOURCE_SECURE_TAGS,...] + A list of instance secure tags indicating the set of instances on the + network to which the rule applies if all other fields match. Either + --src-ip-ranges or --src-secure-tags must be specified for ingress + traffic. If both --src-ip-ranges and --src-secure-tags are specified, + an inbound connection is allowed if either the range of the source + matches --src-ip-ranges or the tag of the source matches + --src-secure-tags. Secure Tags can be assigned to instances during + instance creation. + --src-threat-intelligence=[SOURCE_THREAT_INTELLIGENCE_LISTS,...] Source Threat Intelligence lists to match for this rule. Can only be specified if DIRECTION is ingress. Cannot be specified when the source @@ -157,6 +169,10 @@ OPTIONAL FLAGS --target-resources=[TARGET_RESOURCES,...] List of URLs of target resources to which the rule is applied. + --target-secure-tags=[TARGET_SECURE_TAGS,...] + An optional, list of target secure tags with a name of the format + tagValues/ or full namespaced name + --target-service-accounts=[TARGET_SERVICE_ACCOUNTS,...] List of target service accounts for the rule. diff --git a/gcloud/alpha/compute/interconnects/cross-site-networks/describe b/gcloud/alpha/compute/interconnects/cross-site-networks/describe new file mode 100644 index 000000000..4ec9df290 --- /dev/null +++ b/gcloud/alpha/compute/interconnects/cross-site-networks/describe @@ -0,0 +1,31 @@ +NAME + gcloud alpha compute interconnects cross-site-networks describe - describe + a Compute Engine cross site network + +SYNOPSIS + gcloud alpha compute interconnects cross-site-networks describe NAME + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) gcloud alpha compute interconnects cross-site-networks describe + displays all data associated with Compute Engine cross site network in a + project. + +POSITIONAL ARGUMENTS + NAME + Name of the crossSiteNetwork to describe. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/compute/interconnects/cross-site-networks/help b/gcloud/alpha/compute/interconnects/cross-site-networks/help index 0c838d060..7e89917d8 100644 --- a/gcloud/alpha/compute/interconnects/cross-site-networks/help +++ b/gcloud/alpha/compute/interconnects/cross-site-networks/help @@ -23,6 +23,9 @@ COMMANDS delete (ALPHA) Delete Compute Engine cross site networks. + describe + (ALPHA) Describe a Compute Engine cross site network. + list (ALPHA) List Google Compute Engine cross site networks. diff --git a/gcloud/alpha/compute/interconnects/groups/get-operational-status b/gcloud/alpha/compute/interconnects/groups/get-operational-status new file mode 100644 index 000000000..3229da30a --- /dev/null +++ b/gcloud/alpha/compute/interconnects/groups/get-operational-status @@ -0,0 +1,31 @@ +NAME + gcloud alpha compute interconnects groups get-operational-status - get the + operational status of a Compute Engine interconnect group + +SYNOPSIS + gcloud alpha compute interconnects groups get-operational-status NAME + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) gcloud alpha compute interconnects groups get-operational-status + gets the operational status of a Compute Engine interconnect group in a + project. + +POSITIONAL ARGUMENTS + NAME + Name of the interconnect group to get operational status. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/compute/interconnects/groups/help b/gcloud/alpha/compute/interconnects/groups/help index 1a638d1f3..4b350bb14 100644 --- a/gcloud/alpha/compute/interconnects/groups/help +++ b/gcloud/alpha/compute/interconnects/groups/help @@ -29,6 +29,10 @@ COMMANDS describe (ALPHA) Describe a Compute Engine interconnect group. + get-operational-status + (ALPHA) Get the operational status of a Compute Engine interconnect + group. + list (ALPHA) List Google Compute Engine interconnect groups. diff --git a/gcloud/alpha/compute/interconnects/wire-groups/help b/gcloud/alpha/compute/interconnects/wire-groups/help index c2233f262..98582c902 100644 --- a/gcloud/alpha/compute/interconnects/wire-groups/help +++ b/gcloud/alpha/compute/interconnects/wire-groups/help @@ -20,6 +20,9 @@ COMMANDS create (ALPHA) Create a Compute Engine wire group. + list + (ALPHA) List Google Compute Engine wire groups. + NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct diff --git a/gcloud/alpha/compute/interconnects/wire-groups/list b/gcloud/alpha/compute/interconnects/wire-groups/list new file mode 100644 index 000000000..1d8b44143 --- /dev/null +++ b/gcloud/alpha/compute/interconnects/wire-groups/list @@ -0,0 +1,73 @@ +NAME + gcloud alpha compute interconnects wire-groups list - list Google Compute + Engine wire groups + +SYNOPSIS + gcloud alpha compute interconnects wire-groups list + --cross-site-network=CROSS_SITE_NETWORK [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) gcloud alpha compute interconnects wire-groups list displays all + Google Compute Engine wire groups in a project. + +EXAMPLES + To list all wire groups in a project in table form, run: + + $ gcloud alpha compute interconnects wire-groups list + + To list the URIs of all wire groups in a project, run: + + $ gcloud alpha compute interconnects wire-groups list --uri + +REQUIRED FLAGS + --cross-site-network=CROSS_SITE_NETWORK + A cross site network for the wire group. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/container/clusters/create b/gcloud/alpha/container/clusters/create index 45bee0dc9..d78827d7d 100644 --- a/gcloud/alpha/container/clusters/create +++ b/gcloud/alpha/container/clusters/create @@ -1329,6 +1329,7 @@ FLAGS hugepageConfig: hugepage_size2m: '1024' hugepage_size1g: '2' + cgroupMode: 'CGROUP_MODE_V2' List of supported kubelet configs in 'kubeletConfig'. @@ -1343,26 +1344,60 @@ FLAGS List of supported sysctls in 'linuxConfig'. - KEY VALUE - net.core.netdev_max_backlog Any positive integer, less - than 2147483647 - net.core.rmem_max Any positive integer, less - than 2147483647 - net.core.wmem_default Any positive integer, less - than 2147483647 - net.core.wmem_max Any positive integer, less - than 2147483647 - net.core.optmem_max Any positive integer, less - than 2147483647 - net.core.somaxconn Must be [128, 2147483647] - net.ipv4.tcp_rmem Any positive integer tuple - net.ipv4.tcp_wmem Any positive integer tuple - net.ipv4.tcp_tw_reuse Must be {0, 1} - kernel.shmmni Must be [4096, 32768] - kernel.shmmax Must be [0, - 18446744073692774399] - kernel.shmall Must be [0, - 18446744073692774399] + KEY VALUE + net.core.netdev_max_backlog Any positive + integer, less than + 2147483647 + net.core.rmem_default Any positive + integer, less than + 2147483647 + net.core.rmem_max Any positive + integer, less than + 2147483647 + net.core.wmem_default Any positive + integer, less than + 2147483647 + net.core.wmem_max Any positive + integer, less than + 2147483647 + net.core.optmem_max Any positive + integer, less than + 2147483647 + net.core.somaxconn Must be between + [128, 2147483647] + net.ipv4.tcp_rmem Any positive + integer tuple + net.ipv4.tcp_wmem Any positive + integer tuple + net.ipv4.tcp_tw_reuse Must be {0, 1} + net.netfilter.nf_conntrack_max Must be between + [65536, 4194304] + net.netfilter.nf_conntrack_buckets Must be between + [65536, 524288]. + Recommend setting: + nf_conntrack_max = + nf_conntrack_bucke + ts * 4 + net.netfilter.nf_conntrack_tcp_timeout_close_wait Must be between + [60, 3600] + net.netfilter.nf_conntrack_tcp_timeout_time_wait Must be between + [1, 600] + net.netfilter.nf_conntrack_tcp_timeout_established Must be between + [600, 86400] + net.netfilter.nf_conntrack_acct Must be {0, 1} + kernel.shmmni Must be between + [4096, 32768] + kernel.shmmax Must be between + [0, + 184467440736927743 + 99] + kernel.shmall Must be between + [0, + 184467440736927743 + 99] + vm.max_map_count Must be between + [65536, + 2147483647] List of supported hugepage size in 'hugepageConfig'. @@ -1377,6 +1412,12 @@ FLAGS 1G hugepages are only available in following machine familes: c3, m2, c2d, c3d, h3, m3, a2, a3, g2. + Supported values for 'cgroupMode' under 'linuxConfig'. + + ◆ CGROUP_MODE_V1: Use cgroupv1 on the node pool. + ◆ CGROUP_MODE_V2: Use cgroupv2 on the node pool. + ◆ CGROUP_MODE_UNSPECIFIED: Use the default GKE cgroup configuration. + Note, updating the system configuration of an existing node pool requires recreation of the nodes which which might cause a disruption. diff --git a/gcloud/alpha/container/node-pools/create b/gcloud/alpha/container/node-pools/create index 353e1559a..b5fd86435 100644 --- a/gcloud/alpha/container/node-pools/create +++ b/gcloud/alpha/container/node-pools/create @@ -703,6 +703,7 @@ FLAGS hugepageConfig: hugepage_size2m: '1024' hugepage_size1g: '2' + cgroupMode: 'CGROUP_MODE_V2' List of supported kubelet configs in 'kubeletConfig'. @@ -717,26 +718,60 @@ FLAGS List of supported sysctls in 'linuxConfig'. - KEY VALUE - net.core.netdev_max_backlog Any positive integer, less - than 2147483647 - net.core.rmem_max Any positive integer, less - than 2147483647 - net.core.wmem_default Any positive integer, less - than 2147483647 - net.core.wmem_max Any positive integer, less - than 2147483647 - net.core.optmem_max Any positive integer, less - than 2147483647 - net.core.somaxconn Must be [128, 2147483647] - net.ipv4.tcp_rmem Any positive integer tuple - net.ipv4.tcp_wmem Any positive integer tuple - net.ipv4.tcp_tw_reuse Must be {0, 1} - kernel.shmmni Must be [4096, 32768] - kernel.shmmax Must be [0, - 18446744073692774399] - kernel.shmall Must be [0, - 18446744073692774399] + KEY VALUE + net.core.netdev_max_backlog Any positive + integer, less than + 2147483647 + net.core.rmem_default Any positive + integer, less than + 2147483647 + net.core.rmem_max Any positive + integer, less than + 2147483647 + net.core.wmem_default Any positive + integer, less than + 2147483647 + net.core.wmem_max Any positive + integer, less than + 2147483647 + net.core.optmem_max Any positive + integer, less than + 2147483647 + net.core.somaxconn Must be between + [128, 2147483647] + net.ipv4.tcp_rmem Any positive + integer tuple + net.ipv4.tcp_wmem Any positive + integer tuple + net.ipv4.tcp_tw_reuse Must be {0, 1} + net.netfilter.nf_conntrack_max Must be between + [65536, 4194304] + net.netfilter.nf_conntrack_buckets Must be between + [65536, 524288]. + Recommend setting: + nf_conntrack_max = + nf_conntrack_bucke + ts * 4 + net.netfilter.nf_conntrack_tcp_timeout_close_wait Must be between + [60, 3600] + net.netfilter.nf_conntrack_tcp_timeout_time_wait Must be between + [1, 600] + net.netfilter.nf_conntrack_tcp_timeout_established Must be between + [600, 86400] + net.netfilter.nf_conntrack_acct Must be {0, 1} + kernel.shmmni Must be between + [4096, 32768] + kernel.shmmax Must be between + [0, + 184467440736927743 + 99] + kernel.shmall Must be between + [0, + 184467440736927743 + 99] + vm.max_map_count Must be between + [65536, + 2147483647] List of supported hugepage size in 'hugepageConfig'. @@ -751,6 +786,12 @@ FLAGS 1G hugepages are only available in following machine familes: c3, m2, c2d, c3d, h3, m3, a2, a3, g2. + Supported values for 'cgroupMode' under 'linuxConfig'. + + ◆ CGROUP_MODE_V1: Use cgroupv1 on the node pool. + ◆ CGROUP_MODE_V2: Use cgroupv2 on the node pool. + ◆ CGROUP_MODE_UNSPECIFIED: Use the default GKE cgroup configuration. + Note, updating the system configuration of an existing node pool requires recreation of the nodes which which might cause a disruption. diff --git a/gcloud/alpha/container/node-pools/update b/gcloud/alpha/container/node-pools/update index de8b7e94f..cc3751a19 100644 --- a/gcloud/alpha/container/node-pools/update +++ b/gcloud/alpha/container/node-pools/update @@ -274,6 +274,7 @@ REQUIRED FLAGS hugepageConfig: hugepage_size2m: '1024' hugepage_size1g: '2' + cgroupMode: 'CGROUP_MODE_V2' List of supported kubelet configs in 'kubeletConfig'. @@ -288,29 +289,63 @@ REQUIRED FLAGS List of supported sysctls in 'linuxConfig'. - KEY VALUE - net.core.netdev_max_backlog Any positive integer, - less than 2147483647 - net.core.rmem_max Any positive integer, - less than 2147483647 - net.core.wmem_default Any positive integer, - less than 2147483647 - net.core.wmem_max Any positive integer, - less than 2147483647 - net.core.optmem_max Any positive integer, - less than 2147483647 - net.core.somaxconn Must be [128, - 2147483647] - net.ipv4.tcp_rmem Any positive integer - tuple - net.ipv4.tcp_wmem Any positive integer - tuple - net.ipv4.tcp_tw_reuse Must be {0, 1} - kernel.shmmni Must be [4096, 32768] - kernel.shmmax Must be [0, - 18446744073692774399] - kernel.shmall Must be [0, - 18446744073692774399] + KEY VALUE + net.core.netdev_max_backlog Any positive + integer, less + than 2147483647 + net.core.rmem_default Any positive + integer, less + than 2147483647 + net.core.rmem_max Any positive + integer, less + than 2147483647 + net.core.wmem_default Any positive + integer, less + than 2147483647 + net.core.wmem_max Any positive + integer, less + than 2147483647 + net.core.optmem_max Any positive + integer, less + than 2147483647 + net.core.somaxconn Must be between + [128, + 2147483647] + net.ipv4.tcp_rmem Any positive + integer tuple + net.ipv4.tcp_wmem Any positive + integer tuple + net.ipv4.tcp_tw_reuse Must be {0, 1} + net.netfilter.nf_conntrack_max Must be between + [65536, 4194304] + net.netfilter.nf_conntrack_buckets Must be between + [65536, 524288]. + Recommend + setting: + nf_conntrack_max + = + nf_conntrack_buc + kets * 4 + net.netfilter.nf_conntrack_tcp_timeout_close_wait Must be between + [60, 3600] + net.netfilter.nf_conntrack_tcp_timeout_time_wait Must be between + [1, 600] + net.netfilter.nf_conntrack_tcp_timeout_established Must be between + [600, 86400] + net.netfilter.nf_conntrack_acct Must be {0, 1} + kernel.shmmni Must be between + [4096, 32768] + kernel.shmmax Must be between + [0, + 1844674407369277 + 4399] + kernel.shmall Must be between + [0, + 1844674407369277 + 4399] + vm.max_map_count Must be between + [65536, + 2147483647] List of supported hugepage size in 'hugepageConfig'. @@ -325,6 +360,13 @@ REQUIRED FLAGS 1G hugepages are only available in following machine familes: c3, m2, c2d, c3d, h3, m3, a2, a3, g2. + Supported values for 'cgroupMode' under 'linuxConfig'. + + ▸ CGROUP_MODE_V1: Use cgroupv1 on the node pool. + ▸ CGROUP_MODE_V2: Use cgroupv2 on the node pool. + ▸ CGROUP_MODE_UNSPECIFIED: Use the default GKE cgroup + configuration. + Note, updating the system configuration of an existing node pool requires recreation of the nodes which which might cause a disruption. diff --git a/gcloud/alpha/filestore/instances/create b/gcloud/alpha/filestore/instances/create index 7fc68dc5a..7ab51d0e9 100644 --- a/gcloud/alpha/filestore/instances/create +++ b/gcloud/alpha/filestore/instances/create @@ -206,7 +206,8 @@ REQUIRED FLAGS network. connect-mode Network connection mode used by instances. CONNECT_MODE must be one - of: DIRECT_PEERING or PRIVATE_SERVICE_ACCESS. + of: DIRECT_PEERING, PRIVATE_SERVICE_ACCESS or + PRIVATE_SERVICE_CONNECT. OPTIONAL FLAGS --async diff --git a/gcloud/alpha/logging/buckets/update b/gcloud/alpha/logging/buckets/update index 9285fe5d0..b7f604020 100644 --- a/gcloud/alpha/logging/buckets/update +++ b/gcloud/alpha/logging/buckets/update @@ -8,6 +8,8 @@ SYNOPSIS [--enable-analytics] [--locked] [--remove-indexes=[FIELD PATH,...]] [--restricted-fields=[RESTRICTED_FIELD,...]] [--retention-days=RETENTION_DAYS] [--update-index=[KEY=VALUE, ...,...]] + [--billing-account=BILLING_ACCOUNT_ID | --folder=FOLDER_ID + | --organization=ORGANIZATION_ID | --project=PROJECT_ID] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -122,6 +124,31 @@ OPTIONAL FLAGS The type of data in this index. For example: INDEX_TYPE_STRING Supported types are strings and integers. + At most one of these can be specified: + + --billing-account=BILLING_ACCOUNT_ID + Billing account of the bucket to update. + + --folder=FOLDER_ID + Folder of the bucket to update. + + --organization=ORGANIZATION_ID + Organization of the bucket to update. + + --project=PROJECT_ID + Project of the bucket to update. + + The Google Cloud project ID to use for this invocation. If omitted, + then the current project is assumed; the current project can be + listed using gcloud config list --format='text(core.project)' and can + be set using gcloud config set project PROJECTID. + + --project and its fallback core/project property play two roles in + the invocation. It specifies the project of the resource to operate + on. It also specifies the project for API enablement check, quota, + and billing. To specify a different project for quota and billing, + use --billing-project or billing/quota_project property. + 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-profile-groups/create b/gcloud/alpha/network-security/security-profile-groups/create index 3c6483936..204a241e5 100644 --- a/gcloud/alpha/network-security/security-profile-groups/create +++ b/gcloud/alpha/network-security/security-profile-groups/create @@ -5,14 +5,10 @@ NAME SYNOPSIS gcloud alpha network-security security-profile-groups create (SECURITY_PROFILE_GROUP - : --location=LOCATION --organization=ORGANIZATION) [--async] - [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] - [--custom-intercept-profile=CUSTOM_INTERCEPT_PROFILE - : --custom-intercept-profile-location=CUSTOM_INTERCEPT_PROFILE_LOCATION --custom-intercept-profile-organization=CUSTOM_INTERCEPT_PROFILE_ORGANIZATION] - [--custom-mirroring-profile=CUSTOM_MIRRORING_PROFILE - : --custom-mirroring-profile-location=CUSTOM_MIRRORING_PROFILE_LOCATION --custom-mirroring-profile-organization=CUSTOM_MIRRORING_PROFILE_ORGANIZATION] - [--threat-prevention-profile=THREAT_PREVENTION_PROFILE - : --threat-prevention-profile-location=THREAT_PREVENTION_PROFILE_LOCATION --threat-prevention-profile-organization=THREAT_PREVENTION_PROFILE_ORGANIZATION] + : --location=LOCATION --organization=ORGANIZATION) + ([--custom-intercept-profile=CUSTOM_INTERCEPT_PROFILE + : --custom-intercept-profile-location=CUSTOM_INTERCEPT_PROFILE_LOCATION --custom-intercept-profile-organization=CUSTOM_INTERCEPT_PROFILE_ORGANIZATION] [--custom-mirroring-profile=CUSTOM_MIRRORING_PROFILE : --custom-mirroring-profile-location=CUSTOM_MIRRORING_PROFILE_LOCATION --custom-mirroring-profile-organization=CUSTOM_MIRRORING_PROFILE_ORGANIZATION] [--threat-prevention-profile=THREAT_PREVENTION_PROFILE : --threat-prevention-profile-location=THREAT_PREVENTION_PROFILE_LOCATION --threat-prevention-profile-organization=THREAT_PREVENTION_PROFILE_ORGANIZATION] [--url-filtering-profile=URL_FILTERING_PROFILE : --url-filtering-profile-location=URL_FILTERING_PROFILE_LOCATION --url-filtering-profile-organization=URL_FILTERING_PROFILE_ORGANIZATION]) + [--async] [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -63,7 +59,182 @@ POSITIONAL ARGUMENTS with a fully specified name; ▸ provide the argument --organization on the command line. -FLAGS +REQUIRED FLAGS + At least one of these must be specified: + + Security Profile resource - Path to Security Profile resource. The + arguments in this group can be used to specify the attributes of this + resource. + + --custom-intercept-profile=CUSTOM_INTERCEPT_PROFILE + ID of the Security Profile or fully qualified identifier for the + Security Profile. + + To set the custom-intercept-profile-profile attribute: + ▫ provide the argument --custom-intercept-profile on the command + line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --custom-intercept-profile-location=CUSTOM_INTERCEPT_PROFILE_LOCATION + Location of the Security Profile. NOTE: Only global security + profiles are supported. + + To set the custom-intercept-profile-location attribute: + ▫ provide the argument --custom-intercept-profile on the command + line with a fully specified name; + ▫ provide the argument --custom-intercept-profile-location on the + command line; + ▫ provide the argument --location on the command line; + ▫ provide the argument + networksecurity.organizations.locations.securityProfileGroups on + the command line with a fully specified name. + + --custom-intercept-profile-organization=CUSTOM_INTERCEPT_PROFILE_ORGANIZATION + Organization ID of the Security Profile. + + To set the custom-intercept-profile-organization attribute: + ▫ provide the argument --custom-intercept-profile on the command + line with a fully specified name; + ▫ provide the argument --custom-intercept-profile-organization on + the command line; + ▫ provide the argument --organization on the command line; + ▫ provide the argument + networksecurity.organizations.locations.securityProfileGroups on + the command line with a fully specified name. + + Security Profile resource - Path to Security Profile resource. The + arguments in this group can be used to specify the attributes of this + resource. + + --custom-mirroring-profile=CUSTOM_MIRRORING_PROFILE + ID of the Security Profile or fully qualified identifier for the + Security Profile. + + To set the custom-mirroring-profile-profile attribute: + ▫ provide the argument --custom-mirroring-profile on the command + line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --custom-mirroring-profile-location=CUSTOM_MIRRORING_PROFILE_LOCATION + Location of the Security Profile. NOTE: Only global security + profiles are supported. + + To set the custom-mirroring-profile-location attribute: + ▫ provide the argument --custom-mirroring-profile on the command + line with a fully specified name; + ▫ provide the argument --custom-mirroring-profile-location on the + command line; + ▫ provide the argument --location on the command line; + ▫ provide the argument + networksecurity.organizations.locations.securityProfileGroups on + the command line with a fully specified name. + + --custom-mirroring-profile-organization=CUSTOM_MIRRORING_PROFILE_ORGANIZATION + Organization ID of the Security Profile. + + To set the custom-mirroring-profile-organization attribute: + ▫ provide the argument --custom-mirroring-profile on the command + line with a fully specified name; + ▫ provide the argument --custom-mirroring-profile-organization on + the command line; + ▫ provide the argument --organization on the command line; + ▫ provide the argument + networksecurity.organizations.locations.securityProfileGroups on + the command line with a fully specified name. + + Security Profile resource - Path to Security Profile resource. The + arguments in this group can be used to specify the attributes of this + resource. + + --threat-prevention-profile=THREAT_PREVENTION_PROFILE + ID of the Security Profile or fully qualified identifier for the + Security Profile. + + To set the threat-prevention-profile-profile attribute: + ▫ provide the argument --threat-prevention-profile on the command + line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --threat-prevention-profile-location=THREAT_PREVENTION_PROFILE_LOCATION + Location of the Security Profile. NOTE: Only global security + profiles are supported. + + To set the threat-prevention-profile-location attribute: + ▫ provide the argument --threat-prevention-profile on the command + line with a fully specified name; + ▫ provide the argument --threat-prevention-profile-location on + the command line; + ▫ provide the argument --security-profile-location on the command + line; + ▫ provide the argument --location on the command line; + ▫ provide the argument + networksecurity.organizations.locations.securityProfileGroups on + the command line with a fully specified name. + + --threat-prevention-profile-organization=THREAT_PREVENTION_PROFILE_ORGANIZATION + Organization ID of the Security Profile. + + To set the threat-prevention-profile-organization attribute: + ▫ provide the argument --threat-prevention-profile on the command + line with a fully specified name; + ▫ provide the argument --threat-prevention-profile-organization + on the command line; + ▫ provide the argument --security-profile-organization on the + command line; + ▫ provide the argument --organization on the command line; + ▫ provide the argument + networksecurity.organizations.locations.securityProfileGroups on + the command line with a fully specified name. + + Security Profile resource - Path to Security Profile resource. The + arguments in this group can be used to specify the attributes of this + resource. + + --url-filtering-profile=URL_FILTERING_PROFILE + ID of the Security Profile or fully qualified identifier for the + Security Profile. + + To set the url-filtering-profile-profile attribute: + ▫ provide the argument --url-filtering-profile on the command + line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --url-filtering-profile-location=URL_FILTERING_PROFILE_LOCATION + Location of the Security Profile. NOTE: Only global security + profiles are supported. + + To set the url-filtering-profile-location attribute: + ▫ provide the argument --url-filtering-profile on the command + line with a fully specified name; + ▫ provide the argument --url-filtering-profile-location on the + command line; + ▫ provide the argument --location on the command line; + ▫ provide the argument + networksecurity.organizations.locations.securityProfileGroups on + the command line with a fully specified name. + + --url-filtering-profile-organization=URL_FILTERING_PROFILE_ORGANIZATION + Organization ID of the Security Profile. + + To set the url-filtering-profile-organization attribute: + ▫ provide the argument --url-filtering-profile on the command + line with a fully specified name; + ▫ provide the argument --url-filtering-profile-organization on + the command line; + ▫ provide the argument --organization on the command line; + ▫ provide the argument + networksecurity.organizations.locations.securityProfileGroups on + the command line with a fully specified name. + +OPTIONAL FLAGS --async Return immediately, without waiting for the operation in progress to complete. The default is False. @@ -79,136 +250,6 @@ FLAGS contain only hyphens (-), underscores (_), lowercase characters, and numbers. - Security Profile resource - Path to Security Profile resource. The - arguments in this group can be used to specify the attributes of this - resource. - - --custom-intercept-profile=CUSTOM_INTERCEPT_PROFILE - ID of the Security Profile or fully qualified identifier for the - Security Profile. - - To set the custom-intercept-profile-profile attribute: - ▸ provide the argument --custom-intercept-profile on the command - line. - - This flag argument must be specified if any of the other arguments in - this group are specified. - - --custom-intercept-profile-location=CUSTOM_INTERCEPT_PROFILE_LOCATION - Location of the Security Profile. NOTE: Only global security profiles - are supported. - - To set the custom-intercept-profile-location attribute: - ▸ provide the argument --custom-intercept-profile on the command - line with a fully specified name; - ▸ provide the argument --custom-intercept-profile-location on the - command line; - ▸ provide the argument --location on the command line; - ▸ provide the argument - networksecurity.organizations.locations.securityProfileGroups on - the command line with a fully specified name. - - --custom-intercept-profile-organization=CUSTOM_INTERCEPT_PROFILE_ORGANIZATION - Organization ID of the Security Profile. - - To set the custom-intercept-profile-organization attribute: - ▸ provide the argument --custom-intercept-profile on the command - line with a fully specified name; - ▸ provide the argument --custom-intercept-profile-organization on - the command line; - ▸ provide the argument --organization on the command line; - ▸ provide the argument - networksecurity.organizations.locations.securityProfileGroups on - the command line with a fully specified name. - - Security Profile resource - Path to Security Profile resource. The - arguments in this group can be used to specify the attributes of this - resource. - - --custom-mirroring-profile=CUSTOM_MIRRORING_PROFILE - ID of the Security Profile or fully qualified identifier for the - Security Profile. - - To set the custom-mirroring-profile-profile attribute: - ▸ provide the argument --custom-mirroring-profile on the command - line. - - This flag argument must be specified if any of the other arguments in - this group are specified. - - --custom-mirroring-profile-location=CUSTOM_MIRRORING_PROFILE_LOCATION - Location of the Security Profile. NOTE: Only global security profiles - are supported. - - To set the custom-mirroring-profile-location attribute: - ▸ provide the argument --custom-mirroring-profile on the command - line with a fully specified name; - ▸ provide the argument --custom-mirroring-profile-location on the - command line; - ▸ provide the argument --location on the command line; - ▸ provide the argument - networksecurity.organizations.locations.securityProfileGroups on - the command line with a fully specified name. - - --custom-mirroring-profile-organization=CUSTOM_MIRRORING_PROFILE_ORGANIZATION - Organization ID of the Security Profile. - - To set the custom-mirroring-profile-organization attribute: - ▸ provide the argument --custom-mirroring-profile on the command - line with a fully specified name; - ▸ provide the argument --custom-mirroring-profile-organization on - the command line; - ▸ provide the argument --organization on the command line; - ▸ provide the argument - networksecurity.organizations.locations.securityProfileGroups on - the command line with a fully specified name. - - Security Profile resource - Path to Security Profile resource. The - arguments in this group can be used to specify the attributes of this - resource. - - --threat-prevention-profile=THREAT_PREVENTION_PROFILE - ID of the Security Profile or fully qualified identifier for the - Security Profile. - - To set the threat-prevention-profile-profile attribute: - ▸ provide the argument --threat-prevention-profile on the command - line. - - This flag argument must be specified if any of the other arguments in - this group are specified. - - --threat-prevention-profile-location=THREAT_PREVENTION_PROFILE_LOCATION - Location of the Security Profile. NOTE: Only global security profiles - are supported. - - To set the threat-prevention-profile-location attribute: - ▸ provide the argument --threat-prevention-profile on the command - line with a fully specified name; - ▸ provide the argument --threat-prevention-profile-location on the - command line; - ▸ provide the argument --security-profile-location on the command - line; - ▸ provide the argument --location on the command line; - ▸ provide the argument - networksecurity.organizations.locations.securityProfileGroups on - the command line with a fully specified name. - - --threat-prevention-profile-organization=THREAT_PREVENTION_PROFILE_ORGANIZATION - Organization ID of the Security Profile. - - To set the threat-prevention-profile-organization attribute: - ▸ provide the argument --threat-prevention-profile on the command - line with a fully specified name; - ▸ provide the argument --threat-prevention-profile-organization on - the command line; - ▸ provide the argument --security-profile-organization on the - command line; - ▸ provide the argument --organization on the command line; - ▸ provide the argument - networksecurity.organizations.locations.securityProfileGroups on - the command line with a fully specified name. - 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-profile-groups/update b/gcloud/alpha/network-security/security-profile-groups/update index 876a2ee0a..50c1a362c 100644 --- a/gcloud/alpha/network-security/security-profile-groups/update +++ b/gcloud/alpha/network-security/security-profile-groups/update @@ -8,8 +8,13 @@ SYNOPSIS : --location=LOCATION --organization=ORGANIZATION) [--async] [--description=DESCRIPTION] [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] - [--threat-prevention-profile=THREAT_PREVENTION_PROFILE - : --threat-prevention-profile-location=THREAT_PREVENTION_PROFILE_LOCATION --threat-prevention-profile-organization=THREAT_PREVENTION_PROFILE_ORGANIZATION] + [--clear-threat-prevention-profile + | [--threat-prevention-profile=THREAT_PREVENTION_PROFILE + : --threat-prevention-profile-location=THREAT_PREVENTION_PROFILE_LOCATION --threat-prevention-profile-organization=THREAT_PREVENTION_PROFILE_ORGANIZATION]] + [--clear-url-filtering-profile + | [--url-filtering-profile=URL_FILTERING_PROFILE + : --url-filtering-profile-location=URL_FILTERING_PROFILE_LOCATION + --url-filtering-profile-organization=URL_FILTERING_PROFILE_ORGANIZATION]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -97,51 +102,103 @@ FLAGS silently ignored. If --update-labels is also specified then --update-labels is applied first. - Security Profile resource - Path to Security Profile resource. The - arguments in this group can be used to specify the attributes of this - resource. + At most one of these can be specified: - --threat-prevention-profile=THREAT_PREVENTION_PROFILE - ID of the Security Profile or fully qualified identifier for the - Security Profile. + --clear-threat-prevention-profile + Clear the threat-prevention-profile field. - To set the threat-prevention-profile-profile attribute: - ▸ provide the argument --threat-prevention-profile on the command - line. + Security Profile resource - Path to Security Profile resource. The + arguments in this group can be used to specify the attributes of this + resource. - This flag argument must be specified if any of the other arguments in - this group are specified. + --threat-prevention-profile=THREAT_PREVENTION_PROFILE + ID of the Security Profile or fully qualified identifier for the + Security Profile. - --threat-prevention-profile-location=THREAT_PREVENTION_PROFILE_LOCATION - Location of the Security Profile. NOTE: Only global security profiles - are supported. + To set the threat-prevention-profile-profile attribute: + ▫ provide the argument --threat-prevention-profile on the command + line. - To set the threat-prevention-profile-location attribute: - ▸ provide the argument --threat-prevention-profile on the command - line with a fully specified name; - ▸ provide the argument --threat-prevention-profile-location on the - command line; - ▸ provide the argument --security-profile-location on the command - line; - ▸ provide the argument --location on the command line; - ▸ provide the argument - networksecurity.organizations.locations.securityProfileGroups on - the command line with a fully specified name. + This flag argument must be specified if any of the other arguments + in this group are specified. - --threat-prevention-profile-organization=THREAT_PREVENTION_PROFILE_ORGANIZATION - Organization ID of the Security Profile. + --threat-prevention-profile-location=THREAT_PREVENTION_PROFILE_LOCATION + Location of the Security Profile. NOTE: Only global security + profiles are supported. - To set the threat-prevention-profile-organization attribute: - ▸ provide the argument --threat-prevention-profile on the command - line with a fully specified name; - ▸ provide the argument --threat-prevention-profile-organization on - the command line; - ▸ provide the argument --security-profile-organization on the - command line; - ▸ provide the argument --organization on the command line; - ▸ provide the argument - networksecurity.organizations.locations.securityProfileGroups on - the command line with a fully specified name. + To set the threat-prevention-profile-location attribute: + ▫ provide the argument --threat-prevention-profile on the command + line with a fully specified name; + ▫ provide the argument --threat-prevention-profile-location on + the command line; + ▫ provide the argument --security-profile-location on the command + line; + ▫ provide the argument --location on the command line; + ▫ provide the argument + networksecurity.organizations.locations.securityProfileGroups on + the command line with a fully specified name. + + --threat-prevention-profile-organization=THREAT_PREVENTION_PROFILE_ORGANIZATION + Organization ID of the Security Profile. + + To set the threat-prevention-profile-organization attribute: + ▫ provide the argument --threat-prevention-profile on the command + line with a fully specified name; + ▫ provide the argument --threat-prevention-profile-organization + on the command line; + ▫ provide the argument --security-profile-organization on the + command line; + ▫ provide the argument --organization on the command line; + ▫ provide the argument + networksecurity.organizations.locations.securityProfileGroups on + the command line with a fully specified name. + + At most one of these can be specified: + + --clear-url-filtering-profile + Clear the url-filtering-profile field. + + Security Profile resource - Path to Security Profile resource. The + arguments in this group can be used to specify the attributes of this + resource. + + --url-filtering-profile=URL_FILTERING_PROFILE + ID of the Security Profile or fully qualified identifier for the + Security Profile. + + To set the url-filtering-profile-profile attribute: + ▫ provide the argument --url-filtering-profile on the command + line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --url-filtering-profile-location=URL_FILTERING_PROFILE_LOCATION + Location of the Security Profile. NOTE: Only global security + profiles are supported. + + To set the url-filtering-profile-location attribute: + ▫ provide the argument --url-filtering-profile on the command + line with a fully specified name; + ▫ provide the argument --url-filtering-profile-location on the + command line; + ▫ provide the argument --location on the command line; + ▫ provide the argument + networksecurity.organizations.locations.securityProfileGroups on + the command line with a fully specified name. + + --url-filtering-profile-organization=URL_FILTERING_PROFILE_ORGANIZATION + Organization ID of the Security Profile. + + To set the url-filtering-profile-organization attribute: + ▫ provide the argument --url-filtering-profile on the command + line with a fully specified name; + ▫ provide the argument --url-filtering-profile-organization on + the command line; + ▫ provide the argument --organization on the command line; + ▫ provide the argument + networksecurity.organizations.locations.securityProfileGroups on + the command line with a fully specified name. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/network-security/security-profiles/help b/gcloud/alpha/network-security/security-profiles/help index ca75c260c..199a397ec 100644 --- a/gcloud/alpha/network-security/security-profiles/help +++ b/gcloud/alpha/network-security/security-profiles/help @@ -35,6 +35,9 @@ COMMANDS export (ALPHA) Export Security Profile. + import + (ALPHA) Import Security Profile. + list (ALPHA) List Security Profiles. diff --git a/gcloud/alpha/network-security/security-profiles/import b/gcloud/alpha/network-security/security-profiles/import new file mode 100644 index 000000000..86f08fd37 --- /dev/null +++ b/gcloud/alpha/network-security/security-profiles/import @@ -0,0 +1,86 @@ +NAME + gcloud alpha network-security security-profiles import - import Security + Profile + +SYNOPSIS + gcloud alpha network-security security-profiles import + (SECURITY_PROFILE : --location=LOCATION --organization=ORGANIZATION) + [--async] [--source=SOURCE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Import a Security Profile. + +EXAMPLES + To import a Security Profile from a YAML file, run: + + $ gcloud alpha network-security security-profiles import \ + my-security-profile --organization=1234 --location=global \ + --source=my-security-profile.yaml + +POSITIONAL ARGUMENTS + Security profile resource - Name of the Security Profile to import. 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. + + --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/v1alpha1 API. The full documentation + for this API can be found at: https://cloud.google.com/networking + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/quotas/help b/gcloud/alpha/quotas/help index fec0e22c0..78f41a21c 100644 --- a/gcloud/alpha/quotas/help +++ b/gcloud/alpha/quotas/help @@ -25,5 +25,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta quotas diff --git a/gcloud/alpha/quotas/info/describe b/gcloud/alpha/quotas/info/describe index 88faa2dce..b3914772e 100644 --- a/gcloud/alpha/quotas/info/describe +++ b/gcloud/alpha/quotas/info/describe @@ -9,16 +9,16 @@ SYNOPSIS EXAMPLES To get the details about quota CpusPerProject for service - example.googleapis.com and projects/my-project, run: + example.$$UNIVERSE_DOMAIN$$ and projects/my-project, run: $ gcloud alpha quotas info describe CpusPerProject \ - --service=example.googleapis.com --project=my-project + --service=example.$$UNIVERSE_DOMAIN$$ --project=my-project To get the details about quota CpusPerProject for service - example.googleapis.com and folders/12345, run: + example.$$UNIVERSE_DOMAIN$$ and folders/123, run: $ gcloud alpha quotas info describe CpusPerProject \ - --service=example.googleapis.com --folder=12345 + --service=example.$$UNIVERSE_DOMAIN$$ --folder=123 POSITIONAL ARGUMENTS QUOTA_ID @@ -51,5 +51,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta quotas info describe diff --git a/gcloud/alpha/quotas/info/help b/gcloud/alpha/quotas/info/help index 5c6d81c9a..57f961b5c 100644 --- a/gcloud/alpha/quotas/info/help +++ b/gcloud/alpha/quotas/info/help @@ -42,5 +42,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta quotas info diff --git a/gcloud/alpha/quotas/info/list b/gcloud/alpha/quotas/info/list index 6a8bd4231..3490862f4 100644 --- a/gcloud/alpha/quotas/info/list +++ b/gcloud/alpha/quotas/info/list @@ -10,20 +10,21 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] EXAMPLES - To list all quota info for service example.googleapis.com and + To list all quota info for service example.$$UNIVERSE_DOMAIN$$ and projects/12321, run: - $ gcloud alpha quotas info list --service=example.googleapis.com \ - --project=12321 - $ gcloud alpha quotas info list --service=example.googleapis.com \ - --project=my-project-id + $ gcloud alpha quotas info list \ + --service=example.$$UNIVERSE_DOMAIN$$ --project=12321 + $ gcloud alpha quotas info list \ + --service=example.$$UNIVERSE_DOMAIN$$ --project=my-project-id To list first 100 quota info ordered alphabetically for service - `example.googleapis.com` and `folders/12321`, + `example.$$UNIVERSE_DOMAIN$$` and `folders/123`, run: - $ gcloud alpha quotas info list --service=example.googleapis.com \ - --folder=12321 --page-size=100 + $ gcloud alpha quotas info list \ + --service=example.$$UNIVERSE_DOMAIN$$ --folder=123 \ + --page-size=100 REQUIRED FLAGS --service=SERVICE @@ -84,5 +85,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta quotas info list diff --git a/gcloud/alpha/quotas/preferences/create b/gcloud/alpha/quotas/preferences/create index 218fb31fb..d38e96464 100644 --- a/gcloud/alpha/quotas/preferences/create +++ b/gcloud/alpha/quotas/preferences/create @@ -14,20 +14,20 @@ SYNOPSIS EXAMPLES To create a quota preference in region us-central1 that applies to the - default_limit quota under service example.googleapis.com for + default_limit quota under service example.$$UNIVERSE_DOMAIN$$ for projects/12321, run: $ gcloud alpha quotas preferences create \ - --service=example.googleapis.com --project=12321 \ + --service=example.$$UNIVERSE_DOMAIN$$ --project=12321 \ --quota-id=default_limit --preferred-value=100 \ --dimensions=region=us-central1 \ --preference-id=example_default-limit_us-central1 - To create a quota preference under service example.googleapis.com for - organizations/123 with random preference ID, run: + To create a quota preference under service example.$$UNIVERSE_DOMAIN$$ for + organizations/789 with random preference ID, run: $ gcloud alpha quotas preferences create \ - --service=example.googleapis.com --organization=123 \ + --service=example.$$UNIVERSE_DOMAIN$$ --organization=789 \ --quota-id=default_limit --preferred-value=200 REQUIRED FLAGS @@ -93,5 +93,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta quotas preferences create diff --git a/gcloud/alpha/quotas/preferences/describe b/gcloud/alpha/quotas/preferences/describe index e803df9ea..be791bd72 100644 --- a/gcloud/alpha/quotas/preferences/describe +++ b/gcloud/alpha/quotas/preferences/describe @@ -16,11 +16,10 @@ EXAMPLES $ gcloud alpha quotas preferences describe my-preference \ --project=my-project-id - To get the details about quota preference my-preference for folders/12345, + To get the details about quota preference my-preference for folders/123, run: - $ gcloud alpha quotas preferences describe my-preference \ - --folder=12345 + $ gcloud alpha quotas preferences describe my-preference --folder=123 POSITIONAL ARGUMENTS PREFERENCE_ID @@ -50,5 +49,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta quotas preferences describe diff --git a/gcloud/alpha/quotas/preferences/help b/gcloud/alpha/quotas/preferences/help index ed01f4ab5..9d87b01b2 100644 --- a/gcloud/alpha/quotas/preferences/help +++ b/gcloud/alpha/quotas/preferences/help @@ -39,5 +39,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta quotas preferences diff --git a/gcloud/alpha/quotas/preferences/list b/gcloud/alpha/quotas/preferences/list index 80780d107..db1641009 100644 --- a/gcloud/alpha/quotas/preferences/list +++ b/gcloud/alpha/quotas/preferences/list @@ -15,16 +15,16 @@ EXAMPLES $ gcloud alpha quotas preferences list --project=12321 $ gcloud alpha quotas preferences list --project=my-project-id - To list first 10 quota preferences ordered by create time for folder/12345, + To list first 10 quota preferences ordered by create time for folder/123, run: - $ gcloud alpha quotas preferences list --folder=12345 \ - --page-size=10 --sort-by=create_time + $ gcloud alpha quotas preferences list --folder=123 --page-size=10 \ + --sort-by=create_time To list all quota preferences in unresolved state in region us-central1 for - organization/987, run: + organization/789, run: - $ gcloud alpha quotas preferences list --organization=987 \ + $ gcloud alpha quotas preferences list --organization=789 \ --filter=dimensions.region:us-central1 --reconciling-only REQUIRED FLAGS @@ -88,5 +88,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta quotas preferences list diff --git a/gcloud/alpha/quotas/preferences/update b/gcloud/alpha/quotas/preferences/update index 53e29ccba..2cad9db16 100644 --- a/gcloud/alpha/quotas/preferences/update +++ b/gcloud/alpha/quotas/preferences/update @@ -22,14 +22,14 @@ EXAMPLES that applies to the default_limit quota for projects/12321, run: $ gcloud alpha quotas preferences update my-preference \ - --service=example.googleapis.com --project=12321 \ + --service=example.$$UNIVERSE_DOMAIN$$ --project=12321 \ --quota-id=default_limit --preferred-value=100 \ --dimensions=region=us-central1 - To create a new quota preference for organizations/123, run: + To create a new quota preference for organizations/789, run: $ gcloud alpha quotas preferences update my-preference \ - --service=example.googleapis.com --organization=123 \ + --service=example.$$UNIVERSE_DOMAIN$$ --organization=789 \ --quota-id=default_limit --preferred-value=200 --allow-missing POSITIONAL ARGUMENTS @@ -105,5 +105,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta quotas preferences update diff --git a/gcloud/alpha/redis/clusters/create b/gcloud/alpha/redis/clusters/create index 54bf0dbcd..3f2a55b92 100644 --- a/gcloud/alpha/redis/clusters/create +++ b/gcloud/alpha/redis/clusters/create @@ -9,7 +9,7 @@ SYNOPSIS [--automated-backup-start-time=AUTOMATED_BACKUP_START_TIME] [--automated-backup-ttl=AUTOMATED_BACKUP_TTL] [--cross-cluster-replication-role=CROSS_CLUSTER_REPLICATION_ROLE] - [--deletion-protection] + [--deletion-protection] [--kms-key=KMS_KEY] [--maintenance-window-day=MAINTENANCE_WINDOW_DAY] [--maintenance-window-hour=MAINTENANCE_WINDOW_HOUR] [--network=NETWORK] [--node-type=NODE_TYPE] [--persistence-mode=PERSISTENCE_MODE] @@ -144,6 +144,13 @@ FLAGS Enable deletion protection for the Redis Cluster. Use --deletion-protection/--no-deletion-protection to enable/disable it. + --kms-key=KMS_KEY + The resource name of the customer-managed encryption key (CMEK) to use + for the cluster. It must use this format: + projects/PROJECT_ID/locations/LOCATION/keyRings/KEY_RING/cryptoKeys/CRYPTO_KEY. + The key must be in the same region as the cluster. Otherwise, the + create operation fails. + --maintenance-window-day=MAINTENANCE_WINDOW_DAY Day of week when the window starts, e.g. sunday. MAINTENANCE_WINDOW_DAY must be one of: friday, monday, saturday, sunday, thursday, tuesday, diff --git a/gcloud/alpha/run/services/update b/gcloud/alpha/run/services/update index 7875d19a3..bf502f44d 100644 --- a/gcloud/alpha/run/services/update +++ b/gcloud/alpha/run/services/update @@ -33,10 +33,9 @@ SYNOPSIS --cpu=CPU --depends-on=[CONTAINER,...] --gpu=GPU --image=IMAGE --liveness-probe=[KEY=VALUE,...] --memory=MEMORY --port=PORT --remove-volume-mount=[MOUNT_PATH,...] - --startup-probe=[KEY=VALUE,...] - --[no-]use-http2 --base-image=BASE_IMAGE - | --clear-base-image --clear-env-vars | --env-vars-file=FILE_PATH - | --set-env-vars=[KEY=VALUE,...] | --remove-env-vars=[KEY,...] + --startup-probe=[KEY=VALUE,...] --[no-]use-http2 --clear-env-vars + | --env-vars-file=FILE_PATH | --set-env-vars=[KEY=VALUE,...] + | --remove-env-vars=[KEY,...] --update-env-vars=[KEY=VALUE,...] --clear-secrets | --set-secrets=[KEY=VALUE,...] | --remove-secrets=[KEY,...] --update-secrets=[KEY=VALUE,...]] @@ -498,19 +497,6 @@ FLAGS Whether to use HTTP/2 for connections to the service. Use --use-http2 to enable and --no-use-http2 to disable. - At most one of these can be specified: - - --base-image=BASE_IMAGE - Specifies the base image to be used for automatic base image - updates. When deploying from source using the Google Cloud - buildpacks, this flag will also override the base image used for - the application image. See - https://cloud.google.com/run/docs/deploying-source-code for more - details. - - --clear-base-image - Opts out of automatic base image updates. - At most one of these can be specified: --clear-env-vars diff --git a/gcloud/alpha/source-manager/help b/gcloud/alpha/source-manager/help index 29a8849d1..8a4f471aa 100644 --- a/gcloud/alpha/source-manager/help +++ b/gcloud/alpha/source-manager/help @@ -24,6 +24,9 @@ GROUPS operations (ALPHA) Manage Secure Source Manager operations. + repos + (ALPHA) Manage Secure Source Manager repositories. + 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/source-manager/repos/add-iam-policy-binding b/gcloud/alpha/source-manager/repos/add-iam-policy-binding new file mode 100644 index 000000000..95d06a3f2 --- /dev/null +++ b/gcloud/alpha/source-manager/repos/add-iam-policy-binding @@ -0,0 +1,99 @@ +NAME + gcloud alpha source-manager repos add-iam-policy-binding - add an IAM + policy binding to a Secure Source Manager repository + +SYNOPSIS + gcloud alpha source-manager repos add-iam-policy-binding + (REPOSITORY : --region=REGION) --member=PRINCIPAL --role=ROLE + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Add an IAM policy binding to a Secure Source Manager repository. + +EXAMPLES + To add an IAM policy binding for the Repository Admin role + (roles/securesourcemanager.repoAdmin) for the user test-user@gmail.com in a + repository named my-repo and location us-central1, run the following + command: + + $ gcloud alpha source-manager repos add-iam-policy-binding my-repo \ + --region=us-central1 --member=user:test-user@gmail.com \ + --role=roles/securesourcemanager.repoAdmin + + See https://cloud.google.com/iam/docs/managing-policies for details of + policy role and member types. + +POSITIONAL ARGUMENTS + Repository resource - Secure Source Manager repository to add the IAM + policy binding 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 repository 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. + + REPOSITORY + ID of the repository or fully qualified identifier for the + repository. + + To set the repository attribute: + ▸ provide the argument repository on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Secure Source Manager location. + + To set the region attribute: + ▸ provide the argument repository on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + +REQUIRED FLAGS + --member=PRINCIPAL + The principal to add the binding for. Should be of the form + user|group|serviceAccount:email or domain:domain. + + Examples: user:test-user@gmail.com, group:admins@example.com, + serviceAccount:test123@example.domain.com, or + domain:example.domain.com. + + Some resources also accept the following special values: + ◆ allUsers - Special identifier that represents anyone who is on the + internet, with or without a Google account. + ◆ allAuthenticatedUsers - Special identifier that represents anyone + who is authenticated with a Google account or a service account. + + --role=ROLE + Role name to assign to the principal. The role name is the complete + path of a predefined role, such as roles/logging.viewer, or the role ID + for a custom role, such as + organizations/{ORGANIZATION_ID}/roles/logging.viewer. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the securesourcemanager/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/secure-source-manager + +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 source-manager repos add-iam-policy-binding + diff --git a/gcloud/alpha/source-manager/repos/create b/gcloud/alpha/source-manager/repos/create new file mode 100644 index 000000000..b87d43a31 --- /dev/null +++ b/gcloud/alpha/source-manager/repos/create @@ -0,0 +1,95 @@ +NAME + gcloud alpha source-manager repos create - create a Secure Source Manager + repository + +SYNOPSIS + gcloud alpha source-manager repos create (REPOSITORY : --region=REGION) + --instance=INSTANCE [--description=DESCRIPTION] + [--default-branch=DEFAULT_BRANCH + --gitignores=[GITIGNORES,...] --license=LICENSE --readme=README] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create a Secure Source Manager repository. + +EXAMPLES + To create a repository called 'my-repo' in location 'us-central1' in + instance 'my-instance', run the following command: + + $ gcloud alpha source-manager repos create my-repo \ + --region=us-central1 --instance=my-instance + +POSITIONAL ARGUMENTS + Repository resource - The Secure Source Manager repository to create. 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 + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + REPOSITORY + ID of the repository or fully qualified identifier for the + repository. + + To set the repository attribute: + ▸ provide the argument repository on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Secure Source Manager location. + + To set the region attribute: + ▸ provide the argument repository on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + +REQUIRED FLAGS + --instance=INSTANCE + A Secure Source Manager instance ID. + +OPTIONAL FLAGS + --description=DESCRIPTION + Description of the repository. Cannot exceed 500 characters. + + Repository initialization configuration. + + --default-branch=DEFAULT_BRANCH + Default branch name of the repository. + + --gitignores=[GITIGNORES,...] + List of gitignore template names user can choose from. Full list can + be found here: + https://cloud.google.com/secure-source-manager/docs/reference/rest/v1/projects.locations.repositories#InitialConfig + + --license=LICENSE + License template name user can choose from. Full list can be found + here: + https://cloud.google.com/secure-source-manager/docs/reference/rest/v1/projects.locations.repositories#InitialConfig + + --readme=README + README template name. Valid template name(s) are: default. + +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 source-manager repos create + diff --git a/gcloud/alpha/source-manager/repos/delete b/gcloud/alpha/source-manager/repos/delete new file mode 100644 index 000000000..09bd9620d --- /dev/null +++ b/gcloud/alpha/source-manager/repos/delete @@ -0,0 +1,71 @@ +NAME + gcloud alpha source-manager repos delete - delete a Secure Source Manager + repository + +SYNOPSIS + gcloud alpha source-manager repos delete (REPOSITORY : --region=REGION) + [--allow-missing] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete a Secure Source Manager repository. + +EXAMPLES + To delete a repository called my-repo in location us-central1, run the + following command: + + $ gcloud alpha source-manager repos delete my-repo \ + --region=us-central1 + +POSITIONAL ARGUMENTS + Repository resource - The Secure Source Manager repository to delete. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument repository 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. + + REPOSITORY + ID of the repository or fully qualified identifier for the + repository. + + To set the repository attribute: + ▸ provide the argument repository on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Secure Source Manager location. + + To set the region attribute: + ▸ provide the argument repository on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + +FLAGS + --allow-missing + If set to true, and the repository is not found, the request will + succeed but no action will be taken on the server. + +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 source-manager repos delete + diff --git a/gcloud/alpha/source-manager/repos/describe b/gcloud/alpha/source-manager/repos/describe new file mode 100644 index 000000000..4bebf3c36 --- /dev/null +++ b/gcloud/alpha/source-manager/repos/describe @@ -0,0 +1,71 @@ +NAME + gcloud alpha source-manager repos describe - describe a Secure Source + Manager repository + +SYNOPSIS + gcloud alpha source-manager repos describe (REPOSITORY : --region=REGION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Get metadata of a Secure Source Manager repository. + +EXAMPLES + To describe a repository called my-repo in location us-central1, run the + following command: + + $ gcloud alpha source-manager repos describe my-repo \ + --region=us-central1 + +POSITIONAL ARGUMENTS + Repository resource - The Secure Source Manager repository to describe. + The arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument repository 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. + + REPOSITORY + ID of the repository or fully qualified identifier for the + repository. + + To set the repository attribute: + ▸ provide the argument repository on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Secure Source Manager location. + + To set the region attribute: + ▸ provide the argument repository on the command line with a fully + specified name; + ▸ provide the argument --region 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 securesourcemanager/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/secure-source-manager + +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 source-manager repos describe + diff --git a/gcloud/alpha/source-manager/repos/get-iam-policy b/gcloud/alpha/source-manager/repos/get-iam-policy new file mode 100644 index 000000000..63f5ddc34 --- /dev/null +++ b/gcloud/alpha/source-manager/repos/get-iam-policy @@ -0,0 +1,98 @@ +NAME + gcloud alpha source-manager repos get-iam-policy - get the IAM policy for a + Secure Source Manager repository + +SYNOPSIS + gcloud alpha source-manager repos get-iam-policy + (REPOSITORY : --region=REGION) [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Get the IAM policy for a Secure Source Manager repository. + +EXAMPLES + To get the IAM policy for an repository named my-repo in location + us-central1, run the following command: + + $ gcloud alpha source-manager repos get-iam-policy my-repo \ + --region=us-central1 + +POSITIONAL ARGUMENTS + Repository resource - Secure Source Manager repository to get the IAM + policy from. 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 + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + REPOSITORY + ID of the repository or fully qualified identifier for the + repository. + + To set the repository attribute: + ▸ provide the argument repository on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Secure Source Manager location. + + To set the region attribute: + ▸ provide the argument repository on the command line with a fully + specified name; + ▸ provide the argument --region 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 securesourcemanager/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/secure-source-manager + +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 source-manager repos get-iam-policy + diff --git a/gcloud/alpha/source-manager/repos/help b/gcloud/alpha/source-manager/repos/help new file mode 100644 index 000000000..bc236741d --- /dev/null +++ b/gcloud/alpha/source-manager/repos/help @@ -0,0 +1,52 @@ +NAME + gcloud alpha source-manager repos - manage Secure Source Manager + repositories + +SYNOPSIS + gcloud alpha source-manager repos COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Secure Source Manager repositories. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + add-iam-policy-binding + (ALPHA) Add an IAM policy binding to a Secure Source Manager + repository. + + create + (ALPHA) Create a Secure Source Manager repository. + + delete + (ALPHA) Delete a Secure Source Manager repository. + + describe + (ALPHA) Describe a Secure Source Manager repository. + + get-iam-policy + (ALPHA) Get the IAM policy for a Secure Source Manager repository. + + list + (ALPHA) List all repositories under a Secure Source Manager instance. + + remove-iam-policy-binding + (ALPHA) Remove an IAM policy binding from a Secure Source Manager + repository. + + set-iam-policy + (ALPHA) Set the IAM policy for a Secure Source Manager repository. + +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 source-manager repos + diff --git a/gcloud/alpha/source-manager/repos/list b/gcloud/alpha/source-manager/repos/list new file mode 100644 index 000000000..65bc82952 --- /dev/null +++ b/gcloud/alpha/source-manager/repos/list @@ -0,0 +1,69 @@ +NAME + gcloud alpha source-manager repos list - list all repositories under a + Secure Source Manager instance + +SYNOPSIS + gcloud alpha source-manager repos list --instance=INSTANCE --region=REGION + [--limit=LIMIT] [--page-size=PAGE_SIZE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List Secure Source Manager repositories. + +EXAMPLES + To list repositories in location us-central1 under instance my-instance, + run the following command: + + $ gcloud alpha source-manager repos list --region=us-central1 \ + --instance=my-instance + +REQUIRED FLAGS + --instance=INSTANCE + A Secure Source Manager instance ID. + + Location resource - The Secure Source Manager location to list. This + represents a Cloud resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --region 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. + + --region=REGION + ID of the location or fully qualified identifier for the location. + + To set the region attribute: + ▸ provide the argument --region on the command line. + +LIST COMMAND FLAGS + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This 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 source-manager repos list + diff --git a/gcloud/alpha/source-manager/repos/remove-iam-policy-binding b/gcloud/alpha/source-manager/repos/remove-iam-policy-binding new file mode 100644 index 000000000..4272fcd80 --- /dev/null +++ b/gcloud/alpha/source-manager/repos/remove-iam-policy-binding @@ -0,0 +1,100 @@ +NAME + gcloud alpha source-manager repos remove-iam-policy-binding - remove an IAM + policy binding from a Secure Source Manager repository + +SYNOPSIS + gcloud alpha source-manager repos remove-iam-policy-binding + (REPOSITORY : --region=REGION) --member=PRINCIPAL --role=ROLE + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Remove an IAM policy binding to a Secure Source Manager repository. + +EXAMPLES + To remove the Repository Admin IAM role + (roles/securesourcemanager.repoAdmin) binding from the user + test-user@gmail.com in a repository named my-repo and location us-central1, + run the following command: + + $ gcloud alpha source-manager repos remove-iam-policy-binding \ + my-repo --region=us-central1 --member=user:test-user@gmail.com \ + --role=roles/securesourcemanager.repoAdmin + + See https://cloud.google.com/iam/docs/managing-policies for details of + policy role and member types. + +POSITIONAL ARGUMENTS + Repository resource - Secure Source Manager repository to remove the IAM + policy binding from. 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 + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + REPOSITORY + ID of the repository or fully qualified identifier for the + repository. + + To set the repository attribute: + ▸ provide the argument repository on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Secure Source Manager location. + + To set the region attribute: + ▸ provide the argument repository on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + +REQUIRED FLAGS + --member=PRINCIPAL + The principal to remove the binding for. Should be of the form + user|group|serviceAccount:email or domain:domain. + + Examples: user:test-user@gmail.com, group:admins@example.com, + serviceAccount:test123@example.domain.com, or + domain:example.domain.com. + + Deleted principals have an additional deleted: prefix and a ?uid=UID + suffix, where UID is a unique identifier for the principal. Example: + deleted:user:test-user@gmail.com?uid=123456789012345678901. + + Some resources also accept the following special values: + ◆ allUsers - Special identifier that represents anyone who is on the + internet, with or without a Google account. + ◆ allAuthenticatedUsers - Special identifier that represents anyone + who is authenticated with a Google account or a service account. + + --role=ROLE + The role to remove the principal from. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the securesourcemanager/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/secure-source-manager + +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 source-manager repos remove-iam-policy-binding + diff --git a/gcloud/alpha/source-manager/repos/set-iam-policy b/gcloud/alpha/source-manager/repos/set-iam-policy new file mode 100644 index 000000000..4f8bad852 --- /dev/null +++ b/gcloud/alpha/source-manager/repos/set-iam-policy @@ -0,0 +1,78 @@ +NAME + gcloud alpha source-manager repos set-iam-policy - set the IAM policy for a + Secure Source Manager repository + +SYNOPSIS + gcloud alpha source-manager repos set-iam-policy + (REPOSITORY : --region=REGION) POLICY_FILE [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Set the IAM policy for a Secure Source Manager repository. + +EXAMPLES + To set the IAM policy for a repository named my-repo in location us-central + to the content of policy.json , run the following command: + + $ gcloud alpha source-manager repos set-iam-policy my-repo \ + --region=us-central1 policy.json + +POSITIONAL ARGUMENTS + Repository resource - Secure Source Manager repository to set the IAM + policy on. 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 + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + REPOSITORY + ID of the repository or fully qualified identifier for the + repository. + + To set the repository attribute: + ▸ provide the argument repository on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Secure Source Manager location. + + To set the region attribute: + ▸ provide the argument repository on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + + POLICY_FILE + Path to a local JSON or YAML formatted file containing a valid policy. + + The output of the get-iam-policy command is a valid file, as is any + JSON or YAML file conforming to the structure of a Policy + (https://cloud.google.com/iam/reference/rest/v1/Policy). + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the securesourcemanager/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/secure-source-manager + +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 source-manager repos set-iam-policy + diff --git a/gcloud/alpha/spanner/instances/create b/gcloud/alpha/spanner/instances/create index 9cc283a95..ce6f347ac 100644 --- a/gcloud/alpha/spanner/instances/create +++ b/gcloud/alpha/spanner/instances/create @@ -100,7 +100,7 @@ OPTIONAL FLAGS --processing-units=PROCESSING_UNITS Number of processing units for the instance. - Autoscaling (Preview) + Autoscaling --autoscaling-high-priority-cpu-target=AUTOSCALING_HIGH_PRIORITY_CPU_TARGET Specifies the target percentage of high-priority CPU the autoscaled @@ -116,9 +116,11 @@ OPTIONAL FLAGS This flag argument must be specified if any of the other arguments in this group are specified. + Autoscaling limits can be defined in either nodes or processing units. + Exactly one of these must be specified: - Autoscaling limits in nodes + Autoscaling limits in nodes: --autoscaling-max-nodes=AUTOSCALING_MAX_NODES Maximum number of nodes for the autoscaled instance. @@ -132,7 +134,7 @@ OPTIONAL FLAGS This flag argument must be specified if any of the other arguments in this group are specified. - Autoscaling limits in processing units + Autoscaling limits in processing units: --autoscaling-max-processing-units=AUTOSCALING_MAX_PROCESSING_UNITS Maximum number of processing units for the autoscaled instance. diff --git a/gcloud/alpha/spanner/instances/update b/gcloud/alpha/spanner/instances/update index eedf82398..93434cc58 100644 --- a/gcloud/alpha/spanner/instances/update +++ b/gcloud/alpha/spanner/instances/update @@ -91,7 +91,7 @@ FLAGS --processing-units=PROCESSING_UNITS Number of processing units for the instance. - Autoscaling (Preview) + Autoscaling --autoscaling-high-priority-cpu-target=AUTOSCALING_HIGH_PRIORITY_CPU_TARGET Specifies the target percentage of high-priority CPU the autoscaled @@ -101,9 +101,11 @@ FLAGS Specifies the target percentage of storage the autoscaled instance can utilize. + Autoscaling limits can be defined in either nodes or processing units. + At most one of these can be specified: - Autoscaling limits in nodes + Autoscaling limits in nodes: --autoscaling-max-nodes=AUTOSCALING_MAX_NODES Maximum number of nodes for the autoscaled instance. @@ -111,7 +113,7 @@ FLAGS --autoscaling-min-nodes=AUTOSCALING_MIN_NODES Minimum number of nodes for the autoscaled instance. - Autoscaling limits in processing units + Autoscaling limits in processing units: --autoscaling-max-processing-units=AUTOSCALING_MAX_PROCESSING_UNITS Maximum number of processing units for the autoscaled instance. diff --git a/gcloud/alpha/storage/batch-operations/jobs/cancel b/gcloud/alpha/storage/batch-operations/jobs/cancel index 5b86849ee..288c7f285 100644 --- a/gcloud/alpha/storage/batch-operations/jobs/cancel +++ b/gcloud/alpha/storage/batch-operations/jobs/cancel @@ -3,8 +3,8 @@ NAME batch-operations job SYNOPSIS - gcloud alpha storage batch-operations jobs cancel - (BATCH_JOB : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + gcloud alpha storage batch-operations jobs cancel BATCH_JOB + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Cancel the batch operation job. @@ -21,10 +21,9 @@ EXAMPLES projects/my-project/locations/us-central1/jobs/my-job POSITIONAL ARGUMENTS - Batch job resource - The batch job to cancel. 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. + Batch job resource - The batch job to cancel. 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 batch_job on the command line with a fully @@ -32,6 +31,11 @@ POSITIONAL ARGUMENTS ◆ provide the argument --project on the command line; ◆ set the property core/project. + To set the location attribute: + ◆ provide the argument batch_job on the command line with a fully + specified name; + ◆ The default is global. + This must be specified. BATCH_JOB @@ -40,17 +44,6 @@ POSITIONAL ARGUMENTS To set the batch-job attribute: ▸ provide the argument batch_job on the command line. - This positional argument must be specified if any of the other - arguments in this group are specified. - - --location=LOCATION - Batch-operations supported Google Cloud location for the batch-job. - - To set the location attribute: - ▸ provide the argument batch_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, diff --git a/gcloud/alpha/storage/batch-operations/jobs/create b/gcloud/alpha/storage/batch-operations/jobs/create index 7cff47bf0..190039118 100644 --- a/gcloud/alpha/storage/batch-operations/jobs/create +++ b/gcloud/alpha/storage/batch-operations/jobs/create @@ -3,8 +3,7 @@ NAME operation job SYNOPSIS - gcloud alpha storage batch-operations jobs create - (BATCH_JOB : --location=LOCATION) + gcloud alpha storage batch-operations jobs create BATCH_JOB (--manifest-location=MANIFEST_LOCATION | --prefix-list-file=PREFIX_LIST_FILE) (--put-kms-key=PUT_KMS_KEY | --put-metadata=KEY=VALUE,[KEY=VALUE,...] @@ -19,29 +18,26 @@ DESCRIPTION manner. EXAMPLES - To create a batch job with the name my-job in location us-central1 to - perform object deletion where the manifest file gs://my-bucket/manifest.csv - specifies the objects to be transformed: + To create a batch job with the name my-job to perform object deletion where + the manifest file gs://my-bucket/manifest.csv specifies the objects to be + transformed: $ gcloud alpha storage batch-operations jobs create my-job \ - --location=us-central1 \ --manifest-location=gs://my-bucket/manifest.csv --delete-object - To create a batch job with the name my-job in location us-central1 to - update object metadata Content-Disposition to inline and Content-Language - to en where the prefix list file my-path/my-prefix-list.json specifies the - objects to be transformed: + To create a batch job with the name my-job to update object metadata + Content-Disposition to inline and Content-Language to en where the prefix + list file my-path/my-prefix-list.json specifies the objects to be + transformed: $ gcloud alpha storage batch-operations jobs create my-job \ - --location=us-central1 \ --prefix-list-file=my-path/my-prefix-list.json \ --put-metadata=Content-Disposition=inline,Content-Language=en POSITIONAL ARGUMENTS - Batch job resource - The batch job to create. 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. + Batch job resource - The batch job to create. 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 batch_job on the command line with a fully @@ -49,6 +45,11 @@ POSITIONAL ARGUMENTS ◆ provide the argument --project on the command line; ◆ set the property core/project. + To set the location attribute: + ◆ provide the argument batch_job on the command line with a fully + specified name; + ◆ The default is global. + This must be specified. BATCH_JOB @@ -57,17 +58,6 @@ POSITIONAL ARGUMENTS To set the batch-job attribute: ▸ provide the argument batch_job on the command line. - This positional argument must be specified if any of the other - arguments in this group are specified. - - --location=LOCATION - Batch-operations supported Google Cloud location for the batch-job. - - To set the location attribute: - ▸ provide the argument batch_job on the command line with a fully - specified name; - ▸ provide the argument --location on the command line. - REQUIRED FLAGS Source specifying objects to perform batch operations on. Must be one of --manifest-location=``MANIFEST_LOCATION or diff --git a/gcloud/alpha/storage/batch-operations/jobs/delete b/gcloud/alpha/storage/batch-operations/jobs/delete index 1fb123095..96829183d 100644 --- a/gcloud/alpha/storage/batch-operations/jobs/delete +++ b/gcloud/alpha/storage/batch-operations/jobs/delete @@ -3,8 +3,8 @@ NAME batch-operations job SYNOPSIS - gcloud alpha storage batch-operations jobs delete - (BATCH_JOB : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + gcloud alpha storage batch-operations jobs delete BATCH_JOB + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Delete the batch operation job. @@ -21,10 +21,9 @@ EXAMPLES projects/my-project/locations/us-central1/jobs/my-job POSITIONAL ARGUMENTS - Batch job resource - The batch job to delete. The arguments in this group - can be used to specify the attributes of this resource. (NOTE) Some - attributes are not given arguments in this group but can be set in other - ways. + Batch job resource - The batch job to delete. 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 batch_job on the command line with a fully @@ -32,6 +31,11 @@ POSITIONAL ARGUMENTS ◆ provide the argument --project on the command line; ◆ set the property core/project. + To set the location attribute: + ◆ provide the argument batch_job on the command line with a fully + specified name; + ◆ The default is global. + This must be specified. BATCH_JOB @@ -40,17 +44,6 @@ POSITIONAL ARGUMENTS To set the batch-job attribute: ▸ provide the argument batch_job on the command line. - This positional argument must be specified if any of the other - arguments in this group are specified. - - --location=LOCATION - Batch-operations supported Google Cloud location for the batch-job. - - To set the location attribute: - ▸ provide the argument batch_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, diff --git a/gcloud/alpha/storage/batch-operations/jobs/describe b/gcloud/alpha/storage/batch-operations/jobs/describe index ed7889667..52905c2fc 100644 --- a/gcloud/alpha/storage/batch-operations/jobs/describe +++ b/gcloud/alpha/storage/batch-operations/jobs/describe @@ -3,28 +3,26 @@ NAME batch-operations job SYNOPSIS - gcloud alpha storage batch-operations jobs describe - (BATCH_JOB : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + gcloud alpha storage batch-operations jobs describe BATCH_JOB + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Describe the batch operation job. EXAMPLES - To describe a batch job with the name my-job in location us-central1: + To describe a batch job with the name my-job: - $ gcloud alpha storage batch-operations jobs describe my-job \ - --location=us-central1 + $ gcloud alpha storage batch-operations jobs describe my-job To describe the same batch job with fully specified name: $ gcloud alpha storage batch-operations jobs describe \ - projects/my-project/locations/us-central1/jobs/my-job + projects/my-project/locations/global/jobs/my-job POSITIONAL ARGUMENTS - Batch job resource - The batch job to describe. The arguments in this - group can be used to specify the attributes of this resource. (NOTE) Some - attributes are not given arguments in this group but can be set in other - ways. + Batch job resource - The batch job to describe. This represents a Cloud + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. To set the project attribute: ◆ provide the argument batch_job on the command line with a fully @@ -32,6 +30,11 @@ POSITIONAL ARGUMENTS ◆ provide the argument --project on the command line; ◆ set the property core/project. + To set the location attribute: + ◆ provide the argument batch_job on the command line with a fully + specified name; + ◆ The default is global. + This must be specified. BATCH_JOB @@ -40,17 +43,6 @@ POSITIONAL ARGUMENTS To set the batch-job attribute: ▸ provide the argument batch_job on the command line. - This positional argument must be specified if any of the other - arguments in this group are specified. - - --location=LOCATION - Batch-operations supported Google Cloud location for the batch-job. - - To set the location attribute: - ▸ provide the argument batch_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, diff --git a/gcloud/alpha/storage/batch-operations/jobs/list b/gcloud/alpha/storage/batch-operations/jobs/list index fb8217854..b1bea83d4 100644 --- a/gcloud/alpha/storage/batch-operations/jobs/list +++ b/gcloud/alpha/storage/batch-operations/jobs/list @@ -3,9 +3,9 @@ NAME jobs SYNOPSIS - gcloud alpha storage batch-operations jobs list [--location=LOCATION] - [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] - [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + gcloud alpha storage batch-operations jobs list [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) List batch operation jobs. @@ -15,29 +15,17 @@ EXAMPLES $ gcloud alpha storage batch-operations jobs list - To list all batch jobs for location us-central1: + To list all batch jobs with a page size of 10: - $ gcloud alpha storage batch-operations jobs list \ - --location=us-central1 + $ gcloud alpha storage batch-operations jobs list --page-size=10 - To list all batch jobs for location us-central1 with a page size of 10: + To list a limit of 20 batch jobs: - $ gcloud alpha storage batch-operations jobs list \ - --location=us-central1 --page-size=10 + $ gcloud alpha storage batch-operations jobs list --limit=20 - To list a limit of 20 batch jobs for location us-central1: + To list all batch jobs in JSON format: - $ gcloud alpha storage batch-operations jobs list \ - --location=us-central1 --limit=20 - - To list all batch jobs for location us-central1 in JSON format: - - $ gcloud alpha storage batch-operations jobs list \ - --location=us-central1 --format=json - -FLAGS - --location=LOCATION - The location of the batch jobs. + $ gcloud alpha storage batch-operations jobs list --format=json LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/alpha/workstations/configs/create b/gcloud/alpha/workstations/configs/create index a8f58dbaa..33235dec2 100644 --- a/gcloud/alpha/workstations/configs/create +++ b/gcloud/alpha/workstations/configs/create @@ -24,7 +24,6 @@ SYNOPSIS [--machine-type=MACHINE_TYPE; default="e2-standard-4"] [--max-usable-workstations-count=MAX_USABLE_WORKSTATIONS_COUNT] [--network-tags=[NETWORK_TAGS,...]] - [--pd-disk-size=PD_DISK_SIZE; default=200] [--pd-disk-type=PD_DISK_TYPE; default="pd-standard"] [--pd-reclaim-policy=PD_RECLAIM_POLICY; default="delete"] [--pool-size=POOL_SIZE] [--replica-zones=[REPLICA_ZONES,...]] @@ -39,7 +38,8 @@ SYNOPSIS | --container-predefined-image=CONTAINER_PREDEFINED_IMAGE; default="codeoss"] [--kms-key=KMS_KEY : --kms-key-service-account=KMS_KEY_SERVICE_ACCOUNT] - [GCLOUD_WIDE_FLAG ...] + [--pd-disk-size=PD_DISK_SIZE; default=200 + | --pd-source-snapshot=PD_SOURCE_SNAPSHOT] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Create a workstation configuration. @@ -313,10 +313,6 @@ FLAGS $ gcloud alpha workstations configs create --network-tags=tag_1,tag_2 - --pd-disk-size=PD_DISK_SIZE; default=200 - Size of the persistent directory in GB. PD_DISK_SIZE must be one of: - 10, 50, 100, 200, 500, 1000. - --pd-disk-type=PD_DISK_TYPE; default="pd-standard" Type of the persistent directory. PD_DISK_TYPE must be one of: pd-standard, pd-balanced, pd-ssd. @@ -443,6 +439,15 @@ FLAGS The service account associated with the provided customer-managed encryption key. + At most one of these can be specified: + + --pd-disk-size=PD_DISK_SIZE; default=200 + Size of the persistent directory in GB. PD_DISK_SIZE must be one of: + 10, 50, 100, 200, 500, 1000. + + --pd-source-snapshot=PD_SOURCE_SNAPSHOT + Name of the snapshot to use as the source for the home disk. + 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/workstations/configs/update b/gcloud/alpha/workstations/configs/update index cacfe9258..98b4e9f7b 100644 --- a/gcloud/alpha/workstations/configs/update +++ b/gcloud/alpha/workstations/configs/update @@ -18,7 +18,8 @@ SYNOPSIS [--idle-timeout=IDLE_TIMEOUT] [--labels=[LABELS,...]] [--machine-type=MACHINE_TYPE] [--max-usable-workstations-count=MAX_USABLE_WORKSTATIONS_COUNT] - [--network-tags=[NETWORK_TAGS,...]] [--pool-size=POOL_SIZE] + [--network-tags=[NETWORK_TAGS,...]] + [--pd-source-snapshot=PD_SOURCE_SNAPSHOT] [--pool-size=POOL_SIZE] [--running-timeout=RUNNING_TIMEOUT] [--service-account=SERVICE_ACCOUNT] [--service-account-scopes=[SERVICE_ACCOUNT_SCOPES,...]] [--shielded-integrity-monitoring] [--shielded-secure-boot] @@ -267,6 +268,9 @@ FLAGS $ gcloud alpha workstations configs update --network-tags=tag_1,tag_2 + --pd-source-snapshot=PD_SOURCE_SNAPSHOT + Name of the snapshot to use as the source for the home disk. + --pool-size=POOL_SIZE Number of instances to pool for faster Workstation startup. diff --git a/gcloud/artifacts/files/describe b/gcloud/artifacts/files/describe index b0c139f0b..ee473eb89 100644 --- a/gcloud/artifacts/files/describe +++ b/gcloud/artifacts/files/describe @@ -9,6 +9,8 @@ SYNOPSIS DESCRIPTION Describe an Artifact Registry file. + The file hashes are displayed as hex strings. + This command can fail for the following reasons: ▪ The specified file does not exist. ▪ The active account does not have permission to view file. diff --git a/gcloud/beta/builds/submit b/gcloud/beta/builds/submit index ad23a280d..e58f821bb 100644 --- a/gcloud/beta/builds/submit +++ b/gcloud/beta/builds/submit @@ -222,13 +222,13 @@ FLAGS The YAML or JSON file to use as the build configuration file. --pack=[builder=BUILDER],[env=ENV],[image=IMAGE] - Uses CNCF buildpack (https://buildpacks.io/) to create image. The - "image" key/value must be provided. The image name must be in the - gcr.io or pkg.dev namespace. By default gcr.io/buildpacks/builder - will be used. To specify your own builder image use the optional - "builder" key/value argument. To pass environment variables to the - builder use the optional "env" key/value argument where value is a - list of key values using escaping + Uses CNCF buildpack (https://buildpacks.io/) to create the app image. + The app "image" key/value must be provided. The app image name must + be in the gcr.io or pkg.dev namespace. To specify your own builder + image use the optional "builder" key/value argument. By default + gcr.io/buildpacks/builder is used. To pass environment variables to + the builder use the optional "env" key/value argument where value is + a list of key values using escaping (https://cloud.google.com/sdk/gcloud/reference/topic/escaping) if necessary. diff --git a/gcloud/beta/compute/firewall-policies/rules/create b/gcloud/beta/compute/firewall-policies/rules/create index e04684007..59d1ea69f 100644 --- a/gcloud/beta/compute/firewall-policies/rules/create +++ b/gcloud/beta/compute/firewall-policies/rules/create @@ -18,8 +18,10 @@ SYNOPSIS [--src-network-scope=SRC_NETWORK_SCOPE] [--src-networks=[SRC_NETWORKS,...]] [--src-region-codes=[SOURCE_REGION_CODES,...]] + [--src-secure-tags=[SOURCE_SECURE_TAGS,...]] [--src-threat-intelligence=[SOURCE_THREAT_INTELLIGENCE_LISTS,...]] [--target-resources=[TARGET_RESOURCES,...]] + [--target-secure-tags=[TARGET_SECURE_TAGS,...]] [--target-service-accounts=[TARGET_SERVICE_ACCOUNTS,...]] [--[no-]tls-inspect] [GCLOUD_WIDE_FLAG ...] @@ -141,6 +143,16 @@ OPTIONAL FLAGS DIRECTION is ingress. Cannot be specified when the source network scope is NON_INTERNET, VPC_NETWORK or INTRA_VPC. + --src-secure-tags=[SOURCE_SECURE_TAGS,...] + A list of instance secure tags indicating the set of instances on the + network to which the rule applies if all other fields match. Either + --src-ip-ranges or --src-secure-tags must be specified for ingress + traffic. If both --src-ip-ranges and --src-secure-tags are specified, + an inbound connection is allowed if either the range of the source + matches --src-ip-ranges or the tag of the source matches + --src-secure-tags. Secure Tags can be assigned to instances during + instance creation. + --src-threat-intelligence=[SOURCE_THREAT_INTELLIGENCE_LISTS,...] Source Threat Intelligence lists to match for this rule. Can only be specified if DIRECTION is ingress. Cannot be specified when the source @@ -151,6 +163,10 @@ OPTIONAL FLAGS --target-resources=[TARGET_RESOURCES,...] List of URLs of target resources to which the rule is applied. + --target-secure-tags=[TARGET_SECURE_TAGS,...] + An optional, list of target secure tags with a name of the format + tagValues/ or full namespaced name + --target-service-accounts=[TARGET_SERVICE_ACCOUNTS,...] List of target service accounts for the rule. diff --git a/gcloud/beta/compute/firewall-policies/rules/update b/gcloud/beta/compute/firewall-policies/rules/update index 024affabe..cc3629813 100644 --- a/gcloud/beta/compute/firewall-policies/rules/update +++ b/gcloud/beta/compute/firewall-policies/rules/update @@ -20,8 +20,10 @@ SYNOPSIS [--src-network-scope=SRC_NETWORK_SCOPE] [--src-networks=[SRC_NETWORKS,...]] [--src-region-codes=[SOURCE_REGION_CODES,...]] + [--src-secure-tags=[SOURCE_SECURE_TAGS,...]] [--src-threat-intelligence=[SOURCE_THREAT_INTELLIGENCE_LISTS,...]] [--target-resources=[TARGET_RESOURCES,...]] + [--target-secure-tags=[TARGET_SECURE_TAGS,...]] [--target-service-accounts=[TARGET_SERVICE_ACCOUNTS,...]] [--[no-]tls-inspect] [GCLOUD_WIDE_FLAG ...] @@ -147,6 +149,16 @@ OPTIONAL FLAGS DIRECTION is ingress. Cannot be specified when the source network scope is NON_INTERNET, VPC_NETWORK or INTRA_VPC. + --src-secure-tags=[SOURCE_SECURE_TAGS,...] + A list of instance secure tags indicating the set of instances on the + network to which the rule applies if all other fields match. Either + --src-ip-ranges or --src-secure-tags must be specified for ingress + traffic. If both --src-ip-ranges and --src-secure-tags are specified, + an inbound connection is allowed if either the range of the source + matches --src-ip-ranges or the tag of the source matches + --src-secure-tags. Secure Tags can be assigned to instances during + instance creation. + --src-threat-intelligence=[SOURCE_THREAT_INTELLIGENCE_LISTS,...] Source Threat Intelligence lists to match for this rule. Can only be specified if DIRECTION is ingress. Cannot be specified when the source @@ -157,6 +169,10 @@ OPTIONAL FLAGS --target-resources=[TARGET_RESOURCES,...] List of URLs of target resources to which the rule is applied. + --target-secure-tags=[TARGET_SECURE_TAGS,...] + An optional, list of target secure tags with a name of the format + tagValues/ or full namespaced name + --target-service-accounts=[TARGET_SERVICE_ACCOUNTS,...] List of target service accounts for the rule. diff --git a/gcloud/beta/container/clusters/create b/gcloud/beta/container/clusters/create index b0dc0a105..ec0c44350 100644 --- a/gcloud/beta/container/clusters/create +++ b/gcloud/beta/container/clusters/create @@ -1294,6 +1294,7 @@ FLAGS hugepageConfig: hugepage_size2m: '1024' hugepage_size1g: '2' + cgroupMode: 'CGROUP_MODE_V2' List of supported kubelet configs in 'kubeletConfig'. @@ -1308,26 +1309,60 @@ FLAGS List of supported sysctls in 'linuxConfig'. - KEY VALUE - net.core.netdev_max_backlog Any positive integer, less - than 2147483647 - net.core.rmem_max Any positive integer, less - than 2147483647 - net.core.wmem_default Any positive integer, less - than 2147483647 - net.core.wmem_max Any positive integer, less - than 2147483647 - net.core.optmem_max Any positive integer, less - than 2147483647 - net.core.somaxconn Must be [128, 2147483647] - net.ipv4.tcp_rmem Any positive integer tuple - net.ipv4.tcp_wmem Any positive integer tuple - net.ipv4.tcp_tw_reuse Must be {0, 1} - kernel.shmmni Must be [4096, 32768] - kernel.shmmax Must be [0, - 18446744073692774399] - kernel.shmall Must be [0, - 18446744073692774399] + KEY VALUE + net.core.netdev_max_backlog Any positive + integer, less than + 2147483647 + net.core.rmem_default Any positive + integer, less than + 2147483647 + net.core.rmem_max Any positive + integer, less than + 2147483647 + net.core.wmem_default Any positive + integer, less than + 2147483647 + net.core.wmem_max Any positive + integer, less than + 2147483647 + net.core.optmem_max Any positive + integer, less than + 2147483647 + net.core.somaxconn Must be between + [128, 2147483647] + net.ipv4.tcp_rmem Any positive + integer tuple + net.ipv4.tcp_wmem Any positive + integer tuple + net.ipv4.tcp_tw_reuse Must be {0, 1} + net.netfilter.nf_conntrack_max Must be between + [65536, 4194304] + net.netfilter.nf_conntrack_buckets Must be between + [65536, 524288]. + Recommend setting: + nf_conntrack_max = + nf_conntrack_bucke + ts * 4 + net.netfilter.nf_conntrack_tcp_timeout_close_wait Must be between + [60, 3600] + net.netfilter.nf_conntrack_tcp_timeout_time_wait Must be between + [1, 600] + net.netfilter.nf_conntrack_tcp_timeout_established Must be between + [600, 86400] + net.netfilter.nf_conntrack_acct Must be {0, 1} + kernel.shmmni Must be between + [4096, 32768] + kernel.shmmax Must be between + [0, + 184467440736927743 + 99] + kernel.shmall Must be between + [0, + 184467440736927743 + 99] + vm.max_map_count Must be between + [65536, + 2147483647] List of supported hugepage size in 'hugepageConfig'. @@ -1342,6 +1377,12 @@ FLAGS 1G hugepages are only available in following machine familes: c3, m2, c2d, c3d, h3, m3, a2, a3, g2. + Supported values for 'cgroupMode' under 'linuxConfig'. + + ◆ CGROUP_MODE_V1: Use cgroupv1 on the node pool. + ◆ CGROUP_MODE_V2: Use cgroupv2 on the node pool. + ◆ CGROUP_MODE_UNSPECIFIED: Use the default GKE cgroup configuration. + Note, updating the system configuration of an existing node pool requires recreation of the nodes which which might cause a disruption. diff --git a/gcloud/beta/container/node-pools/create b/gcloud/beta/container/node-pools/create index 9e3e4351c..174572b2e 100644 --- a/gcloud/beta/container/node-pools/create +++ b/gcloud/beta/container/node-pools/create @@ -685,6 +685,7 @@ FLAGS hugepageConfig: hugepage_size2m: '1024' hugepage_size1g: '2' + cgroupMode: 'CGROUP_MODE_V2' List of supported kubelet configs in 'kubeletConfig'. @@ -699,26 +700,60 @@ FLAGS List of supported sysctls in 'linuxConfig'. - KEY VALUE - net.core.netdev_max_backlog Any positive integer, less - than 2147483647 - net.core.rmem_max Any positive integer, less - than 2147483647 - net.core.wmem_default Any positive integer, less - than 2147483647 - net.core.wmem_max Any positive integer, less - than 2147483647 - net.core.optmem_max Any positive integer, less - than 2147483647 - net.core.somaxconn Must be [128, 2147483647] - net.ipv4.tcp_rmem Any positive integer tuple - net.ipv4.tcp_wmem Any positive integer tuple - net.ipv4.tcp_tw_reuse Must be {0, 1} - kernel.shmmni Must be [4096, 32768] - kernel.shmmax Must be [0, - 18446744073692774399] - kernel.shmall Must be [0, - 18446744073692774399] + KEY VALUE + net.core.netdev_max_backlog Any positive + integer, less than + 2147483647 + net.core.rmem_default Any positive + integer, less than + 2147483647 + net.core.rmem_max Any positive + integer, less than + 2147483647 + net.core.wmem_default Any positive + integer, less than + 2147483647 + net.core.wmem_max Any positive + integer, less than + 2147483647 + net.core.optmem_max Any positive + integer, less than + 2147483647 + net.core.somaxconn Must be between + [128, 2147483647] + net.ipv4.tcp_rmem Any positive + integer tuple + net.ipv4.tcp_wmem Any positive + integer tuple + net.ipv4.tcp_tw_reuse Must be {0, 1} + net.netfilter.nf_conntrack_max Must be between + [65536, 4194304] + net.netfilter.nf_conntrack_buckets Must be between + [65536, 524288]. + Recommend setting: + nf_conntrack_max = + nf_conntrack_bucke + ts * 4 + net.netfilter.nf_conntrack_tcp_timeout_close_wait Must be between + [60, 3600] + net.netfilter.nf_conntrack_tcp_timeout_time_wait Must be between + [1, 600] + net.netfilter.nf_conntrack_tcp_timeout_established Must be between + [600, 86400] + net.netfilter.nf_conntrack_acct Must be {0, 1} + kernel.shmmni Must be between + [4096, 32768] + kernel.shmmax Must be between + [0, + 184467440736927743 + 99] + kernel.shmall Must be between + [0, + 184467440736927743 + 99] + vm.max_map_count Must be between + [65536, + 2147483647] List of supported hugepage size in 'hugepageConfig'. @@ -733,6 +768,12 @@ FLAGS 1G hugepages are only available in following machine familes: c3, m2, c2d, c3d, h3, m3, a2, a3, g2. + Supported values for 'cgroupMode' under 'linuxConfig'. + + ◆ CGROUP_MODE_V1: Use cgroupv1 on the node pool. + ◆ CGROUP_MODE_V2: Use cgroupv2 on the node pool. + ◆ CGROUP_MODE_UNSPECIFIED: Use the default GKE cgroup configuration. + Note, updating the system configuration of an existing node pool requires recreation of the nodes which which might cause a disruption. diff --git a/gcloud/beta/container/node-pools/update b/gcloud/beta/container/node-pools/update index 2e13feea0..7b110ae40 100644 --- a/gcloud/beta/container/node-pools/update +++ b/gcloud/beta/container/node-pools/update @@ -274,6 +274,7 @@ REQUIRED FLAGS hugepageConfig: hugepage_size2m: '1024' hugepage_size1g: '2' + cgroupMode: 'CGROUP_MODE_V2' List of supported kubelet configs in 'kubeletConfig'. @@ -288,29 +289,63 @@ REQUIRED FLAGS List of supported sysctls in 'linuxConfig'. - KEY VALUE - net.core.netdev_max_backlog Any positive integer, - less than 2147483647 - net.core.rmem_max Any positive integer, - less than 2147483647 - net.core.wmem_default Any positive integer, - less than 2147483647 - net.core.wmem_max Any positive integer, - less than 2147483647 - net.core.optmem_max Any positive integer, - less than 2147483647 - net.core.somaxconn Must be [128, - 2147483647] - net.ipv4.tcp_rmem Any positive integer - tuple - net.ipv4.tcp_wmem Any positive integer - tuple - net.ipv4.tcp_tw_reuse Must be {0, 1} - kernel.shmmni Must be [4096, 32768] - kernel.shmmax Must be [0, - 18446744073692774399] - kernel.shmall Must be [0, - 18446744073692774399] + KEY VALUE + net.core.netdev_max_backlog Any positive + integer, less + than 2147483647 + net.core.rmem_default Any positive + integer, less + than 2147483647 + net.core.rmem_max Any positive + integer, less + than 2147483647 + net.core.wmem_default Any positive + integer, less + than 2147483647 + net.core.wmem_max Any positive + integer, less + than 2147483647 + net.core.optmem_max Any positive + integer, less + than 2147483647 + net.core.somaxconn Must be between + [128, + 2147483647] + net.ipv4.tcp_rmem Any positive + integer tuple + net.ipv4.tcp_wmem Any positive + integer tuple + net.ipv4.tcp_tw_reuse Must be {0, 1} + net.netfilter.nf_conntrack_max Must be between + [65536, 4194304] + net.netfilter.nf_conntrack_buckets Must be between + [65536, 524288]. + Recommend + setting: + nf_conntrack_max + = + nf_conntrack_buc + kets * 4 + net.netfilter.nf_conntrack_tcp_timeout_close_wait Must be between + [60, 3600] + net.netfilter.nf_conntrack_tcp_timeout_time_wait Must be between + [1, 600] + net.netfilter.nf_conntrack_tcp_timeout_established Must be between + [600, 86400] + net.netfilter.nf_conntrack_acct Must be {0, 1} + kernel.shmmni Must be between + [4096, 32768] + kernel.shmmax Must be between + [0, + 1844674407369277 + 4399] + kernel.shmall Must be between + [0, + 1844674407369277 + 4399] + vm.max_map_count Must be between + [65536, + 2147483647] List of supported hugepage size in 'hugepageConfig'. @@ -325,6 +360,13 @@ REQUIRED FLAGS 1G hugepages are only available in following machine familes: c3, m2, c2d, c3d, h3, m3, a2, a3, g2. + Supported values for 'cgroupMode' under 'linuxConfig'. + + ▸ CGROUP_MODE_V1: Use cgroupv1 on the node pool. + ▸ CGROUP_MODE_V2: Use cgroupv2 on the node pool. + ▸ CGROUP_MODE_UNSPECIFIED: Use the default GKE cgroup + configuration. + Note, updating the system configuration of an existing node pool requires recreation of the nodes which which might cause a disruption. diff --git a/gcloud/beta/filestore/instances/create b/gcloud/beta/filestore/instances/create index 15baae476..3037e93dd 100644 --- a/gcloud/beta/filestore/instances/create +++ b/gcloud/beta/filestore/instances/create @@ -210,7 +210,8 @@ REQUIRED FLAGS network. connect-mode Network connection mode used by instances. CONNECT_MODE must be one - of: DIRECT_PEERING or PRIVATE_SERVICE_ACCESS. + of: DIRECT_PEERING, PRIVATE_SERVICE_ACCESS or + PRIVATE_SERVICE_CONNECT. OPTIONAL FLAGS --async diff --git a/gcloud/beta/logging/buckets/update b/gcloud/beta/logging/buckets/update index 447be5059..6bd316d53 100644 --- a/gcloud/beta/logging/buckets/update +++ b/gcloud/beta/logging/buckets/update @@ -8,6 +8,8 @@ SYNOPSIS [--enable-analytics] [--locked] [--remove-indexes=[FIELD PATH,...]] [--restricted-fields=[RESTRICTED_FIELD,...]] [--retention-days=RETENTION_DAYS] [--update-index=[KEY=VALUE, ...,...]] + [--billing-account=BILLING_ACCOUNT_ID | --folder=FOLDER_ID + | --organization=ORGANIZATION_ID | --project=PROJECT_ID] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -122,6 +124,31 @@ OPTIONAL FLAGS The type of data in this index. For example: INDEX_TYPE_STRING Supported types are strings and integers. + At most one of these can be specified: + + --billing-account=BILLING_ACCOUNT_ID + Billing account of the bucket to update. + + --folder=FOLDER_ID + Folder of the bucket to update. + + --organization=ORGANIZATION_ID + Organization of the bucket to update. + + --project=PROJECT_ID + Project of the bucket to update. + + The Google Cloud project ID to use for this invocation. If omitted, + then the current project is assumed; the current project can be + listed using gcloud config list --format='text(core.project)' and can + be set using gcloud config set project PROJECTID. + + --project and its fallback core/project property play two roles in + the invocation. It specifies the project of the resource to operate + on. It also specifies the project for API enablement check, quota, + and billing. To specify a different project for quota and billing, + use --billing-project or billing/quota_project property. + 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/netapp/volumes/replications/create b/gcloud/beta/netapp/volumes/replications/create index a92862ef5..5a5fbb950 100644 --- a/gcloud/beta/netapp/volumes/replications/create +++ b/gcloud/beta/netapp/volumes/replications/create @@ -6,8 +6,8 @@ SYNOPSIS gcloud beta netapp volumes replications create (REPLICATION : --location=LOCATION) --destination-volume-parameters=[description=DESCRIPTION], - [share_name=SHARE_NAME], - [storage_pool=STORAGE_POOL],[volume_id=VOLUME_ID] + [share_name=SHARE_NAME],[storage_pool=STORAGE_POOL], + [tiering_policy=TIERING_POLICY],[volume_id=VOLUME_ID] --replication-schedule=REPLICATION_SCHEDULE [--async] [--cluster-location=CLUSTER_LOCATION] [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] [--volume=VOLUME] [GCLOUD_WIDE_FLAG ...] @@ -64,7 +64,42 @@ POSITIONAL ARGUMENTS ▸ set the property netapp/location. REQUIRED FLAGS - --destination-volume-parameters=[description=DESCRIPTION],[share_name=SHARE_NAME],[storage_pool=STORAGE_POOL],[volume_id=VOLUME_ID] + --destination-volume-parameters=[description=DESCRIPTION],[share_name=SHARE_NAME],[storage_pool=STORAGE_POOL],[tiering_policy=TIERING_POLICY],[volume_id=VOLUME_ID] + Required, Sets destination_volume_parameters value. + + description + Sets description value. + + share_name + Sets share_name value. + + storage_pool + Required, Sets storage_pool value. + + tiering_policy + Sets tiering_policy value. + + cooling-threshold-days + Sets cooling-threshold-days value. + + tier-action + Sets tier-action value. + + volume_id + Sets volume_id value. + + Shorthand Example: + + --destination-volume-parameters='description=string,share_name=string,storage_pool=string,tiering_policy={"cooling-threshold-days": int, "tier-action": "string"},volume_id=string' + + JSON Example: + + --destination-volume-parameters='{"description": "string", "share_name": "string", "storage_pool": "string", "tiering_policy": {"cooling-threshold-days": int, "tier-action": "string"}, "volume_id": "string"}' + + File Example: + + --destination-volume-parameters=path_to_file.(yaml|json) + --replication-schedule=REPLICATION_SCHEDULE The schedule for the Replication. diff --git a/gcloud/beta/network-connectivity/regional-endpoints/create b/gcloud/beta/network-connectivity/regional-endpoints/create index 098d5e92b..b0069dbc1 100644 --- a/gcloud/beta/network-connectivity/regional-endpoints/create +++ b/gcloud/beta/network-connectivity/regional-endpoints/create @@ -19,7 +19,8 @@ EXAMPLES $ gcloud beta network-connectivity regional-endpoints create \ my-regional-endpoint --region=us-central1 \ - [--network=my-network] [--subnetwork=my-subnet] \ + [--address=my-address] [--network=my-network] \ + [--subnetwork=my-subnet] \ --target-google-api=my-target-endpoint [--enable-global-access] POSITIONAL ARGUMENTS diff --git a/gcloud/beta/network-management/connectivity-tests/create b/gcloud/beta/network-management/connectivity-tests/create index b2123e6c4..ea7fb73c9 100644 --- a/gcloud/beta/network-management/connectivity-tests/create +++ b/gcloud/beta/network-management/connectivity-tests/create @@ -18,7 +18,8 @@ SYNOPSIS --source-gke-master-cluster=SOURCE_GKE_MASTER_CLUSTER --source-instance=SOURCE_INSTANCE --source-ip-address=SOURCE_IP_ADDRESS) [--async] - [--description=DESCRIPTION] [--destination-fqdn=DESTINATION_FQDN] + [--bypass-firewall-checks] [--description=DESCRIPTION] + [--destination-fqdn=DESTINATION_FQDN] [--destination-network=DESTINATION_NETWORK] [--destination-port=DESTINATION_PORT] [--destination-project=DESTINATION_PROJECT] [--labels=[KEY=VALUE,...]] @@ -116,6 +117,9 @@ OPTIONAL FLAGS Return immediately, without waiting for the operation in progress to complete. + --bypass-firewall-checks + This boolean controls whether to skip firewall checking. + --description=DESCRIPTION The description of the connectivity test. diff --git a/gcloud/beta/network-management/connectivity-tests/update b/gcloud/beta/network-management/connectivity-tests/update index e8fd0ea7a..30dee6d4e 100644 --- a/gcloud/beta/network-management/connectivity-tests/update +++ b/gcloud/beta/network-management/connectivity-tests/update @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud beta network-management connectivity-tests update CONNECTIVITY_TEST - [--async] [--description=DESCRIPTION] + [--async] [--bypass-firewall-checks] [--description=DESCRIPTION] [--destination-fqdn=DESTINATION_FQDN] [--destination-network=DESTINATION_NETWORK] [--destination-port=DESTINATION_PORT] @@ -77,6 +77,10 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + --bypass-firewall-checks + This boolean controls whether to skip firewall checking. Use + --no-bypass-firewall-checks to disable. + --description=DESCRIPTION The description of the connectivity test. diff --git a/gcloud/beta/quotas/adjuster/help b/gcloud/beta/quotas/adjuster/help new file mode 100644 index 000000000..e322c2933 --- /dev/null +++ b/gcloud/beta/quotas/adjuster/help @@ -0,0 +1,23 @@ +NAME + gcloud beta quotas adjuster - the command group for Cloud Quotas Adjuster + +SYNOPSIS + gcloud beta quotas adjuster GROUP [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) The command group for Cloud Quotas Adjuster. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + settings + (BETA) The command group for Cloud Quotas AdjusterSettings. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/quotas/adjuster/settings/describe b/gcloud/beta/quotas/adjuster/settings/describe new file mode 100644 index 000000000..1f0b81d2c --- /dev/null +++ b/gcloud/beta/quotas/adjuster/settings/describe @@ -0,0 +1,31 @@ +NAME + gcloud beta quotas adjuster settings describe - gets details of the + QuotaAdjusterSettings for a project + +SYNOPSIS + gcloud beta quotas adjuster settings describe + --project=PROJECT_ID_OR_NUMBER [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) This command gets the QuotaAdjusterSettings for a project. + +EXAMPLES + To get the QuotaAdjusterSettings for container 'projects/12321', run: + + $ gcloud beta quotas adjuster settings describe --project=12321 + +REQUIRED FLAGS + --project=PROJECT_ID_OR_NUMBER + Project of the container 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. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/quotas/adjuster/settings/help b/gcloud/beta/quotas/adjuster/settings/help new file mode 100644 index 000000000..6aff46f4c --- /dev/null +++ b/gcloud/beta/quotas/adjuster/settings/help @@ -0,0 +1,28 @@ +NAME + gcloud beta quotas adjuster settings - the command group for Cloud Quotas + AdjusterSettings + +SYNOPSIS + gcloud beta quotas adjuster settings COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) A QuotaAdjusterSettings resource represents your adjuster setting + for a particular project. Enable this to automatically adjust quotas. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + (BETA) Gets details of the QuotaAdjusterSettings for a project. + + update + (BETA) Update the QuotaAdjusterSettings of a project. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/quotas/adjuster/settings/update b/gcloud/beta/quotas/adjuster/settings/update new file mode 100644 index 000000000..13124a9be --- /dev/null +++ b/gcloud/beta/quotas/adjuster/settings/update @@ -0,0 +1,42 @@ +NAME + gcloud beta quotas adjuster settings update - update the + QuotaAdjusterSettings of a project + +SYNOPSIS + gcloud beta quotas adjuster settings update --enablement=ENABLEMENT + --project=PROJECT_ID_OR_NUMBER [--validate-only] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) This command updates the enablement state of a project. + +EXAMPLES + To update QuotaAdjusterSettings for projects/12321, run: + + $ gcloud beta quotas adjuster settings update --enablement=enabled \ + --project=12321 + +REQUIRED FLAGS + --enablement=ENABLEMENT + Enablement state of the QuotaAdjusterSettings. ENABLEMENT must be one + of: enabled, disabled. + + --project=PROJECT_ID_OR_NUMBER + Project of the container id. + +OPTIONAL FLAGS + --validate-only + If specified, only validates the request, but does not actually update. + Note that a request being valid does not mean that the request is + guaranteed to be fulfilled. Default is false. + +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. + diff --git a/gcloud/beta/quotas/help b/gcloud/beta/quotas/help new file mode 100644 index 000000000..3a09a4482 --- /dev/null +++ b/gcloud/beta/quotas/help @@ -0,0 +1,34 @@ +NAME + gcloud beta quotas - manage Cloud Quotas quota info, quota preferences and + quota adjuster settings + +SYNOPSIS + gcloud beta quotas GROUP [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Manage Cloud Quotas quota info, quota preferences and quota adjuster + settings. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + adjuster + (BETA) The command group for Cloud Quotas Adjuster. + + info + (BETA) Manage Cloud Quotas QuotaInfo. + + preferences + (BETA) Manage Cloud Quotas QuotaPreferences. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha quotas + diff --git a/gcloud/beta/quotas/info/describe b/gcloud/beta/quotas/info/describe new file mode 100644 index 000000000..635a34921 --- /dev/null +++ b/gcloud/beta/quotas/info/describe @@ -0,0 +1,55 @@ +NAME + gcloud beta quotas info describe - retrieve the QuotaInfo of a quota for a + project, folder or organization + +SYNOPSIS + gcloud beta quotas info describe QUOTA_ID --service=SERVICE + (--folder=FOLDER_ID | --organization=ORGANIZATION_ID + | --project=PROJECT_ID_OR_NUMBER) [GCLOUD_WIDE_FLAG ...] + +EXAMPLES + To get the details about quota CpusPerProject for service + example.$$UNIVERSE_DOMAIN$$ and projects/my-project, run: + + $ gcloud beta quotas info describe CpusPerProject \ + --service=example.$$UNIVERSE_DOMAIN$$ --project=my-project + + To get the details about quota CpusPerProject for service + example.$$UNIVERSE_DOMAIN$$ and folders/123, run: + + $ gcloud beta quotas info describe CpusPerProject \ + --service=example.$$UNIVERSE_DOMAIN$$ --folder=123 + +POSITIONAL ARGUMENTS + QUOTA_ID + ID of the quota, which is unique within the service. + +REQUIRED FLAGS + --service=SERVICE + Name of the service in which the quota is defined. + + Exactly one of these must be specified: + + --folder=FOLDER_ID + Folder of the quota info to describe. + + --organization=ORGANIZATION_ID + Organization of the quota info to describe. + + --project=PROJECT_ID_OR_NUMBER + Project of the quota info to describe. + +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 quotas info describe + diff --git a/gcloud/beta/quotas/info/help b/gcloud/beta/quotas/info/help new file mode 100644 index 000000000..fe87214dd --- /dev/null +++ b/gcloud/beta/quotas/info/help @@ -0,0 +1,46 @@ +NAME + gcloud beta quotas info - manage Cloud Quotas QuotaInfo + +SYNOPSIS + gcloud beta quotas info COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) QuotaInfo is a read-only resource that provides metadata and quota + value information about a particular quota for a given project, folder or + organization. The QuotaInfo resource contains: + + ▪ Metadata such as name and dimension. + ▪ Quota values for different quota dimensions. + + Cloud Quotas obtains information from the quotas defined by Google Cloud + services and any fulfilled quota adjustments that you initiate. + + Note: Because QuotaInfo is constructed by incorporating information from + different sources, a default quota configuration exists even if you have + not created a QuotaPreference resource. Until you express a preferred state + through quotaPreference.create or quotaPreference.update, QuotaInfo relies + on the default quota information available to determine what quota value to + enforce. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + (BETA) Retrieve the QuotaInfo of a quota for a project, folder or + organization. + + list + (BETA) List QuotaInfos of all quotas for a given project, folder or + organization. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha quotas info + diff --git a/gcloud/beta/quotas/info/list b/gcloud/beta/quotas/info/list new file mode 100644 index 000000000..70885ae4f --- /dev/null +++ b/gcloud/beta/quotas/info/list @@ -0,0 +1,89 @@ +NAME + gcloud beta quotas info list - list QuotaInfos of all quotas for a given + project, folder or organization + +SYNOPSIS + gcloud beta quotas info list --service=SERVICE + (--folder=FOLDER_ID | --organization=ORGANIZATION_ID + | --project=PROJECT_ID_OR_NUMBER) [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +EXAMPLES + To list all quota info for service example.$$UNIVERSE_DOMAIN$$ and + projects/12321, run: + + $ gcloud beta quotas info list \ + --service=example.$$UNIVERSE_DOMAIN$$ --project=12321 + $ gcloud beta quotas info list \ + --service=example.$$UNIVERSE_DOMAIN$$m --project=my-project-id + + To list first 100 quota info ordered alphabetically for service + `example.$$UNIVERSE_DOMAIN$$` and `folders/123`, + run: + + $ gcloud beta quotas info list \ + --service=example.$$UNIVERSE_DOMAIN$$ --folder=123 \ + --page-size=100 + +REQUIRED FLAGS + --service=SERVICE + Name of the service in which the quota is defined. + + Exactly one of these must be specified: + + --folder=FOLDER_ID + Folder of the quota info to list. + + --organization=ORGANIZATION_ID + Organization of the quota info to list. + + --project=PROJECT_ID_OR_NUMBER + Project of the quota info to list. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha quotas info list + diff --git a/gcloud/beta/quotas/preferences/create b/gcloud/beta/quotas/preferences/create new file mode 100644 index 000000000..b39d6f9c2 --- /dev/null +++ b/gcloud/beta/quotas/preferences/create @@ -0,0 +1,97 @@ +NAME + gcloud beta quotas preferences create - create a new QuotaPreference that + declares the desired value for a quota + +SYNOPSIS + gcloud beta quotas preferences create --preferred-value=PREFERRED_VALUE + --quota-id=QUOTA_ID --service=SERVICE + (--folder=FOLDER_ID | --organization=ORGANIZATION_ID + | --project=PROJECT_ID_OR_NUMBER) + [--allow-high-percentage-quota-decrease] + [--allow-quota-decrease-below-usage] [--dimensions=[KEY=VALUE,...]] + [--email=EMAIL] [--justification=JUSTIFICATION] + [--preference-id=PREFERENCE_ID] [GCLOUD_WIDE_FLAG ...] + +EXAMPLES + To create a quota preference in region us-central1 that applies to the + default_limit quota under service example.$$UNIVERSE_DOMAIN$$ for + projects/12321, run: + + $ gcloud beta quotas preferences create \ + --service=example.$$UNIVERSE_DOMAIN$$ --project=12321 \ + --quota-id=default_limit --preferred-value=100 \ + --dimensions=region=us-central1 \ + --preference-id=example_default-limit_us-central1 + + To create a quota preference under service example.$$UNIVERSE_DOMAIN$$`` + for organizations/789 with random preference ID, run: + + $ gcloud beta quotas preferences create \ + --service=example.$$UNIVERSE_DOMAIN$$ --organization=789 \ + --quota-id=default_limit --preferred-value=200 + +REQUIRED FLAGS + --preferred-value=PREFERRED_VALUE + Preferred value. Must be greater than or equal to -1. If set to -1, it + means the value is "unlimited". + + --quota-id=QUOTA_ID + ID of the quota, which is unique within the service. + + --service=SERVICE + Name of the service in which the quota is defined. + + Exactly one of these must be specified: + + --folder=FOLDER_ID + Folder of the quota preference to create. + + --organization=ORGANIZATION_ID + Organization of the quota preference to create. + + --project=PROJECT_ID_OR_NUMBER + Project of the quota preference to create. + +OPTIONAL FLAGS + --allow-high-percentage-quota-decrease + If specified, allows you to reduce your effective limit by more than 10 + percent. Default is false. + + --allow-quota-decrease-below-usage + If specified, allows you to reduce your effective limit below your + quota usage. Default is false. + + --dimensions=[KEY=VALUE,...] + Dimensions of the quota. + + --email=EMAIL + An optional email address that can be used for quota related + communication between the Google Cloud and the user in case the Google + Cloud needs further information to make a decision on whether the user + preferred quota can be granted. The Google account for the email + address must have quota update permission for the project, folder or + organization this quota preference is for. If no contact email address + is provided, or the provided email address does not have the required + quota update permission, the quota preference request will be denied in + case further information is required to make a decision. + + --justification=JUSTIFICATION + A short statement to justify quota increase requests. + + --preference-id=PREFERENCE_ID + ID of the Quota Preference object, must be unique under its parent. + +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 quotas preferences create + diff --git a/gcloud/beta/quotas/preferences/describe b/gcloud/beta/quotas/preferences/describe new file mode 100644 index 000000000..e5a246fb5 --- /dev/null +++ b/gcloud/beta/quotas/preferences/describe @@ -0,0 +1,53 @@ +NAME + gcloud beta quotas preferences describe - get details about a single + QuotaPreference + +SYNOPSIS + gcloud beta quotas preferences describe PREFERENCE_ID + (--folder=FOLDER_ID | --organization=ORGANIZATION_ID + | --project=PROJECT_ID_OR_NUMBER) [GCLOUD_WIDE_FLAG ...] + +EXAMPLES + To get the details about quota preference my-preference for projects/12321, + run: + + $ gcloud beta quotas preferences describe my-preference \ + --project=12321 + $ gcloud beta quotas preferences describe my-preference \ + --project=my-project-id + + To get the details about quota preference my-preference for folders/123, + run: + + $ gcloud beta quotas preferences describe my-preference --folder=123 + +POSITIONAL ARGUMENTS + PREFERENCE_ID + ID of the Quota Preference object, must be unique under its parent. + +REQUIRED FLAGS + Exactly one of these must be specified: + + --folder=FOLDER_ID + Folder of the quota preference to describe. + + --organization=ORGANIZATION_ID + Organization of the quota preference to describe. + + --project=PROJECT_ID_OR_NUMBER + Project of the quota preference to describe. + +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 quotas preferences describe + diff --git a/gcloud/beta/quotas/preferences/help b/gcloud/beta/quotas/preferences/help new file mode 100644 index 000000000..fa9cd04d3 --- /dev/null +++ b/gcloud/beta/quotas/preferences/help @@ -0,0 +1,43 @@ +NAME + gcloud beta quotas preferences - manage Cloud Quotas QuotaPreferences + +SYNOPSIS + gcloud beta quotas preferences COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) A QuotaPreference resource represents your preference for a + particular dimension combination. Use this resource to make quota increase + adjustments to quotas in your projects and to make quota decrease + adjustments to quotas in your projects, folders or organizations. Quota + increase adjustments are subject to approval and fulfillment. Quota + decreases are fulfilled immediately. Use the Cloud Quotas console UI or API + to set a quota preference. + +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 QuotaPreference that declares the desired value for + a quota. + + describe + (BETA) Get details about a single QuotaPreference. + + list + (BETA) List QuotaPreferences in a given project, folder or + organization. + + update + (BETA) Update the parameters of a single QuotaPreference. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha quotas preferences + diff --git a/gcloud/beta/quotas/preferences/list b/gcloud/beta/quotas/preferences/list new file mode 100644 index 000000000..76a3f84a7 --- /dev/null +++ b/gcloud/beta/quotas/preferences/list @@ -0,0 +1,92 @@ +NAME + gcloud beta quotas preferences list - list QuotaPreferences in a given + project, folder or organization + +SYNOPSIS + gcloud beta quotas preferences list + (--folder=FOLDER_ID | --organization=ORGANIZATION_ID + | --project=PROJECT_ID_OR_NUMBER) [--reconciling-only] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +EXAMPLES + To list the quota preferences for projects/12321, run: + + $ gcloud beta quotas preferences list --project=12321 + $ gcloud beta quotas preferences list --project=my-project-id + + To list first 10 quota preferences ordered by create time for folder/123, + run: + + $ gcloud beta quotas preferences list --folder=123 --page-size=10 \ + --sort-by=create_time + + To list all quota preferences in unresolved state in region us-central1 for + organization/789, run: + + $ gcloud beta quotas preferences list --organization=789 \ + --filter=dimensions.region:us-central1 --reconciling-only + +REQUIRED FLAGS + Exactly one of these must be specified: + + --folder=FOLDER_ID + Folder of the quota preferences to list. + + --organization=ORGANIZATION_ID + Organization of the quota preferences to list. + + --project=PROJECT_ID_OR_NUMBER + Project of the quota preferences to list. + +FLAGS + --reconciling-only + If specified, only displays quota preferences in unresolved states. + Default is false. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --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 quotas preferences list + diff --git a/gcloud/beta/quotas/preferences/update b/gcloud/beta/quotas/preferences/update new file mode 100644 index 000000000..b84794ada --- /dev/null +++ b/gcloud/beta/quotas/preferences/update @@ -0,0 +1,109 @@ +NAME + gcloud beta quotas preferences update - update the parameters of a single + QuotaPreference + +SYNOPSIS + gcloud beta quotas preferences update PREFERENCE_ID + --preferred-value=PREFERRED_VALUE --quota-id=QUOTA_ID --service=SERVICE + (--folder=FOLDER_ID | --organization=ORGANIZATION_ID + | --project=PROJECT_ID_OR_NUMBER) + [--allow-high-percentage-quota-decrease] [--allow-missing] + [--allow-quota-decrease-below-usage] [--dimensions=[KEY=VALUE,...]] + [--email=EMAIL] [--justification=JUSTIFICATION] [--validate-only] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) This command updates an existing or creates a new QuotaPreference. + It can updates the config in any states, not just the ones pending + approval. + +EXAMPLES + To update a quota preference with id my-preference in region us-central1 + that applies to the default_limit quota for projects/12321, run: + + $ gcloud beta quotas preferences update my-preference \ + --service=example.$$UNIVERSE_DOMAIN$$ --project=12321 \ + --quota-id=default_limit --preferred-value=100 \ + --dimensions=region=us-central1 + + To create a new quota preference for organizations/789, run: + + $ gcloud beta quotas preferences update my-preference \ + --service=example.$$UNIVERSE_DOMAIN$$ --organization=789 \ + --quota-id=default_limit --preferred-value=200 --allow-missing + +POSITIONAL ARGUMENTS + PREFERENCE_ID + ID of the Quota Preference object, must be unique under its parent. + +REQUIRED FLAGS + --preferred-value=PREFERRED_VALUE + Preferred value. Must be greater than or equal to -1. If set to -1, it + means the value is "unlimited". + + --quota-id=QUOTA_ID + ID of the quota, which is unique within the service. + + --service=SERVICE + Name of the service in which the quota is defined. + + Exactly one of these must be specified: + + --folder=FOLDER_ID + Folder of the quota preference to update. + + --organization=ORGANIZATION_ID + Organization of the quota preference to update. + + --project=PROJECT_ID_OR_NUMBER + Project of the quota preference to update. + +OPTIONAL FLAGS + --allow-high-percentage-quota-decrease + If specified, allows you to reduce your effective limit by more than 10 + percent. Default is false. + + --allow-missing + If specified and the quota preference is not found, a new one will be + created. Default is false. + + --allow-quota-decrease-below-usage + If specified, allows you to reduce your effective limit below your + quota usage. Default is false. + + --dimensions=[KEY=VALUE,...] + Dimensions of the quota. + + --email=EMAIL + An optional email address that can be used for quota related + communication between the Google Cloud and the user in case the Google + Cloud needs further information to make a decision on whether the user + preferred quota can be granted. The Google account for the email + address must have quota update permission for the project, folder or + organization this quota preference is for. If no contact email address + is provided, or the provided email address does not have the required + quota update permission, the quota preference request will be denied in + case further information is required to make a decision. + + --justification=JUSTIFICATION + A short statement to justify quota increase requests. + + --validate-only + If specified, only validates the request, but does not actually update. + Note that a request being valid does not mean that the request is + guaranteed to be fulfilled. Default is false. + +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 quotas preferences update + diff --git a/gcloud/beta/redis/clusters/create b/gcloud/beta/redis/clusters/create index 338b04429..96f62ff1e 100644 --- a/gcloud/beta/redis/clusters/create +++ b/gcloud/beta/redis/clusters/create @@ -9,7 +9,7 @@ SYNOPSIS [--automated-backup-start-time=AUTOMATED_BACKUP_START_TIME] [--automated-backup-ttl=AUTOMATED_BACKUP_TTL] [--cross-cluster-replication-role=CROSS_CLUSTER_REPLICATION_ROLE] - [--deletion-protection] + [--deletion-protection] [--kms-key=KMS_KEY] [--maintenance-window-day=MAINTENANCE_WINDOW_DAY] [--maintenance-window-hour=MAINTENANCE_WINDOW_HOUR] [--network=NETWORK] [--node-type=NODE_TYPE] [--persistence-mode=PERSISTENCE_MODE] @@ -144,6 +144,13 @@ FLAGS Enable deletion protection for the Redis Cluster. Use --deletion-protection/--no-deletion-protection to enable/disable it. + --kms-key=KMS_KEY + The resource name of the customer-managed encryption key (CMEK) to use + for the cluster. It must use this format: + projects/PROJECT_ID/locations/LOCATION/keyRings/KEY_RING/cryptoKeys/CRYPTO_KEY. + The key must be in the same region as the cluster. Otherwise, the + create operation fails. + --maintenance-window-day=MAINTENANCE_WINDOW_DAY Day of week when the window starts, e.g. sunday. MAINTENANCE_WINDOW_DAY must be one of: friday, monday, saturday, sunday, thursday, tuesday, diff --git a/gcloud/beta/run/services/update b/gcloud/beta/run/services/update index 8bb01ee14..4cf68e7f9 100644 --- a/gcloud/beta/run/services/update +++ b/gcloud/beta/run/services/update @@ -32,10 +32,9 @@ SYNOPSIS --cpu=CPU --depends-on=[CONTAINER,...] --gpu=GPU --image=IMAGE --liveness-probe=[KEY=VALUE,...] --memory=MEMORY --port=PORT --remove-volume-mount=[MOUNT_PATH,...] - --startup-probe=[KEY=VALUE,...] - --[no-]use-http2 --base-image=BASE_IMAGE - | --clear-base-image --clear-env-vars | --env-vars-file=FILE_PATH - | --set-env-vars=[KEY=VALUE,...] | --remove-env-vars=[KEY,...] + --startup-probe=[KEY=VALUE,...] --[no-]use-http2 --clear-env-vars + | --env-vars-file=FILE_PATH | --set-env-vars=[KEY=VALUE,...] + | --remove-env-vars=[KEY,...] --update-env-vars=[KEY=VALUE,...] --clear-secrets | --set-secrets=[KEY=VALUE,...] | --remove-secrets=[KEY,...] --update-secrets=[KEY=VALUE,...]] @@ -462,19 +461,6 @@ FLAGS Whether to use HTTP/2 for connections to the service. Use --use-http2 to enable and --no-use-http2 to disable. - At most one of these can be specified: - - --base-image=BASE_IMAGE - Specifies the base image to be used for automatic base image - updates. When deploying from source using the Google Cloud - buildpacks, this flag will also override the base image used for - the application image. See - https://cloud.google.com/run/docs/deploying-source-code for more - details. - - --clear-base-image - Opts out of automatic base image updates. - At most one of these can be specified: --clear-env-vars diff --git a/gcloud/beta/source-manager/help b/gcloud/beta/source-manager/help index c8bf31a43..e573c173e 100644 --- a/gcloud/beta/source-manager/help +++ b/gcloud/beta/source-manager/help @@ -24,6 +24,9 @@ GROUPS operations (BETA) Manage Secure Source Manager operations. + repos + (BETA) Manage Secure Source Manager repositories. + NOTES This command is currently in beta and might change without notice. This variant is also available: diff --git a/gcloud/beta/source-manager/repos/add-iam-policy-binding b/gcloud/beta/source-manager/repos/add-iam-policy-binding new file mode 100644 index 000000000..5b9863027 --- /dev/null +++ b/gcloud/beta/source-manager/repos/add-iam-policy-binding @@ -0,0 +1,97 @@ +NAME + gcloud beta source-manager repos add-iam-policy-binding - add an IAM policy + binding to a Secure Source Manager repository + +SYNOPSIS + gcloud beta source-manager repos add-iam-policy-binding + (REPOSITORY : --region=REGION) --member=PRINCIPAL --role=ROLE + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Add an IAM policy binding to a Secure Source Manager repository. + +EXAMPLES + To add an IAM policy binding for the Repository Admin role + (roles/securesourcemanager.repoAdmin) for the user test-user@gmail.com in a + repository named my-repo and location us-central1, run the following + command: + + $ gcloud beta source-manager repos add-iam-policy-binding my-repo \ + --region=us-central1 --member=user:test-user@gmail.com \ + --role=roles/securesourcemanager.repoAdmin + + See https://cloud.google.com/iam/docs/managing-policies for details of + policy role and member types. + +POSITIONAL ARGUMENTS + Repository resource - Secure Source Manager repository to add the IAM + policy binding 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 repository 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. + + REPOSITORY + ID of the repository or fully qualified identifier for the + repository. + + To set the repository attribute: + ▸ provide the argument repository on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Secure Source Manager location. + + To set the region attribute: + ▸ provide the argument repository on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + +REQUIRED FLAGS + --member=PRINCIPAL + The principal to add the binding for. Should be of the form + user|group|serviceAccount:email or domain:domain. + + Examples: user:test-user@gmail.com, group:admins@example.com, + serviceAccount:test123@example.domain.com, or + domain:example.domain.com. + + Some resources also accept the following special values: + ◆ allUsers - Special identifier that represents anyone who is on the + internet, with or without a Google account. + ◆ allAuthenticatedUsers - Special identifier that represents anyone + who is authenticated with a Google account or a service account. + + --role=ROLE + Role name to assign to the principal. The role name is the complete + path of a predefined role, such as roles/logging.viewer, or the role ID + for a custom role, such as + organizations/{ORGANIZATION_ID}/roles/logging.viewer. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the securesourcemanager/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/secure-source-manager + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha source-manager repos add-iam-policy-binding + diff --git a/gcloud/beta/source-manager/repos/create b/gcloud/beta/source-manager/repos/create new file mode 100644 index 000000000..0fa7aa681 --- /dev/null +++ b/gcloud/beta/source-manager/repos/create @@ -0,0 +1,93 @@ +NAME + gcloud beta source-manager repos create - create a Secure Source Manager + repository + +SYNOPSIS + gcloud beta source-manager repos create (REPOSITORY : --region=REGION) + --instance=INSTANCE [--description=DESCRIPTION] + [--default-branch=DEFAULT_BRANCH + --gitignores=[GITIGNORES,...] --license=LICENSE --readme=README] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Create a Secure Source Manager repository. + +EXAMPLES + To create a repository called 'my-repo' in location 'us-central1' in + instance 'my-instance', run the following command: + + $ gcloud beta source-manager repos create my-repo \ + --region=us-central1 --instance=my-instance + +POSITIONAL ARGUMENTS + Repository resource - The Secure Source Manager repository to create. 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 + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + REPOSITORY + ID of the repository or fully qualified identifier for the + repository. + + To set the repository attribute: + ▸ provide the argument repository on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Secure Source Manager location. + + To set the region attribute: + ▸ provide the argument repository on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + +REQUIRED FLAGS + --instance=INSTANCE + A Secure Source Manager instance ID. + +OPTIONAL FLAGS + --description=DESCRIPTION + Description of the repository. Cannot exceed 500 characters. + + Repository initialization configuration. + + --default-branch=DEFAULT_BRANCH + Default branch name of the repository. + + --gitignores=[GITIGNORES,...] + List of gitignore template names user can choose from. Full list can + be found here: + https://cloud.google.com/secure-source-manager/docs/reference/rest/v1/projects.locations.repositories#InitialConfig + + --license=LICENSE + License template name user can choose from. Full list can be found + here: + https://cloud.google.com/secure-source-manager/docs/reference/rest/v1/projects.locations.repositories#InitialConfig + + --readme=README + README template name. Valid template name(s) are: default. + +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 source-manager repos create + diff --git a/gcloud/beta/source-manager/repos/delete b/gcloud/beta/source-manager/repos/delete new file mode 100644 index 000000000..8577b10a3 --- /dev/null +++ b/gcloud/beta/source-manager/repos/delete @@ -0,0 +1,69 @@ +NAME + gcloud beta source-manager repos delete - delete a Secure Source Manager + repository + +SYNOPSIS + gcloud beta source-manager repos delete (REPOSITORY : --region=REGION) + [--allow-missing] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Delete a Secure Source Manager repository. + +EXAMPLES + To delete a repository called my-repo in location us-central1, run the + following command: + + $ gcloud beta source-manager repos delete my-repo \ + --region=us-central1 + +POSITIONAL ARGUMENTS + Repository resource - The Secure Source Manager repository to delete. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument repository 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. + + REPOSITORY + ID of the repository or fully qualified identifier for the + repository. + + To set the repository attribute: + ▸ provide the argument repository on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Secure Source Manager location. + + To set the region attribute: + ▸ provide the argument repository on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + +FLAGS + --allow-missing + If set to true, and the repository is not found, the request will + succeed but no action will be taken on the server. + +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 source-manager repos delete + diff --git a/gcloud/beta/source-manager/repos/describe b/gcloud/beta/source-manager/repos/describe new file mode 100644 index 000000000..1abdd81a1 --- /dev/null +++ b/gcloud/beta/source-manager/repos/describe @@ -0,0 +1,69 @@ +NAME + gcloud beta source-manager repos describe - describe a Secure Source + Manager repository + +SYNOPSIS + gcloud beta source-manager repos describe (REPOSITORY : --region=REGION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Get metadata of a Secure Source Manager repository. + +EXAMPLES + To describe a repository called my-repo in location us-central1, run the + following command: + + $ gcloud beta source-manager repos describe my-repo \ + --region=us-central1 + +POSITIONAL ARGUMENTS + Repository resource - The Secure Source Manager repository to describe. + The arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument repository 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. + + REPOSITORY + ID of the repository or fully qualified identifier for the + repository. + + To set the repository attribute: + ▸ provide the argument repository on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Secure Source Manager location. + + To set the region attribute: + ▸ provide the argument repository on the command line with a fully + specified name; + ▸ provide the argument --region 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 securesourcemanager/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/secure-source-manager + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha source-manager repos describe + diff --git a/gcloud/beta/source-manager/repos/get-iam-policy b/gcloud/beta/source-manager/repos/get-iam-policy new file mode 100644 index 000000000..5315ffeb4 --- /dev/null +++ b/gcloud/beta/source-manager/repos/get-iam-policy @@ -0,0 +1,96 @@ +NAME + gcloud beta source-manager repos get-iam-policy - get the IAM policy for a + Secure Source Manager repository + +SYNOPSIS + gcloud beta source-manager repos get-iam-policy + (REPOSITORY : --region=REGION) [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Get the IAM policy for a Secure Source Manager repository. + +EXAMPLES + To get the IAM policy for an repository named my-repo in location + us-central1, run the following command: + + $ gcloud beta source-manager repos get-iam-policy my-repo \ + --region=us-central1 + +POSITIONAL ARGUMENTS + Repository resource - Secure Source Manager repository to get the IAM + policy from. 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 + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + REPOSITORY + ID of the repository or fully qualified identifier for the + repository. + + To set the repository attribute: + ▸ provide the argument repository on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Secure Source Manager location. + + To set the region attribute: + ▸ provide the argument repository on the command line with a fully + specified name; + ▸ provide the argument --region 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 securesourcemanager/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/secure-source-manager + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha source-manager repos get-iam-policy + diff --git a/gcloud/beta/source-manager/repos/help b/gcloud/beta/source-manager/repos/help new file mode 100644 index 000000000..b9fdf97cf --- /dev/null +++ b/gcloud/beta/source-manager/repos/help @@ -0,0 +1,49 @@ +NAME + gcloud beta source-manager repos - manage Secure Source Manager + repositories + +SYNOPSIS + gcloud beta source-manager repos COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Manage Secure Source Manager repositories. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + add-iam-policy-binding + (BETA) Add an IAM policy binding to a Secure Source Manager repository. + + create + (BETA) Create a Secure Source Manager repository. + + delete + (BETA) Delete a Secure Source Manager repository. + + describe + (BETA) Describe a Secure Source Manager repository. + + get-iam-policy + (BETA) Get the IAM policy for a Secure Source Manager repository. + + list + (BETA) List all repositories under a Secure Source Manager instance. + + remove-iam-policy-binding + (BETA) Remove an IAM policy binding from a Secure Source Manager + repository. + + set-iam-policy + (BETA) Set the IAM policy for a Secure Source Manager repository. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha source-manager repos + diff --git a/gcloud/beta/source-manager/repos/list b/gcloud/beta/source-manager/repos/list new file mode 100644 index 000000000..877553db4 --- /dev/null +++ b/gcloud/beta/source-manager/repos/list @@ -0,0 +1,67 @@ +NAME + gcloud beta source-manager repos list - list all repositories under a + Secure Source Manager instance + +SYNOPSIS + gcloud beta source-manager repos list --instance=INSTANCE --region=REGION + [--limit=LIMIT] [--page-size=PAGE_SIZE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) List Secure Source Manager repositories. + +EXAMPLES + To list repositories in location us-central1 under instance my-instance, + run the following command: + + $ gcloud beta source-manager repos list --region=us-central1 \ + --instance=my-instance + +REQUIRED FLAGS + --instance=INSTANCE + A Secure Source Manager instance ID. + + Location resource - The Secure Source Manager location to list. This + represents a Cloud resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --region 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. + + --region=REGION + ID of the location or fully qualified identifier for the location. + + To set the region attribute: + ▸ provide the argument --region on the command line. + +LIST COMMAND FLAGS + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha source-manager repos list + diff --git a/gcloud/beta/source-manager/repos/remove-iam-policy-binding b/gcloud/beta/source-manager/repos/remove-iam-policy-binding new file mode 100644 index 000000000..35194a25a --- /dev/null +++ b/gcloud/beta/source-manager/repos/remove-iam-policy-binding @@ -0,0 +1,98 @@ +NAME + gcloud beta source-manager repos remove-iam-policy-binding - remove an IAM + policy binding from a Secure Source Manager repository + +SYNOPSIS + gcloud beta source-manager repos remove-iam-policy-binding + (REPOSITORY : --region=REGION) --member=PRINCIPAL --role=ROLE + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Remove an IAM policy binding to a Secure Source Manager repository. + +EXAMPLES + To remove the Repository Admin IAM role + (roles/securesourcemanager.repoAdmin) binding from the user + test-user@gmail.com in a repository named my-repo and location us-central1, + run the following command: + + $ gcloud beta source-manager repos remove-iam-policy-binding \ + my-repo --region=us-central1 --member=user:test-user@gmail.com \ + --role=roles/securesourcemanager.repoAdmin + + See https://cloud.google.com/iam/docs/managing-policies for details of + policy role and member types. + +POSITIONAL ARGUMENTS + Repository resource - Secure Source Manager repository to remove the IAM + policy binding from. 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 + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + REPOSITORY + ID of the repository or fully qualified identifier for the + repository. + + To set the repository attribute: + ▸ provide the argument repository on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Secure Source Manager location. + + To set the region attribute: + ▸ provide the argument repository on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + +REQUIRED FLAGS + --member=PRINCIPAL + The principal to remove the binding for. Should be of the form + user|group|serviceAccount:email or domain:domain. + + Examples: user:test-user@gmail.com, group:admins@example.com, + serviceAccount:test123@example.domain.com, or + domain:example.domain.com. + + Deleted principals have an additional deleted: prefix and a ?uid=UID + suffix, where UID is a unique identifier for the principal. Example: + deleted:user:test-user@gmail.com?uid=123456789012345678901. + + Some resources also accept the following special values: + ◆ allUsers - Special identifier that represents anyone who is on the + internet, with or without a Google account. + ◆ allAuthenticatedUsers - Special identifier that represents anyone + who is authenticated with a Google account or a service account. + + --role=ROLE + The role to remove the principal from. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the securesourcemanager/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/secure-source-manager + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha source-manager repos remove-iam-policy-binding + diff --git a/gcloud/beta/source-manager/repos/set-iam-policy b/gcloud/beta/source-manager/repos/set-iam-policy new file mode 100644 index 000000000..2e6754a30 --- /dev/null +++ b/gcloud/beta/source-manager/repos/set-iam-policy @@ -0,0 +1,76 @@ +NAME + gcloud beta source-manager repos set-iam-policy - set the IAM policy for a + Secure Source Manager repository + +SYNOPSIS + gcloud beta source-manager repos set-iam-policy + (REPOSITORY : --region=REGION) POLICY_FILE [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Set the IAM policy for a Secure Source Manager repository. + +EXAMPLES + To set the IAM policy for a repository named my-repo in location us-central + to the content of policy.json , run the following command: + + $ gcloud beta source-manager repos set-iam-policy my-repo \ + --region=us-central1 policy.json + +POSITIONAL ARGUMENTS + Repository resource - Secure Source Manager repository to set the IAM + policy on. 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 + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + REPOSITORY + ID of the repository or fully qualified identifier for the + repository. + + To set the repository attribute: + ▸ provide the argument repository on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Secure Source Manager location. + + To set the region attribute: + ▸ provide the argument repository on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + + POLICY_FILE + Path to a local JSON or YAML formatted file containing a valid policy. + + The output of the get-iam-policy command is a valid file, as is any + JSON or YAML file conforming to the structure of a Policy + (https://cloud.google.com/iam/reference/rest/v1/Policy). + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the securesourcemanager/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/secure-source-manager + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha source-manager repos set-iam-policy + diff --git a/gcloud/beta/spanner/instances/create b/gcloud/beta/spanner/instances/create index 010378c8a..dc514c6d0 100644 --- a/gcloud/beta/spanner/instances/create +++ b/gcloud/beta/spanner/instances/create @@ -100,7 +100,7 @@ OPTIONAL FLAGS --processing-units=PROCESSING_UNITS Number of processing units for the instance. - Autoscaling (Preview) + Autoscaling --autoscaling-high-priority-cpu-target=AUTOSCALING_HIGH_PRIORITY_CPU_TARGET Specifies the target percentage of high-priority CPU the autoscaled @@ -116,9 +116,11 @@ OPTIONAL FLAGS This flag argument must be specified if any of the other arguments in this group are specified. + Autoscaling limits can be defined in either nodes or processing units. + Exactly one of these must be specified: - Autoscaling limits in nodes + Autoscaling limits in nodes: --autoscaling-max-nodes=AUTOSCALING_MAX_NODES Maximum number of nodes for the autoscaled instance. @@ -132,7 +134,7 @@ OPTIONAL FLAGS This flag argument must be specified if any of the other arguments in this group are specified. - Autoscaling limits in processing units + Autoscaling limits in processing units: --autoscaling-max-processing-units=AUTOSCALING_MAX_PROCESSING_UNITS Maximum number of processing units for the autoscaled instance. diff --git a/gcloud/beta/spanner/instances/update b/gcloud/beta/spanner/instances/update index cb23dd109..15402d8b6 100644 --- a/gcloud/beta/spanner/instances/update +++ b/gcloud/beta/spanner/instances/update @@ -91,7 +91,7 @@ FLAGS --processing-units=PROCESSING_UNITS Number of processing units for the instance. - Autoscaling (Preview) + Autoscaling --autoscaling-high-priority-cpu-target=AUTOSCALING_HIGH_PRIORITY_CPU_TARGET Specifies the target percentage of high-priority CPU the autoscaled @@ -101,9 +101,11 @@ FLAGS Specifies the target percentage of storage the autoscaled instance can utilize. + Autoscaling limits can be defined in either nodes or processing units. + At most one of these can be specified: - Autoscaling limits in nodes + Autoscaling limits in nodes: --autoscaling-max-nodes=AUTOSCALING_MAX_NODES Maximum number of nodes for the autoscaled instance. @@ -111,7 +113,7 @@ FLAGS --autoscaling-min-nodes=AUTOSCALING_MIN_NODES Minimum number of nodes for the autoscaled instance. - Autoscaling limits in processing units + Autoscaling limits in processing units: --autoscaling-max-processing-units=AUTOSCALING_MAX_PROCESSING_UNITS Maximum number of processing units for the autoscaled instance. diff --git a/gcloud/beta/workstations/configs/create b/gcloud/beta/workstations/configs/create index 1d76ee871..10e851561 100644 --- a/gcloud/beta/workstations/configs/create +++ b/gcloud/beta/workstations/configs/create @@ -24,7 +24,6 @@ SYNOPSIS [--machine-type=MACHINE_TYPE; default="e2-standard-4"] [--max-usable-workstations-count=MAX_USABLE_WORKSTATIONS_COUNT] [--network-tags=[NETWORK_TAGS,...]] - [--pd-disk-size=PD_DISK_SIZE; default=200] [--pd-disk-type=PD_DISK_TYPE; default="pd-standard"] [--pd-reclaim-policy=PD_RECLAIM_POLICY; default="delete"] [--pool-size=POOL_SIZE] [--replica-zones=[REPLICA_ZONES,...]] @@ -39,7 +38,8 @@ SYNOPSIS | --container-predefined-image=CONTAINER_PREDEFINED_IMAGE; default="codeoss"] [--kms-key=KMS_KEY : --kms-key-service-account=KMS_KEY_SERVICE_ACCOUNT] - [GCLOUD_WIDE_FLAG ...] + [--pd-disk-size=PD_DISK_SIZE; default=200 + | --pd-source-snapshot=PD_SOURCE_SNAPSHOT] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Create a workstation configuration. @@ -313,10 +313,6 @@ FLAGS $ gcloud beta workstations configs create --network-tags=tag_1,tag_2 - --pd-disk-size=PD_DISK_SIZE; default=200 - Size of the persistent directory in GB. PD_DISK_SIZE must be one of: - 10, 50, 100, 200, 500, 1000. - --pd-disk-type=PD_DISK_TYPE; default="pd-standard" Type of the persistent directory. PD_DISK_TYPE must be one of: pd-standard, pd-balanced, pd-ssd. @@ -443,6 +439,15 @@ FLAGS The service account associated with the provided customer-managed encryption key. + At most one of these can be specified: + + --pd-disk-size=PD_DISK_SIZE; default=200 + Size of the persistent directory in GB. PD_DISK_SIZE must be one of: + 10, 50, 100, 200, 500, 1000. + + --pd-source-snapshot=PD_SOURCE_SNAPSHOT + Name of the snapshot to use as the source for the home disk. + 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/workstations/configs/update b/gcloud/beta/workstations/configs/update index 29c719b47..ad87f9863 100644 --- a/gcloud/beta/workstations/configs/update +++ b/gcloud/beta/workstations/configs/update @@ -18,7 +18,8 @@ SYNOPSIS [--idle-timeout=IDLE_TIMEOUT] [--labels=[LABELS,...]] [--machine-type=MACHINE_TYPE] [--max-usable-workstations-count=MAX_USABLE_WORKSTATIONS_COUNT] - [--network-tags=[NETWORK_TAGS,...]] [--pool-size=POOL_SIZE] + [--network-tags=[NETWORK_TAGS,...]] + [--pd-source-snapshot=PD_SOURCE_SNAPSHOT] [--pool-size=POOL_SIZE] [--running-timeout=RUNNING_TIMEOUT] [--service-account=SERVICE_ACCOUNT] [--service-account-scopes=[SERVICE_ACCOUNT_SCOPES,...]] [--shielded-integrity-monitoring] [--shielded-secure-boot] @@ -267,6 +268,9 @@ FLAGS $ gcloud beta workstations configs update --network-tags=tag_1,tag_2 + --pd-source-snapshot=PD_SOURCE_SNAPSHOT + Name of the snapshot to use as the source for the home disk. + --pool-size=POOL_SIZE Number of instances to pool for faster Workstation startup. diff --git a/gcloud/builds/submit b/gcloud/builds/submit index 503efdc17..8196b891c 100644 --- a/gcloud/builds/submit +++ b/gcloud/builds/submit @@ -222,13 +222,13 @@ FLAGS The YAML or JSON file to use as the build configuration file. --pack=[builder=BUILDER],[env=ENV],[image=IMAGE] - Uses CNCF buildpack (https://buildpacks.io/) to create image. The - "image" key/value must be provided. The image name must be in the - gcr.io or pkg.dev namespace. By default gcr.io/buildpacks/builder - will be used. To specify your own builder image use the optional - "builder" key/value argument. To pass environment variables to the - builder use the optional "env" key/value argument where value is a - list of key values using escaping + Uses CNCF buildpack (https://buildpacks.io/) to create the app image. + The app "image" key/value must be provided. The app image name must + be in the gcr.io or pkg.dev namespace. To specify your own builder + image use the optional "builder" key/value argument. By default + gcr.io/buildpacks/builder is used. To pass environment variables to + the builder use the optional "env" key/value argument where value is + a list of key values using escaping (https://cloud.google.com/sdk/gcloud/reference/topic/escaping) if necessary. diff --git a/gcloud/compute/firewall-policies/rules/create b/gcloud/compute/firewall-policies/rules/create index 0d94e8563..437e2aaf4 100644 --- a/gcloud/compute/firewall-policies/rules/create +++ b/gcloud/compute/firewall-policies/rules/create @@ -15,8 +15,10 @@ SYNOPSIS [--src-address-groups=[SOURCE_ADDRESS_GROUPS,...]] [--src-fqdns=[SOURCE_FQDNS,...]] [--src-ip-ranges=[SRC_IP_RANGE,...]] [--src-region-codes=[SOURCE_REGION_CODES,...]] + [--src-secure-tags=[SOURCE_SECURE_TAGS,...]] [--src-threat-intelligence=[SOURCE_THREAT_INTELLIGENCE_LISTS,...]] [--target-resources=[TARGET_RESOURCES,...]] + [--target-secure-tags=[TARGET_SECURE_TAGS,...]] [--target-service-accounts=[TARGET_SERVICE_ACCOUNTS,...]] [--[no-]tls-inspect] [GCLOUD_WIDE_FLAG ...] @@ -118,6 +120,16 @@ OPTIONAL FLAGS Source Region Code to match for this rule. Can only be specified if DIRECTION is ingress. + --src-secure-tags=[SOURCE_SECURE_TAGS,...] + A list of instance secure tags indicating the set of instances on the + network to which the rule applies if all other fields match. Either + --src-ip-ranges or --src-secure-tags must be specified for ingress + traffic. If both --src-ip-ranges and --src-secure-tags are specified, + an inbound connection is allowed if either the range of the source + matches --src-ip-ranges or the tag of the source matches + --src-secure-tags. Secure Tags can be assigned to instances during + instance creation. + --src-threat-intelligence=[SOURCE_THREAT_INTELLIGENCE_LISTS,...] Source Threat Intelligence lists to match for this rule. Can only be specified if DIRECTION is ingress. The available lists can be found @@ -127,6 +139,10 @@ OPTIONAL FLAGS --target-resources=[TARGET_RESOURCES,...] List of URLs of target resources to which the rule is applied. + --target-secure-tags=[TARGET_SECURE_TAGS,...] + An optional, list of target secure tags with a name of the format + tagValues/ or full namespaced name + --target-service-accounts=[TARGET_SERVICE_ACCOUNTS,...] List of target service accounts for the rule. diff --git a/gcloud/compute/firewall-policies/rules/update b/gcloud/compute/firewall-policies/rules/update index c0adcff61..1dc1c0c0f 100644 --- a/gcloud/compute/firewall-policies/rules/update +++ b/gcloud/compute/firewall-policies/rules/update @@ -17,8 +17,10 @@ SYNOPSIS [--src-address-groups=[SOURCE_ADDRESS_GROUPS,...]] [--src-fqdns=[SOURCE_FQDNS,...]] [--src-ip-ranges=[SRC_IP_RANGE,...]] [--src-region-codes=[SOURCE_REGION_CODES,...]] + [--src-secure-tags=[SOURCE_SECURE_TAGS,...]] [--src-threat-intelligence=[SOURCE_THREAT_INTELLIGENCE_LISTS,...]] [--target-resources=[TARGET_RESOURCES,...]] + [--target-secure-tags=[TARGET_SECURE_TAGS,...]] [--target-service-accounts=[TARGET_SERVICE_ACCOUNTS,...]] [--[no-]tls-inspect] [GCLOUD_WIDE_FLAG ...] @@ -124,6 +126,16 @@ OPTIONAL FLAGS Source Region Code to match for this rule. Can only be specified if DIRECTION is ingress. + --src-secure-tags=[SOURCE_SECURE_TAGS,...] + A list of instance secure tags indicating the set of instances on the + network to which the rule applies if all other fields match. Either + --src-ip-ranges or --src-secure-tags must be specified for ingress + traffic. If both --src-ip-ranges and --src-secure-tags are specified, + an inbound connection is allowed if either the range of the source + matches --src-ip-ranges or the tag of the source matches + --src-secure-tags. Secure Tags can be assigned to instances during + instance creation. + --src-threat-intelligence=[SOURCE_THREAT_INTELLIGENCE_LISTS,...] Source Threat Intelligence lists to match for this rule. Can only be specified if DIRECTION is ingress. The available lists can be found @@ -133,6 +145,10 @@ OPTIONAL FLAGS --target-resources=[TARGET_RESOURCES,...] List of URLs of target resources to which the rule is applied. + --target-secure-tags=[TARGET_SECURE_TAGS,...] + An optional, list of target secure tags with a name of the format + tagValues/ or full namespaced name + --target-service-accounts=[TARGET_SERVICE_ACCOUNTS,...] List of target service accounts for the rule. diff --git a/gcloud/container/clusters/create b/gcloud/container/clusters/create index 5a2f4bd21..653384582 100644 --- a/gcloud/container/clusters/create +++ b/gcloud/container/clusters/create @@ -1237,6 +1237,7 @@ FLAGS hugepageConfig: hugepage_size2m: '1024' hugepage_size1g: '2' + cgroupMode: 'CGROUP_MODE_V2' List of supported kubelet configs in 'kubeletConfig'. @@ -1251,26 +1252,60 @@ FLAGS List of supported sysctls in 'linuxConfig'. - KEY VALUE - net.core.netdev_max_backlog Any positive integer, less - than 2147483647 - net.core.rmem_max Any positive integer, less - than 2147483647 - net.core.wmem_default Any positive integer, less - than 2147483647 - net.core.wmem_max Any positive integer, less - than 2147483647 - net.core.optmem_max Any positive integer, less - than 2147483647 - net.core.somaxconn Must be [128, 2147483647] - net.ipv4.tcp_rmem Any positive integer tuple - net.ipv4.tcp_wmem Any positive integer tuple - net.ipv4.tcp_tw_reuse Must be {0, 1} - kernel.shmmni Must be [4096, 32768] - kernel.shmmax Must be [0, - 18446744073692774399] - kernel.shmall Must be [0, - 18446744073692774399] + KEY VALUE + net.core.netdev_max_backlog Any positive + integer, less than + 2147483647 + net.core.rmem_default Any positive + integer, less than + 2147483647 + net.core.rmem_max Any positive + integer, less than + 2147483647 + net.core.wmem_default Any positive + integer, less than + 2147483647 + net.core.wmem_max Any positive + integer, less than + 2147483647 + net.core.optmem_max Any positive + integer, less than + 2147483647 + net.core.somaxconn Must be between + [128, 2147483647] + net.ipv4.tcp_rmem Any positive + integer tuple + net.ipv4.tcp_wmem Any positive + integer tuple + net.ipv4.tcp_tw_reuse Must be {0, 1} + net.netfilter.nf_conntrack_max Must be between + [65536, 4194304] + net.netfilter.nf_conntrack_buckets Must be between + [65536, 524288]. + Recommend setting: + nf_conntrack_max = + nf_conntrack_bucke + ts * 4 + net.netfilter.nf_conntrack_tcp_timeout_close_wait Must be between + [60, 3600] + net.netfilter.nf_conntrack_tcp_timeout_time_wait Must be between + [1, 600] + net.netfilter.nf_conntrack_tcp_timeout_established Must be between + [600, 86400] + net.netfilter.nf_conntrack_acct Must be {0, 1} + kernel.shmmni Must be between + [4096, 32768] + kernel.shmmax Must be between + [0, + 184467440736927743 + 99] + kernel.shmall Must be between + [0, + 184467440736927743 + 99] + vm.max_map_count Must be between + [65536, + 2147483647] List of supported hugepage size in 'hugepageConfig'. @@ -1285,6 +1320,12 @@ FLAGS 1G hugepages are only available in following machine familes: c3, m2, c2d, c3d, h3, m3, a2, a3, g2. + Supported values for 'cgroupMode' under 'linuxConfig'. + + ◆ CGROUP_MODE_V1: Use cgroupv1 on the node pool. + ◆ CGROUP_MODE_V2: Use cgroupv2 on the node pool. + ◆ CGROUP_MODE_UNSPECIFIED: Use the default GKE cgroup configuration. + Note, updating the system configuration of an existing node pool requires recreation of the nodes which which might cause a disruption. diff --git a/gcloud/container/node-pools/create b/gcloud/container/node-pools/create index 5b8030cd8..8ada8c903 100644 --- a/gcloud/container/node-pools/create +++ b/gcloud/container/node-pools/create @@ -673,6 +673,7 @@ FLAGS hugepageConfig: hugepage_size2m: '1024' hugepage_size1g: '2' + cgroupMode: 'CGROUP_MODE_V2' List of supported kubelet configs in 'kubeletConfig'. @@ -687,26 +688,60 @@ FLAGS List of supported sysctls in 'linuxConfig'. - KEY VALUE - net.core.netdev_max_backlog Any positive integer, less - than 2147483647 - net.core.rmem_max Any positive integer, less - than 2147483647 - net.core.wmem_default Any positive integer, less - than 2147483647 - net.core.wmem_max Any positive integer, less - than 2147483647 - net.core.optmem_max Any positive integer, less - than 2147483647 - net.core.somaxconn Must be [128, 2147483647] - net.ipv4.tcp_rmem Any positive integer tuple - net.ipv4.tcp_wmem Any positive integer tuple - net.ipv4.tcp_tw_reuse Must be {0, 1} - kernel.shmmni Must be [4096, 32768] - kernel.shmmax Must be [0, - 18446744073692774399] - kernel.shmall Must be [0, - 18446744073692774399] + KEY VALUE + net.core.netdev_max_backlog Any positive + integer, less than + 2147483647 + net.core.rmem_default Any positive + integer, less than + 2147483647 + net.core.rmem_max Any positive + integer, less than + 2147483647 + net.core.wmem_default Any positive + integer, less than + 2147483647 + net.core.wmem_max Any positive + integer, less than + 2147483647 + net.core.optmem_max Any positive + integer, less than + 2147483647 + net.core.somaxconn Must be between + [128, 2147483647] + net.ipv4.tcp_rmem Any positive + integer tuple + net.ipv4.tcp_wmem Any positive + integer tuple + net.ipv4.tcp_tw_reuse Must be {0, 1} + net.netfilter.nf_conntrack_max Must be between + [65536, 4194304] + net.netfilter.nf_conntrack_buckets Must be between + [65536, 524288]. + Recommend setting: + nf_conntrack_max = + nf_conntrack_bucke + ts * 4 + net.netfilter.nf_conntrack_tcp_timeout_close_wait Must be between + [60, 3600] + net.netfilter.nf_conntrack_tcp_timeout_time_wait Must be between + [1, 600] + net.netfilter.nf_conntrack_tcp_timeout_established Must be between + [600, 86400] + net.netfilter.nf_conntrack_acct Must be {0, 1} + kernel.shmmni Must be between + [4096, 32768] + kernel.shmmax Must be between + [0, + 184467440736927743 + 99] + kernel.shmall Must be between + [0, + 184467440736927743 + 99] + vm.max_map_count Must be between + [65536, + 2147483647] List of supported hugepage size in 'hugepageConfig'. @@ -721,6 +756,12 @@ FLAGS 1G hugepages are only available in following machine familes: c3, m2, c2d, c3d, h3, m3, a2, a3, g2. + Supported values for 'cgroupMode' under 'linuxConfig'. + + ◆ CGROUP_MODE_V1: Use cgroupv1 on the node pool. + ◆ CGROUP_MODE_V2: Use cgroupv2 on the node pool. + ◆ CGROUP_MODE_UNSPECIFIED: Use the default GKE cgroup configuration. + Note, updating the system configuration of an existing node pool requires recreation of the nodes which which might cause a disruption. diff --git a/gcloud/container/node-pools/update b/gcloud/container/node-pools/update index fbd9ff256..9c8881c0f 100644 --- a/gcloud/container/node-pools/update +++ b/gcloud/container/node-pools/update @@ -275,6 +275,7 @@ REQUIRED FLAGS hugepageConfig: hugepage_size2m: '1024' hugepage_size1g: '2' + cgroupMode: 'CGROUP_MODE_V2' List of supported kubelet configs in 'kubeletConfig'. @@ -289,29 +290,63 @@ REQUIRED FLAGS List of supported sysctls in 'linuxConfig'. - KEY VALUE - net.core.netdev_max_backlog Any positive integer, - less than 2147483647 - net.core.rmem_max Any positive integer, - less than 2147483647 - net.core.wmem_default Any positive integer, - less than 2147483647 - net.core.wmem_max Any positive integer, - less than 2147483647 - net.core.optmem_max Any positive integer, - less than 2147483647 - net.core.somaxconn Must be [128, - 2147483647] - net.ipv4.tcp_rmem Any positive integer - tuple - net.ipv4.tcp_wmem Any positive integer - tuple - net.ipv4.tcp_tw_reuse Must be {0, 1} - kernel.shmmni Must be [4096, 32768] - kernel.shmmax Must be [0, - 18446744073692774399] - kernel.shmall Must be [0, - 18446744073692774399] + KEY VALUE + net.core.netdev_max_backlog Any positive + integer, less + than 2147483647 + net.core.rmem_default Any positive + integer, less + than 2147483647 + net.core.rmem_max Any positive + integer, less + than 2147483647 + net.core.wmem_default Any positive + integer, less + than 2147483647 + net.core.wmem_max Any positive + integer, less + than 2147483647 + net.core.optmem_max Any positive + integer, less + than 2147483647 + net.core.somaxconn Must be between + [128, + 2147483647] + net.ipv4.tcp_rmem Any positive + integer tuple + net.ipv4.tcp_wmem Any positive + integer tuple + net.ipv4.tcp_tw_reuse Must be {0, 1} + net.netfilter.nf_conntrack_max Must be between + [65536, 4194304] + net.netfilter.nf_conntrack_buckets Must be between + [65536, 524288]. + Recommend + setting: + nf_conntrack_max + = + nf_conntrack_buc + kets * 4 + net.netfilter.nf_conntrack_tcp_timeout_close_wait Must be between + [60, 3600] + net.netfilter.nf_conntrack_tcp_timeout_time_wait Must be between + [1, 600] + net.netfilter.nf_conntrack_tcp_timeout_established Must be between + [600, 86400] + net.netfilter.nf_conntrack_acct Must be {0, 1} + kernel.shmmni Must be between + [4096, 32768] + kernel.shmmax Must be between + [0, + 1844674407369277 + 4399] + kernel.shmall Must be between + [0, + 1844674407369277 + 4399] + vm.max_map_count Must be between + [65536, + 2147483647] List of supported hugepage size in 'hugepageConfig'. @@ -326,6 +361,13 @@ REQUIRED FLAGS 1G hugepages are only available in following machine familes: c3, m2, c2d, c3d, h3, m3, a2, a3, g2. + Supported values for 'cgroupMode' under 'linuxConfig'. + + ▸ CGROUP_MODE_V1: Use cgroupv1 on the node pool. + ▸ CGROUP_MODE_V2: Use cgroupv2 on the node pool. + ▸ CGROUP_MODE_UNSPECIFIED: Use the default GKE cgroup + configuration. + Note, updating the system configuration of an existing node pool requires recreation of the nodes which which might cause a disruption. diff --git a/gcloud/database-migration/connection-profiles/create/sqlserver b/gcloud/database-migration/connection-profiles/create/sqlserver index 1e03ba12d..00dd4159a 100644 --- a/gcloud/database-migration/connection-profiles/create/sqlserver +++ b/gcloud/database-migration/connection-profiles/create/sqlserver @@ -103,8 +103,8 @@ REQUIRED FLAGS only for SQL Server to Cloud SQL migrations. --provider=PROVIDER - Database provider, for managed databases. PROVIDER must be (only one - value is supported): RDS. + Database provider, for managed databases. PROVIDER must be one of: + CLOUDSQL, RDS. OPTIONAL FLAGS --no-async diff --git a/gcloud/database-migration/connection-profiles/update b/gcloud/database-migration/connection-profiles/update index 0cabb8ee2..fc91d4e46 100644 --- a/gcloud/database-migration/connection-profiles/update +++ b/gcloud/database-migration/connection-profiles/update @@ -8,6 +8,7 @@ SYNOPSIS [--alloydb-cluster=ALLOYDB_CLUSTER] [--ca-certificate=CA_CERTIFICATE] [--client-certificate=CLIENT_CERTIFICATE] [--cloudsql-instance=CLOUDSQL_INSTANCE] + [--cloudsql-project-id=CLOUDSQL_PROJECT_ID] [--database-service=DATABASE_SERVICE] [--display-name=DISPLAY_NAME] [--host=HOST] [--port=PORT] [--private-key=PRIVATE_KEY] [--update-labels=[KEY=VALUE,...]] [--username=USERNAME] @@ -90,6 +91,10 @@ FLAGS If the source or destination is a Cloud SQL database, then use this field to provide the respective Cloud SQL instance ID. + --cloudsql-project-id=CLOUDSQL_PROJECT_ID + The project id of the Cloud SQL instance. Only needed if the Cloud SQL + instance is in a different project than the connection profile. + --database-service=DATABASE_SERVICE database service for the oracle connection profile. diff --git a/gcloud/database-migration/conversion-workspaces/create b/gcloud/database-migration/conversion-workspaces/create index 52abccc04..6ec50b7ec 100644 --- a/gcloud/database-migration/conversion-workspaces/create +++ b/gcloud/database-migration/conversion-workspaces/create @@ -6,11 +6,12 @@ SYNOPSIS gcloud database-migration conversion-workspaces create (CONVERSION_WORKSPACE : --region=REGION) --destination-database-engine=DESTINATION_DATABASE_ENGINE - --destination-database-version=DESTINATION_DATABASE_VERSION - --source-database-engine=SOURCE_DATABASE_ENGINE - --source-database-version=SOURCE_DATABASE_VERSION [--no-async] - [--display-name=DISPLAY_NAME] [--global-settings=[KEY=VALUE,...]] - [GCLOUD_WIDE_FLAG ...] + --source-database-engine=SOURCE_DATABASE_ENGINE [--no-async] + [--destination-database-version=DESTINATION_DATABASE_VERSION; + default="unspecified"] [--display-name=DISPLAY_NAME] + [--global-settings=[KEY=VALUE,...]] + [--source-database-version=SOURCE_DATABASE_VERSION; + default="unspecified"] [GCLOUD_WIDE_FLAG ...] DESCRIPTION Create a Database Migration Service conversion workspace. @@ -59,27 +60,22 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS --destination-database-engine=DESTINATION_DATABASE_ENGINE - Database engine type. DESTINATION_DATABASE_ENGINE must be (only one - value is supported): POSTGRESQL. - - --destination-database-version=DESTINATION_DATABASE_VERSION - Version number for the database engine. The version number must contain - numbers and letters only. Example for Oracle 21c, version number will - be 21c. + Destination database engine type. DESTINATION_DATABASE_ENGINE must be + (only one value is supported): POSTGRESQL. --source-database-engine=SOURCE_DATABASE_ENGINE - Database engine type. SOURCE_DATABASE_ENGINE must be (only one value is - supported): ORACLE. - - --source-database-version=SOURCE_DATABASE_VERSION - Version number for the database engine. The version number must contain - numbers and letters only. Example for Oracle 21c, version number will - be 21c. + Source database engine type. SOURCE_DATABASE_ENGINE must be (only one + value is supported): ORACLE. OPTIONAL FLAGS --no-async Waits for the operation in progress to complete before returning. + --destination-database-version=DESTINATION_DATABASE_VERSION; default="unspecified" + Version number for the database engine. The version number must contain + numbers and letters only. Example for PostgreSQL 17.0, version number + will be 17.0. + --display-name=DISPLAY_NAME A user-friendly name for the conversion workspace. The display name can include letters, numbers, spaces, and hyphens, and must start with a @@ -91,6 +87,11 @@ OPTIONAL FLAGS engine or turn on or off specific features. An object containing a list of "key": "value" pairs. + --source-database-version=SOURCE_DATABASE_VERSION; default="unspecified" + Version number for the database engine. The version number must contain + numbers and letters only. Example for Oracle 21c, version number will + be 21c. + 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/database-migration/conversion-workspaces/delete b/gcloud/database-migration/conversion-workspaces/delete index b92b1eb10..032872050 100644 --- a/gcloud/database-migration/conversion-workspaces/delete +++ b/gcloud/database-migration/conversion-workspaces/delete @@ -8,7 +8,7 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - Delete a Database Migration conversion workspace + Delete a Database Migration conversion workspace. EXAMPLES To delete a conversion workspace called 'my-conversion-workspace', run: diff --git a/gcloud/database-migration/conversion-workspaces/describe-ddls b/gcloud/database-migration/conversion-workspaces/describe-ddls index 9e931ad7f..30b06f982 100644 --- a/gcloud/database-migration/conversion-workspaces/describe-ddls +++ b/gcloud/database-migration/conversion-workspaces/describe-ddls @@ -5,8 +5,10 @@ NAME SYNOPSIS gcloud database-migration conversion-workspaces describe-ddls (CONVERSION_WORKSPACE : --region=REGION) [--commit-id=COMMIT_ID] - [--filter=FILTER] [--tree-type=TREE_TYPE; default="DRAFT"] - [--uncommitted] [GCLOUD_WIDE_FLAG ...] + [--tree-type=TREE_TYPE; default="DRAFT"] [--uncommitted] + [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE; default=100] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION Describe DDLs in a Database Migration Service conversion workspace. @@ -16,13 +18,13 @@ EXAMPLES project and location us-central1, run: $ gcloud database-migration conversion-workspaces describe-ddls \ - my-conversion-workspace --region=us-central1 + my-conversion-workspace --region=us-central1 To describe the DDLs of the source tree in a conversion workspace in a project and location us-central1, run: $ gcloud database-migration conversion-workspaces describe-ddls \ - my-conversion-workspace --region=us-central1 --tree-type=SOURCE + my-conversion-workspace --region=us-central1 --tree-type=SOURCE POSITIONAL ARGUMENTS Conversion workspace resource - The conversion workspace to describe DDLs. @@ -61,12 +63,6 @@ FLAGS Request a specific commit id. If not specified, the entities from the latest commit are returned. - --filter=FILTER - Filter the entities based on AIP-160 (https://google.aip.dev/160) - standard. Example: to filter all tables whose name start with - "Employee" and are present under schema "Company", use filter as - "Company.Employee* AND type=TABLE" - --tree-type=TREE_TYPE; default="DRAFT" Tree type for database entities. TREE_TYPE must be one of: SOURCE, DRAFT. @@ -76,6 +72,37 @@ FLAGS latest version. This field is ignored if a specific commit_id is specified. +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; default=100 + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is 100. + 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, diff --git a/gcloud/database-migration/conversion-workspaces/describe-entities b/gcloud/database-migration/conversion-workspaces/describe-entities index 3c87aa03d..0a4fb7dd4 100644 --- a/gcloud/database-migration/conversion-workspaces/describe-entities +++ b/gcloud/database-migration/conversion-workspaces/describe-entities @@ -5,8 +5,9 @@ NAME SYNOPSIS gcloud database-migration conversion-workspaces describe-entities (CONVERSION_WORKSPACE : --region=REGION) --tree-type=TREE_TYPE - [--commit-id=COMMIT_ID] [--filter=FILTER] [--uncommitted] - [GCLOUD_WIDE_FLAG ...] + [--commit-id=COMMIT_ID] [--uncommitted] [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE; default=100] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION Describe database entities in a Database Migration conversion workspace. @@ -56,22 +57,47 @@ REQUIRED FLAGS Tree type for database entities. TREE_TYPE must be one of: SOURCE, DRAFT. -OPTIONAL FLAGS +FLAGS --commit-id=COMMIT_ID Request a specific commit id. If not specified, the entities from the latest commit are returned. - --filter=FILTER - Filter the entities based on AIP-160 (https://google.aip.dev/160) - standard. Example: to filter all tables whose name start with - "Employee" and are present under schema "Company", use filter as - "Company.Employee* AND type=TABLE" - --uncommitted Whether to retrieve the latest committed version of the entities or the latest version. This field is ignored if a specific commit_id is specified. +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; default=100 + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is 100. + 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, diff --git a/gcloud/database-migration/conversion-workspaces/describe-issues b/gcloud/database-migration/conversion-workspaces/describe-issues index f7316046f..4f2b8d5df 100644 --- a/gcloud/database-migration/conversion-workspaces/describe-issues +++ b/gcloud/database-migration/conversion-workspaces/describe-issues @@ -5,7 +5,9 @@ NAME SYNOPSIS gcloud database-migration conversion-workspaces describe-issues (CONVERSION_WORKSPACE : --region=REGION) [--commit-id=COMMIT_ID] - [--filter=FILTER] [--uncommitted] [GCLOUD_WIDE_FLAG ...] + [--uncommitted] [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE; default=100] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION Describe database entity issues in a Database Migration Services conversion @@ -16,7 +18,7 @@ EXAMPLES project and location us-central1, run: $ gcloud database-migration conversion-workspaces describe-issues \ - my-conversion-workspace --region=us-central1 + my-conversion-workspace --region=us-central1 POSITIONAL ARGUMENTS Conversion workspace resource - The conversion workspace to describe @@ -55,17 +57,42 @@ FLAGS Request a specific commit id. If not specified, the entities from the latest commit are returned. - --filter=FILTER - Filter the entities based on AIP-160 (https://google.aip.dev/160) - standard. Example: to filter all tables whose name start with - "Employee" and are present under schema "Company", use filter as - "Company.Employee* AND type=TABLE" - --uncommitted Whether to retrieve the latest committed version of the entities or the latest version. This field is ignored if a specific commit_id is specified. +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; default=100 + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is 100. + 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, diff --git a/gcloud/database-migration/conversion-workspaces/import-rules b/gcloud/database-migration/conversion-workspaces/import-rules index 3400c79f1..31ac6eb58 100644 --- a/gcloud/database-migration/conversion-workspaces/import-rules +++ b/gcloud/database-migration/conversion-workspaces/import-rules @@ -5,8 +5,8 @@ NAME SYNOPSIS gcloud database-migration conversion-workspaces import-rules (CONVERSION_WORKSPACE : --region=REGION) - --config-files=CONGIF_FILE,[CONGIF_FILE,...] --file-format=FILE_FORMAT - [--auto-commit] [GCLOUD_WIDE_FLAG ...] + --config-files=CONGIF_FILE,[CONGIF_FILE,...] [--auto-commit] + [--file-format=FILE_FORMAT; default="ORA2PG"] [GCLOUD_WIDE_FLAG ...] DESCRIPTION Import mapping rules in a Database Migration Service conversion workspace @@ -59,14 +59,14 @@ REQUIRED FLAGS or if multiple files are to be provided, each file should correspond to one schema. Provide file paths as a comma separated list. - --file-format=FILE_FORMAT - File format type to import rules from. FILE_FORMAT must be (only one - value is supported): ORA2PG. - OPTIONAL FLAGS --auto-commit Auto commits the conversion workspace. + --file-format=FILE_FORMAT; default="ORA2PG" + File format type to import rules from. FILE_FORMAT must be (only one + value is supported): ORA2PG. + 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/database-migration/help b/gcloud/database-migration/help index ba0e60610..334cd6b10 100644 --- a/gcloud/database-migration/help +++ b/gcloud/database-migration/help @@ -24,6 +24,9 @@ GROUPS migration-jobs Manage Database Migration Service migration jobs. + objects + Manage Database Migration Service migration job objects. + operations Manage Database Migration Service operations. diff --git a/gcloud/database-migration/migration-jobs/create b/gcloud/database-migration/migration-jobs/create index 818f37b51..61c84848c 100644 --- a/gcloud/database-migration/migration-jobs/create +++ b/gcloud/database-migration/migration-jobs/create @@ -7,7 +7,7 @@ SYNOPSIS (MIGRATION_JOB : --region=REGION) --destination=DESTINATION --source=SOURCE --type=TYPE [--no-async] [--commit-id=COMMIT_ID] [--conversion-workspace=CONVERSION_WORKSPACE] - [--display-name=DISPLAY_NAME] + [--databases-filter=databaseName,[...]] [--display-name=DISPLAY_NAME] [--dump-parallel-level=DUMP_PARALLEL_LEVEL] [--dump-path=DUMP_PATH] [--dump-type=DUMP_TYPE] [--filter=FILTER] [--labels=[KEY=VALUE,...]] [--cmek-key=CMEK_KEY @@ -187,6 +187,14 @@ OPTIONAL FLAGS To set the conversion_workspace attribute: ▸ provide the argument --conversion-workspace on the command line. + The migration job objects config. + + --databases-filter=databaseName,[...] + A list of databases to be migrated to the destination instance. + Provide databases as a comma separated list. This flag is used only + for Postgres to AlloyDB and SQL Server to Cloud SQL SQL Server + migrations. + --display-name=DISPLAY_NAME A user-friendly name for the migration job. The display name can include letters, numbers, spaces, and hyphens, and must start with a diff --git a/gcloud/database-migration/migration-jobs/fetch-source-objects b/gcloud/database-migration/migration-jobs/fetch-source-objects new file mode 100644 index 000000000..429ebf4fa --- /dev/null +++ b/gcloud/database-migration/migration-jobs/fetch-source-objects @@ -0,0 +1,52 @@ +NAME + gcloud database-migration migration-jobs fetch-source-objects - fetch + objects for a Database Migration Service migration job by connection to + the source + +SYNOPSIS + gcloud database-migration migration-jobs fetch-source-objects + (MIGRATION_JOB : --region=REGION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Fetch objects for a Database Migration Service migration job by connection + to the source. + +POSITIONAL ARGUMENTS + Migration job resource - The migration job to restart. 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 migration_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. + + MIGRATION_JOB + ID of the migration_job or fully qualified identifier for the + migration_job. + + To set the migration_job attribute: + ▸ provide the argument migration_job 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 migration_job. + + To set the region attribute: + ▸ provide the argument migration_job on the command line with a + fully specified name; + ▸ provide the argument --region 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. diff --git a/gcloud/database-migration/migration-jobs/help b/gcloud/database-migration/migration-jobs/help index 66d7470f6..87483201d 100644 --- a/gcloud/database-migration/migration-jobs/help +++ b/gcloud/database-migration/migration-jobs/help @@ -28,6 +28,10 @@ COMMANDS describe Show details about a Database Migration Service migration job. + fetch-source-objects + Fetch objects for a Database Migration Service migration job by + connection to the source. + generate-ssh-script Generate a SSH script for a Database Migration Service migration job. diff --git a/gcloud/database-migration/migration-jobs/promote b/gcloud/database-migration/migration-jobs/promote index 2280e0f57..24d9951fa 100644 --- a/gcloud/database-migration/migration-jobs/promote +++ b/gcloud/database-migration/migration-jobs/promote @@ -4,7 +4,8 @@ NAME SYNOPSIS gcloud database-migration migration-jobs promote - (MIGRATION_JOB : --region=REGION) [GCLOUD_WIDE_FLAG ...] + (MIGRATION_JOB : --region=REGION) + [--databases-filter=databaseName,[...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION Promote a Database Migration Service migration job. @@ -47,6 +48,14 @@ POSITIONAL ARGUMENTS fully specified name; ▸ provide the argument --region on the command line. +FLAGS + The migration job objects config. + + --databases-filter=databaseName,[...] + A list of databases to be migrated to the destination instance. + Provide databases as a comma separated list. This flag is used only + for SQL Server to Cloud SQL SQL Server migrations. + 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/database-migration/migration-jobs/restart b/gcloud/database-migration/migration-jobs/restart index 90074ef90..158681f76 100644 --- a/gcloud/database-migration/migration-jobs/restart +++ b/gcloud/database-migration/migration-jobs/restart @@ -4,8 +4,9 @@ NAME SYNOPSIS gcloud database-migration migration-jobs restart - (MIGRATION_JOB : --region=REGION) [--skip-validation] - [GCLOUD_WIDE_FLAG ...] + (MIGRATION_JOB : --region=REGION) + [--databases-filter=databaseName,[...]] [--restart-failed-objects] + [--skip-validation] [GCLOUD_WIDE_FLAG ...] DESCRIPTION Restart a Database Migration Service migration job. @@ -55,6 +56,17 @@ POSITIONAL ARGUMENTS ▸ provide the argument --region on the command line. FLAGS + The migration job objects config. + + --databases-filter=databaseName,[...] + A list of databases to be migrated to the destination instance. + Provide databases as a comma separated list. This flag is used only + for SQL Server to Cloud SQL SQL Server migrations. + + --restart-failed-objects + Restart the failed objects in the migration job. This flag is used only + for Postgres to AlloyDB migrations. + --skip-validation Restart the migration job without running prior configuration verification. diff --git a/gcloud/database-migration/migration-jobs/update b/gcloud/database-migration/migration-jobs/update index 5f73f5f36..322c2f23e 100644 --- a/gcloud/database-migration/migration-jobs/update +++ b/gcloud/database-migration/migration-jobs/update @@ -5,7 +5,8 @@ NAME SYNOPSIS gcloud database-migration migration-jobs update (MIGRATION_JOB : --region=REGION) [--no-async] [--commit-id=COMMIT_ID] - [--destination=DESTINATION] [--display-name=DISPLAY_NAME] + [--databases-filter=databaseName,[...]] [--destination=DESTINATION] + [--display-name=DISPLAY_NAME] [--dump-parallel-level=DUMP_PARALLEL_LEVEL] [--dump-path=DUMP_PATH] [--dump-type=DUMP_TYPE] [--filter=FILTER] [--source=SOURCE] [--type=TYPE] [--update-labels=[KEY=VALUE,...]] @@ -75,6 +76,14 @@ FLAGS migration job. If not specified, the latest commit id will be used by default. + The migration job objects config. + + --databases-filter=databaseName,[...] + A list of databases to be migrated to the destination instance. + Provide databases as a comma separated list. This flag is used only + for Postgres to AlloyDB and SQL Server to Cloud SQL SQL Server + migrations. + Connection profile resource - ID of the destination connection profile, representing the destination database. This represents a Cloud resource. (NOTE) Some attributes are not given arguments in this group but can be diff --git a/gcloud/database-migration/objects/help b/gcloud/database-migration/objects/help new file mode 100644 index 000000000..85bacbcb0 --- /dev/null +++ b/gcloud/database-migration/objects/help @@ -0,0 +1,23 @@ +NAME + gcloud database-migration objects - manage Database Migration Service + migration job objects + +SYNOPSIS + gcloud database-migration objects COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Commands for managing Database Migration Service migration job objects. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + list + List a DMS migration job objects. + + lookup + Lookup a DMS migration job object. diff --git a/gcloud/database-migration/objects/list b/gcloud/database-migration/objects/list new file mode 100644 index 000000000..73ec950f5 --- /dev/null +++ b/gcloud/database-migration/objects/list @@ -0,0 +1,93 @@ +NAME + gcloud database-migration objects list - list a DMS migration job objects + +SYNOPSIS + gcloud database-migration objects list + (--migration-job=MIGRATION_JOB : --region=REGION) [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List migration job objects. + +EXAMPLES + To list all objects in a migration job and location 'us-central1', run: + + $ gcloud database-migration objects list --migration-job=mj \ + --region=us-central1 + +REQUIRED FLAGS + Migration job resource - The migration job to list migration job objects. + 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 --migration-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. + + --migration-job=MIGRATION_JOB + ID of the migration_job or fully qualified identifier for the + migration_job. + + To set the migration_job attribute: + ▸ provide the argument --migration-job on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --region=REGION + The Cloud region for the migration_job. + + To set the region attribute: + ▸ provide the argument --migration-job on the command line with a + fully specified name; + ▸ provide the argument --region 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 database-migration/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/database-migration/ diff --git a/gcloud/database-migration/objects/lookup b/gcloud/database-migration/objects/lookup new file mode 100644 index 000000000..a9a87e431 --- /dev/null +++ b/gcloud/database-migration/objects/lookup @@ -0,0 +1,65 @@ +NAME + gcloud database-migration objects lookup - lookup a DMS migration job + object + +SYNOPSIS + gcloud database-migration objects lookup --database=DATABASE + (--migration-job=MIGRATION_JOB : --region=REGION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Lookup a migration job object by its source object identifier (e.g. + database) + +EXAMPLES + To lookup an existing migration job object: + + $ gcloud database-migration objects lookup --migration-job=my-job \ + --location=us-central1 --database=my-database + +REQUIRED FLAGS + The source object identifier. + + This must be specified. + + --database=DATABASE + The name of the database to lookup. + + Migration job resource - The migration job to list migration job objects. + 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 --migration-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. + + --migration-job=MIGRATION_JOB + ID of the migration_job or fully qualified identifier for the + migration_job. + + To set the migration_job attribute: + ▸ provide the argument --migration-job on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --region=REGION + The Cloud region for the migration_job. + + To set the region attribute: + ▸ provide the argument --migration-job on the command line with a + fully specified name; + ▸ provide the argument --region 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. diff --git a/gcloud/filestore/instances/create b/gcloud/filestore/instances/create index 2aa603e3d..c8d062f5c 100644 --- a/gcloud/filestore/instances/create +++ b/gcloud/filestore/instances/create @@ -188,7 +188,8 @@ REQUIRED FLAGS network. connect-mode Network connection mode used by instances. CONNECT_MODE must be one - of: DIRECT_PEERING or PRIVATE_SERVICE_ACCESS. + of: DIRECT_PEERING, PRIVATE_SERVICE_ACCESS or + PRIVATE_SERVICE_CONNECT. OPTIONAL FLAGS --async diff --git a/gcloud/logging/buckets/update b/gcloud/logging/buckets/update index 760329270..16f9fe412 100644 --- a/gcloud/logging/buckets/update +++ b/gcloud/logging/buckets/update @@ -8,6 +8,8 @@ SYNOPSIS [--enable-analytics] [--locked] [--remove-indexes=[FIELD PATH,...]] [--restricted-fields=[RESTRICTED_FIELD,...]] [--retention-days=RETENTION_DAYS] [--update-index=[KEY=VALUE, ...,...]] + [--billing-account=BILLING_ACCOUNT_ID | --folder=FOLDER_ID + | --organization=ORGANIZATION_ID | --project=PROJECT_ID] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -122,6 +124,31 @@ OPTIONAL FLAGS The type of data in this index. For example: INDEX_TYPE_STRING Supported types are strings and integers. + At most one of these can be specified: + + --billing-account=BILLING_ACCOUNT_ID + Billing account of the bucket to update. + + --folder=FOLDER_ID + Folder of the bucket to update. + + --organization=ORGANIZATION_ID + Organization of the bucket to update. + + --project=PROJECT_ID + Project of the bucket to update. + + The Google Cloud project ID to use for this invocation. If omitted, + then the current project is assumed; the current project can be + listed using gcloud config list --format='text(core.project)' and can + be set using gcloud config set project PROJECTID. + + --project and its fallback core/project property play two roles in + the invocation. It specifies the project of the resource to operate + on. It also specifies the project for API enablement check, quota, + and billing. To specify a different project for quota and billing, + use --billing-project or billing/quota_project property. + 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/volumes/replications/create b/gcloud/netapp/volumes/replications/create index 7bebb4729..145134802 100644 --- a/gcloud/netapp/volumes/replications/create +++ b/gcloud/netapp/volumes/replications/create @@ -6,8 +6,8 @@ SYNOPSIS gcloud netapp volumes replications create (REPLICATION : --location=LOCATION) --destination-volume-parameters=[description=DESCRIPTION], - [share_name=SHARE_NAME], - [storage_pool=STORAGE_POOL],[volume_id=VOLUME_ID] + [share_name=SHARE_NAME],[storage_pool=STORAGE_POOL], + [tiering_policy=TIERING_POLICY],[volume_id=VOLUME_ID] --replication-schedule=REPLICATION_SCHEDULE [--async] [--cluster-location=CLUSTER_LOCATION] [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] [--volume=VOLUME] [GCLOUD_WIDE_FLAG ...] @@ -64,7 +64,42 @@ POSITIONAL ARGUMENTS ▸ set the property netapp/location. REQUIRED FLAGS - --destination-volume-parameters=[description=DESCRIPTION],[share_name=SHARE_NAME],[storage_pool=STORAGE_POOL],[volume_id=VOLUME_ID] + --destination-volume-parameters=[description=DESCRIPTION],[share_name=SHARE_NAME],[storage_pool=STORAGE_POOL],[tiering_policy=TIERING_POLICY],[volume_id=VOLUME_ID] + Required, Sets destination_volume_parameters value. + + description + Sets description value. + + share_name + Sets share_name value. + + storage_pool + Required, Sets storage_pool value. + + tiering_policy + Sets tiering_policy value. + + cooling-threshold-days + Sets cooling-threshold-days value. + + tier-action + Sets tier-action value. + + volume_id + Sets volume_id value. + + Shorthand Example: + + --destination-volume-parameters='description=string,share_name=string,storage_pool=string,tiering_policy={"cooling-threshold-days": int, "tier-action": "string"},volume_id=string' + + JSON Example: + + --destination-volume-parameters='{"description": "string", "share_name": "string", "storage_pool": "string", "tiering_policy": {"cooling-threshold-days": int, "tier-action": "string"}, "volume_id": "string"}' + + File Example: + + --destination-volume-parameters=path_to_file.(yaml|json) + --replication-schedule=REPLICATION_SCHEDULE The schedule for the Replication. diff --git a/gcloud/network-connectivity/regional-endpoints/create b/gcloud/network-connectivity/regional-endpoints/create index bea29eb59..75a41cff8 100644 --- a/gcloud/network-connectivity/regional-endpoints/create +++ b/gcloud/network-connectivity/regional-endpoints/create @@ -19,7 +19,8 @@ EXAMPLES $ gcloud network-connectivity regional-endpoints create \ my-regional-endpoint --region=us-central1 \ - [--network=my-network] [--subnetwork=my-subnet] \ + [--address=my-address] [--network=my-network] \ + [--subnetwork=my-subnet] \ --target-google-api=my-target-endpoint [--enable-global-access] POSITIONAL ARGUMENTS diff --git a/gcloud/network-management/connectivity-tests/create b/gcloud/network-management/connectivity-tests/create index 5a5b66256..d83de2549 100644 --- a/gcloud/network-management/connectivity-tests/create +++ b/gcloud/network-management/connectivity-tests/create @@ -18,7 +18,8 @@ SYNOPSIS --source-gke-master-cluster=SOURCE_GKE_MASTER_CLUSTER --source-instance=SOURCE_INSTANCE --source-ip-address=SOURCE_IP_ADDRESS) [--async] - [--description=DESCRIPTION] [--destination-fqdn=DESTINATION_FQDN] + [--bypass-firewall-checks] [--description=DESCRIPTION] + [--destination-fqdn=DESTINATION_FQDN] [--destination-network=DESTINATION_NETWORK] [--destination-port=DESTINATION_PORT] [--destination-project=DESTINATION_PROJECT] [--labels=[KEY=VALUE,...]] @@ -116,6 +117,9 @@ OPTIONAL FLAGS Return immediately, without waiting for the operation in progress to complete. + --bypass-firewall-checks + This boolean controls whether to skip firewall checking. + --description=DESCRIPTION The description of the connectivity test. diff --git a/gcloud/network-management/connectivity-tests/update b/gcloud/network-management/connectivity-tests/update index 7dea1b969..1bcc3ef62 100644 --- a/gcloud/network-management/connectivity-tests/update +++ b/gcloud/network-management/connectivity-tests/update @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud network-management connectivity-tests update CONNECTIVITY_TEST - [--async] [--description=DESCRIPTION] + [--async] [--bypass-firewall-checks] [--description=DESCRIPTION] [--destination-fqdn=DESTINATION_FQDN] [--destination-network=DESTINATION_NETWORK] [--destination-port=DESTINATION_PORT] @@ -77,6 +77,10 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + --bypass-firewall-checks + This boolean controls whether to skip firewall checking. Use + --no-bypass-firewall-checks to disable. + --description=DESCRIPTION The description of the connectivity test. diff --git a/gcloud/spanner/instances/create b/gcloud/spanner/instances/create index 60e6d839e..0eda91ed4 100644 --- a/gcloud/spanner/instances/create +++ b/gcloud/spanner/instances/create @@ -7,7 +7,8 @@ SYNOPSIS [--default-backup-schedule-type=DEFAULT_BACKUP_SCHEDULE_TYPE] [--edition=EDITION] [--expire-behavior=EXPIRE_BEHAVIOR] [--instance-type=INSTANCE_TYPE] - [--nodes=NODES | --processing-units=PROCESSING_UNITS] + [--nodes=NODES | --processing-units=PROCESSING_UNITS + | --autoscaling-high-priority-cpu-target=AUTOSCALING_HIGH_PRIORITY_CPU_TARGET --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET (--autoscaling-max-nodes=AUTOSCALING_MAX_NODES --autoscaling-min-nodes=AUTOSCALING_MIN_NODES | --autoscaling-max-processing-units=AUTOSCALING_MAX_PROCESSING_UNITS --autoscaling-min-processing-units=AUTOSCALING_MIN_PROCESSING_UNITS)] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -99,6 +100,54 @@ OPTIONAL FLAGS --processing-units=PROCESSING_UNITS Number of processing units for the instance. + Autoscaling + + --autoscaling-high-priority-cpu-target=AUTOSCALING_HIGH_PRIORITY_CPU_TARGET + Specifies the target percentage of high-priority CPU the autoscaled + instance can utilize. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET + Specifies the target percentage of storage the autoscaled instance + can utilize. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + Autoscaling limits can be defined in either nodes or processing units. + + Exactly one of these must be specified: + + Autoscaling limits in nodes: + + --autoscaling-max-nodes=AUTOSCALING_MAX_NODES + Maximum number of nodes for the autoscaled instance. + + This flag argument must be specified if any of the other + arguments in this group are specified. + + --autoscaling-min-nodes=AUTOSCALING_MIN_NODES + Minimum number of nodes for the autoscaled instance. + + This flag argument must be specified if any of the other + arguments in this group are specified. + + Autoscaling limits in processing units: + + --autoscaling-max-processing-units=AUTOSCALING_MAX_PROCESSING_UNITS + Maximum number of processing units for the autoscaled instance. + + This flag argument must be specified if any of the other + arguments in this group are specified. + + --autoscaling-min-processing-units=AUTOSCALING_MIN_PROCESSING_UNITS + Minimum number of processing units for the autoscaled instance. + + 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/spanner/instances/update b/gcloud/spanner/instances/update index 4c20f4682..80c616250 100644 --- a/gcloud/spanner/instances/update +++ b/gcloud/spanner/instances/update @@ -6,7 +6,8 @@ SYNOPSIS [--default-backup-schedule-type=DEFAULT_BACKUP_SCHEDULE_TYPE] [--description=DESCRIPTION] [--edition=EDITION] [--expire-behavior=EXPIRE_BEHAVIOR] [--instance-type=INSTANCE_TYPE] - [--nodes=NODES | --processing-units=PROCESSING_UNITS] + [--nodes=NODES | --processing-units=PROCESSING_UNITS + | --autoscaling-high-priority-cpu-target=AUTOSCALING_HIGH_PRIORITY_CPU_TARGET --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET --autoscaling-max-nodes=AUTOSCALING_MAX_NODES --autoscaling-min-nodes=AUTOSCALING_MIN_NODES | --autoscaling-max-processing-units=AUTOSCALING_MAX_PROCESSING_UNITS --autoscaling-min-processing-units=AUTOSCALING_MIN_PROCESSING_UNITS] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -90,6 +91,36 @@ FLAGS --processing-units=PROCESSING_UNITS Number of processing units for the instance. + Autoscaling + + --autoscaling-high-priority-cpu-target=AUTOSCALING_HIGH_PRIORITY_CPU_TARGET + Specifies the target percentage of high-priority CPU the autoscaled + instance can utilize. + + --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET + Specifies the target percentage of storage the autoscaled instance + can utilize. + + Autoscaling limits can be defined in either nodes or processing units. + + At most one of these can be specified: + + Autoscaling limits in nodes: + + --autoscaling-max-nodes=AUTOSCALING_MAX_NODES + Maximum number of nodes for the autoscaled instance. + + --autoscaling-min-nodes=AUTOSCALING_MIN_NODES + Minimum number of nodes for the autoscaled instance. + + Autoscaling limits in processing units: + + --autoscaling-max-processing-units=AUTOSCALING_MAX_PROCESSING_UNITS + Maximum number of processing units for the autoscaled instance. + + --autoscaling-min-processing-units=AUTOSCALING_MIN_PROCESSING_UNITS + Minimum number of processing units for the autoscaled 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/workbench/instances/update b/gcloud/workbench/instances/update index 51a3201e1..904420301 100644 --- a/gcloud/workbench/instances/update +++ b/gcloud/workbench/instances/update @@ -5,7 +5,7 @@ SYNOPSIS gcloud workbench instances update (INSTANCE : --location=LOCATION) [--async] [--labels=[KEY=VALUE,...]] [--machine-type=MACHINE_TYPE --metadata=[KEY=VALUE,...] - --accelerator-core-count=ACCELERATOR_CORE_COUNT + --tags=[TAGS,...] --accelerator-core-count=ACCELERATOR_CORE_COUNT --accelerator-type=ACCELERATOR_TYPE --custom-gpu-driver-path=CUSTOM_GPU_DRIVER_PATH --install-gpu-driver=INSTALL_GPU_DRIVER @@ -82,6 +82,9 @@ FLAGS --metadata=[KEY=VALUE,...] Custom metadata to apply to this instance. + --tags=[TAGS,...] + Tags to apply to this instance. + Accelerator configurations. --accelerator-core-count=ACCELERATOR_CORE_COUNT diff --git a/gcloud/workstations/configs/create b/gcloud/workstations/configs/create index d72c8fa5e..2f016aa51 100644 --- a/gcloud/workstations/configs/create +++ b/gcloud/workstations/configs/create @@ -20,7 +20,6 @@ SYNOPSIS [--machine-type=MACHINE_TYPE; default="e2-standard-4"] [--max-usable-workstations-count=MAX_USABLE_WORKSTATIONS_COUNT] [--network-tags=[NETWORK_TAGS,...]] - [--pd-disk-size=PD_DISK_SIZE; default=200] [--pd-disk-type=PD_DISK_TYPE; default="pd-standard"] [--pd-reclaim-policy=PD_RECLAIM_POLICY; default="delete"] [--pool-size=POOL_SIZE] [--replica-zones=[REPLICA_ZONES,...]] @@ -35,7 +34,8 @@ SYNOPSIS | --container-predefined-image=CONTAINER_PREDEFINED_IMAGE; default="codeoss"] [--kms-key=KMS_KEY : --kms-key-service-account=KMS_KEY_SERVICE_ACCOUNT] - [GCLOUD_WIDE_FLAG ...] + [--pd-disk-size=PD_DISK_SIZE; default=200 + | --pd-source-snapshot=PD_SOURCE_SNAPSHOT] [GCLOUD_WIDE_FLAG ...] DESCRIPTION Create a workstation configuration. @@ -244,10 +244,6 @@ FLAGS $ gcloud workstations configs create --network-tags=tag_1,tag_2 - --pd-disk-size=PD_DISK_SIZE; default=200 - Size of the persistent directory in GB. PD_DISK_SIZE must be one of: - 10, 50, 100, 200, 500, 1000. - --pd-disk-type=PD_DISK_TYPE; default="pd-standard" Type of the persistent directory. PD_DISK_TYPE must be one of: pd-standard, pd-balanced, pd-ssd. @@ -374,6 +370,15 @@ FLAGS The service account associated with the provided customer-managed encryption key. + At most one of these can be specified: + + --pd-disk-size=PD_DISK_SIZE; default=200 + Size of the persistent directory in GB. PD_DISK_SIZE must be one of: + 10, 50, 100, 200, 500, 1000. + + --pd-source-snapshot=PD_SOURCE_SNAPSHOT + Name of the snapshot to use as the source for the home disk. + 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/workstations/configs/update b/gcloud/workstations/configs/update index 4f522bb5d..d7315b2e7 100644 --- a/gcloud/workstations/configs/update +++ b/gcloud/workstations/configs/update @@ -17,7 +17,8 @@ SYNOPSIS [--idle-timeout=IDLE_TIMEOUT] [--labels=[LABELS,...]] [--machine-type=MACHINE_TYPE] [--max-usable-workstations-count=MAX_USABLE_WORKSTATIONS_COUNT] - [--network-tags=[NETWORK_TAGS,...]] [--pool-size=POOL_SIZE] + [--network-tags=[NETWORK_TAGS,...]] + [--pd-source-snapshot=PD_SOURCE_SNAPSHOT] [--pool-size=POOL_SIZE] [--running-timeout=RUNNING_TIMEOUT] [--service-account=SERVICE_ACCOUNT] [--service-account-scopes=[SERVICE_ACCOUNT_SCOPES,...]] [--shielded-integrity-monitoring] [--shielded-secure-boot] @@ -214,6 +215,9 @@ FLAGS $ gcloud workstations configs update --network-tags=tag_1,tag_2 + --pd-source-snapshot=PD_SOURCE_SNAPSHOT + Name of the snapshot to use as the source for the home disk. + --pool-size=POOL_SIZE Number of instances to pool for faster Workstation startup.